从安装开始，按步骤完成自己的配置。

01 / 开始前准备

先确认电脑、店铺和服务条件。

下载和阅读指南不要求先开通所有第三方服务。完整跟卖流程需要软件授权、可用的 Seller API、Chrome 扩展，以及所用模型能力所需账户。模型、生图、存储等可能按各自服务规则计费。

准备什么

Windows 64 位电脑、日常 Chrome、自己的 Ozon 店铺；先确认 Seller API 在你的账户上可用。按实际模型能力准备服务账户并了解费用。

在哪里操作

在自己的 Ozon Seller 账户与模型服务控制台核对账号状态。Ozon 菜单会随地区和账户变化，本指南不提供未经确认的逐屏路径。

填写什么

此时无需在官网填写卡密、API Key 或 Cookie。官网仅提供产品信息、静态指南、下载和人工联系入口。

完成标志

知道电脑与浏览器要求、Seller API 状态，并已决定是否需要模型或媒体等可选服务。

失败下一步

Seller API 或店铺访问受限时联系 Ozon 支持核实。软件授权不能解除平台限制；不要因平台限制反复输卡或更换 Key。

02 / 下载与安装

使用固定 Setup，从快捷方式进入。

当前固定公开包为 1.0.0、Windows x64、126,110,012 字节；本指南未执行该文件。

准备什么

OzonRelay-Setup-20261017.exe。确认下载来源为 https://ozonrelay.top。

在哪里操作

在 Windows 下载目录双击 Setup，按安装程序提示完成。安装后从桌面或「开始菜单 → OzonRelay」快捷方式启动。

填写什么

按 Setup 页面提示选择安装流程；此步骤不要求 Python、CMD、Terminal 或 Tailnet。

完成标志

点击 OzonRelay 快捷方式后，工作台在浏览器打开。若没有自动打开，先确认程序已启动，再在 Chrome 访问 http://127.0.0.1:17871/。

失败下一步

记下版本、错误提示和发生步骤，前往安装与启动排障。不要同时启动多个安装版本。

压缩包说明：主下载是 Setup 安装程序。已核对的旧 ZIP 内没有 Setup；若你拿到其他压缩包，先确认它的版本及用途，不要假设 ZIP 中还有 Setup。便携版应完整解压后按随包说明运行 ozonrelay.exe。

03 / 激活授权与绑定店铺

按状态完成设备授权和店铺凭据校验。

授权卡绑定设备与店铺。激活卡密后出现 store_unbound，对应「已绑定本机、待绑定店铺」，是正常中间状态，表示还要配置自己的店铺凭据。

准备什么

销售方发给你的授权卡，以及同一目标 Ozon 店铺的一组 Seller ID 与 API Key。卡密和 API Key 均不要发到官网或聊天。

在哪里操作

客户端「授权」页激活。随后进入「设置 → 店铺与仓库」，填写店铺凭据，点击「保存配置」。

填写什么

界面字段包括「OZON 卖家 ID」「OZON API Key」「Seller 结算货币」「Seller 注册国家」。依据自己店铺资料填写；不要把 Chrome 登录账号当成 Seller ID。

完成标志

依次确认配置已保存、使用「核对店铺（只读）」查看身份与凭据是否可用、授权状态已从待绑店进入对应已绑定状态；另行检查发布控制，才能判断发布是否允许。

失败下一步

保存成功只说明配置写入，不代表 API 已验证或店铺已绑定。把准确状态和非敏感错误交给支持人员；若 Ozon 显示 API 暂停或 403，联系 Ozon 支持，不反复输卡、不删除授权文件。

「已激活」「已保存」「身份核对通过」「已绑定店铺」「允许发布」是不同的界面状态。按客户端实际回读判断；不要根据示意说明认定自己已通过。

04 / Chrome 扩展与模型

用自己的 Chrome 账户连接扩展。

准备什么

已安装的 OzonRelay、Chrome，以及你本人可登录的 Ozon 和 1688 账户。模型相关功能需要你有权限使用的模型服务账户。

在哪里操作

在客户端设置诊断中查看扩展状态。用桌面 OzonRelay 快捷方式打开文件所在位置，进入安装根目录中的 extension 文件夹。

