开源阅读 Legado

## 更新日志

• feat(desktop): 桌面端能量采集改为只读整带测量 (c62a3c678)


• feat(audio): 点播放页顶栏标题进入书籍详情 (c686aa578)


• fix(ui): 半屏弹窗全屏与缩回手感对称, 顶栏拖拽即时响应 (c9fec7c77)


• feat(audio): 上线沉浸歌词与逐字动效, 全端音频能量统一驱动 (e304498c8)


• fix(http): iOS/鸿蒙端链接按 RFC 3986 逐段合法化, 修正非法转义闪退 (17d29ab06)


• fix(crypto): 对称解密支持二进制字节入参, 漫画图解密不再取空 (a7efa6a63)

# 2026/10/18 测试版更新说明

> ⚠️ 升级前请先备份数据。 本版数据库由 93 升级到 94，首次启动自动迁移。旧版应用不能直接读取迁移后的数据库；如需回退，请使用升级前备份，不要仅覆盖安装旧 APK。

## 发现与 MCP

• 恢复可选的旧版发现页：在“设置 → 其它设置 → 使用旧版发现页”开启，按书源展开分类，支持搜索、分组、登录、编辑与刷新；默认仍为新版卡片页。


• MCP 新增发现卡片的查询、添加、批量添加、更新和删除工具，支持一次跨多个书源创建卡片，以及全部分类、动态分类和逐卡配置。


• 批量最多提交 50 项，采用严格原子校验：任一书源不存在、未启用发现或参数无效，整批报错，不会部分添加。追加使用自增 ID 和连续排序，不覆盖已有卡片。


• 本次新增的是 MCP 工具，不是独立 HTTP / WebSocket 接口；重复调用仍会新增卡片，不做跨调用去重。调用示例见 API / MCP 使用说明。


## 阅读记录与备份


• 阅读记录增加作者与封面快照，尽量保留书籍移出书架后的展示信息；按书籍 URL 区分同名书，避免统计混在一起。


• 历史记录只有能唯一匹配到在架书籍时才补全身份和元数据；有歧义或已删除的记录保留历史身份，不猜测作者。


• 旧备份按同设备、同书籍身份合并累计时长，重复恢复不重复累加同一份时长；保留旧记录的设备归属。


• 修复翻页、朗读和音频计时在切书、暂停及开关记录时的边界问题，并修复中英文大字体下两行时间可能重叠的问题。


## 音频与书源交互


• 音频页菜单新增“播放速度”，提供 0.5 / 0.75 / 1 / 1.25 / 1.5 / 2 / 3 倍预设，保留 ±0.1 倍微调，统一校验并保存速度。


• 修复 v1 / v2 登录 UI 的动态渲染、按钮动作和登录脚本中的页面扩展绑定，支持使用 java.open 跳转。


• 补齐交互回调 / 登录脚本的 java.open("rss", articleUrl, title, rssSourceUrl)：使用已导入的目标订阅源进入文章加载链路，未缓存文章不会覆盖已有正文；导航受原页面生命周期约束。


## 界面


• 修正封面背景、图片与前景的圆角裁切，调整书架及发现封面卡片，避免双重圆角和额外内边距导致角部露底。


• 沿用此前浅色文字修复，补充输入框正文和确认弹窗标题的可读性回归，不将既有修复重复记为本轮新增。


## Nostr 段评


• 支持 NIP-46 远程签名器与 NIP-55 本机签名器（如 Amber），连接入口集中管理，支持头像、昵称、点赞和五级嵌套回复。


• 新增“最热 / 最新”切换：“最热”混合热度榜与最新榜，去重后展示；调整排序控件、列表配色及下拉刷新，已打开的列表避免后台更新引起跳动。


• 发送状态与草稿支持跨弹窗展示，失败草稿落盘，重启后仍可恢复并点击重发。


• 发布成功后原位更新占位项，不再整页重载；修复成功后残留“发送中”，断网或发送失败时保留已缓存的段评气泡。


• 未定位段评入口改挂到最后一段旁的独立气泡，不再额外插入章末占位行。


• 保留中继自动发现、签名校验、跨摘录回复与统计 / 详情缓存等能力。


## 测试提示与已知限制


• 已通过 85 项聚焦 JVM 回归、API 34 模拟器 14 项设备回归，App Debug 与 AndroidTest APK 构建成功；这不等于已签名发布包或所有场景均已验收。


• 原始登录 / RSS 源的真实网络规则、Nostr 签名器与中继发布回读、Android 16 厂商设备的硬件圆角及完整日夜切换仍需实机反馈。全量 JVM 尚有既有原生库环境和静态断言失败，未宣称全量通过，详见 验证记录。


