规则与指南
规则与用户指南
1. 适用范围
Readori 支持社区兼容的规则格式,用于网页书源解析与 RSS 阅读。本指南描述的是 Readori 的行为,而非第三方项目文档。
2. 书源规则模型
- 基础字段:书源地址、书源名称、启用状态。
- 搜索规则:列表、书名、作者、详情地址、封面、简介。
- 详情规则:元数据提取与目录地址。
- 目录规则:章节列表、章节标题、章节 URL、可选下一页。
- 正文规则:章节内容提取与可选内容翻页。
3. 支持的表达类型
- CSS 类选择器:用于 HTML 内容提取。
- XPath:用于结构化 DOM 查询。
- JSONPath:用于 JSON 接口返回解析。
- 正则替换:用于提取后的清理处理。
- JavaScript:用于受限场景下的后处理逻辑。
4. URL 与请求选项
规则可包含请求选项,例如 method、headers、charset 和可选网页渲染行为。仅在目标站点确实需要时启用。
5. RSS 规则
- 订阅地址:必填,必须返回合法 RSS/Atom XML。
- 列表映射:条目标题、链接、发布时间、摘要。
- 详情映射(可选):从条目链接提取完整正文。
- 刷新策略:根据源站行为配置页码或时间戳。
6. 合规提示
- 仅配置你有合法访问权的内容来源。
- 遵守目标站点条款、robots 规则与版权要求。
- 避免账号滥用、绕过限制或禁止的自动化抓取。
7. 排查指南
- 列表解析失败:先校验选择器范围是否覆盖目标节点。
- 章节内容为空:检查详情 URL 与正文规则顺序。
- 编码异常:在请求选项中显式指定 charset。
8. 快速开始
- 从 App Store 安装 Readori。
- 打开应用并完成欢迎引导。
- 使用书架上的加号按钮添加第一本书。
书源管理
书源定义 Readori 获取内容的来源。你可以使用内置书源或添加自定义书源。
- 打开设置 > 书源管理。
- 点击加号添加新书源。
- 选择导入方式:URL 导入、JSON 粘贴、二维码扫描或本地文件。
书源校验
添加书源后,请校验其是否正常工作。
- 从书源列表中选择该书源。
- 点击校验按钮。
- 查看校验结果。
阅读体验
Readori 支持自定义主题和阅读模式,以优化长时间阅读。
- 打开阅读器并点击屏幕中央。
- 选择主题设置以调整字体、配色和间距。
- 滑动翻页:左右滑动获得类书本翻页体验。
- 滚动翻页:垂直滚动用于连续阅读。
iCloud 同步
使用 iCloud 同步可在多台设备间保持书架、进度与书源一致。
- 打开设置 > iCloud 同步。
- 开启启用同步。
- 选择要同步的内容:书架、进度、书源等。
同步冲突
当设备间数据冲突时,可选择保留某个版本或合并更改。
- 查看冲突提示。
- 选择“本地”、“云端”或“合并”。
语音朗读
Readori 支持系统 TTS 和自定义 HTTP TTS 引擎。
- 点击阅读器工具栏中的朗读按钮。
- 选择语音和语速。
- 开始朗读。
要使用自定义 TTS 引擎,请打开设置 > TTS 设置,选择自定义引擎并输入服务 URL 与参数。
RSS 订阅
Readori 还可以订阅 RSS 订阅源,用于新闻与更新阅读。
- 打开设置 > RSS 管理。
- 点击加号添加订阅地址。
- 设置更新频率。
9. 高级功能
书签管理
为重要片段添加书签。
- 在阅读器中长按文本。
- 选择“添加书签”。
- 为书签命名。
内容清理规则
定义清理规则以移除广告、水印或不需要的文字。
- 打开设置 > 内容清理。
- 添加新规则。
- 设置匹配模式和替换内容。
数据备份
定期备份数据以防丢失。
- WebDAV 备份:配置远程服务器以自动备份。
- 本地备份:将备份文件导出到设备。
- iCloud 备份:将数据同步到 iCloud。
10. 安全与隐私
Readori 设计时优先考虑隐私。
- 默认情况下,所有数据本地存储。
- iCloud 同步为可选功能。
- 我们不会收集或上传个人敏感信息。
- 你可以随时导出或完全清除数据。
11. 联系方式
如需格式兼容或产品支持,请联系 support@readori.com。