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

# 最终审查
[待完成]