v0.1.29

v0.1.29 更新

修复 Edge TTS 听书第二次起必报错（Cannot read properties of undefined (reading 'voiceLocale')）：

msedge-tts 库 setMetadata(voiceName, outputFormat, metadataOptions) 第三参数未传时，首次朗读因 voiceLocale 未设而短路无碍，但第二次起 voiceLocale 已有值导致短路失效，转而访问 undefined.voiceLocale 抛错。调用处补传空对象 {} 绕过，连续朗读恢复正常。

安装方式

• FnDepot 应用源（推荐）：飞牛 fnOS 安装 FnDepot 后添加应用源 https://github.com/MisiteQ/FnDepot，搜索「惬意阅读」一键升级。
• 手动安装：按 NAS 架构下载下方对应 fpk，飞牛 OS → 应用中心 → 手动安装。

v0.1.28

v0.1.28 更新内容

✨ 新功能：书架封面与作者自动补全

• 内嵌优先：导入书籍后优先提取 EPUB / MOBI / AZW3 / CBZ / CBR / CB7 文件自带的内嵌封面与作者信息
• 联网兜底：TXT 等本身无封面/作者信息的书籍，自动按书名在聚合书源网络搜索（书名严格匹配，避免张冠李戴），命中后下载封面并补全作者
• 只填空缺：作者为「佚名 / 未知」等占位值时才补全，绝不覆盖已有数据，也不修改书名
• 无感处理：打开书架即后台自动处理，补全后即时刷新；书源搜不到则保持原样，不会乱填

安装与升级

• FnDepot 客户端刷新应用源后搜索「惬意阅读」即可一键更新；或在下方按 NAS 架构下载对应 fpk 手动安装
• x86 机型下载 qyread-0.1.28-x86.fpk，arm64 机型下载 qyread-0.1.28-arm.fpk
• 升级不会影响书库与阅读数据；如新增书库目录，请记得在 fnOS 应用中心为书籍路径添加存储空间访问权限

v0.1.27

v0.1.27 更新内容

• 应用介绍新增「请给书籍路径添加权限」重要提示：安装后需到 fnOS 应用中心 → 惬意阅读 → 权限（存储空间访问权限） 中，把书籍所在的文件夹（安装时填写的现有书库路径、应用内新增的书库目录、小说下载目录）逐一添加授权
• 未授权路径会导致书籍无法导入 / 打开、下载与另存失败或书库显示为空；新增书库目录后如遇读写异常，请回到该权限页检查

安装 / 升级

• x86 机型下载 qyread-0.1.27-x86.fpk；arm64 机型下载 qyread-0.1.27-arm.fpk
• 飞牛 fnOS → 应用中心 → 左下角手动安装；已安装用户直接覆盖安装，书库与阅读数据不受影响
• 也可在 FnDepot 应用源刷新后搜索「惬意阅读」一键更新：https://github.com/MisiteQ/FnDepot

v0.1.26

v0.1.26 更新内容

彻底移除已下线的「读后感」与「成就」残留代码，界面无任何变化（功能此前已下线）：

• 后端删除成就路由、读后感接口与相关建表逻辑
• 前端移除「我的」页成就入口、管理中心「成就配置」tab、书籍详情读后感按钮及成就提示弹窗
• 修复启动清理脚本长期静默失败（sqlite3 构造器用法错误 + 未设 busyTimeout 导致旧表从未被删除），旧版本残留的成就 / 读后感数据表在启动后正确清理
• 安装说明与应用描述同步更新

安装 / 升级

• x86 机型下载 qyread-0.1.26-x86.fpk；arm64 机型下载 qyread-0.1.26-arm.fpk
• 飞牛 fnOS → 应用中心 → 左下角手动安装；已安装用户直接覆盖安装，书库与阅读数据不受影响
• 也可在 FnDepot 应用源刷新后搜索「惬意阅读」一键更新：https://github.com/MisiteQ/FnDepot

v0.1.24

v0.1.24 更新内容

