chengmaandClaude Opus 4.8
479d02a2b8
- docs/ 完整 harness coding 文档集（愿景/需求/技术栈/架构/编码规则/任务/api/routes/current-state） - 5 Tab 流水线设计 + UI 效果图 SVG（docs/ui/） - cdp.py CDP 底座；prototypes/ 已验证原型脚本（待 editor.py 移植后清理） - AGENTS.md/CLAUDE.md 入口、progress.md 执行流水、.gitignore（排除凭证/DB/图片） Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
项目文档导航
cmshopee 的 harness coding 文档集合。agent 开始编程前从
00-ai-start-here.md进入。
一句话定位
cmshopee 是一个给电商运营使用的 Windows 桌面自动化工具，用于管理多个 Shopee 卖家账号、并用 CDP 驱动 Chrome 批量修改商品标题、替换商品封面图。第一版先跑通「配置账号 → 绑定独立 Chrome 配置目录（保留登录态）→ 用某账号打开指定商品详情页 → 改标题 + 换封面（可选提交更新）」闭环。
文档导航
../AGENTS.md：Codex / 通用 AI coding agent 的仓库级入口。../CLAUDE.md：Claude Code 的薄入口，具体规则以AGENTS.md为准。../progress.md：执行历史流水，只追加记录任务执行、验证、阻塞和决策。- AI 开发入口：agent 每次开始工作的入口、阅读顺序和任务领取规则。
- 项目愿景：为什么做、为谁做、产品原则、非目标。
- 需求：要什么、用户故事、验收标准。
- 技术栈：语言、运行平台、CDP 方案、GUI 选型和运行命令。
- 架构设计：模块职责、账号与配置目录数据模型、CDP 已验证事实和开发顺序。
- 编码规则：写代码前必须遵守的硬约束。
- 任务看板：按依赖拆分的小任务，agent 每轮只做一个。
- 模块 / CLI 合约：本地模块接口、Chrome 启动参数、账号配置 schema。
- 界面与流程结构：GUI 窗口、操作流程、按钮职责（无前端路由，用 GUI 流程替代）。
- 当前实现状态：当前代码现实、可运行命令、下一步可做任务。
任务 / 进度 / 当前状态
06-tasks.md维护任务看板：任务 ID、依赖、验收要点和状态。../progress.md维护执行进度：每轮实际做了什么、跑了什么验证、遇到什么阻塞、做了什么决策。current-state.md维护当前快照：当前目录、可运行命令、已完成摘要和下一个可领取任务。
维护原则
- 需求变化先改文档，再改代码。
- CDP 交互的关键事实（选择器、就绪判断、上传/拖拽方式）一旦定稿，写入
04-architecture.md，代码不得另起一套。 - 涉及账号、登录凭证、Cookie 时，文档与代码只用占位符或路径引用，绝不写入真实值。
- agent 开始新任务前，必须从
00-ai-start-here.md进入。