Usagi 对接追踪服务常见问题 — 授权失败、匹配不准、同步延迟

授权失败

授权页打开但登录完跳回 Usagi 后显示「授权失败」或直接没反应。

排查方向：

• 确认设备网络正常，浏览器能正常访问追踪服务网站
• 部分追踪服务有地区访问限制，可能需要代理
• Usagi 需要通过浏览器 OAuth 授权——确认系统里有可用的浏览器应用
• 如果之前授权过但 token 过期了，先在追踪服务网站的「授权应用」里撤销旧授权，然后在 Usagi 里重新走一遍授权流程

漫画匹配不准

绑定追踪服务时，Usagi 自动匹配的条目不对——可能匹配到了同名但不同版本的作品。

解决方法：在绑定界面手动搜索并选择正确的条目。Usagi 的自动匹配是基于名称相似度做的，同名作品、翻译名不同、或者别名差异都可能导致匹配不准。多试几个关键词（原名、英文名、常用译名）通常能找到正确条目。

同步延迟

Usagi 里读完了一章，但追踪服务网站上看不到更新。

正常情况：追踪服务的 API 有写入频率限制，同步可能延迟几秒到几分钟。

排查方向：

• 在 Usagi 的追踪服务设置里手动点「立即同步」触发一次强制推送
• 检查网络是否通畅
• 确认追踪服务账号的 API 配额有没有用完（部分服务有每日调用上限）

解绑

不想用某个追踪服务了，在 Usagi 设置的「追踪服务」分类里找到对应的开关关掉，或者在追踪服务网站的授权应用列表里撤销对 Usagi 的授权。

关掉后 Usagi 不再往该服务推送进度，但也不会删除追踪服务上已有的数据——需要删除的话去追踪服务网站操作。