Skip to content

Releases

v0.1.18 — 修复 APK 打开 PDF 永远卡在「正在打开 PDF…」

Choose a tag to compare

@github-actions github-actions released this 02 Oct 07:55

🔴 重要:请务必升级到这个版本

v0.1.15 ~ v0.1.17 的 APK,打开任何 PDF 都会永远卡在「正在打开 PDF…」(v0.1.16 起表现为不报错、无限等待;v0.1.17 起会报「PDF 打开超时」)。
这是打包配置的 bug,不是你的设备、也不是 WebView 太旧。所有旧 APK 都建议直接卸载重装本版。


根因:worker 注入时漏了一个分号(ASI 陷阱)

打包时会把 src/lib/polyfills.js 原样前置进压缩后的 pdf.js worker 产物,而两段代码的衔接处是:

})()                                  ← polyfills IIFE 结尾,没有分号
(function(){"use strict";var zn={...   ← worker 产物以 "(" 开头

JavaScript 的自动分号插入(ASI)不会在 ( 前补分号,于是两段被粘成一次函数调用:

})(...)(function(){ ... })

关键点:这是合法语法,不报语法错误,所以构建、语法检查、代码审查全都发现不了。真正的后果是 worker 一加载就抛出:

TypeError: (intermediate value)(...) is not a function

它只往 console 打一行错误就静默死掉;pdf.js 因此永远等不到 worker 的 ready 握手,getDocument() 既不 resolve 也不 reject —— 页面就永远停在「正在打开 PDF…」,用户看不到任何原因,只能退出去重开。

桌面版走原生 showOpenFilePicker,不经过这条 worker 注入路径,所以只有 APK 中招,也没有在桌面测试里暴露。

修复

  • 注入时显式补分号:${source}\n;\n,不再依赖源文件的结尾写法;
  • polyfills.js 自身也以 ; 收尾,作为第二道保险;
  • 新增 3 组回归护栏(npm run verify:polyfills):
    1. 真正执行拼接后的代码,断言 worker 能启动 —— 只做语法检查抓不到这个 bug;
    2. 断言 polyfills.js 的代码以分号结尾;
    3. 断言打包注入语句必须带分号。

验证

  • 用旧写法可 1:1 复现浏览器控制台里的原始报错原文,修复后 worker 在真实 Worker 环境中正常发出 ready 握手;
  • 从构建产出的 APK 内部解包核对,衔接处已确认为 })();;
  • npm run verify:polyfills 与 npm run verify:file-cache 全部断言通过。

本版仍包含(v0.1.15 ~ v0.1.17 的修复)

  • Promise.withResolvers 等新 API 在旧 WebView 上缺失导致的「PDF 打开失败」——在主线程与 PDF worker 中双重补齐;
  • 最近文件在 APK 里报「找不到文件」——改为把文件内容缓存进 IndexedDB(元数据与文件实体分表,避免统计/淘汰时读出上百 MB),设置里可查看与清除本地缓存;
  • v0.1.16 的回归:缓存改为「文档打开完成后」才写入,不再和打开动作抢同一个 content:// 源文件;写入串行化;
  • PDF 打开 25 秒看门狗,卡住时给出明确原因而不是无限转圈;
  • 保存/导出改为写入手机的 Download/Note Studio/;返回键先关弹窗再退出;刘海屏安全区与软键盘遮挡;禁用双指缩放与输入框自动放大。

安装

  • app-debug.apk(56 MB,推荐) —— 可直接安装。
    ⚠️ 请认准 56 MB 左右这个体积。CI 自动产出的包只有 8 MB(缺少被 gitignore 的 PDF 编辑器运行时,装了必然打不开 PDF),本 Release 的资产已用完整本机构建覆盖,但你若在别处看到 8 MB 的包请不要下载。
  • app-release-unsigned.apk(49 MB)—— 未签名,需自行签名后安装。
  • Note-Studio-0.1.18-Windows.exe(305 MB)—— Windows 便携版,双击即用。

