# Ozon Seller Kit

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

## 四个组成部分

| 目录 | 部分 | 状态 |
|---|---|---|
| `web/` | ① 工具台 v1：计价、登记、水印、俄文文案 | ✅ 在用（冻结） |
| `extension/` | ② Chrome 采集插件：Ozon / 1688 商品页采集 | 🔨 待开发 |
| `studio/` | ③ 发布工作台：导入文件夹 → 编辑 → 发布 | 📋 待设计 |
| `server/` | ④ FastAPI：AI 文案、图片处理、Ozon API | 🔨 部分就绪 |

四者通过磁盘上的「[商品文件夹](docs/contracts/product-json.md)」契约衔接，不直接耦合代码。

## 目录

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

## 快速开始

**双击 `start.command`**，或：

```bash
./start.command
```

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

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

## 文档

| 文档 | 内容 |
|---|---|
| [`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) | 俄文文案后端方案 |