- 1你在页面选商品、填参数、点操作
- 2Web 服务校验登录和参数，把任务记下来
- 3后台任务进程执行翻译、图片、发布
- 4Ozon 接收资料并审核，返回结果
- 5结果写回商品记录，页面显示状态
| 部分 | 负责什么 | 容易误会的地方 |
|---|---|---|
| 工作台页面 | 展示商品资料，接收你的修改和操作，把请求发给后端。 | 提示“已提交”只说明请求发出去了，不等于已经上架。 |
| Web 服务 | 校验账号权限和参数，把任务写入队列，返回处理结果。 | 这一层只负责接收和记账，翻译、发布这些耗时步骤不在这里跑。 |
| 后台任务进程 | 按队列执行翻译、标题、图片、发布和结果回查。 | 任务入队后关掉页面不会取消；还没保存的编辑会丢。 |
| 商品记录与任务记录 | 商品记录是这件货目前的状态，任务记录是某一次操作走到了哪一步。 | 同一商品在不同店铺、不同款式上结果可能不同，要分开看。 |
| 步骤 | 系统做什么 | 你要做什么 |
|---|---|---|
| 采集商品资料 | 保存来源商品的标题、图片、描述和各个款式。此时还没有上架到 Ozon。 | 确认采到的是要卖的那件商品，重点看型号、数量，以及配件和整机的区别，有没有漏款、错款。 |
| 选店铺、补发布资料 | 按店铺、类目、模板、价格、库存、仓库等设置生成发布用的资料。 | 核对店铺和仓库有没有选对、商品类型和必填属性是否合理。卡住时先看缺失字段和参数提示，不要只反复点发布。 |
| 翻译并整理标题 | 把来源信息翻译成销售所需的语言，按款式生成标题，检查型号、数量、角色、组件等关键信息。 | 核对翻译后的事实和原商品是否一致，不只是句子通不通顺。来源本身冲突或缺少关键事实时，需要人工确认。 |
| 准备图片、提交前检查 | 检查图片能不能取到、主图是否可用、可用图片够不够、各款式图片是否正常，并检查最终发布资料。 | 出问题时先定位是哪张图、哪个款式。主图和款式图有问题会挡住发布；附图部分失败时，看剩下的图够不够用。 |
| 提交给 Ozon | 把资料交给 Ozon，记下这次提交的编号，之后按同一次提交回查结果。 | 分清“系统接到任务”“已交给 Ozon”“审核通过”是三个阶段。等得久不等于提交失败，先看任务记录和平台返回，不要盲目重复提交。 |
| 看结果、处理问题 | 把成功和失败的结果写回商品：成功进“上架成功”，失败带上拒绝原因。 | 部分款式失败时逐款看结果，不要把整件商品都当成成功或都当成失败。按原因补资料或人工检查，再决定要不要重新发布。 |
| 页面上的状态 | 含义 | 先看什么 |
|---|---|---|
| 等待处理 | 这件商品还在准备阶段，或者已经被人为移回待处理。 | 检查资料、翻译和发布设置。这个状态不代表从来没有发布过。 |
| 发布队列 | 发布相关的工作正在排队或处理中，结果还没收齐。 | 打开发布队列，看任务是等待、执行还是正在回查结果。 |
| 已创建待人工检查 | 这类商品需要你确认后再决定下一步。可能是平台一直没给明确结果，也可能是本地风险或低价检查要求人工处理。 | 按商品上的具体提示判断，不能只看分类名称就认定已提交或审核通过。 |
| 图片待人工处理 | 平台因图片内容拒绝了这件商品：主图/附图不合格、图上有中文或水印、二维码、联系方式、促销字样等。它不是一个新状态，商品原本属于哪个状态就还在哪个状态，只是集中到这里方便改图。 | 看商品上「命中」那一行和 Ozon 原话，确认是哪张图、什么毛病；再点「编辑」，在基础信息里用「修复图片」擦掉违规文字或换图，然后重新提交。 |
| 部分 SKU 审核失败 | 部分款式没有通过审核，其余款式的结果不受影响。 | 确认哪些款式失败、在哪家店铺、各自是什么原因。 |
| 发布失败 | 有明确的失败原因，可能发生在本地准备阶段，也可能来自 Ozon。 | 先区分“还没交出去就失败”和“平台返回拒绝”，处理方式不一样。 |
| 上架成功 | 系统已记录到发布成功的结果。 | 核对成功的店铺和款式；能不能实际开卖还要看库存和平台状态。 |
| 情况 | 常见原因 | 怎么处理 |
|---|---|---|
| 提交之前 | 原图链接失效、下载超时、主图不可用、可用图片不足、某个款式图片失败，图片没能成功交给 Ozon。 | 定位到具体图片，检查来源或换成合适的图片。这类问题和 Ozon 审核无关。 |
| 提交之后 | Ozon 不接受图片内容，例如图片和商品不匹配，或平台指出广告、联系方式等问题。 | 先读原始拒绝文案，确认涉及主图、附图还是详情内容，再决定改哪里。 |
| 决定修复之前 | “修复图片”不一定对症：图片里的文字和详情文字里写了网址是两种问题，修图处理不了纯文字或 HTML 内容。 | 出现修复按钮也要确认实际修的是哪张图。修复完成后仍需另外确认重新发布和审核结果。 |
主图、附图、款式图和详情图分别是什么？
- 主图：商品首先展示的那张图，需要可用，并且保持在主图位置。
- 附图：补充细节或角度的图片。允许有限度跳过失败项；去重后的可用图（含主图）够 1 张就能发布，但主图必须可用，并且保持在主图位置。
- 款式图：对应某个颜色、型号或套装的图片，不能因为别的款式有图就忽略它失败。
- 详情图：详情介绍里的图片。详情区域还可能包含独立文字，所以“详情有广告”不一定指图片。
正常发布，会因为图片文字识别而停住吗？
普通发布之前不运行通用的图片文字识别，也不依赖独立的修图虚拟机；图片仍会经过原有的下载、可用性和发布资料检查。
图片文字违规之后的人工修复属于另一条流程。这里只说明流程边界，不代表修复服务当前在线。
我点了发布，为什么还没上架？
先在发布队列里找到对应任务，确认它是在排队、翻译、准备图片，还是等待 Ozon 返回；再看商品当前状态和店铺结果。
已经有提交记录时，先追踪这一次记录，不要把页面转圈或请求超时直接当成“没有提交”。
标题翻译错了，尤其是型号或套装数量
把来源标题、当前款式名称和生成的标题放在一起比对，先判断错在原始资料、翻译，还是标题整理。几种来源写法互相冲突时，要先确定真实商品是什么。
反馈时给出商品 ID、具体款式、原文和错误标题，只说“翻译不好”很难定位。
图片失败，是不是新修图功能拦下来的？
先看错误描述：下载失败、404、超时、主图或款式图不可用，这些都属于原有的图片准备检查。
如果是 Ozon 的拒绝，保留原始文案并确认涉及哪块内容。只有看到具体的调用和拒绝证据，才能判断是否和某项修复功能有关。
同一件商品，有的款成功、有的款失败
到“部分 SKU 审核失败”里看款式和店铺明细。成功的款式不代表失败的款式也通过了，失败的款式也不影响已经通过的款式。
先确认失败原因和范围，再安排针对性处理。
队列很久没变化，是不是服务器坏了？
先看是一个任务卡住，还是多类任务都没有进展，并记下最后变化时间、任务状态和错误提示。长时间等待可能来自外部响应、正在执行的步骤或后台处理。
一个任务慢不能说明整台服务器故障。排查时先做只读检查，不要靠反复重试、取消任务或重启来猜原因。
要让人排查，提供什么最有用？
给出商品 ID、店铺、具体款式、任务 ID、发生时间、页面状态和原始错误文案，再补一句“我刚才做了什么、原本预期什么结果”。
这些信息能把一次操作串起来。不要把店铺密钥、登录令牌或密码放进截图和问题描述。
ozon/、后端 ozon-backend/。| 部分 | 目录 | 放什么 |
|---|---|---|
| 前端页面 | ozon/ |
原生 HTML/CSS/JS 静态站点，没有打包步骤。共享代码在 assets/，业务页是目录形式（index.html + app.js）。 |
| 接口层 | ozon-backend/src/routes/ |
Express 路由，按业务分文件；上架主入口是 scrape.js，同前缀的 scrape.publish.js / scrape.queue.js / scrape.fetch.js / scrape.edit.js 是它的分片。 |
| 业务逻辑 | ozon-backend/src/services/ |
翻译、标题、图片、发布等具体算法与流程。 |
| 数据层 | src/models/、migrations/ |
建表与字段变更。迁移文件名是 YYYYMMDD_HHMMSS_说明.js，按 ops/PRODUCTION_RUNBOOK.md 执行。 |
| 运维 | ops/、scripts/ |
生产手册、reload 流程、一次性排查与离线回放脚本。 |
| 源码归档 | snapshots/ |
历史源码归档，不参与运行。 |
| 我要改 | 去哪里 |
|---|---|
| 上架流程、发布载荷 | src/routes/scrape.js（含 scrape.publish.js 等分片）与 src/services/ 下对应的服务 |
| 标题生成与俄文措辞 | src/services/titlePipeline/（skuTitle* 是兼容用的旧门面，不要当主路径改） |
| 翻译 | src/services/aiTranslation/、src/services/aiTranslationJobs.js |
| 图片准备与可用性判据 | src/services/productPublishImagePolicy.js |
| 店铺连接、额度、自动停用 | src/utils/storeHealth.js、src/routes/stores.js |
| 订单、退货、聊天 | src/routes/orders.js、returns.js、ozon-chat.js |
| 加字段、建表 | migrations/ + src/models/database.js（先看 ops/PRODUCTION_RUNBOOK.md 的迁移流程） |
| 页面样式与公共组件 | ozon/assets/common.css、common.js、shared-nav.js（改共享层要检查全部引用页面） |
| 重启、上线 | ozon-backend/ops/PRODUCTION_RUNBOOK.md：改完 JS 先 npm run check 和 npm test，再走 npm run reload:prod |
现在在做什么？（静态快照，2026-09-18）
任务分档（注意：这里是任务分档，不是上面那套商品状态）：P0 当前必须先完成；P1 下一步应处理；P2 有价值但不影响当前使用；WAIT 等条件或授权；PARKED 暂缓；CLOSED 已关闭，不要重复开发。
2026-09-18 快照：P0 三项（标题颜色原子、标题形态、文档基线）都已完成。P1 里标题、发布、退货、店铺额度等一批修复已上线；当时仍开着口子的是 P1-22 切法②③（暂缓，等点名）、P1-10 / P1-11 的上游断点（等排期）。WAIT 三项在等条件。
这类内容一定会过期：最新状态看 ozon-backend/待办事项.md，已经做了什么看 Ozon修改汇总.md，长期规则与硬边界看 AGENTS.md。