Files

T

QiuSWandClaude Opus 5 93f4c94522 chore: 接入 DevHarness 并建立项目文档基线

从 D:/OPC/dev_harness (c13f6adb76c2ffbcae080dabf1df869a241e8f63) 接入
DevHarness 工作流，治理模式选择轻量。

- 复制 Harness 骨架：AGENTS.md、CLAUDE.md、工单模板、dev_scripts、tests
- 编写 cmsp 专属文档：Home、项目档案、架构与代码地图、业务规则与术语、
  本地开发与验证、常见修改、故障排查、需求总览
- AGENTS.md 填入项目专用红线：凭据边界、淘宝登录不可自动化、
  登录失效全局停止门、货憨憨写操作显式确认
- wiki-docs.json 指向 chengma/cmsp，登记 15 个核心页面映射

本提交为 DevHarness 允许的一次性引导提交，只包含仓库骨架与文档，
不含产品功能代码。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LbdtsD3ohhSMy3KPoCgARq

2026-09-02 11:57:18 +08:00

4.7 KiB

Raw Blame History

cmsp

cmsp 是内部使用的 Windows 桌面工具：把货憨憨 ERP 中指定 Shopee 店铺的商品，按商品主图到淘宝搜同款，抓取同款商品详情页的介绍视频，下载到本地，再批量上传回货憨憨对应商品，使 Shopee 商品页刷新后能看到视频。

技术栈为 Go + Wails v2 + Vue 3 + Naive UI + SQLite，只支持 Windows。项目采用 DevHarness 工作流：需要工单的任务以 Gitea 工单为单次任务事实来源，Gitea Wiki 保存长期文档，Git 记录代码变更，人负责确认目标和验收。

治理模式为轻量。内部工具、单人开发、不对外交付、无常驻服务，因此不设置超出实际风险的门禁。

当前状态

产品代码尚未开始。仓库目前包含 DevHarness 骨架、核心文档镜像，以及淘宝流程的目标设计规范 Wails专属Chrome登录与淘宝以图搜流程.md。业务能力目前只存在于仓库外的两份已验证 Python 实现，正在迁移为 Go。

详见项目档案与需求总览。

任务闭环

讨论需求或缺陷
  -> 阅读代码并提出方案
  -> 人工确认方案
  -> 创建单元任务工单（需要时先建 Epic / MVP）
  -> Agent 实现并测试
  -> 提交代码并更新工单
  -> 工单集中回写最终证据并等待人工验收
  -> 人工验收后在工单记录结论
  -> 关闭工单并更新父工单；长期事实变化时才同步 Wiki

轻量模式下符合直接实施条件的小 Bug、局部 UI 和单模块低风险调整不走上述闭环：确认目标 → 最小修改 → 受影响范围测试 → 提交并报告结果。

涉及货憨憨写操作、账号凭据、SQLite 结构迁移、并发或删除数据时必须建工单并按高风险处理。

快速开始

克隆本仓库到本机，例如 D:\chengma\cmsp。
创建 Gitea 远端仓库并推送当前引导提交，启用工单和 Wiki。
配置 wiki-docs.json 和安全访问方式；优先使用已配置的 Gitea MCP，MCP 不可用时才使用 Gitea API 并记录原因。令牌只通过环境变量或 MCP 安全配置提供，不写入仓库。
按新项目文档初始化查询线上 Wiki；Home 不存在时先创建并回读 Home，取得 revision 后再创建其他核心页面。
治理模式已在项目档案选定为轻量；不可违反的安全规则写在根目录 AGENTS.md 的「项目专用规则」。
需要工单时使用 .gitea/issue_template/ 中的模板。本地 docs/ 的存在不能证明线上 Wiki 已初始化。

开始产品代码前运行：

python dev_scripts/harness.py sync --verify

常用命令

git status --short --branch
python dev_scripts/harness.py check --strict
python -m unittest discover -s tests -v
python dev_scripts/harness.py sync --check

产品构建与测试命令在 Go 骨架建立后补入本地开发与验证。

AGENTS.md                         Agent 的通用工作规则与本项目专用红线
CLAUDE.md                         Claude Code 的规则入口
.gitea/issue_template/            Epic、MVP、单元任务工单模板
docs/                             Gitea Wiki 核心页面的只读镜像
docs/task/                        人工明确要求的专项快照，默认为空
wiki-docs.json                    核心 Wiki 页面到本地镜像的显式映射
dev_scripts/harness.py            check / sync / archive / export 单一入口
dev_scripts/wiki_docs.py          Gitea Wiki 客户端与镜像生成库
tests/                            DevHarness 结构自测
Wails专属Chrome登录与淘宝以图搜流程.md   淘宝链路的目标设计规范

docs/ 由同步工具生成，不要直接编辑。

安全底线

无论治理模式如何裁剪流程，下面几条不可违反：

账号、密码、token、Cookie、Chrome Profile 内容不得写入代码、日志、工单、Wiki 和提交。
淘宝登录必须由使用者手动完成，程序不代填密码、不绕过验证码与安全验证。
淘宝登录失效必须中断整批任务，不得降级为单商品失败后继续。
对真实店铺的批量写入、覆盖和删除必须获得明确授权。
测试结果必须真实，未执行或无法覆盖的验证必须写明。

文档

默认不创建任务归档；archive、export 只作为人工显式触发的兼容能力。长期文档的唯一编辑入口是 Gitea Wiki，修改顺序为：修改 Wiki → 读取确认 → 导出核心 docs → 校验差异 → 提交镜像。

4.7 KiB Raw Blame History Unescape Escape