填写什么

在 Chrome 地址栏打开 chrome://extensions，开启「开发者模式」，点「加载已解压的扩展程序」并选择上述 extension 目录。扩展实际显示名称是 Browser Agent V2（版本 2.1.15）。然后在日常 Chrome 中由本人登录 Ozon 与 1688。

完成标志

客户端设置诊断里的「Bridge（扩展）」显示已连接。此状态只说明扩展桥已连通，不代表商品分析、平台写入或发布全部成功。

失败下一步

核对是否选了当前安装目录里的 extension，Chrome 扩展是否启用，以及本人是否在正常浏览器完成登录。不要复制或迁移 Cookie；继续查看扩展排障。

模型字段与账户地域

在客户端「设置」页向下找到「高级服务」中的「模型与外部服务」卡片，可见「千问 API Key」「兼容 API Base URL」「跟卖虾主模型」「图片文字检测模型」。模型名称和 Base URL 必须与账户地域、权限及软件当前支持的接入方式一致；官网不保证模型可用，也没有证据支持在此承诺任意新模型 ID。

密钥成功保存后可能不会再次回显。固定界面说明秘密字段留空通常表示保留已有值；只有确定要移除时才使用客户端提供的明确清除操作。不要把 Key 粘贴到网页、截图、聊天或反馈中。

准备什么

自己账户允许调用的模型、与该模型服务匹配的地域接入信息，以及预期费用。

在哪里操作

先查看服务商当前官方地域、模型和 API Key 文档，再回客户端「设置」页的「高级服务 → 模型与外部服务」卡片填写。

填写什么

输入自己的千问 API Key、当前兼容 Base URL、主模型和图片文字检测模型；不照搬未经核验的示例值。

完成标志

保存后核对客户端配置状态。固定界面没有证据证明存在独立的「测试连接」按钮；真实可用性需在获准的正常任务中确认。

失败下一步

核对 Key 和 Base URL 是否同一地域、账户权限是否允许所选模型。不要因权限报错直接创建新账户或重复充值。

05 / 核对参数与首次任务

先检查自己的参数，再选择「只分析（不写入）」。

准备什么

要研究的商品链接、目标店铺和市场成本规则。任务会访问相关网页或模型服务，可能产生调用费用。

在哪里操作

在客户端「设置」核对业务参数，并在「发布控制」中确认「允许发布到 Ozon」保持关闭；首次任务从工作台「一键跟卖」进入。

填写什么

按实际账户检查国家、币种、VAT、单位、汇率、佣金、费用和利润参数；需要时确认库存（件）、媒体策略、补图选择、水印要求与水印文字，或不加水印的理由。不要套用其他店铺的默认值。

完成标志

在任务页选择「只分析（不写入）」，并检查生成的任务编号与结果。分析结果不等于平台已接收、审核通过或商品可售。

失败下一步

保留原任务编号与页面提示，先查看任务详情或联系支持。首次配置不要选择「分析并发布」，不要因结果未知而重复发布。

「只分析（不写入）」仍可能访问 Seller、Ozon、1688 或模型服务，并发生费用；它不等于离线模拟。本次网页验收不会运行业务任务或调用 Seller/模型。

06 / 按需服务

只在对应功能需要时配置。

图像生成、媒体托管和飞书入口不是阅读指南或下载 Setup 的前置条件。先确认所选功能和账户，再考虑是否开通。

07 / 故障与反馈

保留上下文，再联系支持。

准备什么

软件版本、发生时间、所在步骤、任务编号（如有）以及能说明问题的错误文字或截图。

在哪里操作

先在客户端读取当前授权、店铺、扩展或任务状态；再打开官网帮助与反馈页。

填写什么

说明你做了什么、期望结果和实际结果。请遮挡客户或个人信息。

完成标志

反馈文本已经复制或保存到本机，并由你在微信中主动发送。网站不会自动上传或发送。

失败下一步

复制被浏览器拒绝时可手动选择文本，也可直接搜索官网显示的微信号。不要附卡密、API Key、Cookie、.env、license.json 或完整用户目录。当前软件没有已核实的一键脱敏导出按钮。