Skip to content

v0.1.16

Choose a tag to compare

@github-actions github-actions released this 02 Oct 06:29
· 2 commits to master since this release

🗂 修复:APK 里「最近文件」必定报「找不到该文件,请重新打开」

安卓 APK 走 <input type=file> 打开文件,拿不到 FileSystemFileHandle,而「最近文件」原本靠句柄持久化重开 —— 在 APK 里等于没有句柄,于是:

  • 点最近文件必定提示「找不到该文件,请重新打开」;
  • 卡片永远挂着「需重新打开」角标,缩略图/摘要也不渲染(拿不到 handle 就提前 return)。

修复方式:把打开过的文件缓存在本机

  • 打开文件时顺带把内容存进 IndexedDB(不 await,不会拖慢打开;单文件 >64 MB 不缓存),最近文件直接从缓存重开;
  • 保存后同步刷新缓存,避免「保存后重开最近文件看到保存前的旧内容」;
  • 缓存命中时不再标「需重新打开」,缩略图与 Markdown 摘要照常显示;缓存真的没了才提示重新选择。

新增「清除本地缓存」(设置 → 本地缓存)

  • 显示占用:N 个文件 · X MB,一键清除并提示释放量;空缓存时按钮禁用;
  • 只清这份内容副本,不动批注(ann-data)、句柄与已保存到 Download/Note Studio/ 的文件;
  • 上限:单文件 64 MB、合计 256 MB,超出按最近使用淘汰最旧的。

实现细节(性能相关的设计约束)

元数据与文件实体分两张表存放(file-blob-meta / file-blobs):统计用量、LRU 淘汰、存在性检查都只碰元数据表。若混在一张表里,每次写入触发的淘汰会把上百 MB 的 blob 实体全部读出来,手机上会直接卡住。

验证

  • npm run verify:file-cache:IDB mock 下逐项断言写入/读取/统计、超大文件跳过并清同名旧缓存、实体丢失时清掉假缓存、总量淘汰顺序、最近打开优先保留、清除释放量、两表记录数始终一致(10 组断言全过);
  • 浏览器实测:APP 正常启动,设置面板「本地缓存」区渲染正确、空缓存时按钮为禁用态。

产物说明

  • app-debug.apk — debug 签名,直接安装即用
  • app-release-unsigned.apk — 未签名,需自行 apksigner 签名后安装
  • Note-Studio-0.1.16-Windows.exe — Windows 便携版

⚠️ 三个产物均为本机构建,包含被 .gitignore 排除的 PDF 工作室运行时(dart-pdf-editor / open-pdf-studio);CI 干净 checkout 构建不出这些目录,同名覆盖了 CI 上传的缺运行时版本。

Full Changelog: v0.1.15...v0.1.16

Full Changelog: v0.1.15...v0.1.16