RSSHub-Radar 使用问题全解析：从入门到进阶的解决方案

一、入门配置篇

扩展安装后图标不显示怎么办？

⚠️ 场景描述：当你在浏览器中安装完 RSSHub-Radar 扩展后，发现工具栏中找不到扩展图标，或者点击后没有任何反应。

🔧 问题定位：浏览器扩展加载失败或权限未正确授予

排查步骤

点击展开详细步骤

1. 打开浏览器扩展管理页面（Chrome用户访问chrome://extensions/，Firefox用户访问about:addons） 2. 确认RSSHub-Radar扩展已启用，若未启用则点击"启用"开关 3. 检查扩展是否有权限访问当前页面（点击扩展图标旁的"固定"按钮将其固定到工具栏） 4. 验证方法：固定后工具栏应显示RSSHub-Radar图标，点击后能正常打开弹窗界面

🔍 原理简析：浏览器扩展需要正确注册后台服务和UI组件，缺失任何一环都会导致图标无法正常显示。固定图标能确保扩展始终在工具栏可见。

📌 小贴士：如果使用Chrome浏览器，建议将扩展固定到工具栏，避免被收纳到扩展菜单中。

浏览器兼容性参考

浏览器	最低版本要求	已知问题
Chrome	88.0+	无特殊问题
Firefox	85.0+	需要手动授予跨域请求权限
Edge	88.0+	与Chrome兼容性一致

二、功能异常篇

网页订阅源识别不到怎么办？

⚠️ 场景描述：当你访问一个已知提供RSS订阅的网站时，RSSHub-Radar图标没有变成彩色，也没有显示可用的订阅源。

🔧 问题定位：网站结构变化或雷达规则未覆盖该网站

排查步骤

点击展开详细步骤

1. 确认网站是否确实提供RSS订阅（通常在页面底部寻找RSS图标或链接） 2. 点击扩展图标，查看是否有"未找到订阅源"提示 3. 刷新页面（快捷键F5）后再次检查 4. 验证方法：成功识别时扩展图标会变为彩色，并在弹窗中显示可用订阅源列表

🔍 原理简析：RSSHub-Radar通过预设规则匹配网页中的RSS链接，网站结构变化或使用动态加载技术可能导致规则失效。

替代方案

• 尝试使用扩展的"手动搜索"功能（点击图标后选择"搜索订阅源"）
• 检查是否有最新版本的扩展更新（扩展管理页面中开启自动更新）
• 手动添加订阅源URL到你的RSS阅读器

扩展界面显示错乱怎么办？

⚠️ 场景描述：打开RSSHub-Radar弹窗后，发现界面元素重叠、文字显示不全或按钮无法点击。

🔧 问题定位：CSS样式冲突或浏览器渲染异常

排查步骤

点击展开详细步骤

1. 关闭所有其他浏览器扩展（特别是样式修改类扩展） 2. 清除浏览器缓存（Chrome: Ctrl+Shift+Delete，Firefox: Ctrl+Shift+R） 3. 强制刷新扩展（扩展管理页面点击"重新加载"按钮） 4. 验证方法：界面元素应正常排列，文字完整显示，所有按钮可点击

🔍 原理简析：浏览器扩展共享页面样式空间，多个扩展的CSS规则可能相互干扰导致显示异常。

三、高级使用篇

如何自定义订阅规则？

📌 重要提示：自定义规则需要基础的HTML和CSS选择器知识

操作步骤

点击展开详细步骤

1. 打开扩展选项页面（右键图标选择"选项"） 2. 切换到"规则"标签页 3. 点击"添加自定义规则"按钮 4. 按照模板填写网站信息和提取规则 5. 保存后刷新目标网页测试效果 6. 验证方法：访问目标网站时扩展应能识别并显示自定义的订阅源

🔍 原理简析：RSSHub-Radar使用CSS选择器和正则表达式从网页中提取订阅信息，自定义规则允许用户为特定网站创建个性化提取逻辑。

如何同步扩展配置？

📌 重要提示：配置同步功能依赖浏览器的扩展同步服务

操作步骤

点击展开详细步骤

1. 确保已登录浏览器账号并启用同步功能 2. 打开扩展选项页面，切换到"通用"标签页 3. 勾选"启用配置同步"选项 4. 在其他设备上登录相同浏览器账号 5. 验证方法：在新设备上安装扩展后，配置会自动同步过来

🔍 原理简析：现代浏览器提供扩展数据同步API，通过浏览器账号将配置数据存储在云端，实现多设备间的配置共享。

四、社区支持

如果你遇到本文未覆盖的问题，可以通过以下方式获取帮助：

• 检查扩展内"关于"页面的常见问题解答
• 在扩展选项中使用"反馈问题"功能提交报告
• 参与项目社区讨论获取支持

记住，开源项目的改进离不开用户的反馈和贡献，如果你发现了新的问题或有好的建议，欢迎参与到项目的改进中来。