注意事项
使用过程中的常见问题、安全与隐私最佳实践，以及标准化故障排除流程
本章节汇总了使用 B 站收藏夹整理工具 过程中的常见问题、安全与隐私注意事项，以及标准化的故障排除流程。在提交 Issue 之前，建议先按本章节排查。
使用前须知
开始使用前，请确认以下事项
- 扩展依赖 B 站页面的登录态，必须保持至少一个已登录的
bilibili.com标签页； - 为避免频繁调用官方接口，收藏数据 默认缓存 24 小时，需要最新数据请手动点击「刷新」；
- 关键字提取的 本地算法（TF-IDF） 与 AI 智能 是两种并列模式，需在「关键字管理」页顶部的 模式选择器 中显式切换；
- 本扩展基于 Chrome Extension Manifest V3 构建，部分旧版 Chromium 浏览器（< 114）可能不兼容。
常见问题
以下问题按出现频率排列，可逐项排查。
安全与隐私最佳实践
本扩展的隐私承诺
- 不收集 任何个人身份信息；
- 不上传 用户数据至任何第三方服务器；
- 所有数据仅保存在 浏览器本地（IndexedDB + Chrome Storage）；
- 网络请求仅用于访问 Bilibili 官方 API 与 OpenAI 兼容 API（可选）。
在此基础上，建议你养成以下使用习惯以进一步提升安全性：
API Key 管理
- 仅在个人设备使用：API Key 存储于 Chrome Storage，共用设备可能导致 Key 泄露；
- 使用最小权限 Key：若服务商支持，生成仅具备模型调用权限的专用 Key；
- 定期轮换：长期使用同一把 Key 时，建议每 3~6 个月手动轮换一次；
- 发现异常立即吊销：一旦怀疑 Key 泄露，应立即在服务商后台吊销并生成新 Key。
账号与登录态
- 不要在不受信任的设备 登录 B 站后再安装扩展；
- 若设备借给他人使用，建议先 在扩展配置中清空缓存，避免收藏数据被意外浏览；
- 离开设备前 锁屏 或退出 Chrome 用户档案，避免他人操作收藏夹。
数据备份与清理
- 在执行 大规模批量整理 之前，建议先使用少量视频进行小范围验证；
- 定期导出 B 站官方收藏数据作为冷备份，避免误操作带来的长期影响；
- 卸载扩展时，Chrome 会自动清理扩展对应的本地数据；如需手动清理，可在扩展详情页的 「网站数据」 中操作。
权限最小化
扩展仅申请运行所必需的权限（storage、sidePanel、bilibili.com 域名访问等），不会 申请：
- 读取其他网站的浏览历史；
- 访问剪贴板或摄像头；
- 修改你的浏览器主页或搜索引擎。
如在安装时发现额外权限请求，极可能是 仿冒版本，请立即卸载并从官方 Chrome Web Store 重新安装。
故障排除
当扩展出现异常时，推荐按 从简到繁 的顺序排查。
第一步：基础自检
确认登录态
打开任意 B 站页面，确认账号已登录且页面可正常浏览。
确认网络环境
确保可正常访问 bilibili.com；若启用了 AI 功能，确认可访问所选模型服务商的 API 端点。
确认扩展版本
在 chrome://extensions/ 查看扩展版本号，确保是最新版（低版本可能已知 Bug 未修复）。
第二步：清理缓存与状态
若基础自检无异常但问题仍存在：
清空扩展缓存
在扩展 配置页 找到「清空缓存」或「重置数据」按钮，执行后重新打开扩展。
重启扩展
前往 chrome://extensions/，关闭本扩展的开关，再重新打开。
重启浏览器
彻底关闭 Chrome（包括所有窗口）后重新打开，部分后台异常可被清除。
第三步：收集诊断信息
如仍无法解决，请在提交 Issue 前收集以下信息，便于维护者快速定位：
- 浏览器类型与版本（例如 Chrome 126.0.6478.127）；
- 扩展版本号（见
chrome://extensions/）； - 操作步骤与预期结果，以及实际观察到的现象；
- 控制台日志：
- 在扩展弹窗 / 侧边栏上右键 → 「检查」，切到 Console 面板，截图或复制红色 Error 日志；
- 在 B 站页面按
F12打开 DevTools，同样复制 Console 面板的错误日志；
- 截图或录屏（如涉及 UI 异常）。
提交日志或截图前，请 先脱敏 处理，例如抹去 API Key、Cookie、uid 等敏感信息。
完成信息收集后，可以前往扩展的 开源仓库 Issues 页按模板提交：
- 使用 清晰的标题 概括现象（如
[Bug] 批量整理时部分视频提示「接口限流」）； - 在正文中粘贴 诊断信息；
- 若问题可稳定复现，请给出 最小复现步骤。
相关链接
- 🚀 快速入门 — 首次使用与核心功能介绍；
- 🛒 Chrome Web Store — 官方安装渠道；
- 🐛 扩展仓库 Issues — 问题反馈与功能建议。
相关链接
- 🚀 快速入门 — 首次使用与核心功能介绍；
- 🛒 Chrome Web Store — 官方安装渠道；
- 🐛 扩展仓库 Issues — 问题反馈与功能建议。