cmautobuy
cmautobuy 包含 Admin Web 管理端和 Client Windows/Android 执行端，用于管理蝦皮、PDD、顺运宝、采集任务和真实采购任务（只创建未付款订单，不自动付款）。
从哪里开始
- 项目文档：Gitea Wiki
- 项目档案：docs/00-project-profile.md
- Admin 规则：admin/AGENTS.md
- Client 规则：client/AGENTS.md
- 共同规则：AGENTS.md
本地 docs/ 是与代码版本绑定的 Wiki 只读镜像，不是编辑主源。
快速验证
从仓库根目录执行：
python -m unittest discover -s tests -v
python dev_scripts/harness.py check --strict
python dev_scripts/harness.py sync --check
Admin 和 Client 的专用启动、测试与安全边界见各自 AGENTS.md 和上手指南。真实采购、真机、生产数据库和部署不是普通冒烟测试。
Wiki 初始化与同步门禁
从此仓库建立新的远端项目时，顺序固定：
- 创建 Gitea 远端仓库并推送当前引导提交，启用工单和 Wiki。
- 优先使用已配置的 Gitea MCP 查询线上页面。
Home不存在时先创建并回读Home，记录 revision。- 逐页创建、回读其余映射页面。
- 运行：
python dev_scripts/harness.py sync --verify
本地 docs/ 的存在不能证明线上 Wiki 已初始化。页面缺失、回读失败、没有 revision 或一致性检查失败时必须停止。
事实来源
- Gitea 工单是单次任务唯一事实来源。
- Gitea Wiki 是长期开发文档事实来源。
- Git 保存代码和与版本绑定的 Wiki 镜像。
- 默认不创建任务归档；历史
docs/task冻结保留，专项快照只能显式创建或导出。
任何产品行为修改都按 开发工作流 执行，并遵守根与子项目 AGENTS.md。