RSSHub-Radar 高效故障排除全解析

故障排除指南：扩展安装后无法正常工作

问题场景

用户在浏览器中安装 RSSHub-Radar 扩展后，出现扩展图标不显示、点击无反应或功能完全无法使用的情况，导致无法正常发现和订阅 RSS 订阅源（网站内容的实时更新链接）。

常见触发场景

• 浏览器版本过低，不支持扩展所需的最新 API
• 扩展安装过程中文件损坏或未完全下载
• 浏览器安全设置阻止了扩展的正常加载
• 扩展与当前浏览器配置存在兼容性冲突

排查思路

1. 确认扩展是否在浏览器扩展列表中显示为已启用状态
2. 检查浏览器版本是否满足扩展的最低要求
3. 观察浏览器控制台是否有相关错误信息输出
4. 尝试在隐私模式下测试扩展是否能正常工作

解决方案

初级操作（适用于所有浏览器）

1. 重新加载扩展

   • Chrome：打开扩展管理页面（chrome://extensions/），开启右上角"开发者模式"，点击"重新加载"按钮
   • Firefox：打开扩展管理页面（about:addons），找到 RSSHub-Radar，点击"禁用"后再点击"启用"

2. 检查扩展状态

   • 确认扩展已启用且权限设置正确
   • 确保扩展图标未被隐藏（Chrome可通过扩展栏的"拼图"图标找回）

进阶操作

1. 清除浏览器缓存

   • Chrome：访问chrome://settings/clearBrowserData，选择"缓存的图片和文件"，点击"清除数据"
   • Firefox：访问about:preferences#privacy，在"Cookie和网站数据"下点击"清除数据"

2. 更新浏览器

   • Chrome：访问chrome://settings/help，浏览器会自动检查并安装更新
   • Firefox：访问about:preferences#general，在"Firefox更新"部分点击"检查更新"

专家操作

1. 检查扩展错误日志

   • Chrome：打开扩展管理页面，点击扩展下的"背景页"链接，查看控制台错误信息
   • Firefox：打开about:debugging#/runtime/this-firefox，找到扩展并点击"检查"查看控制台

2. 重新安装扩展

   • 完全卸载现有扩展，然后从官方渠道重新安装最新版本

预防建议

• 定期检查浏览器和扩展更新，保持软件为最新版本
• 避免同时安装过多功能相似的扩展，减少冲突风险
• 在浏览器中启用扩展自动更新功能
• 创建浏览器配置备份，以便出现问题时快速恢复

验证方法

1. 确认扩展图标在浏览器工具栏中正常显示
2. 访问任意支持 RSS 的网站（如博客、新闻网站）
3. 点击扩展图标，检查是否能正常显示发现的 RSS 订阅源
4. 尝试订阅一个 RSS 源，确认功能正常

同类问题对比

问题现象	可能原因	辨别要点
图标不显示	扩展被禁用或隐藏	扩展管理页面显示已启用但工具栏无图标
点击无反应	扩展后台进程崩溃	控制台有明显错误信息输出
功能部分失效	权限不足或网站规则缺失	部分网站能正常识别，部分不能

故障排除指南：无法识别网站的RSS订阅源

问题场景

用户访问包含 RSS 订阅源的网站时，RSSHub-Radar 扩展未能检测并显示可用的订阅源，导致无法快速订阅网站内容更新。

常见触发场景

• 网站使用非标准 RSS 订阅源路径
• 网站采用动态加载技术导致订阅源链接隐藏
• 网站的 RSS 订阅源需要特定权限才能访问
• RSSHub-Radar 的规则库未包含该网站的识别规则

排查思路

1. 确认目标网站是否确实提供 RSS 订阅功能
2. 检查浏览器地址栏是否有浏览器原生的 RSS 图标
3. 查看页面源代码中是否包含 RSS 订阅链接
4. 测试其他类似网站是否能正常识别，判断是个别还是普遍问题

解决方案

初级操作

1. 刷新当前页面

   • 按下 F5 或 Ctrl+R（Cmd+R for Mac）刷新页面，给扩展足够时间识别订阅源

2. 检查网站是否提供 RSS

   • 查看网站页面底部或导航栏，寻找类似"RSS"、"订阅"或"Feed"的链接
   • 尝试在网站 URL 后添加常见 RSS 路径，如 /rss、/feed、/atom.xml

进阶操作

