docs: 初始化 cmshopee 文档、设计与项目骨架

- 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>

AGENTS.md

@@ -0,0 +1,52 @@
+# AGENTS.md
+
+> Codex / 通用 AI coding agent 的仓库级入口。进入本仓库后，先读本文，再进入 [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)。
+
+## 项目定位
+
+cmshopee 是一个 **Windows 本地桌面自动化工具**：管理多个 Shopee 卖家账号，用 CDP 驱动 Chrome 自动改商品标题、换商品封面。当前单账号流程已验证，正在扩展多账号管理与 GUI。
+
+## 文档位置
+
+- 项目文档集合在 [`docs/`](docs/)，导航见 [`docs/README.md`](docs/README.md)。
+- 编程入口是 [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)，它继续导航到愿景、需求、技术栈、架构、编码规则、任务看板。
+- 执行历史流水在根目录 [`progress.md`](progress.md)；当前快照在 [`docs/current-state.md`](docs/current-state.md)。
+
+## 必读顺序
+
+每次开始工作前，按顺序读取：
+
+1. 本文 `AGENTS.md`：仓库定位与规则。
+2. [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)：编程入口与流程。
+3. [`docs/04-architecture.md`](docs/04-architecture.md)：尤其**第四节 CDP 已验证事实**。
+4. [`docs/05-coding-rules.md`](docs/05-coding-rules.md)：硬性编码规则。
+5. [`docs/06-tasks.md`](docs/06-tasks.md) + [`docs/current-state.md`](docs/current-state.md)：领取任务、了解现状。
+6. 与当前任务相关的具体文档。
+
+## 工作规则
+
+- 复用已有 `cdp.py`，遵守架构第四节的选择器、就绪判断、上传/拖拽方式，不另起一套 CDP 交互。
+- 只做当前任务范围内的事；V2（批量、多账号并行）只记录不实现。
+- CDP 选择器 / 流程 / 配置 schema 变化，必须同步更新 `docs/04-architecture.md` 与相关任务。
+- 改完后更新任务状态、追加 `progress.md`、覆盖 `docs/current-state.md`。
+
+## 安全红线
+
+- 绝不把真实账号、密码、Cookie、token 写进代码、文档或日志；密码加密存、不自动登录。
+- `config.json`、`cmshopee.db`、`chrome_user_data_dir/`（含密码/登录态）绝不提交版本库。
+- 「更新」提交线上、删除满 9 张封面等不可逆动作，必须显式确认/开关，并先在测试商品验证。
+- 不绕过 Shopee 的验证码、风控、限流或权限校验。
+
+## 验证
+
+```bash
+python -m py_compile *.py     # 语法检查
+python prototypes/demo.py                # 单账号闭环（不提交）
+```
+
+涉及 CDP 改动，在测试商品（ITEM_ID 51100639510）上实跑确认；如命令不可运行，在回复里如实说明。
+
+## 风格
+
+- 文档与 UI 文案用中文，标识符用英文。
+- 内容面向 agent 执行：能落到“读什么、改什么、验证什么”。