R524809
71 lines
2.5 KiB
Markdown
71 lines
2.5 KiB
Markdown
# Ozon Seller Kit
|
||
|
||
Ozon 跨境上品工具链：**采集 → 编辑 → 发布**。
|
||
|
||
## 四个组成部分
|
||
|
||
| 目录 | 部分 | 状态 |
|
||
|---|---|---|
|
||
| `web/` | ① 工具台 v1：计价、登记、水印、俄文文案 | ✅ 在用（冻结） |
|
||
| `extension/` | ② Chrome 采集插件：Ozon / 1688 商品页采集 | 🔨 待开发 |
|
||
| `studio/` | ③ 发布工作台：AI 图生图（上传/水印/万相图生图） | 🔨 开发中 |
|
||
| `server/` | ④ FastAPI：AI 文案、图生图（wanx2.1-imageedit）、Ozon API | 🔨 部分就绪 |
|
||
|
||
四者通过磁盘上的「[商品文件夹](docs/contracts/product-json.md)」契约衔接，不直接耦合代码。
|
||
|
||
## 目录
|
||
|
||
```
|
||
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`**，或：
|
||
|
||
```bash
|
||
./start.command
|
||
```
|
||
|
||
打开 http://127.0.0.1:8800/ozonSeller.html
|
||
|
||
- 密钥写在根目录 `.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
|
||
```
|
||
|
||
## 文档
|
||
|
||
| 文档 | 内容 |
|
||
|---|---|
|
||
| [`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） |
|