generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Home wiki_url: https://git.ilapage.cn/chengma/cmsp/wiki/Home wiki_revision: 829416e60ca2daf5a505baea943fa0d6be112327 synchronized_at: 2026-09-02T03:57:20Z # cmsp 开发文档导航 cmsp 是一个内部使用的 Windows 桌面工具：把货憨憨 ERP 里指定 Shopee 店铺的商品，按商品主图到淘宝搜同款，抓取同款商品详情页的介绍视频，下载到本地，再批量上传回货憨憨对应商品，使 Shopee 商品页刷新后能看到视频。 本页是 Gitea Wiki 的入口页。仓库内 `docs/` 是只读镜像，请不要直接编辑镜像文件。 ## 第一次阅读 按顺序读，读完能独立完成一次简单修改： 1. [项目档案](00-project-profile.md)：项目目标、治理模式、技术栈、常用命令、凭据来源。 2. [需求总览](09-product-requirements-overview.md)：现在有哪些长期需求、各自处在什么状态。 3. [架构与代码地图](02-architecture-and-code-map.md)：目录职责、两条主要执行路径、不可破坏的边界。 4. [业务规则与术语](03-business-rules-and-glossary.md)：货憨憨、拍立淘、MTOP、专属 Chrome 等术语，以及必须遵守的业务规则。 5. [本地开发与验证](04-local-development-and-verification.md)：怎样跑起来、怎样验证。 6. [常见修改](05-common-changes.md)：典型改动改哪里、验证什么。 7. [故障排查](06-troubleshooting.md)：出问题时的排查顺序和必须停止的情况。 流程规则见 [开发工作流](01-workflow.md)。 ## 五分钟开始 ```powershell cd D:\chengma\cmsp git status --short --branch python dev_scripts/harness.py check --strict ``` 预期结果：工作区状态正常显示；`check --strict` 输出检查通过。 产品代码尚未建立时，上面两条是本仓库当前唯一可执行的命令。Go 与 Wails 环境就绪后，可运行的构建与测试命令统一记录在[本地开发与验证](04-local-development-and-verification.md)，不在本页维护第二份。 ## 简单修改从哪里开始 | 想做的事 | 从哪里开始 | |---|---| | 改界面文案或标签 | 前端 `frontend/src/`，见[常见修改](05-common-changes.md) | | 改参数设置项 | 配置结构与设置页，见[常见修改](05-common-changes.md) | | 改淘宝搜索或视频提取行为 | `internal/taobao/`，属于中高风险，见[架构与代码地图](02-architecture-and-code-map.md) | | 改货憨憨接口调用 | `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 已更新。