常见问题
安装与启动
Q：安装后 Shopman 在哪里？
Shopman 启动后会最小化到系统托盘（Windows 右下角通知区域），点击托盘图标可显示主窗口。
Q：Chrome 扩展加载失败怎么办？
- 确认 Shopman 应用已启动（托盘图标可见）
- 打开
chrome://extensions/，确认「开发者模式」已开启 - 点击「加载已解压的扩展程序」，选择安装目录下的
chrome-extension-dist文件夹 - 如果提示版本错误，更新 Chrome 到最新版
Q：端口 17921 被占用怎么办？
目前端口不可配置，请停止占用该端口的其他应用。可在 PowerShell 中运行：
powershell
netstat -ano | findstr :17921找到对应进程 PID 后，在任务管理器中结束进程。
订单同步
Q：同步后首页没有新订单？
依次检查：
- Shopman 服务是否运行中（首页右上角同步状态）
- WebSocket 连接是否正常（状态图标为绿色）
- Chrome 扩展是否已加载（
chrome://extensions/查看） - TikTok 页面是否有订单数据（确认不是空列表）
Q：订单同步了但条形码没下载？
条形码下载依赖 TikTok 页面内的下载按钮触发。可能原因：
- 页面加载不完全：刷新 TikTok 页面后重试
- 网络问题：等待条形码 CDN 加载完毕再同步
- 该订单暂无条形码（平台未生成）：属正常现象
Q：只同步了第一页的订单？
TikTok 卖家后台分页显示。建议：
- 将每页显示数量调到最大（100 条，如平台支持）
- 翻到下一页后再次点击「一键同步」
- 每次同步会与已有数据去重，不会重复导入
供应商与 SKU
Q：供应商导入后旺旺 ID 显示为空？
可能是 1688 收藏夹页面该供应商资料未完善。可手动编辑供应商，填入旺旺 ID（在 1688 供应商首页右侧可找到）。
Q：SKU 徽章一直显示红色，但已经绑定了供应商？
检查绑定是否设置了「默认来源」。有绑定但无默认供应商时徽章为黄色；只有设置默认后才变绿色。
旺旺消息
Q：点击「在旺旺打开」后，消息没有自动填充？
- 确认 Chrome 扩展已加载
- 等待旺旺 IM 页面完全加载（通常需要 3~8 秒 SPA 渲染）
- 如页面渲染过慢，扩展设置了 8 秒超时，超时后需手动粘贴
- 确认消息 URL 包含了
def_cbu_web_im参数
Q：消息变量显示为占位符而不是实际内容？
如出现类似 {买家地址} 的未替换变量，说明该字段数据为空。检查：
- 订单是否包含买家地址（TikTok 部分订单地址有延迟）
- SKU 映射是否填写了采购价格
付款与物流
Q：自动付款功能开启了但没有触发？
自动付款仅在 Shopman 运行时检测状态变化。如果应用关闭期间状态改变，重新打开后需手动触发。
Q：物流单号填错了怎么改？
点击订单行 → 展开六步工作流 → 第⑥步 → 点击运单号旁的编辑图标 → 修正后保存。
数据与备份
Q：误操作删除了数据怎么办？
如果有之前的备份 JSON，通过「设置 → 数据管理 → 从备份还原」恢复。如没有备份，数据无法找回。建议每周备份一次。
Q：更换电脑后数据会丢失吗？
不会，只要提前通过「备份数据」导出 JSON，在新电脑还原即可。下载的 PDF 文件需另行复制。
其他问题
遇到上述未覆盖的问题，可通过以下渠道反馈：
- 在应用内：设置 → 关于 → 发送反馈
- 访问 shopman.cooder.co 联系我们