Skip to content

Readest Lite v8.18.2 — 第二轮用户反馈 bug 修复

Choose a tag to compare

@cshdotcom cshdotcom released this 05 Sep 08:38
· 69 commits to main since this release

Readest Lite v8.18.2 — 第二轮用户反馈 bug 修复

🐛 关键修复

1. 中文文件名上传报「Invalid fileName」(严重)

用户原话:「人教版】八年级上册(2025秋版)语文电子课本-页面-1 Invalid fileName」

根因:getRemoteBookFilename() 在 local 存储下返回空字符串,cloud path 形如 Readest/Books/ 出现空段。

修复:local 分支也生成 hash/<safe-title>.ext。

2. 下载报「File not found」(严重)

用户原话:「Fundamental-Accessibility-Tests-Basic-Functionality-v2.0.0 File not found」

根因:上传写进 DB 的 fileKey 是 <uid>/Readest/Books/<hash>/,下载请求 fileKey 是 <uid>/Readest/Books/<hash>/<title>.ext,不匹配。

修复:修复 #1 后两侧一致。

3. 站点名称 / 安装应用名称 → Readest Lite

修复:完整覆盖所有用户可见字符串 + 元数据:

  • public/manifest.json
  • app/layout.tsx(含 openGraph / twitter / appleWebApp)
  • o/page.tsx / s/page.tsx
  • SettingsMenu / BookMenu
  • Annotator / ExportMarkdownDialog / ImportAnnotationsDialog
  • BooknoteItem / ShareLanding / commandRegistry

4. 删除服务条款 + 隐私政策

修复:移除 LegalLinks 组件。Lite 自托管无外部 ToS。

5. 删除文章批注点击崩溃 → 优雅降级

修复:BooknoteItem.handleClickItem 用 try/catch 包住 goTo(cfi),导航失败时显示 toast「The highlighted location is no longer available in this book.」。

6. 阅读统计清除功能

修复:

  • 新 API 端点 DELETE /api/usage/stats(需 Bearer auth)
  • 「Danger Zone」分区加「Clear Reading Statistics」按钮
  • 确认弹窗说明删除范围(保留书籍、进度、批注)

7. 翻译 / 词典代理必须登录

已验证:/api/proxy/wiki / /api/proxy/resource / /api/translate/google 全部要求 validateUserAndToken。

8. 设置跨设备同步说明

说明:syncCategories.settings 默认开启,但跨设备同步需要先配置 WebDAV / S3 等云同步 provider。

📦 升级方式

docker compose pull && docker compose up -d

✅ CI 状态

  • ✅ CI workflow: success
  • ✅ Docker Image workflow: success
  • ❌ CodeQL Advanced: pre-existing failure (不阻塞)