# 项目愿景

## 一、核心目标

cmshopee 要解决：**运营要在多个 Shopee 卖家账号下，逐个商品手动改标题、换封面，效率低、易出错、来回切换登录痛苦**。

> 让**电商运营**能够在一个工具里集中管理多个 Shopee 账号，并自动完成商品标题修改和封面图替换，无需反复登录、手动逐项操作。

它不是一个通用爬虫，也不是 Shopee 官方 API 客户端，而是一个**驱动已登录的真实 Chrome 浏览器、在卖家中心页面上代为操作**的本地自动化工具。

## 二、目标用户

- **电商运营 / 店铺管理员**：管理 1 个或多个 Shopee 卖家账号，需要批量调整商品标题和主图。
- **小型卖家团队负责人**：希望把重复的商品维护操作标准化、半自动化。
- **本项目维护者（含 AI agent）**：需要在已验证的单账号流程上，扩展出多账号管理与 GUI。

## 三、产品原则

遇到取舍时，以这些原则为准：

- **核心流程优先**：先把「单账号改标题 + 换封面」做稳，再扩展多账号和批量。
- **真实环境优先**：操作真实的已登录 Chrome，不伪造登录、不绕过风控。
- **小步交付**：每一步都能运行、能验证、能回退；提交线上前必须由用户在批量确认弹窗中确认。
- **少即是稳**：V1 不追求无人值守全自动，只追求本地批量流水线可靠；首次登录由人工完成。
- **凭证安全**：登录态保存在各账号独立的 Chrome user-data-dir 里，不导出、不外传、不写进代码或文档。

## 四、核心价值主张

| 价值点 | 说明 |
| --- | --- |
| 多账号集中管理 | 一处配置多个 Shopee 账号，各自绑定独立浏览器配置目录，互不串号 |
| 免反复登录 | 每个账号的登录态持久化在自己的 user-data-dir，启动即带登录 Cookie |
| 自动改标题/换封面 | CDP 驱动浏览器自动改标题、上传新图并拖拽设为封面 |
| 可控可追溯 | ③ 点击「开始更新」后弹窗确认，确认后才批量提交；执行结果实时落库并回写 Excel |

## 五、不做什么（非目标）

- 不做 Shopee 账号的**自动登录 / 自动填账号密码**（首次登录人工完成）。
- 不**绕过验证码、风控、限流或平台权限校验**。
- 不做商品数据的**批量爬取 / 导出**。
- 不做云端服务、外部数据库、多人协作后台（V1 为本地单机工具，业务数据使用本地 SQLite）。
- 不接管标题/封面以外的商品字段编辑。

> V1 的具体功能范围与验收标准，见 [需求](02-requirements.md)。