Table of Contents

cmautobuy 文档首页

第一次阅读
五分钟开始
简单修改从哪里开始
详细文档
事实来源

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

cmautobuy 文档首页

cmautobuy 由两个交付单元组成：Admin 是 Go Web 管理端，Client 是 Windows + Android 自动化执行端。两个子项目技术栈不同，但通过 Client 侧 API 契约协作。

第一次阅读

第一次接手项目：先读项目档案和对应子项目上手指南。
修改 Admin：先读仓库 admin/AGENTS.md，再按任务进入 Admin 上手指南。
修改 Client：先读仓库 client/AGENTS.md，再按任务进入 Client 上手指南。
修改两边接口：以 Client–Admin API 契约为唯一事实来源。
了解完整业务目标：读产品需求总览。

五分钟开始

从仓库根目录执行：

git status --short
python dev_scripts/harness.py check --strict

Admin 的常用验证从 admin/ 执行：

$env:GOTOOLCHAIN="go1.23.0"
go build ./...
go test ./... -count=1
Remove-Item Env:GOTOOLCHAIN

Client 的普通离线验证从 client/ 执行；不要把真实采购当冒烟测试：

C:/Python310/python.exe -m unittest discover -s test -v

简单修改从哪里开始

要做的事	先读
找代码入口和调用边界	架构与代码地图
查业务术语和红线	业务规则与术语
本地启动和验证	本地开发与验证
常见改动的最小路径	常见修改
分析报错	故障排查
建工单、实施、验收	开发工作流
写面向采购员或运维的文档	交付文档指南
部署或回退 Admin	Admin 部署与运维

详细文档

Admin 与 Client 的详细长期文档已经迁移为 Wiki 页面：

Client：上手 · 术语 · 需求 · 架构 · 数据模型 · API 契约 · 界面 · 质量安全
Admin：上手 · 术语 · 需求 · 架构 · 数据模型 · Client API · 界面 · 质量安全 · 设备登记 · 顺运宝 · SQLite 到 MySQL · 商品目录接口

事实来源

单次需求、变更、实现、测试、提交和验收：Gitea 工单。
长期稳定文档：Gitea Wiki。
代码和与版本绑定的 Wiki 镜像：Git 仓库。
产品红线和 Agent 执行规则：根 AGENTS.md 与子项目 AGENTS.md。
Client–Admin 接口：Client 侧契约页面。

本地 docs/ 是 Wiki 的只读镜像；必须先改在线 Wiki，再运行：

python dev_scripts/harness.py sync --verify

历史 docs/task 在 2026-08-26 工作流切换前形成，冻结保留，不删除、不重命名、不批量重写。新任务默认不再创建第二份任务归档。