Repository navigation
v0.1.16
🗂 修复: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