v0.1.17

Choose a tag to compare

@github-actions github-actions released this 02 Oct 07:25

🐛 修复:打开 PDF 永远停在「正在打开 PDF…」(v0.1.16 的回归)

现象:APK 里打开 PDF,空白页中间一直显示「正在打开 PDF…」,一直卡着、不报错,只能退出重开。

根因:v0.1.16 为「最近文件能从本地缓存重开」加了文件内容缓存,但把写入放在了选完文件的那一刻(pickFiles 里顺手 putFileBlob(entry.id, file))。安卓里 <input type=file> 选中的文件是 content:// URI 支撑的 blob,应用紧接着要拿同一个 File 去 arrayBuffer() 喂 pdf.js —— 两次读并发抢同一个流,arrayBuffer() 永远不返回;于是 getDocument() 既不 resolve 也不 reject,界面永远停在「正在打开 PDF…」。

桌面浏览器走 showOpenFilePicker(有句柄、根本不走缓存),所以只有 APK 中招。

修法:缓存一律挪到「打开完成之后」,而且不再碰源文件

  • 缓存只吃调用方已经读出来的字节(PDF 用的就是 openPdf 已经读进内存的那份,零额外读盘);
  • 其它格式(docx / md / txt / epub / excel / PDF 文字提取)在文档打开完成之后才延后去读源文件;
  • 所有写入走串行队列,同一时间只落盘一个文件,避免大文件并发写把 WebView 卡住。

顺带修掉「卡住也不报错」这个问题本身

  • pdf.js 加 25 秒看门狗:worker 起不来时不再无限等待,而是明确提示「PDF 打开超时:渲染线程没有响应(可能是这台设备的 WebView 太旧)」;
  • 内嵌编辑器同样加了 25 秒未报到的提示。

测试

  • npm run verify:file-cache 13 组断言全过,其中新增 回归护栏:断言 pickFiles 里不得把源 File 交给缓存、PDF 视图必须走「打开后缓存」;
  • APK 产物核验:修复标记与 PDF 编辑器运行时(main.dart.js / canvaskit.wasm)均在包内。

Full Changelog: v0.1.16...v0.1.17

v0.1.16

Choose a tag to compare

@github-actions github-actions released this 02 Oct 06:29

🗂 修复: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

v0.1.15

Choose a tag to compare

@github-actions github-actions released this 02 Oct 05:46

🐞 修复:旧版 WebView 打开 PDF 直接失败

部分 Android 设备报 「PDF 打开失败:Promise.withResolvers is not a function」,PDF 完全打不开。

原因:pdfjs-dist 4.x 使用了 Promise.withResolvers(ES2024,需要 Chrome 119+),而 Vite 的 build.target 只做语法降级、不会补 API;系统 WebView 版本偏低的机器(Chrome < 119)一打开 PDF 就抛错。

修复:

  • 新增 src/lib/polyfills.js:纯语句 + 全部特性检测(现代浏览器上完全是 no-op),补齐 Promise.withResolvers / any / allSettled / try、Array/String 的 at / findLast / toSorted / toReversed / toSpliced / with、replaceAll、Object.hasOwn / fromEntries / groupBy、Map.groupBy、Set 集合运算、URL.canParse、AbortSignal.timeout、structuredClone
  • main.jsx 最先导入该补丁,确保在 App → pdfEngine → pdfjs 求值前完成打补丁
  • vite.config.js 新增 pdfWorkerPolyfills 插件:把同一份补丁原样前置进 pdfjs 的 worker 产物(worker 是独立线程,主线程补丁到不了它,而 worker 里同样调用了这些 API)——构建日志里 worker 体积 +14.2 kB 就是注入结果
  • 新增 npm run verify:polyfills(tools/verify-polyfills.mjs):先删掉 27 个 API 模拟旧 WebView,再加载补丁逐项断言行为,作为回归守卫

