帮助中心

快速上手 极地星神 · 查阅操作指南 · 解决常见问题

🔍

🚀 快速入门

首次使用 极地星神？按以下步骤即可快速上手。

1
授权平台店铺
在「商铺管理」中添加 Joom、Ozon、Shein、MercadoLibre 等平台店铺，完成 OAuth 授权后即可同步数据。
2
同步商品数据
授权后系统自动定时同步商品信息。也可在「商品管理」页面手动刷新，查看已缓存的商品列表。
3
查看处理订单
「订单管理」页面展示各平台订单，支持按店铺筛选、查看详情。系统每 20 分钟自动同步最新订单。
4
批量上架商品
下载模板 CSV，填入商品信息后上传，即可批量上架到 Joom 或 Ozon 平台。支持多店铺同时上架。

📚 操作文档

按模块查阅详细操作指南。

🔐 平台授权
Joom 店铺授权
在 Joom 开发者后台创建应用，获取 Client ID 和 Secret，在「商铺管理」中添加授权。
Ozon 店铺授权
在 Ozon 卖家后台生成 API Key，填入「商铺管理」完成授权。支持 Client ID + API Key 模式。
Shein 半托管授权
通过 Shein 开放平台 OAuth 授权，点击「添加店铺」自动跳转 Shein 授权页面。
MercadoLibre 授权
支持 CBT Global Selling OAuth + PKCE 安全授权流程，跨境卖家专用通道。
店铺管理操作
查看已授权店铺列表、修改店铺标签、取消授权、按平台筛选店铺。
子账户权限设置
管理员可为员工创建子账户，按平台/店铺粒度控制访问权限，保障数据安全。
📦 商品管理
查看商品列表
「商品管理」页面展示各平台已缓存的商品，支持按平台/店铺筛选、搜索商品名称/Offer ID。
手动刷新商品
选择店铺后点击「刷新」按钮，从平台实时拉取最新商品数据并更新缓存。
Joom 商品同步
系统每 30 分钟自动同步 Joom 商品，已缓存 66 万+ 商品。支持全店铺覆盖。
Ozon 商品同步
支持 Ozon FBS/FBO 商品同步，自动解析商品图片、变体（颜色/尺码）等多维度属性。
Shein 商品同步
已同步 10 万+ Shein 半托管商品，覆盖全部 164 家店铺，每 30 分钟自动更新。
商品数据说明
商品名称、价格、库存、图片、变体信息均缓存至本地数据库，查询速度快，无 API 延迟。
📋 订单管理
查看订单列表
「订单管理」页面展示各平台订单，支持按平台/店铺/状态筛选，查看订单详情（商品、金额、买家信息）。
Ozon 订单同步
每 20 分钟自动同步 Ozon 订单，缓存到本地数据库。支持全店铺视图，无需逐个店铺查询。
Shein 订单同步
已全量回填 16,974 条历史订单，每 20 分钟增量同步新订单。
Joom 订单同步
支持 Joom 订单实时查询和定时同步，已缓存 16,666 条订单数据。
ML 订单同步
MercadoLibre 订单每 20 分钟同步，支持已支付/已取消状态跟踪。
订单排序与筛选
支持按时间、金额排序，按店铺、状态筛选，快速定位目标订单。
📤 批量上架
Joom 批量 CSV 上架
下载 Joom 模板 CSV，按格式填入商品信息，上传后批量创建商品。支持断点续传，服务重启自动恢复。
Ozon 批量上架
支持 CSV 和 XLSX 两种格式。CSV 模板包含 43 列 T 恤映射字段，XLSX 支持多颜色多尺码变体。
多店铺同时上架
勾选多个店铺后上传 CSV，系统自动串行为每个店铺创建商品。进度实时显示（成功/失败/总数）。
上架任务管理
查看历史批量上架任务，成功/失败明细。失败任务支持「继续上架」，从未完成的行恢复执行。
CSV 格式要求
使用逗号分隔值，含逗号的字段用英文双引号包裹。模板从「批量上架」页面下载。编码 UTF-8。
XLSX 上传（Ozon）
支持标准 Excel .xlsx 文件直接上传，系统自动解析为商品属性，比 CSV 更便捷。
🎯 活动报名（Ozon）
查看可报名活动
「活动报名」页面展示 Ozon 平台当前可参加的活动列表，显示活动时间、折扣要求等。
查看候选商品
点击活动进入候选商品列表，查看平台推荐的报名商品及其当前价格。
报名全部商品
一键报名当前活动的所有候选商品，支持跨页自动收集（不受每页 100 条限制）。
统一设置价格
批量设置所有报名商品的活动价格，一次操作覆盖全部勾选商品。
跨页勾选
在不同页面勾选的商品会自动保持选中状态，翻页不丢失，统一提交报名。
报名结果报告
报名完成后弹窗展示详细报告：收集数量、提交数量、成功/失败/未返回明细。
🛍️ Joom 专题功能
Joom Select
Joom 精选商品管理，支持多状态 Tab（待选/已选/已拒绝/全部），批量选择操作。
FBJ 补货管理
Fulfillment by Joom 补货和入库管理，后台每 10 分钟自动缓存库存数据。
并发控制
Joom Select 支持 50 店并发处理（ThreadPool），高效处理大批量店铺操作。
⚙️ 系统功能
平台选择门户
登录后进入平台选择页面，点击 Joom / Ozon / Shein 进入对应工作台，各平台独立操作。
子账户与权限
管理员在「员工管理」创建子账户，设置可访问的平台和店铺，实现数据隔离。
数据自动同步
系统通过 crontab 定时任务自动同步各平台数据，无需手动操作。同步频率：订单 20min / 商品 30min。
客服助手（Ozon）
Ozon 订单页面内置客服助手，支持查看订单对话、上报工单、添加工单备注。
数据备份
每日 00:00 自动备份代码和数据库，VACUUM INTO 确保数据完整性。
移动端适配
响应式设计，手机浏览器可正常访问和使用各项功能。

