可收获多个地块

.tasks/2025-11-15_1_harvest-multiple-plots.md

@@ -0,0 +1,99 @@
+# 背景
+文件名：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
+     - 重构消息生成：根据成功和失败结果生成汇总消息，包括地块列表、果实汇总、额外奖励等
+     - 处理边界情况：支持部分成功、全部失败等场景
+- 原因：实现一次收获多个地块的功能，提高用户操作效率
+- 阻碍因素：无
+- 状态：未确认
+
+# 最终审查
+[待完成]
+