本版本包含 v0.1.22 ~ v0.1.24 累计更新：

v0.1.24

• 修复 x86 机型可能因 sqlite3 原生模块为空 / 错架构导致书库数据库打不开：打包时 x86 包同样强制覆盖为预编译 Linux x64 二进制（此前仅 arm 包替换）
• 修复卸载维护脚本 drop-tables 在新版 sqlite3 下加载失败（require('sqlite3').Database 适配）

v0.1.23

• 修复 Node 22 环境下服务启动失败（ERR_INVALID_PACKAGE_CONFIG）：替换含尾随逗号的 ms 包并兜底空 package.json

v0.1.22

• 小说下载新增「代理设置」：下载源管理页可开启 HTTP/HTTPS 代理（如 Clash、V2Ray 本地代理），支持保存与一键连通性测试
• 阅读器悬浮按钮（小说搜索、白噪音）停靠边缘后自动缩进仅露约 6px，悬停 / 点击滑出，不再遮挡正文

安装 / 升级

• x86 机型下载 qyread-0.1.24-x86.fpk；arm64 机型下载 qyread-0.1.24-arm.fpk
• 飞牛 fnOS → 应用中心 → 左下角手动安装；已安装用户直接覆盖安装，书库与阅读数据不受影响
• 也可在 FnDepot 应用源刷新后搜索「惬意阅读」一键更新：https://github.com/MisiteQ/FnDepot

v0.1.21

v0.1.21：修复更新备份失败 + 关于页加宽

修复

• 在线更新「备份当前程序失败：Permission denied」：备份目录从 /vol1/@appcenter/qyread.bak 改放到应用数据目录下。qyread 用户仅拥有应用子目录，没有上级 /vol1/@appcenter/ 的写权限，导致 cp 创建备份目录时被拒。

优化

• 关于页内容加宽：内容容器从 max-w-sm（384px）加宽到 46rem（736px），并自动放宽被 max-w-* 类限制的父级容器，版面更舒展大方。

安装方式

1. 应用源（推荐）：在 fnOS 上安装 FnDepot 客户端，添加应用源 https://github.com/MisiteQ/FnDepot，搜索「惬意阅读」升级
2. 手动安装：按 NAS 架构下载下方 fpk，飞牛 OS → 应用中心 → 左下角「手动安装」

⚠️ 从 v0.1.20 升级到 v0.1.21 需手动安装：v0.1.20 的在线更新存在备份权限 bug，无法通过「立即更新」完成升级。请手动下载 v0.1.21 fpk 安装；安装后后续版本即可正常使用在线更新。

v0.1.20

v0.1.20：小说下载源管理 UI

小说下载界面新增 「下载源设置」 管理页（第三个 tab），可在线管理 go-novel 兼容规则书源。

新增功能

• 浏览全部书源，按分类（普通 / 限流 / 不可搜索 / 代理）显示徽章
• 可视化编辑规则 JSON，含 search / �ook / oc / chapter / crawl 字段格式说明
• 支持 新增 / 编辑 / 删除 / 跨分类移动 书源
• 改动即时写回规则文件，并重建搜索与下载索引

安装方式

1. 应用源（推荐）：在 fnOS 上安装 FnDepot 客户端，添加作者应用源 https://github.com/MisiteQ/FnDepot，搜索「惬意阅读」即可一键安装/升级
2. 手动安装：按 NAS 架构下载下方 fpk，飞牛 OS → 应用中心 → 左下角「手动安装」

安装后请到 应用中心 → 惬意阅读 → 权限 中给书籍所在文件夹授权。

v0.1.19

更新内容

优化「当前已是最新版本」时点击「立即更新」的体验。

界面语义区分升级与重装

• 当前已是最新版本时，按钮文字直接从「立即更新」变为 「重新安装」，悬停提示「重新安装当前版本 vX（修复异常，版本不变）」。
• 确认弹窗不再是容易误导的「将自动下载并安装 vX」，而是明确告知：
  • 当前已是最新版本 vX
  • 将重新安装同一版本（用于修复程序异常）
  • 版本不会变化，安装期间服务会短暂重启
