Ozon Seller Kit

Ozon 跨境上品工具链：采集 → 编辑 → 发布。

四个组成部分

目录	部分	状态
web/	① 工具台 v1：计价、登记、水印、俄文文案	✅ 在用（冻结）
extension/	② Chrome 采集插件：Ozon / 1688 商品页采集	🔨 待开发
studio/	③ 发布工作台：AI 图生图（上传/水印/万相图生图）	🔨 开发中
server/	④ FastAPI：AI 文案、图生图（wanx2.1-imageedit）、Ozon API	🔨 部分就绪

四者通过磁盘上的「商品文件夹」契约衔接，不直接耦合代码。

目录

ozon-seller-kit/
├── server/          # ④ FastAPI（main.py / api / services / schemas / config）
├── web/             # ① 工具台 v1，冻结
├── extension/       # ② 采集插件（待建）
├── studio/          # ③ 发布工作台（React + Vite + antd，AI 图生图已上线）
├── packages/schema/ # 跨端共享契约（待建）
├── docs/            # 全部文档
├── start.command
└── .env.example

快速开始

双击 start.command，或：

./start.command

打开 http://127.0.0.1:8800/ozonSeller.html

• 密钥写在根目录 .env（参考 .env.example）
• 可选模型写在 server/config/models.yaml

发布工作台（studio/，AI 图生图）

先启动后端（同上 ./start.command，或确保 uvicorn 跑在 8800），再启动前端：

cd studio
pnpm install
pnpm dev        # http://localhost:8900（启动后自动打开浏览器）

前端通过 Vite 代理把 /api 转发到 http://127.0.0.1:8800。图生图依赖阿里云百炼的 wanx2.1-imageedit（华北2/北京），需在 .env 配置：

DASHSCOPE_API_KEY=sk-xxxx

文档

文档	内容
docs/architecture.md	总体架构，先读这个
docs/contracts/product-json.md	商品文件夹契约（四部分的衔接点）
docs/extension/plan.md	插件方案（含 1688 插件逆向分析）
docs/extension/plan-revision.md	插件方案修正（针对 Ozon 优先）
docs/deployment.md	部署与启动
docs/ai-copy-backend-plan.md	俄文文案后端方案
docs/studio/image-edit.md	AI 图生图（studio 页面 + /api/image/edit）