RSS Reader v0.0.3

RSS Reader v0.0.3

整理日期：2026-10-30。面向 Kindle Paperwhite 3；相对于 v0.0.2，重点更新阅读界面、原生首页订阅卡片及异常恢复。

安装包与源码

下载名称以 -KPW3.zip 结尾的安装包。-source.zip 是项目源码，-third-party-sources.zip 是固定版本的依赖及工具链归档（包含实际链接的运行库源码）；修改或重新构建时需同时保存这两份源码包。SHA256SUMS.txt 覆盖三个附件。

新版排版迁移至 CREngine-ng 0.9.13，其 GPL-2.0-or-later 许可允许本构建选择 GPLv3。组合阅读程序按 GPLv3 分发，项目原创代码仍保留 MIT；其他组件保留原许可。源码包包括可复现的构建脚本、锁文件及引擎集成修改。详见许可核对与重建说明。

新增

• 网页正文可单篇后台下载，也可按订阅自动下载以后的新文章，支持取消、继续和失败重试。RSS 原文与网页正文分别保存阅读位置。
• 新版正文排版保留标题、引用、代码和图文结构；保留原排版、独立阅读位置及失败回退。
• 正文支持左滑下一页、右滑上一页，保留点击翻页。末页滑动不会自动跳到下一篇；竖向拖动、多指和按钮区域拖动不会误触翻页。
• 可选的 Kindle 原生首页适配将原有 Kindle+ 推荐卡位替换成最多三张订阅书卡。卡片内显示来源、未读优先的文章标题、正文摘录、日期和未读数，点击打开对应文章。阅读器设置中可控制显示。

界面与性能

• 文章列表把范围标题、分组选择、未读／全部／收藏和搜索集中到上方；左下角放菜单，右下角放上下页按钮。列表行收紧留白，短标题时可一页显示七篇。
• 同步改为弹窗，可后台运行、取消、重试失败项目及进入缓存管理。
• 统一各页状态栏字号、顶部间距、返回按钮和阅读面板样式，保留各页时间及返回按钮的位置；收紧阅读正文与顶栏间距。
• 原生首页书卡按实际标题高度分配摘录空间，调整标题箭头对齐与分隔线样式。
• 缓存常用图标，避免同步时重复写入未变化的图片缓存，减少绘制与存储开销。

修复

• 打开文章时，将已读状态、阅读位置、正文来源及最近文章一起保存。任一步写入失败会整体回滚，错误返回文章列表；返回时保存进度失败也能离开正文，避免存储已满时反复进入错误页。
• 修复重启后私有目录权限变化导致的启动失败。
• 补齐首页后台的 USB 存储恢复任务，检查实际进程而非只依赖旧健康记录。自动恢复不主动切换前台应用；手动启用、停用保留打开首页的行为。
• 清理本组件重载首页产生的诊断报告，避免它们持续出现在书库或占用系统状态分区。
• 修复部分大尺寸 PNG 缓存失败，并保留下载失败时的 RSS 原文和阅读记录。

升级与数据

升级前正常退出阅读器，备份整个 native-rss，合并复制安装文件并保留 native-rss/data/。网页正文使用新增附表，保留订阅、收藏和旧阅读位置；不要用旧备份覆盖当前数据库。

首页卡片是需要单独安装的开发功能，仅验证 KPW3 固件 5.16.2.1.1 的匹配原文件。普通安装包不带设备固件补丁，应用里的显示开关不会自动安装适配。已安装旧适配时，更新后执行一次 home.sh enable 补装恢复任务；更新 Kindle 固件或卸载前先停用适配。详见首页适配指南。

验证与限制

• 本轮功能代码通过全部 28 个 CTest 测试目标，ARM 静态构建通过。
• KPW3 真机验证两种排版下的六组写入故障回滚，以及正常打开文章、翻页、返回列表与退出。故障通过数据库触发器模拟，并非再次填满设备存储。
• 真机验证首页恢复时保留商店前台，返回系统首页后重新显示订阅书卡；个人数据库前后校验值一致。
• 本轮未完成整机重启、物理 USB 拔插及微信读书等各类前台应用的完整回归；长期休眠、耗电与其他机型仍未充分验证。发布流程先生成草稿附件，再核对下载文件并进行 KPW3 验证后公开。
• 网页正文仅尝试提取公开、无需登录的 UTF-8 / ASCII 静态 HTML；不执行脚本，不支持付费墙、旧编码网页或多页拼接。

安装教程 · 使用指南 · 问题排查

发布附件验收（2026-10-30）

GitHub Actions 发布构建 已通过，发布标签指向 7acc6cbdd8dbb8f28037e1633291d194258b376b。四个附件已从草稿重新下载，核对三份 ZIP 的 SHA-256、逐文件清单、对应源码、固定构建输入以及 16 份依赖归档。

直接运行下载的 CI 安装包中的程序，在 KPW3 临时数据库中验证 HTML 标题与引用排版、正文翻页、返回列表、设置页许可和正常退出；已安装程序与个人数据库前后哈希一致。该验证不包含覆盖安装、整机重启、物理 USB 拔插或长期待机测试。