• 未新增或恢复“明月书阁”订阅源，仍需可验证的站点地址或旧源规则。


• Test Build / Release Build 均保持手动触发，本次文档更新不会自动发布测试版。


---

完整更新历史 · 使用帮助 · API / MCP 使用说明

<details>
<summary>完整提交记录</summary>

自上一测试版以来的全部更新:


• docs: prepare beta release notes and guides


• fix: size reading record rows by their tallest text


• fix: address discovery tools, login navigation and reading records


• ci: run test and release builds only on manual dispatch


• Merge remote-tracking branch 'newdea/feat/nostr-paragraph-comments'


• fix(review): 段评发布成功后原地升级占位，不再整页重载


• fix(review): 段评占位项与待发布表对账，治发送成功后残留「发送中」


• fix(read): 去掉章末占位行，未定位段评入口改为最后一段双气泡


• fix(review): 段评发布失败的提示改为长时长 toast


• fix(review): 断网发布失败不再清空整章段评气泡


• fix(review): 段评草稿落盘，重启后仍可在列表恢复并重发


• fix(review): 断网时保留已缓存的段评气泡


• fix(review): 段评发布后统计回查延时改为 5s/20s


• feat(review): 段评/回复发布跨弹窗乐观显示（发送中/草稿）


• fix(review): 段评冻结排序 key 改用 buildDetailItemKey


• feat(review): 段评排序调整——配色、位置、混合插入、冻结与下拉刷新


• feat(review): 段评弹窗新增最热/最新排序切换


• docs: 精简段评日志条目并将日期更新为 2026/10/15


• fix(nostr): 段评详情建树改用本段全部评论，避免跨摘录回复丢失导致列表少于计数


• fix(nostr): 显式标注签名器启动器类型避免递归类型推断


• fix(nostr): 恢复使用 (Intent)->Unit 参数避免递归类型推断


• fix(nostr): 修复 launch 方法解析歧义


• feat(nostr): 未登录时段评评论/回复/点赞可点并提示连接


• fix(nostr): 段评气泡不再「显示几秒后消失又出现」，并移除临时诊断


• chore(nostr): 段评诊断补行级日志（段落号/offset/是否段末/是否已有列）


• chore(nostr): 段评诊断日志（查询命中/评论数/入缓存/上屏）


• fix(nostr): 段评统计内存缓存命中后仍后台刷新，回查并入计数下限


• fix(review): 「查看更多回复」去掉不准确的条数


• feat(review): 段评支持五级嵌套回复，昵称行标注回复对象


• fix(review): 段评回复项也显示点赞


• fix(review): 段评回复按钮统一到时间行，左对齐不再顶到最右


• fix(nostr): 段评气泡改为点击即乐观 +1，发布失败再回退


• chore(nostr): 临时诊断日志：段评乐观计数链路


• fix(review): 修正回复按钮点击器里非法的 return@ 标签


• fix(nostr): 修正段评乐观计数翻倍与发布后详情不立即缓存


• fix(review): 段评回复项昵称独立成行，回复按钮移到时间行


• fix(nostr): NIP-55 后台签名查询路径用大写方法名


• feat(nostr): 签名器弹窗内直接显示二维码，bunker 去掉标签行


• fix(read): 段评列无变化时不再整页重绘


• feat(nostr): 签名器入口合并为一行，弹窗内集中三种连接方式


• feat(nostr): 两种签名器并存、连接谁用谁，设置项挪到一起


• fix(nostr): 修正 CI 报出的两处编译错误


• feat(nostr): 段评支持 NIP-55 本机签名器，签名不再依赖中继


• docs: 更新日志补充 Nostr 段评条目（2026/10/13）


• feat(read): 段评计数两次递进回查取 max，预热改并发就近优先并补加载态


• fix(read): 本地占位项不再写入段评详情缓存


• feat(段评): 兼容重新分段的匹配，并把未定位段评汇总到章末


• fix(read): 段评发布改用应用级协程，退回正文也在后台完成


• fix(nostr): publishAndCollect 改为 internal，修复编译错误


• feat(nostr): 发布返回逐中继结果并对传输层失败重试一次


• feat(nostr): 段评照 Amethyst 补 relay hint、投递到摘录所在中继、摘录加 t 标签


• fix(nostr): NIP-46 按 request id 收包，忽略无关回包，超时换新 id 重试


• fix(nostr): fetchEventById 改为 internal，修复编译错误