1. 手动查找订阅源

   • 右键点击页面空白处，选择"查看页面源代码"
   • 在源代码中搜索"rss"、"feed"或"atom"关键词
   • 找到类似 <link rel="alternate" type="application/rss+xml" 的标签，提取其中的 href 属性值

2. 使用扩展的手动添加功能

   • 点击扩展图标，查找"手动添加订阅"或类似选项
   • 输入找到的 RSS 订阅源 URL，完成手动订阅

专家操作

1. 检查并更新规则库

   • 确保 RSSHub-Radar 的规则库为最新版本
   • 查看扩展设置中是否有"更新规则"或"刷新规则"选项

2. 贡献新规则

   • 收集网站信息和 RSS 订阅源结构
   • 按照项目贡献指南提交新的识别规则

预防建议

• 定期更新 RSSHub-Radar 至最新版本以获取最新规则库
• 关注项目官方渠道了解规则库更新情况
• 对于常用网站，主动确认其 RSS 订阅源是否可用

验证方法

1. 访问已知提供 RSS 订阅的测试网站（如部分新闻网站）
2. 确认扩展能正常显示订阅源图标和数量
3. 点击订阅按钮，检查是否能成功添加到 RSS 阅读器
4. 验证订阅后能否接收到网站的更新内容

同类问题对比

问题现象	可能原因	辨别要点
完全不显示订阅源	网站无 RSS 或规则缺失	所有网站都无法识别
部分网站不显示	特定网站规则缺失	其他网站能正常识别
显示订阅源但无法订阅	订阅源链接失效	扩展显示订阅源但点击无反应

故障排除指南：扩展界面显示异常或加载缓慢

问题场景

用户点击 RSSHub-Radar 扩展图标后，界面加载缓慢、布局错乱、部分功能按钮缺失或无法交互，影响正常使用体验。

常见触发场景

• 网络连接不稳定或速度过慢
• 浏览器资源占用过高，导致扩展运行卡顿
• 扩展缓存数据损坏或过大
• 与其他已安装的扩展存在样式或脚本冲突

排查思路

1. 检查网络连接状态，确认网络通畅
2. 观察浏览器任务管理器，查看资源占用情况
3. 尝试在不同网站页面打开扩展，观察是否都存在问题
4. 检查浏览器控制台是否有 JavaScript 错误或样式加载失败提示

解决方案

初级操作

1. 关闭并重新打开扩展

   • 点击扩展图标关闭界面，再次点击重新打开
   • 如仍有问题，刷新当前网页后重试

2. 检查网络连接

   • 确认网络连接正常，尝试访问其他网站验证
   • 如有必要，切换网络（如从 Wi-Fi 切换到有线连接）

进阶操作

1. 清理扩展缓存

   • Chrome：访问chrome://settings/siteData，搜索"RSSHub-Radar"，点击"删除所有显示的Cookie和网站数据"
   • Firefox：访问about:preferences#privacy，在"Cookie和网站数据"下点击"管理数据"，搜索并删除相关数据

2. 禁用其他扩展

   • 打开浏览器扩展管理页面
   • 暂时禁用除 RSSHub-Radar 外的其他扩展
   • 测试扩展界面是否恢复正常

专家操作

1. 以安全模式运行浏览器

   • Chrome：关闭所有 Chrome 窗口，在命令行执行 chrome --safe-mode
   • Firefox：点击菜单 > 帮助 > 重新启动并禁用加载项

2. 检查并修复扩展文件

   • 卸载当前版本的 RSSHub-Radar
   • 重新安装最新版本的扩展
   • 必要时清除浏览器配置文件中与扩展相关的残留数据

预防建议

• 定期清理浏览器缓存和扩展数据
• 避免同时运行过多浏览器标签页和扩展
• 保持浏览器和扩展为最新版本
• 选择性能良好的设备运行浏览器，避免资源不足

验证方法

1. 点击扩展图标，观察界面加载时间是否在3秒内完成
2. 检查界面元素是否完整显示，无错位或缺失
3. 测试所有交互按钮是否能正常响应
4. 在不同类型的网站页面上打开扩展，确认一致正常

同类问题对比

问题现象	可能原因	辨别要点
界面空白	资源加载失败或脚本错误	打开控制台可见明显错误
布局错乱	CSS 冲突或样式加载失败	界面元素位置异常但功能可用
加载缓慢	网络问题或资源过大	界面逐渐显示但耗时过长
按钮无响应	JavaScript 错误	界面显示正常但无法交互