本文从 Obsidian 撰写发布
RSS Dashboard Obsidian 插件完整介绍
一、插件概述
RSS Dashboard 是一个免费、开源的 Obsidian 社区插件,由 Aditya Amatya 开发,致力于将 Obsidian 打造成一个全功能的信息聚合中心。它支持 RSS、Atom、JSON 等多种订阅格式,还能整合 YouTube 频道、播客和 Twitter/X 内容,所有数据本地存储,无广告、无追踪、无付费墙。
当前最新版本为 2.3.0,已完成 Obsidian 社区插件合规性审计(100% 合规),ESLint 零错误、零警告,全部 130 个测试文件通过(共 1180 个测试)。
二、核心特色
1. 多格式媒体支持
| 功能 | 说明 |
|---|---|
| 多格式订阅源 | 支持 RSS、Atom、XML、JSON Feed,自动发现和解析 |
| YouTube 集成 | 将 YouTube 频道转换为 RSS 订阅源,支持嵌入式视频播放 |
| 播客支持 | 完整播客订阅源支持,集成播客播放器 |
| Twitter/X 支持 | 自动将 Twitter/X 个人资料 URL 转换为 Nitter RSS 订阅源 |
| 媒体自动检测 | 自动识别视频和播客内容类型 |
2. 阅读与保存
| 功能 | 说明 |
|---|---|
| 文章阅读器 | 内置阅读器,支持抓取完整文章内容并转换为 Markdown |
| 文章保存 | 使用可自定义模板将文章保存为 Markdown 文件,支持 Frontmatter |
| 自定义模板 | 支持变量替换,自定义保存文章的格式 |
| 播放进度记忆 | 视频和播客可保存播放进度,下次打开从上次位置继续 |
| 付费墙检测 | 自动检测受限内容,仅在摘录可用时显示提示横幅 |
3. 组织与管理
| 功能 | 说明 |
|---|---|
| 文件夹组织 | 支持多层级文件夹/子文件夹结构管理订阅源 |
| 标签管理 | 为订阅源和文章添加自定义标签,便于分类和搜索 |
| 文章筛选 | 按阅读状态、时间、星标、已保存等多维度筛选 |
| 文章排序 | 按最新/最旧排序,支持按订阅源、日期、文件夹分组 |
| 自动刷新 | 可配置间隔自动刷新订阅源(5-120 分钟) |
| OPML 导入/导出 | 标准 OPML 格式导入/导出订阅列表 |
4. 发现与扩展
| 功能 | 说明 |
|---|---|
| 发现页面 | 由社区手动策划的 RSS 订阅源合集,按分类组织,一键订阅 |
| Kagi Smallweb | 浏览和订阅由社区策划的独立博客和小型网站 |
5. 键盘快捷键
在插件界面按 ?(Shift + /)即可打开快捷键帮助参考页,大幅提升操作效率。
三、界面结构
左侧边栏
- 视图切换:「Dashboard」和「Discover」按钮切换看板/发现视图
- 筛选器:全部文章、星标、未读、已读、已存、视频、播客、标签、搜索(部分可设置中禁用)
- 订阅源列表:以文件夹树结构组织
- 快捷操作栏:添加文件夹、排序、折叠/展开、添加订阅源、添加 YouTube 频道、导入/导出 OPML、管理订阅源
右侧主界面
- 顶部工具栏:收起侧边栏、当前筛选器/订阅源名称、文章时限调整、排序切换、分组方式、列表/卡片视图切换、刷新按钮
阅读器视图
- 默认与看板左右分屏,支持拖动调整大小
- 右上角按钮:「保存文章」「在浏览器中打开」(支持 OB 内置网页浏览器或系统浏览器)
四、设置面板说明
General(通用)
- View Style:卡片/列表视图切换
- Dashboard/Reader View Location:选择显示在主页面、左侧边栏或右侧边栏
- Use Web Viewer:调用 Obsidian 核心网页浏览器
- Refresh Interval:5-120 分钟自动刷新间隔
- Maximum Items:每个订阅源最多显示文章数(10-500)
- Page Size:各类视图每页显示文章数(20-200)
Display(显示)
- Show Cover Image:阅读视图显示封面图片
- Show Summary:卡片视图显示内容摘要
- Use Domain Favicons:使用域名图标替代通用 RSS 图标
- Filter Display Style:筛选按钮水平列表/图标模式
- Filter Visibility:各筛选器是否显示在侧边栏
Media(媒体)
- Auto-detect Media Type:自动区分媒体类型
- Auto-tag Videos:自动标记非 YouTube 视频
- Remember Playback Progress:保存视频/播客播放进度
- 各媒体类型的默认文件夹和默认标签设置
Article Saving(文章保存)
- Save Path:默认保存路径
- Add 'Saved' Tag:自动添加「Saved」标签
- Save Full Content:保存完整内容
- Fetch Timeout:抓取超时设置(5-30 秒)
- Article Templates:自定义保存模板
Import/Export(导入/导出)
- Backup & Restore:data.json 备份与恢复
- Import/Export OPML:OPML 格式数据导入/导出
Tags(标签)
- 新建标签:名称 + 颜色
五、使用方法
快速开始
- 安装插件:在 Obsidian 社区插件市场搜索「RSS Dashboard」安装并启用
- 添加订阅源:点击侧边栏底部的「+」按钮,粘贴 RSS 订阅地址,设置文件夹等选项后保存
- 获取订阅地址:直接在网站上寻找 RSS 图标,或使用浏览器扩展「RSSHub Radar」辅助获取
- 阅读文章:点击文章标题打开阅读器视图,可保存为 Markdown 文件
- 发现新内容:切换到「Discover」视图浏览推荐订阅源,点击即可订阅
推荐工作流
- 按主题创建文件夹(如「科技」「新闻」「博客」)
- 使用智能标签对内容二次分类
- 设置合理的自动刷新间隔(建议 30-60 分钟)
- 定期将优质文章保存为永久笔记
六、存在的主要问题
1. 中文翻译不完整
⚠️ 说明:当前已完成主体界面(按钮、菜单、标签)的中文翻译,但设置页面的详细描述文本仍为英文。这是翻译工作正在进行中的表现,不影响核心功能使用。
建议:可接受部分英文描述,或等待后续翻译更新。
2. 大规模订阅源下的性能
在管理数百个订阅源时,刷新操作可能占用较多资源。建议:
- 设置较长的刷新间隔(60 分钟以上)
- 使用「从刷新中排除」功能排除不常用的订阅源
3. 部分网站内容抓取限制
部分网站(如付费墙、反爬措施)可能仅能抓取摘要而非全文。插件 2.3.0 版本已增加付费墙检测提示功能。
4. 需要主动维护订阅源
部分 RSS 订阅源可能失效或变更地址,需要定期检查更新。
七、版本亮点(2.3.0)
- ✅ 可配置 metadata.json 位置及迁移控制
- ✅ 付费墙/受限内容检测
- ✅ 自动视频标记(非 YouTube 视频)
- ✅ 播放进度跨会话保存
- ✅ 键盘快捷键系统(按
?查看) - ✅ 长按触控支持(移动端文件夹操作)
- ✅ URL 作为筛选规则目标
- ✅ 绝对时间戳显示选项
- ✅ 修复 Ars Technica、Substack 等富 HTML 文章正文消失问题
- ✅ 修复重复 YouTube 条目问题(多种 GUID 形式归一化)
八、资源链接
- 项目地址:https://github.com/amatya-aditya/obsidian-rss-dashboard
- Discord 社区:https://discord.gg/9bu7V9BBbs
- Obsidian 论坛讨论:Obsidian 中文论坛搜索「RSS Dashboard」
九、总结
RSS Dashboard 是 Obsidian 生态中功能最全面的 RSS 阅读器插件,将文章阅读、视频观看、播客收听三类场景统一到一个工作区。对于依赖信息输入的知识工作者、研究人员、内容创作者来说,它是提升信息消费效率的重要工具。当前版本(2.3.0)在稳定性、合规性和功能完整性上已达较高水准,值得推荐。