Repository navigation
Releases
v0.1.18 — 修复 APK 打开 PDF 永远卡在「正在打开 PDF…」
🔴 重要:请务必升级到这个版本
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):- 真正执行拼接后的代码,断言 worker 能启动 —— 只做语法检查抓不到这个 bug;
- 断言
polyfills.js的代码以分号结尾; - 断言打包注入语句必须带分号。
验证
- 用旧写法可 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
🐛 修复:打开 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-cache13 组断言全过,其中新增 回归护栏:断言pickFiles里不得把源 File 交给缓存、PDF 视图必须走「打开后缓存」;- APK 产物核验:修复标记与 PDF 编辑器运行时(
main.dart.js/canvaskit.wasm)均在包内。
Full Changelog: v0.1.16...v0.1.17
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
v0.1.15
🐞 修复:旧版 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
📱 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-studioPDF 工作室运行时;这些目录被 .gitignore 排除,CI 干净 checkout 构建不出来,同名覆盖了 CI 上传的缺运行时版本)。
Full Changelog: v0.1.13...v0.1.14
v0.1.13
v0.1.12
v0.1.11
v0.1.10
Note Studio v0.1.9
下载
| 平台 | 文件 | 说明 |
|---|---|---|
| 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纯文本 插入换页符 \fExcel 新建一张工作表 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)改为不入库,缺省不影响构建与主流程。