feat: 采集插件整合进OSK

README.md

@@ -1,70 +1,65 @@
 # Ozon Seller Kit
 
-Ozon 跨境上品工具链：**采集 → 编辑 → 发布**。
+Ozon 跨境上品工具链：**采集 → 商品试算 → 登记导出**（V2.1 起主链路放弃 Ozon API 直传，人工上品，见 [`docs/v2.1/`](docs/v2.1/README.md)）。
 
-## 四个组成部分
+## 组成部分
 
 | 目录 | 部分 | 状态 |
 |---|---|---|
-| `web/` | ① 工具台 v1：计价、登记、水印、俄文文案 | ✅ 在用（冻结） |
-| `extension/` | ② Chrome 采集插件：Ozon / 1688 商品页采集 | 🔨 待开发 |
-| `studio/` | ③ 发布工作台：AI 图生图（上传/水印/万相图生图） | 🔨 开发中 |
-| `server/` | ④ FastAPI：AI 文案、图生图（wanx2.1-imageedit）、Ozon API | 🔨 部分就绪 |
+| `extensions/collector/` | Chrome 插件：三平台采集（Ozon/1688/淘宝/天猫）+ 套图生图面板 + **商品上报** | ✅ 在用（并入自 image-suite-studio） |
+| `studio/` | 商品试算工作台：计价、俄文文案、AI 生图、登记导出 | ✅ 开发中 |
+| `server/` | FastAPI：采集入库、商品库、AI 文案、图生图、汇率 | ✅ 部分就绪 |
+| `web/` | 工具台 v1（计价/登记/水印/俄文文案） | 🧊 冻结（能力已迁入 studio） |
+| `extension-v1/` `extension-v2/` | 旧版采集插件 | 🧊 冻结（被 collector 取代） |
+| `docs/` | 全部文档 | — |
 
-四者通过磁盘上的「[商品文件夹](docs/contracts/product-json.md)」契约衔接，不直接耦合代码。
+主链路：**collector 采集 → 「上报商品」入库（`/api/materials`）→ 自动打开试算页 `/trial/{id}` → 计价/文案/生图 → 录入登记表 → CSV/组合码 → 人工上 Ozon 后台**。
 
 ## 目录
 
 ```
 ozon-seller-kit/
-├── server/          # ④ FastAPI（main.py / api / services / schemas / config）
-├── web/             # ① 工具台 v1，冻结
-├── extension/       # ② 采集插件（待建）
-├── studio/          # ③ 发布工作台（React + Vite + antd，AI 图生图已上线）
-├── packages/schema/ # 跨端共享契约（待建）
-├── docs/            # 全部文档
+├── server/                  # FastAPI（main.py / api / services / schemas / config）
+├── extensions/collector/    # Chrome 插件（WXT + React，pnpm -C extensions/collector build）
+├── studio/                  # 试算工作台（React 19 + Vite + antd）
+├── web/                     # 工具台 v1，冻结
+├── extension-v1/ v2/        # 旧采集插件，冻结
+├── docs/                    # 全部文档（现行方案在 docs/v2.1/）
 ├── start.command
 └── .env.example
 ```
 
 ## 快速开始
 
-**双击 `start.command`**，或：
+**1. 启动后端 + 前端**（双击 `start.command`，或手动）：
 
 ```bash
-./start.command
+./start.command          # server: http://127.0.0.1:8800 + studio: http://localhost:8900
 ```
 
-打开 http://127.0.0.1:8800/ozonSeller.html
+**2. 构建/加载采集插件**：
+
+```bash
+pnpm -C extensions/collector install
+pnpm -C extensions/collector build   # 产物 .output/chrome-mv3
+```
+
+Chrome → `chrome://extensions` → 开发者模式 → 加载已解压的扩展程序 → 选 `extensions/collector/.output/chrome-mv3`。
+打开 Ozon / 1688 / 淘宝 / 天猫商详页，点扩展图标（或页内悬浮「套」按钮）采集；
+在面板「01 商品信息」下方点**「上报商品」**→ 自动入库并在新标签打开商品试算页。
 
 - 密钥写在根目录 `.env`（参考 `.env.example`）
 - 可选模型写在 `server/config/models.yaml`
-
-### 发布工作台（studio/，AI 图生图）
-
-先启动后端（同上 `./start.command`，或确保 `uvicorn` 跑在 8800），再启动前端：
-
-```bash
-cd studio
-pnpm install
-pnpm dev        # http://localhost:8900（启动后自动打开浏览器）
-```
-
-前端通过 Vite 代理把 `/api` 转发到 `http://127.0.0.1:8800`。图生图依赖阿里云百炼的
-**wanx2.1-imageedit**（华北2/北京），需在 `.env` 配置：
-
-```bash
-DASHSCOPE_API_KEY=sk-xxxx
-```
+- 扩展面板「服务端设置」：套图服务端（默认 3300）、商品上报开关 + OSK 后台地址（默认 8800）+ 试算页地址（默认 8900）
 
 ## 文档
 
 | 文档 | 内容 |
 |---|---|
-| [`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) | 俄文文案后端方案 |
-| [`docs/studio/image-edit.md`](docs/studio/image-edit.md) | AI 图生图（studio 页面 + /api/image/edit） |
+| [`docs/v2.1/README.md`](docs/v2.1/README.md) | **现行方案总览**（V2.1 转向：试算工作流） |
+| [`docs/v2.1/collect.md`](docs/v2.1/collect.md) | 采集方案：扩展并入 + 上报开关 |
+| [`docs/v2.1/trial-page.md`](docs/v2.1/trial-page.md) | 商品试算页设计 |
+| [`docs/v2.1/image-suite.md`](docs/v2.1/image-suite.md) | 图片生成（套图 + 单张 AI 生图） |
+| [`docs/v2.1/api.md`](docs/v2.1/api.md) | 前后端 API 契约 |
+| [`docs/architecture.md`](docs/architecture.md) | V1 总体架构（历史参考） |
+| [`docs/ozon-seller-api/`](docs/ozon-seller-api/) | Ozon Seller API 整理（远期重启直传时用） |