RSS 订阅
添加订阅
添加和发现 RSS 订阅源
小幻阅读支持多种方式添加 RSS 订阅，从手动输入 URL 到批量导入 OPML 文件。
通过 URL 添加
最直接的方式是输入订阅源的 URL。
添加步骤
- 在 RSS 模块侧边栏点击 添加订阅 按钮
- 输入 RSS/Atom 订阅源的 URL
- 按 Enter 或点击获取按钮
- 等待解析完成，自动填充订阅源信息
- 选择目标分组（可选）
- 自定义名称和描述（可选）
- 点击 确定 完成添加
支持的格式
| 格式 | 说明 |
|---|---|
| RSS 2.0 | 最常见的订阅格式 |
| Atom 1.0 | 现代化的订阅格式 |
提示
系统会自动检测 URL 指向的是 RSS 还是 Atom 格式，无需手动指定。
自动解析信息
解析成功后，系统会自动提取以下信息：
| 信息 | 说明 |
|---|---|
| 标题 | 订阅源名称 |
| 描述 | 订阅源简介 |
| 网站链接 | 源站 URL |
| 图标 | 订阅源图标（如有） |
| 作者 | 内容作者（如有） |
| 语言 | 订阅源语言 |
你可以在添加前修改名称和描述，自定义显示内容。
从 OPML 导入
OPML（Outline Processor Markup Language）是 RSS 阅读器通用的订阅列表交换格式，可以一次性导入大量订阅。
导入步骤
- 点击 RSS 模块标题栏的 更多 菜单
- 选择 导入 OPML
- 选择本地 OPML 文件
- 选择导入模式
- 确认导入
导入模式
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 合并 | 保留现有订阅，仅添加新的订阅源和分组 | 增量导入、多来源整合 |
| 替换 | 清空现有数据，完全使用 OPML 内容替换 | 全新开始、恢复备份 |
注意
替换模式会删除当前服务中的所有订阅和分组，请谨慎使用。
OPML 格式说明
标准 OPML 文件结构示例：
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
<head>
<title>我的订阅</title>
</head>
<body>
<outline text="技术" title="技术">
<outline type="rss" text="博客A" xmlUrl="https://..." htmlUrl="https://..."/>
<outline type="rss" text="博客B" xmlUrl="https://..." htmlUrl="https://..."/>
</outline>
<outline type="rss" text="新闻C" xmlUrl="https://..."/>
</body>
</opml>系统会解析以下属性：
| 属性 | 说明 |
|---|---|
xmlUrl | 订阅源 URL（必需） |
htmlUrl | 网站链接 |
text / title | 显示名称 |
description | 描述 |
嵌套的 <outline> 元素会自动识别为分组。
分组管理
分组帮助你按类别组织订阅源。
创建分组
- 在侧边栏点击 分组 区域旁的 + 按钮
- 输入分组名称
- 选择图标（可选）
- 点击确定
分组操作
右键点击分组可以进行以下操作：
| 操作 | 说明 |
|---|---|
| 编辑 | 修改分组名称和图标 |
| 上移/下移 | 调整分组顺序 |
| 删除 | 删除分组 |
删除分组
删除分组时可以选择：
- 仅删除分组：分组内的订阅源移到根级别
- 同时删除订阅源：删除分组及其中的所有订阅源
移动订阅源到分组
- 添加时选择：添加订阅时直接选择目标分组
- 编辑订阅源：右键订阅源 → 编辑 → 修改所属分组
- 拖拽移动：将订阅源拖拽到目标分组
添加后的处理
订阅源添加成功后，系统会自动执行以下操作：
| 步骤 | 说明 |
|---|---|
| 保存到数据库 | 存储订阅源信息 |
| 更新侧边栏 | 显示新添加的订阅源 |
| 后台同步文章 | 获取订阅源的最新内容 |
| 显示未读数 | 统计并显示未读文章数量 |
提示
同步过程在后台进行，不会阻塞界面操作。同步完成后会自动更新文章列表和未读数。
URL 验证
系统会对输入的 URL 进行验证：
| 检查项 | 说明 |
|---|---|
| 格式验证 | 必须是有效的 URL 格式 |
| 协议检查 | 仅支持 http:// 和 https:// |
| 连接测试 | 尝试获取订阅内容 |
| 格式解析 | 验证是否为有效的 RSS/Atom |
常见错误
| 错误 | 可能原因 |
|---|---|
| URL 格式无效 | 检查是否包含协议前缀（http:// 或 https://） |
| 无法连接 | 网络问题或 URL 不可访问 |
| 解析失败 | URL 返回的不是有效的 RSS/Atom 内容 |
| 超时 | 服务器响应过慢，默认超时 30 秒 |
同步服务的订阅添加
如果你使用在线同步服务（如 Inoreader、Miniflux 等），添加订阅的流程可能略有不同。
本地 RSS vs 同步服务
| 功能 | 本地 RSS | 同步服务 |
|---|---|---|
| 添加订阅 | 直接添加 | 通过服务 API 添加 |
| OPML 导入 | 本地解析导入 | 发送到服务端处理 |
| 分组管理 | 本地管理 | 同步到服务端 |
| 数据同步 | 单向获取 | 双向同步 |
提示
使用同步服务时，订阅变更会同步到云端，可以在多设备间共享订阅列表。详见同步服务文档。
常见问题
如何获取网站的 RSS 地址？
- 查找 RSS 图标：网站页面通常会有 RSS 图标链接
- 查看页面源码：搜索
<link rel="alternate" type="application/rss+xml"> - 尝试常见路径：如
/feed、/rss、/atom.xml - 使用 RSS 发现工具：浏览器扩展或在线服务
添加订阅后没有文章？
- 检查订阅源是否有内容
- 等待后台同步完成
- 检查订阅源 URL 是否正确
- 尝试手动刷新订阅
OPML 导入后订阅源没有名称？
OPML 文件中可能缺少 text 或 title 属性。导入后可以手动编辑订阅源名称。
如何导出订阅列表？
目前暂不支持导出 OPML 功能，后续版本会添加。