版本与下载

新增与改进

• 支持在线更新。管理员可在“设置 → 关于”中检查并下载新版本，下载完成后点击“立即更新”，确认后即可安装。

修复与改进

• 优化图片目录和有声书目录导入，减少大量图片或音轨带来的重复处理；新增或修改文件时，复用未变化文件的导入结果。
• 修复临时读取错误或进程中断后，文件没有变化时无法通过书库或目录“继续导入”恢复的问题。已保存的有效结果会继续复用，单个文件失败不会让其他成功文件全部重做。
• 改善扫描对新增、移动、删除文件以及目录元数据和封面变化的处理。目录无法完整读取时保留已有内容，避免把临时访问失败当作文件删除。
• 修复智能书架的筛选和规则编辑。

升级说明

• 升级会自动转换未完成的旧导入任务，保留已有书库、资源、有效资产和阅读进度，无需重建书库。无法确认历史文件处理版本时，再次处理对应资源可能需要进行一次保守重处理。

修复与改进

• 图片目录和 PDF 缺少有效元数据封面时，自动使用首页作为封面。新导入自动生效，已导入资源可使用“重新生成封面”更新，并保留人工封面保护。
• 修复普通 HTTP 环境下 Web 阅读器无法保存原文件的问题，下载完成并通过完整性校验后即可阅读。
• 已缓存的原文件可直接打开，无需重复下载。升级后旧阅读缓存会清理，首次打开时需重新下载。

修复与改进

• 改进 SQLite 并发写入：锁等待与 SQL 执行预算分别计算，导入任务完成写入可重试，避免重复执行已完成的导入工作。
• Docker 部署支持浏览挂载目录，目录选择器展示挂载位置，方便配置书库与目标目录。
• 优化 Android 内容浏览与图书标签编辑，保留启动图标原有颜色；低于 1% 的阅读进度显示为“<1%”，正确保留继续阅读状态。
• 优化 Android 全屏音频播放器的系统栏背景与图标显示。
• 优化 Web 书库新建和编辑表单、中英文布局、扫描开关与识别源设置；移除导入设置中重复的文件管理入口。
• 统一交付 Android APK、fnOS FPK、SHA-256 校验文件及 amd64/arm64 Docker 镜像。Android 沿用正式签名并支持保留数据升级；补充提供 iOS 1.0.2（构建号 3）的 iPhone arm64 Release IPA 及 SHA-256 校验文件，最低支持 iOS 17。IPA 需用户自行签名后安装，不能直接安装；本次补包仅修正两处 Kotlin 导出枚举的 Swift 引用名称，不改变业务逻辑；原 v1.0.2 标签保持不变。尚未完成本次补包的真机安装与运行验收。

修复与改进

• 修复 v1.0.0 发布流程未能生成 fnOS 安装包的问题，统一交付 Android APK、fnOS FPK 和支持 amd64/arm64 的 Docker 镜像。
• 正式发布会核验 APK 与 FPK 的完整性和 SHA-256；附件上传不完整时不会公开 Release，也不会切换稳定镜像标签。
• 修复后端封面能力的依赖接线和导入任务批量写入，保留缺失封面时的空值行为及独立图书识别流程。
• Android 正式版升级到 1.0.1，沿用原正式签名，支持从 v1.0.0 保留数据覆盖升级。iOS 同步源码版本，本次不提供 IPA。

简体中文

二毛图书 v1.0.0 集中完善原生阅读、书库导入、进度同步与日常管理。Web、服务端、Android、iOS 与共享阅读组件统一使用 1.0.0 版本标识。

• 阅读与收听：原生客户端提供电子书、PDF、漫画和有声书入口；改进 TXT 目录及字号调整后的位置恢复、漫画阅读方向切换、音频旋转与章节衔接。阅读器保留原始文件，不持久化转换后的 EPUB 或解包副本。
• 跨设备进度：统一第一方客户端的位置保存与同步，改进首页、详情和播放器的继续阅读展示；活动阅读会话发现远端新位置时提示用户，由用户选择跳转。已读状态与阅读位置分别保存。
• 书库与元数据：按真实目录组织图书与卷册资源，支持平铺和卷册两种书库方式；分阶段导入与元数据识别，改进书名、作者、卷册标题及缺失封面的处理。
• 下载与 Kindle：统一移动端下载、Kindle 列表和管理反馈；支持从整本图书选择可发送资源，并在发送前检查 EPUB/PDF 附件及 50 MB 限制。
• 日常管理：图书和卷册删除只需一次确认，无需输入名称；完善用户管理、OPDS 设置、头像、日志与双语操作反馈。

