bilibili-app-recommend常见问题解答：功能失效、配置丢失？一篇文章全解决

【免费下载链接】bilibili-app-recommend[UserScript] Bilibili 自定义首页项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-app-recommend

bilibili-app-recommend（现更名为Bilibili-Gate）是一款强大的B站自定义首页脚本，能将手机端推荐内容搬到桌面，并提供视频过滤、预览、主题设置等丰富功能。但使用过程中可能会遇到功能失效、配置丢失等问题，本文将详细解答常见问题及解决方法。

功能失效问题

脚本无法启动或加载失败

• 检查浏览器和脚本管理器：确保使用Chrome/Edge/Firefox搭配ViolentMonkey或TamperMonkey，macOS Safari用户需使用Userscripts插件，不支持Safari+TamperMonkey组合。
• 更新脚本版本：通过GreasyFork安装最新版，或尝试开发版。
• 冲突检测：与BewlyBewly脚本不兼容，检测到后会自动退出，可使用特殊地址强制启用：https://www.bilibili.com/#/bilibili-gate/。

推荐内容无法加载

• 网络与API问题：检查网络连接，若使用App推荐Tab，需确保access_key有效。
• 清除缓存：在脚本设置中尝试刷新内容（快捷键r），或清除浏览器缓存。
• 兼容性模式：若B站首页版本更新导致失效，可切换至PC桌面端推荐（无需access_key）。

快捷键无效

• 检查快捷键设置：确认在全屏模式下使用快捷键，如方向键选择视频、Enter打开、s/w添加稍后再看。
• 冲突解决：与Bilibili-Evolved快捷键冲突时，可使用w代替s添加稍后再看。
• 重新加载脚本：关闭脚本后重新启用，或重启浏览器。

配置与数据问题

配置丢失或设置不生效

• 备份与恢复：通过设置中的导出功能备份配置，若配置丢失可导入备份文件。
• 云备份：利用专栏草稿箱作为备份存储，在设置中启用相关功能。
• 清除本地存储：在浏览器开发者工具中清除localStorage中与脚本相关的数据，重新配置。

稍后再看列表异常

• 容量限制：B站稍后再看容量已升级至1000，脚本已移除原100的视觉限制。
• 同步问题：稍后再看状态为全局状态，切换Tab后仍可保持，若异常可尝试重新添加。
• 排序与刷新：支持随机顺序和保持顺序刷新，在设置中调整相关选项。

显示与界面问题

视频卡片显示异常

• 主题冲突：与Bilibili-Evolved的深色模式冲突时，删除theme_stylecookie或修改值为light。
• 样式设置：在设置中调整卡片样式，启用“新卡片样式”或“全屏模式”。
• 图片加载：视频预览图片无法加载时，检查网络或尝试切换视频源API。

动态内容过滤失效

• 过滤设置：在设置中开启按UP主、标题关键词过滤，确保过滤规则正确。
• 动态缓存：动态内容支持本地缓存，可清除缓存后重新加载。
• 分组动态：分组中UP主较少时使用“拼接时间线”，较多时基于全部动态过滤，可在设置中调整。

安装与升级问题

手动安装与升级

• 源码构建：

  git clone https://gitcode.com/gh_mirrors/bi/bilibili-app-recommend corepack enable pnpm install pnpm build

• CI构建版：使用main分支自动构建的开发版。

版本兼容性

• 旧版迁移：bilibili-app-recommend用户可通过文件导出全部设置迁移到Bilibili-Gate。
• 浏览器支持：确保浏览器版本符合要求，Chrome/Edge/Firefox建议使用最新版，Safari需14.1以上。

其他常见问题

access_key获取与过期

• 获取方式：通过扫码登录或弹出窗口获取，支持模拟TV扫码登录。
• 过期提示：脚本会提示access_key过期，需重新获取。

与其他插件兼容性

• Bilibili-Evolved：兼容深色模式、自定义顶栏，但首页相关功能需禁用。
• Dark Reader：基本可用，但无专门适配，可能存在样式冲突。

通过以上方法，大部分常见问题都能得到解决。若遇到其他问题，可查看项目文档或提交issue反馈。希望本文能帮助你更好地使用bilibili-app-recommend，享受个性化的B站首页体验！

【免费下载链接】bilibili-app-recommend[UserScript] Bilibili 自定义首页项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-app-recommend