feat: 开发采集插件

README.md

@@ -1,36 +1,52 @@
 # Ozon Seller Kit
 
-Ozon 上品辅助工具：计价、登记、图片水印、俄文文案生成。  
-前后端同仓一体：FastAPI 托管 `web/` 静态页并提供 `/api/*`。
+Ozon 跨境上品工具链：**采集 → 编辑 → 发布**。
+
+## 四个组成部分
+
+| 目录 | 部分 | 状态 |
+|---|---|---|
+| `web/` | ① 工具台 v1：计价、登记、水印、俄文文案 | ✅ 在用（冻结） |
+| `extension/` | ② Chrome 采集插件：Ozon / 1688 商品页采集 | 🔨 待开发 |
+| `studio/` | ③ 发布工作台：导入文件夹 → 编辑 → 发布 | 📋 待设计 |
+| `server/` | ④ FastAPI：AI 文案、图片处理、Ozon API | 🔨 部分就绪 |
+
+四者通过磁盘上的「[商品文件夹](docs/contracts/product-json.md)」契约衔接，不直接耦合代码。
 
 ## 目录
 
 ```
 ozon-seller-kit/
-├── main.py
-├── config/            # settings + models.yaml
-├── api/
-├── services/
-├── schemas/
-├── web/
-├── docs/
+├── server/          # ④ FastAPI（main.py / api / services / schemas / config）
+├── web/             # ① 工具台 v1，冻结
+├── extension/       # ② 采集插件（待建）
+├── studio/          # ③ 发布工作台（待建）
+├── packages/schema/ # 跨端共享契约（待建）
+├── docs/            # 全部文档
 ├── start.command
-├── requirements.txt
 └── .env.example
 ```
 
 ## 快速开始
 
-**推荐：双击 `start.command`**，或：
+**双击 `start.command`**，或：
 
 ```bash
 ./start.command
 ```
 
-打开：http://127.0.0.1:8000/ozonSeller.html
+打开 http://127.0.0.1:8000/ozonSeller.html
 
 - 密钥写在根目录 `.env`（参考 `.env.example`）
-- 可选模型写在 `config/models.yaml`（页面下拉会自动读取）
+- 可选模型写在 `server/config/models.yaml`
 
-部署与启动详见 [`docs/deployment.md`](docs/deployment.md)。  
-文案方案设计见 [`docs/ai-copy-backend-plan.md`](docs/ai-copy-backend-plan.md)。
+## 文档
+
+| 文档 | 内容 |
+|---|---|
+| [`docs/architecture.md`](docs/architecture.md) | **总体架构**，先读这个 |
+| [`docs/contracts/product-json.md`](docs/contracts/product-json.md) | 商品文件夹契约（四部分的衔接点）|
+| [`docs/extension/plan.md`](docs/extension/plan.md) | 插件方案（含 1688 插件逆向分析）|
+| [`docs/extension/plan-revision.md`](docs/extension/plan-revision.md) | 插件方案修正（针对 Ozon 优先）|
+| [`docs/deployment.md`](docs/deployment.md) | 部署与启动 |
+| [`docs/ai-copy-backend-plan.md`](docs/ai-copy-backend-plan.md) | 俄文文案后端方案 |