cmsp 开发文档导航
cmsp 是一个内部使用的 Windows 桌面工具：把货憨憨 ERP 里指定 Shopee 店铺的商品，按商品主图到淘宝搜同款，抓取同款商品详情页的介绍视频，下载到本地，再批量上传回货憨憨对应商品，使 Shopee 商品页刷新后能看到视频。
本页是 Gitea Wiki 的入口页。仓库内 docs/ 是只读镜像，请不要直接编辑镜像文件。
第一次阅读
按顺序读，读完能独立完成一次简单修改：
- 项目档案：项目目标、治理模式、技术栈、常用命令、凭据来源。
- 需求总览：现在有哪些长期需求、各自处在什么状态。
- 架构与代码地图：目录职责、两条主要执行路径、不可破坏的边界。
- 业务规则与术语：货憨憨、拍立淘、MTOP、专属 Chrome 等术语，以及必须遵守的业务规则。
- 本地开发与验证：怎样跑起来、怎样验证。
- 常见修改：典型改动改哪里、验证什么。
- 故障排查：出问题时的排查顺序和必须停止的情况。
流程规则见 开发工作流。
五分钟开始
预期结果：工作区状态正常显示；check --strict 输出检查通过。
产品代码尚未建立时，上面两条是本仓库当前唯一可执行的命令。Go 与 Wails 环境就绪后，可运行的构建与测试命令统一记录在本地开发与验证，不在本页维护第二份。
简单修改从哪里开始
| 想做的事 |
从哪里开始 |
| 改界面文案或标签 |
前端 frontend/src/，见常见修改 |
| 改参数设置项 |
配置结构与设置页，见常见修改 |
| 改淘宝搜索或视频提取行为 |
internal/taobao/，属于中高风险，见架构与代码地图 |
| 改货憨憨接口调用 |
internal/huohanhan/，涉及账号与写操作，按高风险处理 |
| 改长期文档 |
先改 Gitea Wiki，再运行 python dev_scripts/harness.py sync 导出镜像 |
界面文案、局部样式和预期明确的小 Bug 可以直接实施。涉及接口、数据结构、账号凭据、批量写操作和不可逆操作时必须先建工单。
事实来源
| 内容 |
事实来源 |
本地镜像 |
| 长期架构、业务规则、开发规范 |
Gitea Wiki chengma/cmsp |
docs/ |
| 单次任务的需求、方案、测试、验收 |
Gitea 工单 |
无 |
| 源码与版本绑定资料 |
Git |
仓库本身 |
| 淘宝流程的已验证参考实现 |
D:\chengma\电商视频自动下载工具\已验证淘宝流程（仓库外） |
无 |
| 货憨憨接口的已验证参考实现 |
D:\chengma\hhh_api（仓库外） |
无 |
聊天记录不是事实来源。本地 docs/ 存在不能证明 Wiki 已更新。