安装与边界

Android 正式包名为 com.ermao.library，版本为 1.0.0（versionCode 1）；独立测试渠道使用 com.ermao.library.beta，两者需分别登录。请从本版本 Release 附件获取 APK，并核对同名 SHA-256 校验文件。

v1.0 的验收范围为全新安装，不承诺从 0.x 数据库或客户端直接升级；请保留旧数据备份并使用独立应用数据目录。新版客户端发布前，应先部署匹配的后端，特别是卷册源文件删除接口。OPDS 提供目录、搜索与原文件下载，不提供第三方阅读进度同步；有声书不转码，实际解码能力取决于客户端。iOS 版本号同步不代表本次提供 IPA。

2026-09-13，项目负责人确认已完成验收并批准正式发布。此前未完成的候选验收台账已过时并从当前文档中移除。

Android 测试版 / Android Beta

来自 develop 的持续测试版本，可能存在未发现的问题；不代表正式发布或真机验收完成。 Continuous test build from develop. This is not a stable release or a claim of physical-device acceptance.

• 安装下方 APK，可与现有客户端共存；首次需重新登录。后续安装测试版可保留其数据。
• Install the APK below alongside the existing app. Sign in on first use; subsequent beta updates preserve beta app data.
• 包名 / Package: com.ermao.library.beta
• 构建 / Build: 98 (attempt 1); versionCode: 100098
• 提交 / Commit: 3d3f97612fd84d0a4ca6fc46b0981f5976bdc364
• CI: https://github.com/GMD170629/ermao-library/actions/runs/34804014204
• 已通过 / Passed: mobile backend contracts; shared and Android tests/lint; CI emulator smoke/safety checks; beta package and signature verification.
• SHA-256 (ermao-library-1.0.2-beta.98-3d3f9761-r1.apk): f845910fee0226d4faf0f48ce1edc5be64d527245260226c31d4e2f5999c1e73

下载 APK 及对应 .sha256 文件以校验完整性。Download the APK and matching .sha256 file to verify integrity.

简体中文

本版本修复了大书库启动时分类索引重建长时间占用 SQLite 写锁、导致正常查询或写入请求等待的问题。后台维护现在以最多 25 本为一批进行集合处理，优先让正常请求取得写锁；发生竞争时会快速退让并自动重试，不会丢失待处理状态。

索引重建同时改为批量读取和集合写入，显著减少数据库语句数量，并在并发元数据修改时跳过旧快照，避免旧索引覆盖新内容。重建过程保持分批提交、失败回滚、断点续跑及作品更新时间不变。

本版本还包含原生移动端界面对系统导航与原生控件的迁移，改进书库、书架、导入和服务器连接界面的平台一致性。

简体中文

本修复版本解决了 EPUB 阅读器长按方向键翻页后，松开按键仍会持续翻页的问题。键盘自动重复现在会与实际翻页完成速度保持同步，松键后不会继续执行积压的翻页操作，同时仍保留长按连续翻页能力。

修复同时覆盖 EPUB 内嵌正文与阅读器外层界面的键盘输入路径，并保持左右方向、从右向左阅读、Page Up/Page Down、空格键和首尾跳转等既有导航行为。

简体中文

本修复版本优化了大规模书库的浏览与筛选性能。智能筛选的作者、标签和丛书候选项改为有界的按需搜索，并支持可恢复的后台索引维护；书库列表与书架接口使用更轻量的查询和聚合结果，减少加载大型书库时的数据库与网络开销。

书库界面现在可在封面上显示阅读进度，作者、出版社、标签和丛书可直接带入筛选，作品详情补全文件大小、页数、章节数、时长和卷册数等汇总信息。进入并返回作品详情时会保留原有查询，继续阅读和书架数据也会更准确地选择可读卷册。

导入流程缩短了数据库事务范围，并改进文件处理进度、任务恢复和并发处理，降低导入期间的数据库占用。部署文档也补充了数据目录、权限、备份、反向代理和受支持格式说明。

开发中的原生移动端完善了服务器连接与账号会话、书库首页、书架和导入基础流程，并修正顶部与底部导航、大字体布局、继续阅读卡片和无障碍状态。原生阅读器仍在开发中。