Files

T

chengma d130e2675e docs: 初始化核心 Wiki 镜像 (#313 )

2026-08-26 16:45:54 +08:00

3.8 KiB

Raw Permalink Blame History

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Project-Profile wiki_url: https://git.ilapage.cn/OPC/cmautobuy/wiki/Project-Profile.- wiki_revision: a8497a098e753dc0f50e2bbee31ad04b848d69d1 synchronized_at: 2026-08-26T08:42:33Z

项目档案

基本信息

项目	值
项目名	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 目录，对外证据必须脱敏。

3.8 KiB Raw Permalink Blame History Unescape Escape