ozon-seller-kit/README.md

Ozon Seller Kit

Ozon 跨境上品工具链：采集 → 商品试算 → 登记导出（V2.1 起主链路放弃 Ozon API 直传，人工上品，见 docs/v2.1/）。

组成部分

目录	部分	状态
extensions/collector/	Chrome 插件：三平台采集（Ozon/1688/淘宝/天猫）+ 套图生图面板 + 商品上报	✅ 在用（并入自 image-suite-studio）
studio/	商品试算工作台：计价、俄文文案、AI 生图、登记导出	✅ 开发中
server/	FastAPI：采集入库、商品库、AI 文案、图生图、汇率	✅ 部分就绪
web/	工具台 v1（计价/登记/水印/俄文文案）	🧊 冻结（能力已迁入 studio）
extension-v1/ extension-v2/	旧版采集插件	🧊 冻结（被 collector 取代）
docs/	全部文档	—

主链路：collector 采集 → 「上报商品」入库（/api/materials）→ 自动打开试算页 /trial/{id} → 计价/文案/生图 → 录入登记表 → CSV/组合码 → 人工上 Ozon 后台。

目录

ozon-seller-kit/
├── 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

快速开始

1. 启动后端 + 前端（双击 start.command，或手动）：

./start.command          # server: http://127.0.0.1:8800 + studio: http://localhost:8900

2. 构建/加载采集插件：

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
• 扩展面板「服务端设置」：套图服务端（默认 3300）、商品上报开关 + OSK 后台地址（默认 8800）+ 试算页地址（默认 8900）

文档

文档	内容
docs/v2.1/README.md	现行方案总览（V2.1 转向：试算工作流）
docs/v2.1/collect.md	采集方案：扩展并入 + 上报开关
docs/v2.1/trial-page.md	商品试算页设计
docs/v2.1/image-suite.md	图片生成（套图 + 单张 AI 生图）
docs/v2.1/api.md	前后端 API 契约
docs/architecture.md	V1 总体架构（历史参考）
docs/ozon-seller-api/	Ozon Seller API 整理（远期重启直传时用）