# QQ 农场功能清单与优先级

> 参考 `qq-farm-copilot` 的已实现功能，按「用户价值 × 实现成本 × 风险」重排，
> 并对齐 v2 智能体协同架构（插件提供原语，判断交给模型）。

## 分级标准

| 级别 | 含义 | 进入条件 |
|---|---|---|
| **P0** | 核心闭环，没有它插件没意义 | 必须做，且必须稳 |
| **P1** | 高频收益，风险低 | M2 内完成 |
| **P2** | 社交/扩展玩法，中等复杂 | M3 起分批 |
| **P3** | 低频、平台相关、纯运维 | 有空再做 |

风险口径：**涉及花钱或不可逆的操作一律降级**（出售/购买默认关闭，需显式开启并二次确认）。

---

## P0 · 核心闭环（必须）

| # | 功能 | 说明 | 实现路线 |
|---|---|---|---|
| 1 | 看农场 | 截图 + 模型判断，输出概览/经验/任务/务农 | 模型视觉 + `farm_look` |
| 2 | 一键务农 | 收获 + 补种（游戏自带按钮） | `farm_click` |
| 3 | 逐块收获 | 「可摘」标记的地块逐一点击 | `farm_click_plot` |
| 4 | 单块状态读取 | 点地块读弹窗：作物名 + 成熟倒计时 | 点击 + OCR |
| 5 | 地块巡查 | 周期性刷新 24 格状态 | 定时唤醒 + `farm_look` |
| 6 | 面板状态镜像 | 实时画面 + 地块网格 + 任务/日志 | 已有 |
| 7 | 安全红线 | 不点出售/购买/分享；页面白名单 | 插件硬校验 + 指令约束 |
| 8 | 用户不被打断 | 空闲闸门 + 操作中可中断 | 已有 `guard_idle` |

## P1 · 日常收益（高频、低风险）

| # | 功能 | 说明 | 风险 |
|---|---|---|---|
| 9 | 自动施肥 | 按剩余成熟时间决定是否施肥，可缩短周期 | 消耗道具，可配上限 |
| 10 | 一键收获（单独） | 只收不种，用于不想补种的场景 | 无 |
| 11 | 任务奖励领取 | 左下「等级提升」「每日任务」等 | 低 |
| 12 | 分享奖励 | 分享后可领取的奖励 | 低（**点分享本身是红线**，需人工触发） |
| 13 | 商城免费商品 | 每日免费领取 | 低（只领免费） |
| 14 | 邮件领取 | 邮件附件一键领取 | 低 |
| 15 | 月卡 / SVIP 礼包 | 领取类 | 低 |
| 16 | 自动买种子 | 仓库缺种时按最低价补 | **中**（花钱，需额度上限 + 显式开启） |
| 17 | 自动播种 | 空地补种，**优先种当前活动作物**（活动任务可领奖） | 低 |
| 18 | 数据统计 | 收获量/播种量/收益曲线 | 无 |

## P2 · 社交与扩展（中等复杂）

| # | 功能 | 说明 | 风险 |
|---|---|---|---|
| 19 | 好友偷菜 | 遍历好友农场偷取 | 中（需好友列表翻页） |
| 20 | 好友帮忙 | 除草/浇水/杀虫 | 低 |
| 21 | 自动种草 | 种观赏草获取经验 | 低 |
| 21b | 活动作物优先 | 识别当期活动作物（活动页→兑换商店→种子），播种时优先选择；需处理解锁等级与限购 | 中 |
| 22 | 土地扩建 | 达标后扩建（消耗金币） | **中**（花钱） |
| 23 | 土地升级 | 红/黑/金土升级 | **中**（花钱） |
| 24 | 仓库批量出售 | 果实批量卖掉 | **高（不可逆）** → 默认关闭 |
| 25 | 通用活动 | 活动页领奖/兑换 | 中（每个活动要适配） |
| 26 | 神秘商人 | 定时出现，买限定物品 | **中**（花钱） |
| 27 | 图鉴/收集 | 查看收集进度 | 无 |

## P3 · 运维与平台适配

| # | 功能 | 说明 |
|---|---|---|
| 28 | 定时重启窗口 | 长时间运行后重启防卡死 |
| 29 | 异常自动恢复 | 卡页面/弹窗时自动回主场 |
| 30 | 多开多实例 | 一个面板管多个账号 |
| 31 | 通知推送 | 异常时推送到手机/桌面通知 |
| 32 | 窗口隐藏 | 运行时最小化/移出屏幕 |
| 33 | 防抢鼠标 | 已实现（空闲闸门） |
| 34 | 跨平台 | QQ / 微信 两套小程序 |
| 35 | Android/ADB 后端 | 真后台运行（无干扰） |

---

## 本插件特有（参考项目没有的）

| # | 能力 | 价值 |
|---|---|---|
| A | **模型视觉判断** | 作物识别不靠阈值，纠正一次即改进 |
| B | **视觉词典**（`AGENTS.md`） | 领域知识可被用户直接编辑 |
| C | **Token 预算闸门** | 小时/日上限，超限降级为脚本模式 |
| D | **变化检测** | 画面没变就不唤醒模型，省 80% 调用 |
| E | **决策可审计** | 每次点击都记录「为什么」 |
| F | **面板 = 状态镜像** | 用户能看到智能体在想什么 |

---

## 实施顺序（对应里程碑）

### M1 · 闭环（进行中）
P0 的 1/2/3/6/7 —— 看得到、点得准、不越线

### M2 · 稳定与省 token
P0 的 4/5/8 + P1 的 9/10/11 + 本插件特有 C/D

### M3 · 收益最大化
P1 其余（12~18）+ P2 的 19/20/21

### M4 · 扩展
P2 其余（22~27）+ P3（28~32）

### M5 · 平台
P3 的 34/35（Android/ADB 真后台）

---

## 明确不做（或最后再做）

| 功能 | 原因 |
|---|---|
| 四格作物自动种植 | 参考项目也标注「收益太低」，且识别复杂 |
| 出售类自动化 | 不可逆，误操作损失大 |
| 协议/内存注入 | 违反用户意愿，且封号风险 |

---

## 优先级判断依据

1. **收益频率**：每天能触发多次 > 每天一次 > 一次性
2. **失败代价**：只读 < 消耗道具 < 花钱 < 不可逆
3. **识别难度**：有文字标记（可摘/倒计时）> 有固定按钮 > 纯图形判断
4. **token 成本**：能用文本判断的不上图