• fix(nostr): 新建摘录发布后校验可读，失败重发，仍失败则不产悬空评论


• feat(nostr): 段评摘录复用 + 发布可观测与失败兜底


• fix(read): 发布/回复后立即刷新段评统计与气泡


• feat(read): 段评发布/回复乐观上屏，失败显示草稿态并可点击重发


• fix(nostr): 账号资料拉取改用更宽的中继集合并补未命中日志


• perf(read): 打开章节时预热段评详情（当前章+下一章）


• feat(nostr): 段评书标识升级 v2，章节标题入 context 取代 r


• feat(read): 点赞支持再次点击取消（NIP-09 删除自己的 reaction）


• feat(read): 点赞改为乐观更新，失败再回滚


• feat(read): 段评发布显示进度/防重，失败自动存草稿


• feat(read): 段评列表优先展示头像与昵称


• feat(nostr): 登录后启动时同步账号资料（kind 0 头像/昵称）


• perf(read): 打开本章时预取下一章的 Nostr 段评统计


• fix(read): 回复段评后刷新本章统计，使回复计入图标计数


• perf(read): 段评详情缓存跨重启持久化（手写编解码）


• fix(read): 段评发布协程吞掉取消异常，弹窗销毁后触碰 binding 崩溃


• fix(read): onCancelSelect 改块体，避免返回类型推断成 Boolean（修编译）


• perf(read): 段评先显缓存再联网刷新


• fix(read): 选中态下点段评气泡生效，且气泡延后消失


• fix(read): 磁盘缓存 keys 还原为 Int 段落键（修需求1 的编译）


• fix(read): PageView 转发 selectedReviewTarget（修需求2 的编译）


• fix(read): 取选中行改用 getOrNull，避免越界


• fix(read): 段评菜单项默认归入「更多」


• perf(read): 段评统计落盘缓存（3 天 TTL，保留当前章 ±5 章）


• feat(read): 无段评不常显气泡，选中段落临时显示并可经菜单评论


• feat(backup): 备份/恢复包含 Nostr 账号（非敏感字段）


• feat(nostr): 段评事件带 NIP-89 客户端 tag


• build: 提高 Kotlin 守护进程堆到 4G，修复 CI 编译 OOM


• fix(nostr): NIP-46 互操作与健壮性改进 + 规范序列化回归测试


• fix(nostr): NIP-01 规范序列化不再经 org.json，规避 Android 的 / 转义导致 id 不匹配


• fix(nostr): NIP-46 请求事件 id 未转十六进制导致中继无法解析


• fix(nostr): 记录 NIP-46 中继反馈(OK/NOTICE/AUTH/CLOSED)以定位连接失败


• fix: 修复 Nostr 段评协程取消后仍触碰 UI 导致的崩溃


• fix: 修复 NostrRelays 类型推断导致的 release 构建失败,并替换被污染的中继种子


• fix: 修复 NostrRelays.forReading 中 relays(List) 误传给 parse(String) 导致的编译失败


• fix: 登录 Nostr 后可对无评论段落进行首评


• feat: Nostr 中继支持 NIP-11 健康检查自动发现与缓存


• feat: Nostr 中继改为用户配置，二维码配对支持点击复制


• fix: NIP-46 relay 错误诊断与保活，避免只暴露 90 秒超时


• fix: 段评刷新切回主线程，修复打开书籍时的 CalledFromWrongThreadException


• fix: import AppLog in OtherConfigFragment


• fix: handle NIP-46 auth URL challenges


• fix: bypass interceptors for Nostr websockets


• fix: preserve secp256k1 JNI symbols


• 修复音频封面 LiveData lint 错误


• 修复 Map 扩展重复类


• 修复 Nostr 发布编译错误


• 修复 Nostr signer 编译错误


• 修复 Nostr 评论构建错误


• Make Nostr settings easier to find


• Revert "ci(release): fix key.jks"


• ci(release): fix key.jks


• ci(release): 支持任意手动构建分支


• Add Nostr signer and comment publishing


• Verify Nostr event signatures


• Fix cross-source Nostr paragraph matching


• Add read-only Nostr paragraph comments


• docs(迁移): Compose Multiplatform 迁移计划与 Phase 1 成果存档


• refactor(迁移): Phase 1d —— 本地书解析器(Epub/Mobi/Umd/Txt)迁入 shared


• build(迁移): Phase 1e —— epublib fork(modules/book) 转 kotlin-jvm 纯 JVM 模块


• refactor(迁移): Phase 1c-3c-2 —— webBook 在线书籍模型迁入 shared, Phase 1 业务内核 commonMain 化收官