💡 仍建议在设备上更新「Android System WebView」/ Chrome,以获得完整性能与新特性支持。

产物说明

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

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

Full Changelog: v0.1.14...v0.1.15

v0.1.14

Choose a tag to compare

@github-actions github-actions released this 01 Oct 14:46

📱 APK 移动版更新(本次重点)

  • 保存/导出修复:APK 内所有保存(docx / md / txt / EPUB / Excel / PDF 批注)改为直接写入手机 Download/Note Studio/ 目录(同名截断覆盖),保存提示显示落点路径
  • 返回键:安卓返回键先逐层关闭弹窗 / 菜单 / 浮层,全部关闭后才回退或退出应用
  • 刘海屏与软键盘:edge-to-edge 自动适配 + adjustResize + safe-area 兜底,工具栏/输入不再被系统区或输入法遮挡
  • 禁用缩放:APK 内锁定双指捏合、双击放大与输入聚焦自动放大;网页端保持可缩放不受影响

产物说明

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

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

Full Changelog: v0.1.13...v0.1.14

v0.1.13

Choose a tag to compare

@github-actions github-actions released this 19 Sep 13:30

Full Changelog: v0.1.12...v0.1.13

v0.1.12

Choose a tag to compare

@github-actions github-actions released this 19 Sep 09:44

Full Changelog: v0.1.11...v0.1.12

v0.1.11

Choose a tag to compare

@github-actions github-actions released this 19 Sep 08:41

Full Changelog: v0.1.10...v0.1.11

v0.1.10

Choose a tag to compare

@github-actions github-actions released this 19 Sep 08:38

Full Changelog: v0.1.9...v0.1.10

Note Studio v0.1.9

Choose a tag to compare

@github-actions github-actions released this 19 Sep 07:26

下载

平台 文件 说明
Windows Note-Studio-0.1.9-Windows.exe 免安装便携版,双击即用(首次启动略慢)
Android app-debug.apk 调试签名 APK,可直接安装

macOS / Linux 暂无预编译包,源码运行方式见 README。

本版更新

新功能

  • 8 种格式都能「新建一页」,每种都用该格式的原生做法,保存仍走各视图原有流程:

    格式 「新建一页」做了什么
    PDF 追加一页空白页(pdf-lib),随「保存批注到 PDF」写回
    Word (.docx) 插入 Word 原生分页符
    Markdown 插入独立一行 \pagebreak
    纯文本 插入换页符 \f
    Excel 新建一张工作表
    EPUB 新增一个章节(写进 OPF 的 manifest / spine)
    PPT / CAJ / 未知格式 在白板下接一页可批注的空白页
  • 文本框格式栏改为浮层:贴在文本框正下方 10px,不遮挡文本框,不再把文档往下推、也不再触发重新适配缩放;并且只在编辑文本框时出现(仅选中时不显示)。

修复

  • 白板分页数会随批注一起持久化:重开文件不再退回 1 页,落在第 2 页之后的墨迹也不会错位。
  • Word 分页符读取时会被还原成界面上的「新页」标记(mammoth 原本会丢掉它),保存后重开仍在,二次保存不重复、不丢失。
  • Excel 新建的工作表现在是一页可用的空白网格(此前只有 1×1,别的格子点不到、方向键也走不动)。
  • 窄屏(≤1080px)工具栏收起文字标签并允许换行,右侧按钮不再被裁掉点不到。

工程

  • 修 CI:Android APK 之前因为 tag_name 被写死成 v0.1.1,每次都传到旧 Release 上,现在跟着当前 tag 走。
  • 修 CI:android/gradlew 补上可执行位(此前 ./gradlew 直接 Permission denied)。
  • 仓库瘦身:第三方 PDF 编辑器运行时产物(约 115MB)改为不入库,缺省不影响构建与主流程。