俄易宝商品工作台 · 操作文档

1登录与访问

1. 打开工作台网址（本地为 http://localhost:3000，线上为你的域名）。
2. 使用管理员开通的账号登录；连续输错 5 次会锁定 15 分钟，请稍后再试。
3. 登录后左侧为导航栏，普通用户看不到「平台管理后台」，属正常。

2概览页

展示商品数量、各状态分布、积分余额、最近任务等。点击卡片可快速跳转到对应列表。

3导入与创建

左侧「导入与创建」提供多种建品方式：

• 手动新建：填写 SKU、标题、卖点、参数等基础资料。
• 1688 链接 / 批量导入：粘贴商品链接或批量表格。
• 浏览器插件采集：在 1688 商品页一键采集（见第 4 节）。

41688 采集插件（两类采集）

插件需先在 chrome://extensions 开启开发者模式后「加载已解压的扩展程序」，选择 extensions/1688-capture 目录。弹窗标题显示 v0.2.0 即为新版。

通用步骤：先登录工作台 → 在 1688 商品页完成真人登录与验证码 → 点插件「读取工作台登录状态」。顶部用标签切换两种模式：

① 新建 SKU

1. 选「① 新建 SKU」，可选填型号 / 关键词（留空则自动生成 / 由 AI 提取）。
2. 点「拉图（自动分类）」，图片按主图 / 规格图 / 详情图 / 其他图分组，默认勾选详情图。
3. （可选）勾选要导入的规格 SKU。
4. 点「用所选详情图创建 SKU」或「一键采集并创建 SKU」。后端创建新 SKU 并调用 AI 填写资料卡（最多 15 张参考图）。

② 已有 SKU 补参考图

1. 选「② 已有 SKU 补参考图」，点「加载 / 刷新商品库」。
2. 用「状态筛选」缩小范围，选择目标已有 SKU。
3. 点「拉图」，勾选要补充的参考图。
4. 选择写入方式：新增（追加）或覆盖（清空原有普通参考图，功能参考图保留）。
5. 点「上传所选参考图到该 SKU」。仅写图，不改商品基本信息。

5一键生成与任务中心

在商品列表勾选商品后点「一键生成」，系统会扣预扣积分并进入后台队列，依次产出：公共参考图 → 商品分析 → 关键词文案 → 售价 → Ozon 类目属性 → 8 张主图。

• 「任务中心」可看实时进度、并发数、单步日志，可取消未完成任务。
• 某一步若大模型失败会自动「本地兜底」，并按规则退回对应积分（文本 0.3 / 图片 1.0 每次）。

6单品工作区

点商品进入工作区，顶部标签对应处理流程：

7参考图管理

• 可上传本地参考图、设为「公共参考图（主图底图）」、粘贴图片 URL、或由插件批量导入。
• 每张参考图右上角的「×」可删除（删除前会二次确认）。
• 参考图最多保存 15 张；过大图片会自动压缩后再用于多图融合。

8富内容模块

富内容（图文详情）以缩略图条 + 摘要展示，点「预览效果」可看到渲染后的图文排版；点开折叠区可编辑底层 JSON。

9上架（Ozon / Yandex）

1. 先在「店铺管理」配置好对应平台店铺与凭证。
2. 在单品「API 上架」或列表批量上架，选择目标店铺提交。
3. Ozon 走 API 直接提交并返回任务号；Yandex 生成上架预览 payload。

10积分 / 充值 / 明细

积分用于一键生成等 AI 调用。计费：图片 1.0 / 次，文本 0.3 / 次，整套一键生成预扣 10。

• 充值记录：历次充值流水。
• 积分明细：区分「冻结/预扣」与「完成扣费」两类——冻结只是任务开始时的占用、不减余额；任务完成时才真正扣减。明细顶部有说明条。
• 兜底退回：某步走了本地兜底，会出现「兜底退回」正向流水把这部分积分退还。

11管理后台（管理员）

管理员在左侧「平台管理后台」进入，可管理成员账号、查看会员积分、监控模型用量与并发池、配置模型。普通用户无此入口，直接访问 /admin.html 也会被拦截跳转。

12用量与并发池（管理员）

「用量与并发池」页上半部分是各模型调用用量，下半部分是文本 / 图片并发池实时状态（卡片式）。每张卡片：圆环=当前在途/上限；下方小卡=各上游接口（Key）线路，「健康 / 冷却」表示是否可用。页面内「这张图怎么看？」折叠条有完整名词解释。

• 上游接口可在卡片上「编辑 / 删除 / 检测」，右上角「+ 新增接口」。
• 接口 baseUrl 必须带版本段（如 https://api.apiyi.com/v1）；漏写 /v1 会命中官网返回 HTML，系统已自动补全并在日志告警。

13常见问题

生成失败提示「接口返回非 JSON」？

多为某个上游接口 baseUrl 漏了 /v1，请求落到了官网页面（HTTP 200 + text/html）。到「并发池」检查并补全版本段；系统也会自动补全并在系统日志记录端点与响应片段，便于定位。

生成很慢？

文本（尤其推理型模型）单次输出可达 1–3 分钟，属正常；系统已将参考图/分析/文案并发以缩短墙钟。批量时多商品并行，受并发池上限约束。可在并发池适当调大上限或增加上游接口。

提示超时？

文本超时下限 300 秒、图片 600 秒；偶发超时会自动切换到其它健康接口重试，仍失败才走本地兜底（并退回相应积分）。频繁超时请检查上游额度与网络。

改了内容页面没变化？

多为浏览器缓存。请按 Ctrl/Cmd + Shift + R 强制刷新，或用无痕窗口验证。