版本与下载

新增：

1. 在图书详情中点击作者姓名，可按该作者筛选书库。

修复：

1. 修复部分 EPUB 因可选字体引用越出出版物目录而无法打开的问题；阅读时仍会阻止不安全的外部访问。
2. 优化首页“继续阅读”的查询，正确显示最近阅读且仍可见的未读完图书。
3. 修复健康检查对已配置书库目录及导入任务处理状态的判断。

新增：

1. 大型书库按图书独立导入。目录仍在扫描时，已发现的图书可以先完成导入；再次扫描只处理变化的文件，减少等待和重复解析。
2. 失败的导入任务可以创建独立的重新导入任务，原任务结果仍可查看；任务列表显示整本图书的导入状态。

修复：

1. 导入中断或部分资源失败时，保留已成功的资源和阅读位置，其他图书仍可继续处理。
2. 减少重复封面处理，漫画页改为按需解析，降低大型导入和浏览时的不必要工作。
3. 修复 SMTP 连接测试与保存设置使用不同请求字段的问题。

修复

• PDF 导入和文件元数据读取现在会合并 Info 与 XMP 标准字段，优先使用有效的 XMP 值；XMP 缺损时保留 Info 中可读取的信息。写回前的元数据预览也显示同一结果。
• PDF 主题词中的正斜杠、反斜杠和中划线现在可拆分为独立标签。已有 PDF 会在重新扫描时更新标签；例如“儿童文学/奇幻/冒险”会显示为三个标签。

升级说明

• 已使用 v1.4.0 基础环境的用户可通过应用内在线更新安装本次修复。更早的基础环境请先升级到 v1.4.0；安装更新时服务会短暂重启。

自动化接入与书库管理

• 新增 MCP 自动化接入与授权管理，可按授权范围查询书库、管理书架和标签、读取或更新元数据，并执行原文件操作。设置页提供授权、动态接入和操作记录，便于管理自动化客户端。
• 支持选择性刷新与写回元数据，保留手动保护的字段；封面引用和文件版本检查减少误写与过期操作。
• Web 书籍详情支持按卷册选择并下载原文件，便于保存需要的内容。

文件操作与恢复

• 改善文件移动、重命名及跨磁盘复制的恢复处理，保留关联文件和书库身份；移动卷册后重新导入，保持完整书籍的归属正确。
• 修复局部扫描对普通文件的更新处理，并同步书库排序。
• 改进文件删除及未完成操作提示；失败信息提供可追踪的原因，便于定位导入、后台处理和自动化操作问题。
• 加强在线更新失败恢复与运行状态反馈，改善启动和更新异常的诊断。

修复与改进

• 新增书籍“加入书架”操作，可以在操作菜单中选择目标书架，将书籍加入已有书架。
• 修复书架选择弹窗中的下拉菜单被遮挡或无法操作的问题，并改善键盘关闭菜单与返回焦点的体验。
• 修复在线更新失败后，遗留的更新请求或失败标记阻止容器正常重启的问题；重启后保留失败信息，便于查看原因并重新准备更新。
• 改善更新准备阶段的失败处理和状态提示，明确区分下载准备、安装与失败状态。

升级说明

• 本次包含容器启动入口修复。请通过容器管理界面升级至 v1.3.1 完整镜像，或通过 fnOS 管理界面升级安装包，以获得更新失败后的重启修复。
• 升级时保留现有数据目录和挂载配置；无需进入容器执行修复命令。仅安装应用内更新包不会替换旧镜像中的固定启动入口。

修复与改进

• 修复在线更新无法识别更新包下载信息而在安装预检阶段失败的问题，允许更新清单增加扩展字段。
• 简化在线更新校验：下载完成和安装前核对文件 SHA-256，不再因环境指纹、Python ABI、声明大小或本地依赖内容差异阻止安装。
• 保留管理员权限、安全解压、停机备份和失败保护；更新成功以服务实际启动并运行目标版本为准，安装日志记录具体阶段及错误码。

升级说明

• 本次更新包含固定安装器修复。现有用户请通过容器管理界面升级至 v1.3.0 完整镜像，或通过 fnOS 管理界面升级安装包，不能仅使用旧版本的应用内更新完成此次修复。
• 升级时保留原有数据目录及挂载配置，无需进入容器执行修复命令。完成本次升级后，后续应用更新将使用简化后的在线更新流程。

修复

• 修复手动识别图书时未先读取本地元数据的问题，优先利用书籍文件中已有的信息，再进行在线查找。
• 修复平铺书库导入时出版物标题被文件名覆盖的问题，保留书籍自身的标题信息。

升级说明

• 已使用 v1.2.0 基础环境的用户可通过应用内在线更新安装本次修复，无需更换容器镜像或 fnOS 安装包。
• 更早的基础环境请先升级到 v1.2.0。更新保留现有数据和登录状态，安装时服务会短暂重启。

新增与改进

• 支持手动调整书库根目录的全局顺序，按自己的习惯组织内容。
• 更新默认封面；识别图书时可预览候选封面，应用识别结果后自动关闭识别面板。
• 改进后台异常记录与展示，便于定位扫描、导入和元数据处理失败的原因，并加强日志中的敏感信息保护。

修复

• 修复扫描缺口恢复、局部扫描范围和任务等待问题，避免无关目录的失败影响其他导入任务。
• 改善启动与后台任务故障隔离，减少元数据恢复、维护任务或 Worker 异常对登录、浏览和阅读的影响。
• 修复更换容器镜像后程序版本未同步的问题；同一镜像普通重启继续保留在线更新后的版本。
• 修复更新过程中将 Worker 启动失败误判为核心服务超时的问题。

升级说明

• 从 v1.1.0 升级请更新 Docker 镜像或 fnOS 应用。本版本包含基础运行环境与容器启动器变更，不支持从 v1.1.0 直接在线升级。
• 保留原有数据目录与图书目录挂载，升级前备份数据库和配置。升级包含数据库迁移，请勿直接切回旧镜像尝试降级。

新增与改进

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

修复与改进

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

升级说明

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