100 lines
4.1 KiB
Markdown
100 lines
4.1 KiB
Markdown
# 背景
|
||
文件名：2025-11-15_1_harvest-multiple-plots.md
|
||
创建于：2025-11-15_00:37:12
|
||
创建者：ASUS@LIUBAI095
|
||
主分支：main
|
||
任务分支：main
|
||
Yolo模式：Off
|
||
|
||
# 任务描述
|
||
修改收获指令，从只能收获单个地块改为可以一次收获多个地块。
|
||
|
||
当前格式：`收获 <地块序号>`
|
||
新格式：`收获 <地块序号> [地块序号...]`
|
||
|
||
# 项目概览
|
||
这是一个基于WPS Bot的菜园系统插件。当前收获功能只支持一次收获一个地块，用户希望能够一次收获多个地块，提高操作效率。
|
||
|
||
# 分析
|
||
## 当前实现分析
|
||
1. **garden_plugin_harvest.py**：
|
||
- `callback` 方法（第59-112行）只解析单个地块序号
|
||
- 第64-66行：只提取第一个token作为地块序号
|
||
- 第71-75行：调用 `service().harvest()` 处理单个地块
|
||
- 第79-112行：处理单个地块的收获结果并返回消息
|
||
|
||
2. **garden_service.py**：
|
||
- `harvest` 方法（第181-235行）每次只处理一个地块
|
||
- 该方法会删除地块记录，返回收获结果
|
||
|
||
3. **指令格式说明**：
|
||
- 第25行：`identifier="收获 <地块序号>"`
|
||
- 第33行：步骤说明中只提到"输入正整数地块序号"
|
||
- 第46行：帮助文档中也是单个地块格式
|
||
|
||
## 需要修改的部分
|
||
1. **解析多个地块序号**：修改 `callback` 方法，支持解析空格分隔的多个地块序号
|
||
2. **循环处理多个地块**：对每个地块序号调用 `harvest` 方法
|
||
3. **汇总结果**：收集所有成功和失败的结果，统一返回给用户
|
||
4. **更新文档**：更新指令格式说明和帮助文档
|
||
|
||
## 关键逻辑考虑
|
||
- 每个地块的收获是独立的，可能触发不同的额外奖励
|
||
- 需要处理部分成功的情况（某些地块成功，某些失败）
|
||
- 需要汇总所有收获的果实和额外奖励
|
||
- 错误处理：如果某个地块失败，应该继续处理其他地块，最后汇总所有结果
|
||
|
||
# 提议的解决方案
|
||
## 方案概述
|
||
修改 `garden_plugin_harvest.py` 的 `callback` 方法，支持解析和处理多个地块序号。
|
||
|
||
## 具体实现思路
|
||
1. **解析多个地块序号**：
|
||
- 将 `payload.split()` 后的所有token都解析为地块序号
|
||
- 过滤掉非数字的token
|
||
- 去重处理，避免重复收获同一地块
|
||
|
||
2. **循环处理**：
|
||
- 对每个地块序号调用 `service().harvest()`
|
||
- 使用try-except捕获每个地块的错误
|
||
- 记录成功和失败的结果
|
||
|
||
3. **结果汇总**：
|
||
- 统计成功收获的地块数量
|
||
- 汇总所有基础果实（按作物类型分组）
|
||
- 汇总所有额外奖励（积分和物品）
|
||
- 列出失败的地块及原因
|
||
|
||
4. **消息格式**：
|
||
- 如果全部成功：显示汇总信息
|
||
- 如果部分成功：分别显示成功和失败信息
|
||
- 如果全部失败：显示所有失败原因
|
||
|
||
5. **文档更新**：
|
||
- 更新 `collect_command_entries` 中的指令格式
|
||
- 更新 `collect_guide_entries` 中的帮助说明
|
||
|
||
# 当前执行步骤："已完成所有实施步骤"
|
||
|
||
# 任务进度
|
||
[2025-11-15_00:51:11]
|
||
- 已修改：Plugins/WPSGardenSystem/garden_plugin_harvest.py
|
||
- 更改：
|
||
1. 更新 collect_command_entries 方法：修改 identifier 为 "收获 <地块序号> [地块序号...]"，更新 description 和 details 说明支持多个地块
|
||
2. 更新 collect_guide_entries 方法：修改指令格式描述，说明支持多个地块序号
|
||
3. 重构 callback 方法：
|
||
- 修改解析逻辑：支持解析多个地块序号，添加去重处理
|
||
- 重构处理逻辑：循环处理每个地块，收集成功和失败结果
|
||
- 添加数据结构：successful_harvests, failed_harvests, fruit_counts, extra_items, total_points_gained
|
||
- 实现果实统计和额外奖励汇总
|
||
- 统一积分结算：在所有地块处理完成后统一调用 adjust_user_points
|
||
- 重构消息生成：根据成功和失败结果生成汇总消息，包括地块列表、果实汇总、额外奖励等
|
||
- 处理边界情况：支持部分成功、全部失败等场景
|
||
- 原因：实现一次收获多个地块的功能，提高用户操作效率
|
||
- 阻碍因素：无
|
||
- 状态：未确认
|
||
|
||
# 最终审查
|
||
[待完成]
|
||
|