故障排除
批量操作失败
通过关键字整理、AI 整理或可视化拖拽过程中出现异常时的排查指南
常见现象
- 点击「通过关键字整理」或「🤖 AI 整理」后，Toast 提示 「操作失败」 / 「整理失败」 / 「移动失败」；
- 批量操作完成，但 成功数少于预期，或出现「移动失败」前缀；
- 可视化管理中的拖拽操作 Toast 报 「加载失败」 / 「成功: X, 失败: Y」。
触发路径差异
扩展中有三条不同的批量操作路径，不同路径的失败点和排查思路略有差异：
| 路径 | 入口 | 底层调用 |
|---|---|---|
| 通过关键字整理 | 弹窗底部 「通过关键字整理」 | 遍历关键字规则，逐条命中后调用移动接口 |
| 🤖 AI 整理 | 弹窗底部 「🤖 AI 整理」 | 先请求 AI 得到分类，再调用移动接口，每条间隔 100ms |
| 可视化拖拽 | 选项页 → 可视化管理 Tab → 拖拽 | 为每条选中的视频依次调用移动接口 |
通用排查流程
确认默认收藏夹已设置
通过关键字整理 与 🤖 AI 整理 都以默认收藏夹为源；未设置默认收藏夹时 AI 整理会 Toast 「未设置默认收藏夹」。请先在 B 站或扩展中把某个收藏夹设为默认。
确认关键字规则不为空
通过关键字整理 会跳过「没有关键字」或「关键字 favoriteDataId 与默认收藏夹一致」的配置。若所有目标收藏夹都没配关键字，执行结果会是 0 条被移动。
观察浏览器控制台
右键扩展弹窗 → 检查 → 切到 Console 面板。扩展在移动失败时会输出 move video error ... / Move failed: ... 日志，这些信息能直接定位失败原因。
按失败数量与模式判断问题
- 小比例失败：多半是 B 站接口短暂限流或个别视频已被删除；重新执行即可；
- 大面积失败：可能是网络异常、Cookie 失效或默认收藏夹配置问题；
- 全部失败：大概率是登录态或默认收藏夹未设置。
分路径的具体细节
通过关键字整理
- 源收藏夹：固定为 默认收藏夹（由扩展全局状态的
defaultFavoriteId决定）； - 匹配规则：对每个目标收藏夹的关键字依次小写化 → 在默认收藏夹的小写化标题中做 子串匹配 → 命中则调用移动接口；
- 中断机制：loading 层提供 「取消整理」 按钮，点击后循环内会在下一次检查时中止；
- 兜底：未命中任何关键字的视频保留在默认收藏夹，不会被误移动。
🤖 AI 整理
在 批量操作失败 以外，AI 整理还可能因 AI 响应 本身出错而失败，典型场景：
- AI 返回的 JSON 无法被扩展的
\[...\]正则提取 → Toast 显示 「AI 返回的数据格式错误，请重试」； - AI 建议的
targetFavorite名称不在你的收藏夹中 → 扩展会 兜底移入默认收藏夹，并在完成 Toast 的详情中列出这些被兜底的视频。
以上属于 AI 相关问题，请参考 AI 调用错误。
可视化拖拽
- 拖到同一个收藏夹自身 会被代码直接忽略，不会发起请求；
- 目标收藏夹是「稍后再看」等 B 站系统收藏夹 时，接口可能拒绝写入；
- 移动过程中会显示 「正在移动视频...」 遮罩，完成后 Toast 汇总成功 / 失败数。
取消与回滚
- 取消：loading 遮罩内提供 「取消整理」 / 「取消」 按钮，可中断后续的移动请求；
- 不支持自动回滚：扩展没有内置「一键撤销」功能；已经成功移动的视频不会被退回，需要在 B 站官网或可视化管理中手动复原。
相关文档
- 登录态相关问题 — 登录态异常引发的失败
- AI 调用错误 — 与 AI 返回内容相关的失败
- 数据同步 / 缓存问题 — 成功后「看起来没动」的情况