62 lines
3.0 KiB
Markdown
62 lines
3.0 KiB
Markdown
# 修复乌拉能量喂食系统需求文档
|
||
|
||
## 介绍
|
||
|
||
乌拉堕落帝国模组中的能量喂食系统存在严重问题。当乌拉族进入关机状态需要能量补充时，自定义的 `WULA_IngestEnergy` JobDriver 出现了任务循环、物品转移错误和错误执行者等问题。本文档定义了修复这些问题的需求。
|
||
|
||
## 需求
|
||
|
||
### 需求 1：修复任务重复创建问题
|
||
|
||
**用户故事：** 作为玩家，我希望当乌拉族需要能量补充时，只有一个殖民者执行喂食任务，而不是多个殖民者同时尝试执行相同任务。
|
||
|
||
#### 验收标准
|
||
|
||
1. 当乌拉族进入关机状态时，系统应该只创建一个 `WULA_IngestEnergy` 任务
|
||
2. 当一个殖民者已经预留了能量核心时，其他殖民者不应该创建相同的任务
|
||
3. 当任务失败时，系统应该正确清理预留状态，允许其他殖民者重新尝试
|
||
4. 系统不应该在单个tick内创建多个相同的任务
|
||
|
||
### 需求 2：修复物品转移逻辑
|
||
|
||
**用户故事：** 作为玩家，我希望殖民者能够正确地拾取和转移能量核心，而不会出现"物品不存在"的错误。
|
||
|
||
#### 验收标准
|
||
|
||
1. 当殖民者执行 `WULA_IngestEnergy` 任务时，应该能够成功拾取目标能量核心
|
||
2. 当能量核心被其他殖民者拾取或消耗时，当前任务应该正确失败并清理状态
|
||
3. 当能量核心不存在或无法访问时，任务应该立即失败而不是进入循环
|
||
4. 物品转移应该使用正确的 Toil 方法，确保物品状态一致性
|
||
|
||
### 需求 3：确保正确的任务执行者和目标
|
||
|
||
**用户故事：** 作为玩家，我希望殖民者将能量核心喂给需要能量的乌拉族，而不是自己消耗能量核心。
|
||
|
||
#### 验收标准
|
||
|
||
1. 当执行 `WULA_IngestEnergy` 任务时，殖民者应该将能量核心给予目标乌拉族
|
||
2. 能量应该补充到目标乌拉族的 `Need_WulaEnergy` 中，而不是执行者的需求
|
||
3. 只有目标乌拉族应该从关机状态中恢复，执行者不应该受到影响
|
||
4. 任务完成后，能量核心应该被正确消耗，目标乌拉族应该获得能量
|
||
|
||
### 需求 4：改进任务验证和错误处理
|
||
|
||
**用户故事：** 作为玩家，我希望当能量喂食任务遇到问题时，系统能够优雅地处理错误，而不是进入无限循环。
|
||
|
||
#### 验收标准
|
||
|
||
1. 当目标乌拉族不再需要能量时，任务应该自动取消
|
||
2. 当能量核心不可用时，任务应该失败并提供适当的错误信息
|
||
3. 当执行者无法到达目标时，任务应该超时失败
|
||
4. 系统应该记录详细的调试信息以便问题诊断
|
||
|
||
### 需求 5：优化 WorkGiver 逻辑
|
||
|
||
**用户故事：** 作为玩家，我希望系统能够智能地分配能量喂食任务，避免资源冲突和重复工作。
|
||
|
||
#### 验收标准
|
||
|
||
1. WorkGiver 应该检查目标能量核心是否已被其他任务预留
|
||
2. WorkGiver 应该验证执行者能够到达目标乌拉族和能量核心
|
||
3. WorkGiver 应该优先选择距离最近的可用能量核心
|
||
4. WorkGiver 应该正确处理囚犯和殖民者的不同喂食逻辑 |