main_plugin_farm/docs/task_plan.md

# Farm 主仓库初始化计划

日期：2026-10-15。负责人：当前主 Agent。

## 目标与状态

本轮初始化与设计交付已完成。业务重构尚未开始，正式产品决策仍待确认。
建立一个开发主仓库、多框架发布仓库的长期方案；保留旧插件源码与资源；
完成 Git、忽略规则、设计和源码审查文档。

## 完成阶段

- [x] 定位 D:/Work/farm；原为空目录。
- [x] 初始化本地 Git，main 分支；未设远程，未提交或推送。
- [x] 复制 827 个旧文件，生成来源清单；副本移除硬编码凭据。
- [x] 完成架构、目录、业务逻辑、发布与迁移规划。
- [x] 完成源码审查、待确认项与风险说明。
- [x] 验证哈希、Python/JSON 语法、静态库和忽略规则。
- [x] 按补充要求记录三个发布仓库地址。
- [x] 用户撤回拉取并要求删除后，删除三个已克隆副本，停止远程访问。
- [x] 本地文档索引与校验结果交付。

## 不属于本轮的工作

真实多框架业务实现、自动发布、远程提交、发布仓库接管、真实用户数据
迁移和服务端令牌轮换，分别按路线和授权推进，不计为本轮已完成实现。

## 约束

- 旧项目 D:/Work/zhenxun_plugin_farm 保持不变。
- 基线：Beta，b015c6c1997f146f651b677382980d338a306bb2。
- 真实玩家数据、凭据、运行时缓存和 Git 元数据不复制进主源码。
- 文档区分事实、设计建议、待确认项与已完成修改。
- 三个发布仓库仅记录地址，不再 clone/fetch/pull/push。

## 执行异常与处理

| 情况 | 处理 |
|---|---|
| 默认命令环境曾有 MXC 启动错误 | 使用针对用户授权目录的提升执行 |
| 规划解析脚本被签名策略拒绝 | 不改系统策略，显式固定 docs 规划位置 |
| 空目录尚非 Git 仓库，diff 失败 | 初始化后验证 |
| 文档首次检查时 08-validation.md 尚未创建 | 创建后重新检查链接 |
| 旧活动模块 NameError | 记录为已确认缺陷，不混为本轮失败 |
| 用户要求停止拉取时三个 clone 已完成 | 如实说明，收到删除要求后逐个校验路径并删除 |

没有尝试绕过用户停止拉取要求，也没有执行远程发布。

## 第二轮：基础迁移开发

用户已确认范围并选择当前目录，Comet已进入Build。
- [x] 修复Comet管理区并完成Native初始化。
- [x] 202条配置离线迁移，建立独立核心包。
- [x] 注册、查询、购买、播种、收获、铲除、锁定及出售。
- [x] SQLite事务、流水、幂等、并发及取消恢复。
- [x] 32项定向测试通过；文档与打包入口已完成。
- [x] Runtime完整检查与独立Verifier验收：32项测试、8/8验收通过。
- [ ] 用户接受验收结果后归档；本轮不推送发布。

开发期问题：测试连接未关闭导致Windows清理失败，已修复并复测。
主仓库origin由用户设置为Shu-Ying/main_plugin_farm，未访问远程。

## 第三轮：共享农场图片

- [x] 用户确认方案并补充WebP，当前目录进入Build。
- [x] 独立Pillow工具、快照展示、673素材原样打包、缓存和受控任务。
- [x] 13项渲染定向测试通过，wheel独立图片生成通过。
- [x] 生成普通/高清样例并检查文字布局，保存三格式测量和使用文档。
- [x] 正式Runtime检查45项测试通过；独立Verifier判定全部A1-A13通过。
- [ ] 用户接受结果后归档。

## 第四轮：真寻原指令预览包

- [x] 用户确认接入、打包工作流和安装脚本；原指令，不加测试前缀。
- [x] 真寻命令、独立库、日志、生命周期和图片接入。
- [x] 白名单ZIP、校验/安装、固定预览分支dry-run发布脚本。
- [x] 主仓库CI附件与发布仓库校验工作流；未执行远端操作。
- [x] 定向打包与宿主模拟测试、最低Pillow绘图和YAML检查。
- [x] Runtime56项、Pillow10.4下24项及工作流检查通过；独立A1-A18通过。
- [ ] 用户接受后归档；真实机器人测试由用户部署后进行。