• 面板提示语同步改为「已是最新版本（可点「重新安装」修复异常）」。
• 真正有新版本时，文案仍是「将自动下载并安装 vX（升级）」，两种场景区分清晰。

顺带修复一个潜在隐患：残留旧安装包可能导致误降级

• 旧逻辑只判断 update 目录里「有没有任意 fpk」：如果目录里残留了旧版本安装包，最新版点重新安装时可能直接装回旧版本（意外降级）。
• 现在状态接口返回已下载包的版本号（downloaded_version），前端仅当它与目标版本完全一致才跳过下载，否则自动重新下载正确版本。
• 安装接口新增 expected_version 参数，服务端按版本号精确查找安装包，找不到则明确报错，从两端杜绝装错包。

安装

方式一：FnDepot 应用源（推荐，已更新）

刷新源后搜索「惬意阅读」一键升级。

方式二：手动下载 FPK

• x86：qyread-0.1.19-x86.fpk
• arm64：qyread-0.1.19-arm.fpk

升级保留数据。

v0.1.18

修复内容

本次修复「检查到新版本之后，立即更新、自动更新不管用」的问题。

1. 「立即更新」点不动 → 改为一键更新

• 旧逻辑：必须先点「下载到 NAS」并等下载完成，「立即更新」才会从灰色变亮，很多用户以为按钮坏了。
• 现在：检查到新版本后「立即更新」直接可点，点击后自动完成 下载安装包 → 安装 → 重启服务 全流程，页面实时显示「正在下载…（约 28MB）→ 正在安装… → 服务重启中」，并每 3 秒轮询后台进度，完成后自动刷新页面。
• 全程按钮置灰防重复点击，失败会明确提示原因并恢复按钮。

2. 勾选「自动检查并安装更新」不生效 → 立即执行

• 旧逻辑：定时器每 6 小时才跑一次，勾选动作只保存配置，什么都不会立刻发生。
• 现在：勾选后立即在后台执行 检查 → 下载 → 安装 → 重启，面板实时显示后台阶段（检查中 / 下载中 / 安装中）；服务每次启动 60 秒后也会先自动检查一次，之后保持 6 小时间隔。

3. 更新链路加固

• 手动一键更新与后台自动更新加安装并发锁，杜绝两个安装任务同时写文件。
• 服务自重启改为 bash cmd/main restart 显式调用，多候选路径查找 cmd/main，不再依赖脚本可执行位，父服务退出后重启 shell 仍会完成 stop→start。
• 后台自动更新会复用已下载的同版本安装包，不重复下载。

安装

方式一：FnDepot 应用源（推荐，已更新）

刷新源后搜索「惬意阅读」一键升级。

方式二：手动下载 FPK

• x86：qyread-0.1.18-x86.fpk
• arm64：qyread-0.1.18-arm.fpk

注意：v0.1.16/v0.1.17 的在线更新面板仍是旧逻辑，本次升级建议直接通过 FnDepot 或手动安装 fpk；升到 v0.1.18 后，以后的版本即可直接点「立即更新」一键完成。

v0.1.17

更新内容

• 关于页板块顺序调整：按新的排版，卡片顺序为 简介 → 作者 → 软件更新 → 致谢 → 版权，「软件更新」面板移到致谢卡片之前，更顺手。
• 最新版也能下载：当前已是最新版本时，「下载到 NAS」按钮不再禁用，可随时重新下载当前版本安装包用于重装；提示文案改为「已是最新版本（仍可下载安装包重装）」。
• 下载期间按钮显示「正在下载…」并防止重复点击，失败后自动恢复。

安装

方式一：FnDepot 应用源（推荐，已更新）

刷新源后搜索「惬意阅读」一键升级。

方式二：手动下载 FPK

• x86：qyread-0.1.17-x86.fpk
• arm64：qyread-0.1.17-arm.fpk

升级保留数据。