• refactor(迁移): Phase 1c-3c-1 —— 规则编排器 AnalyzeRule/AnalyzeUrl 迁入 shared


• refactor(迁移): Phase 1c-3b —— modules/rhino 转 KMP 模块, CacheManager 迁 shared


• refactor(迁移): Phase 1c-3a —— JsExtensions 拆分纯逻辑/Android 两层


• refactor(迁移): Phase 1c-2 —— Room 实体层迁入 shared commonMain


• refactor(迁移): Phase 1c-1 —— 网络栈与工具类基础设施迁入 shared commonMain


• refactor(迁移): Phase 1b —— 分析解析器族迁入 shared commonMain


• refactor(迁移): Phase 1a —— 规则实体与纯 JVM 异常迁入 shared commonMain


• build: compileSdk 升 37 适配 CMP 1.12, 增加 Termux 本机构建 sqlite-jdbc 强制替换


• feat(迁移): Compose Multiplatform Phase 0 —— 建立 shared KMP 模块并试点迁移关于页

</details>

此版本为测试版，会存在不稳定问题。
### 发布页
### 反馈群组

### 更新内容

* feat: 朗读快捷设置定时
* feat: 滚动翻页时上下边距不对
* feat: 优化分组管理
* feat: 条漫优化
* feat: 朗读系列优化
* fix(read-aloud): 修复运行中控制指令重复请求前台启动导致的超时崩溃
* fix(tts): 修复外部 HTTP 音色兼容与数据一致性

Full Changelog: https://github.com/HapeLee/legado-with-MD3/compare/3.26.16-beta.50...3.26.16-beta.51

### 更新内容
* 修复小米设备阅读自定义字体被系统字重处理替换
* 优化书源QQ登录跳转并修复授权后返回
* 完善书籍编辑顶栏液态玻璃与类型 Dock 亮白底
* 按有效发布记录修正正式版与测试版更新说明
* 补齐 EPUB 惯性滚动并完善中断清理
* 修复 EPUB 朗读翻页时的首屏闪回
* 修复按页朗读切换后的字幕与语音错位
* 修复 EPUB 系统 TTS 跨页和末页跟随
* 优化阅读目录与书签工具栏排版
* 修复手动书籍类型被书架刷新覆盖
* 优化听书小窗大窗口书名与章节排版
* 修复js书源字形库在编辑保存时丢失
* 重构漫画阅读界面
* 重构视频播放界面并修复小窗与续播边界
* 移除首页组件抽屉的关闭按钮
* 修复发现页内容点击无响应
* 修复书源嵌套脚本求值的作用域恢复
* 修复书源缓存清理误删相似地址数据
* 完善订阅源导出分享并修复导出抽屉下拉关闭
* 新增今日书讯自动刷新开关
* 居中显示抽屉背景选项文字

# 阅读 Archive 第十五版

版本：3.26.09242230 · arm64-v8a

• 新增 Minecraft、明日香、诡秘之主、哆啦 A 梦四套阅读主题，以及四周固定、正文滚动的模板。


• 新增可自定义的 EPUB 加载模板，默认「山茶花」，背景覆盖状态栏，适配日夜模式。


• 优化分页、连续翻页和跨章加载，修复引号、反引号等导致的提前跳页和大片留白。


• 优化详情页加载、刷新与简介显示，定时任务入口统一放到「更多」菜单。

完整更新记录

### 更新内容
* 优化工作流文件

### 更新内容
#### 此版本有崩溃bug，该项目不再维护。
* fix：普通朗读模式下按返回可以关闭朗读
* 优化悬浮播放关闭按钮
* 页眉和页脚上下边距最大值从100dp改为200dp
* 封装Compose dialog
* 优化与封装Compose的AppConfirmDialog的dialog
* fix：调试模式改为调试工具
* 文档：补充调试专属日志设计说明
* 文档：修正调试专属日志设计说明中的 putNotSave 描述
* 文档：补充调试专属日志功能实现计划
* 调试日志：新增调试专属日志模式的 PreferKey 常量
* 调试日志：新增 AppConfig.debugLogOnlyCategories 测试
* 调试日志：回滚 AppConfig.debugLogOnlyCategories 测试
* 调试日志：新增 AppConfig 的专属开关和分类配置
* 完善调试专属日志分流与配置入口
* feat：离线缓存界面增加文件大小，字典规则界面增加快速滚动条
* fix：多个界面默认显示快速滚动条
* fix：去除300ms防抖延迟造成文字上下跳动，选择恢复文件界面优化按钮颜色
* fix：选择恢复内容界面优化