Table of Contents

项目档案

基本信息
DevHarness 来源与基线
子项目与交付单元
技术栈与运行环境
阅读入口
常用命令
环境、配置与凭据

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
Gitea 仓库	`OPC/cmautobuy`
仓库地址	https://git.ilapage.cn/OPC/cmautobuy
工作区	`D:/chengma/cmautobuy`
主要语言	Go、Python、HTML/CSS/JavaScript
维护对象	Admin 管理端、Client Windows 桌面端
Wiki 主源启用日期	2026-08-26

DevHarness 来源与基线

来源目录：D:/OPC/dev_harness
采用的完整提交：0b6ec7675dfc2d930a30527eddac83f4302d0879
基线提交时间：2026-08-26 16:11:48 +08:00
本次升级日期：2026-08-26
升级范围：Wiki 主源、Gitea 工单主源、在线回读门禁、设计证据双门禁、自然语言快捷指令、依赖并行规则、可选任务快照和严格检查。
保留范围：本项目五条产品红线、Admin/Client 子项目规则、Client API 契约、真实启动和验证命令、历史 docs/task。

后续再升级时必须先记录新的完整上游提交、比较差异、建工单并增量迁移；不能用“最新版”代替可复现提交。

子项目与交付单元

交付单元	目录	技术栈	职责
Admin	`admin/`	Go 1.23、Gin、html/template、MySQL 8.4	管理商品、顺运宝、任务、用户、客户端、AI 配置和档口入库码
Client	`client/`	Python 3.10、PyQt5、uiautomator2、SQLite	在 Windows 连接 Android，领取并执行 PDD 采集和真实下单（不支付）任务
共享契约	`docs/client/04-admin-api-contract.md` 的 Wiki 镜像	HTTP JSON	登记、领取、提交结果、提交失败及运行时规格解析

两个子项目技术栈和线程模型完全不同。跨接口修改在同一个工单里同步两边契约与验证。

技术栈与运行环境

Client 固定 PyQt5，不得改用其他 Qt 绑定。
Admin 固定 Go 1.23.0、Gin v1.11.0、MySQL 8.4；生产运行时不使用 SQLite。
Admin 页面使用服务端模板和少量原生 JavaScript，不引入 React/Vue/npm 构建链。
Client 使用 QObject + moveToThread 执行耗时任务，QWidget 只在主线程访问。
生产 Admin 为 Linux 常驻服务，前置 nginx，数据位于 MySQL；详细信息见后续的 Deployment-and-Operations 页面。

阅读入口

文档首页
产品需求总览
架构与代码地图
业务规则与术语
修改具体子项目前读取仓库中的对应 AGENTS.md
按任务进入 Admin 或 Client 详细页面

常用命令

从仓库根目录：

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

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/config.yaml、AI API key、数据库密码、Cookie 和 Token 不进入 Git、Wiki、工单或日志。
Admin 生产凭据来自权限受控的环境文件；Windows 本地可使用被 Git 忽略的 admin/config.yaml。
Wiki 同步使用环境变量 GITEA_URL、GITEA_TOKEN；工具报错不得打印 Token。
Client 软件更新公开引导默认密码 chengma 是唯一允许写入源码和文档的例外。
个人数据和无障碍 XML 原文仅保存在本机非 Git 目录，对外证据必须脱敏。