❓ 常见问题

使用中遇到的常见问题及解决方案。

Q: 如何添加新的平台店铺？
进入「商铺管理」页面，点击对应平台的「添加店铺」按钮。
• Joom / Ozon：填入 Client ID 和 API Key 即可授权
• Shein / MercadoLibre：系统会跳转到平台 OAuth 授权页面，登录平台账号完成授权
授权成功后，系统会自动开始同步该店铺的商品和订单数据。
Q: Ozon 商品名称/图片为什么显示空白？
首次同步时部分商品可能缺少名称和图片。点击「刷新」按钮从 Ozon 实时拉取数据即可补全。
Ozon API 按商品维度返回信息，需要逐个查询。建议授权后等待后台定时同步完成（约 30 分钟一轮）。
Q: Joom 批量上架失败怎么办？
批量上架支持断点续传：
1. 在「批量上架」页面的「历史任务」区域找到失败任务
2. 点击「▶ 继续上架」按钮，从上次中断的位置恢复
3. 服务重启后系统也会自动扫描并恢复未完成的任务
CSV 格式错误是最常见的失败原因，请确保使用下载的模板格式。
Q: 订单数据多久更新一次？
各平台订单每 20 分钟自动同步一次（crontab 定时任务）：
• Ozon — 每 20 分钟，sleep 3s 错峰
• Shein — 每 20 分钟，sleep 8s 错峰
• ML — 每 20 分钟，sleep 13s 错峰
• Joom — 每 30 分钟
也可以在订单页面手动选择店铺后查看实时数据。
Q: 页面加载很慢或卡住怎么办？
1. Ozon 订单页面首次加载可能较慢（店铺数量多），建议先选择具体店铺再查看
2. 数据已缓存在本地数据库，第二次访问会快很多
3. 如果持续卡住，尝试硬刷新浏览器（Cmd+Shift+R 或 Ctrl+Shift+R）
4. 检查网络连接是否正常，服务器位于阿里云华东地域
Q: 如何修改密码或管理子账户？
管理员账户可以在「员工管理」页面：
• 创建新子账户，设置角色（管理员/主管/员工）
• 为每个子账户设置可访问的平台和店铺
• 修改或重置子账户密码
修改自己的密码请直接联系系统管理员。
Q: Ozon 活动报名一次最多能报多少商品？
Ozon API 限制每次激活最多 1,000 个商品。系统已内置分批提交逻辑：
• 收集阶段：通过 offset 分页自动收集全部候选商品（不受每页 100 条限制）
• 提交阶段：每 100 个商品为一批自动提交
• 跨页勾选的商品会自动保持选中状态，翻页不丢失
Q: 登录后页面显示异常（白屏/加载中/功能栏消失）？
首先尝试硬刷新（Cmd+Shift+R / Ctrl+Shift+R）清除浏览器缓存。
如果问题持续，可能是 JVS Claw WebView 缓存了旧版 JS 文件。
退出登录后重新登录通常可以解决。如仍异常，请联系技术团队排查。