RSS Reader v0.0.2

更新记录

下面保留每次发布时的变化，方便回查。安装请直接去最新版下载页面。

v0.0.2 · 2026-10-26

这一版面向 Kindle Paperwhite 3（KPW3）。仍处于开发阶段，欢迎反馈使用体验。

新增

• 订阅可以放进多层分组，支持创建、重命名和移动，也能保留空分组。
• 订阅名称、RSS 地址和分组编辑；名称留空时同步自动发现博客名称。
• 下载文章时可以查看进度、取消或重新下载失败的网站；离开下载页面也能继续。
• 支持更多文章图片，并改善大图的下载和显示。
• 越狱后安装教程、贡献指南、安全反馈、MIT 许可和第三方组件说明。

改进与修复

• 重整首页、订阅管理、分组筛选、阅读工具栏和拼音输入界面。
• 首页打开后就能看到准确的当前页和总页数，改善翻页与页面切换速度。
• 两种下载包都带上完整许可，排除私人阅读数据、订阅列表和设备原始报告。
• 发布前自动编译、测试并检查文件是否完整，提供下载校验文件。

安装与升级

到最新版下载页面，下载名称以 -KPW3.zip 结尾的压缩包。已越狱的用户，请按安装教程选择 KUAL 或书库入口，再复制文件。

升级前退出应用并备份整个 native-rss，保留 native-rss/data/。安装包不包含个人数据库；不要整体替换书籍或扩展目录，也不要使用“更新 Kindle”安装 ZIP。

完整安装、升级与排错教程。

验证与限制

安装包由 GitHub 自动编译，发布前会运行测试并检查下载文件是否完整。检查失败时不会发布。

KPW3 已测试过图文阅读、订阅列表导入导出，以及保存阅读位置等基本操作。这次自动编译的安装包还没有重新在设备上走完使用检查；长期耗电、反复休眠、退出和连接电脑，以及其他机型仍需继续验证。部分网站只提供摘要，暂不支持自动补成全文或播放动态图片。

与上一版的变更：v0.0.1...v0.0.2。

文档更新（2026-10-26）

安装包和源码包内的安装、使用说明已更新，程序没有变更。已经下载过的用户可直接查看最新版在线教程，无需为了文档重新安装。更新后的下载校验值见附件 SHA256SUMS.txt。

文档修订记录；包内 native-rss/DOCUMENTATION.json 记录对应的应用和文档提交。

RSS Reader v0.0.1

RSS Reader 首个开发版本，面向已具备运行环境的 Kindle Paperwhite 3（KPW3）。独立原生 C++ 应用，不依赖 KOReader 插件。

功能

• RSS / Atom 订阅、后台同步、订阅分组及 OPML 导入导出。
• 离线图文分页，支持 JPEG、PNG、静态 WebP 和图片查看。
• 已读、收藏、阅读位置与字号保存。
• 中文拼音搜索键盘、统一黑白界面，以及 RSS Reader 书库封面和 KUAL 入口。
• 正常退出、休眠、USB 与异常退出的系统恢复机制。

安装

完整安装与升级教程：运行环境、目录结构、首次导入订阅、保留数据升级、故障排查和卸载。

1. 确认设备为已具备自制程序运行环境的 KPW3，已安装 KUAL 和必需工具；书库入口另需 Scriptlets。详细前置条件见教程。
2. 下载本页 Assets 中的 RSS-Reader-v0.0.1-KPW3.zip，不要把源码包作为安装包。
3. 在电脑上解压，将 native-rss、extensions、documents 的内容合并到 Kindle 用户盘根目录，不要额外嵌套一层目录，也不要整体替换已有书籍或扩展目录。
4. 安全弹出 USB 用户盘，通过 KUAL 的 RSS Reader 启动；已配置 Scriptlets 时也可从书库启动。
5. 添加 RSS/Atom 地址并同步；批量导入请将 feeds.opml 放到 native-rss/data/feeds.opml，在“我的阅读”中导入后同步。

升级前先退出并备份 native-rss，保留 native-rss/data/。本版本安装包不包含个人数据库。不要通过“更新 Kindle”安装此 ZIP。 本包不提供越狱、KUAL 或 Scriptlets 的安装。

本附件仍对应 v0.0.1；main 中后续的性能优化不包含在这个版本里。

验证与限制

已在 KPW3 / 固件 5.16.2.1.1 上运行；离线图文翻页、OPML、阅读位置、字号、收藏及基本退出/休眠恢复已有实机验证。现有工作区 CTest 12/12 通过；本发布的 ARM 二进制与提交源码的构建输入哈希一致，包内文件校验通过。

这是开发版本：长期耗电、反复生命周期与其他 Kindle 型号尚未完整验收。未实现通用网页全文提取，不支持动态图片。

附件

• RSS-Reader-v0.0.1-KPW3.zip：KPW3 安装包。
• RSS-Reader-v0.0.1-source.zip：当前提交的完整源码。
• SHA256SUMS.txt：上述两个文件的 SHA-256 校验值。