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>
2.5 KiB
2.5 KiB
项目愿景
一、核心目标
cmshopee 要解决：运营要在多个 Shopee 卖家账号下，逐个商品手动改标题、换封面，效率低、易出错、来回切换登录痛苦。
让电商运营能够在一个工具里集中管理多个 Shopee 账号，并自动完成商品标题修改和封面图替换，无需反复登录、手动逐项操作。
它不是一个通用爬虫，也不是 Shopee 官方 API 客户端，而是一个驱动已登录的真实 Chrome 浏览器、在卖家中心页面上代为操作的本地自动化工具。
二、目标用户
- 电商运营 / 店铺管理员：管理 1 个或多个 Shopee 卖家账号，需要批量调整商品标题和主图。
- 小型卖家团队负责人：希望把重复的商品维护操作标准化、半自动化。
- 本项目维护者（含 AI agent）：需要在已验证的单账号流程上，扩展出多账号管理与 GUI。
三、产品原则
遇到取舍时，以这些原则为准：
- 核心流程优先：先把「单账号改标题 + 换封面」做稳，再扩展多账号和批量。
- 真实环境优先：操作真实的已登录 Chrome，不伪造登录、不绕过风控。
- 小步交付：每一步都能运行、能验证、能回退；默认不提交线上，显式开关才落库。
- 少即是稳：MVP 不追求全自动，只追求最小可靠闭环；首次登录由人工完成。
- 凭证安全：登录态保存在各账号独立的 Chrome user-data-dir 里，不导出、不外传、不写进代码或文档。
四、核心价值主张
| 价值点 | 说明 |
|---|---|
| 多账号集中管理 | 一处配置多个 Shopee 账号，各自绑定独立浏览器配置目录，互不串号 |
| 免反复登录 | 每个账号的登录态持久化在自己的 user-data-dir，启动即带登录 Cookie |
| 自动改标题/换封面 | CDP 驱动浏览器自动改标题、上传新图并拖拽设为封面 |
| 可控可回退 | 默认只改不提交，显式确认/开关才点「更新」，演示与试错零风险 |
五、不做什么（非目标）
- 不做 Shopee 账号的自动登录 / 自动填账号密码（首次登录人工完成）。
- 不绕过验证码、风控、限流或平台权限校验。
- 不做商品数据的批量爬取 / 导出。
- 不做云端服务、数据库、多人协作后台（MVP 为本地单机工具）。
- 不接管标题/封面以外的商品字段编辑。
MVP 的具体功能范围与验收标准，见 需求。