面向 Windows 笔记本电脑、触控设备和 Android 手机/平板的本地优先手写笔记应用。
- 保存引擎 2.0：每次保存带修订号和事务 ID，临时文件经过 SHA-256 与反序列化验证后再替换，异常中断可依据本地保存日志恢复。
- 笔刷手感 3.0：压力曲线、圆头/椭圆头/扁头、笔尖角度、稳定器、最多 40 ms 轨迹预测、轨迹简化和确定性铅笔颗粒；Windows 支持自定义笔刷收藏与管理。
- 搜索与学习工作流：标题、OCR、手写识别、PDF 文本、文字对象和评论统一离线搜索；PDF 支持按词/按行标注与 XFDF 导入导出。
- 双画布与录音编辑：Windows 可在双画布中编辑笔迹，Android 手机使用参考卡、平板并排编辑；PCM WAV 支持实际裁剪、首次备份、静音检测和区间波形预览。
- 大型笔记基础：页面指纹、脏页检测、内存预算 LRU 缓存和大型文档统计，为后续虚拟化与低内存模式提供基础。
本轮自动化只验证代码、Windows 后台 UI 与 Android 无头模拟器范围；Android 真机、真实触控笔、OEM 后台策略、发热耗电和真实录音质量仍保持未验证。
PaperNote 把资料库、分页纸张、自然手写和 PDF 批注放在同一个工作区里。无需注册账号，打开应用就能开始记录；笔记默认保存在设备本地，也可以通过 .papernote 文件、导出文件和整库备份在电脑与 Android 设备之间传递。
| ✍️ 自然书写 | 📚 分页整理 | 📄 PDF 批注 |
|---|---|---|
| 钢笔、荧光笔、压力输入、倾角采样、整笔/局部橡皮擦、图层与撤销重做。 | 新建、复制、删除、重命名、缩略图跳转和多种纸张模板。 | 按页码范围异步导入 PDF，离线搜索原文、浏览目录与内部链接、管理批注和评论，并导出或提取指定页面。 |
| 🧩 丰富内容 | 💻 Windows + Android | 🔒 本地优先 |
| 文本、图片、直线、箭头、矩形、圆形、三角形、菱形和星形。 | 桌面端适配鼠标、触控和数位笔；移动端适配手机、平板与触控笔。 | 不要求账号，不包含广告和遥测；Android 客户端不申请网络权限。 |
集中管理最近笔记、搜索结果、回收站和本地文件，让桌面上的资料保持清晰。
在宽屏工作区中同时使用手写、页面管理、文本、图片、形状和 PDF 批注工具；“PDF 学习”面板集中提供文本搜索、目录、内部链接和批注列表。
移动端保留完整的核心书写与学习流程：手机端默认可直接用手指书写，两排固定工具栏显示钢笔、荧光笔、橡皮擦、平移、粗细、颜色、手指开关、撤销和重做；“PDF”菜单提供文本搜索、书签/大纲、内部链接、批注列表、页面批量管理、范围导出和范围提取。应用同时支持触控笔、双指缩放、对象编辑、图层、直线/矩形/椭圆几何规整、混合选区 PNG 分享、本地录音波形与播放笔迹高亮、恢复中心、导入导出和备份。大笔迹页面按当前视口绘制，减少无关笔迹扫描。
- 课堂与自习：按课程建立笔记本，在讲义或 PDF 上直接标记重点。
- 会议与项目：用分页整理讨论记录、草图、流程和后续事项。
- 数位板书写：在 Windows 笔记本或台式机上使用数位笔完成长时间记录。
- 跨设备阅读：把
.papernote文件传到 Android 手机或平板，继续查看和编辑。 - 离线资料管理：不依赖账号或内置云服务，自行决定文件和备份放在哪里。
- Windows 与 Android 共用几何规整：可把接近直线的笔迹吸附到直线或 45° 方向，并识别规整矩形、椭圆。
- 混合套索选中的笔迹、文字、图片和形状可裁剪导出为白底 PNG；Android 通过系统分享保存或发送。
- 混合选区还能保存到本机“个人素材库”，在其他笔记中反复插入；插入后仍是可编辑的标准笔迹、文字、图片和形状。
- Windows 在 WAV 保存后离线分析波形；Android 录音期间直接采集本机麦克风振幅。波形最多保存 2048 个归一化峰值，不依赖网络。
- 回放录音时会按照时间标记高亮当时关联的笔迹，并可从开头、25%、50%、75% 快速跳转。
- 整本识别与校对：当前页或整本运行离线 OCR，保存区域、置信度和待校对状态；套索手写可转文字。
- 高级 PDF 覆盖层：填写文本框、复选框、必填校验、图片签名、测量比例和原文复制，不修改原 PDF。
- 数学与几何：基础文字/手写结果转 LaTeX、公式 SVG 导出，以及长度、角度、平行线、垂线和标尺构造。
- 双画布与参考学习：Windows 可打开独立参考页或双画布笔迹编辑窗口；Android 手机使用可收起参考卡，平板可并排编辑两页。
- 本地扩展与资源包：素材、模板可分类搜索并导入/导出；扩展只允许受限的声明式文字处理，不执行外部代码。
- 精细录音时间轴：移动、重命名或删除时间标记；PCM WAV 可实际裁剪、保留首次备份并检测静音，其他格式使用非破坏播放范围；Android 可选三档录音质量。
| 平台 | 系统要求 | 获取方式 | 安装说明 |
|---|---|---|---|
| Windows | Windows 10/11 x64 | GitHub Releases / Gitee Releases | 下载 Windows 压缩包，解压后运行 PaperNote.Desktop.exe。 |
| Android | Android 7.0（API 24）及以上 | GitHub Releases / Gitee Releases | 推荐下载 Android ZIP，解压后安装其中的 APK；也可直接下载 APK。仅为当前文件来源临时授权“安装未知应用”。 |
正式安装包应从 Releases 页面获取。下载后可结合发布页提供的 SHA-256 校验值确认文件完整性。
Android 的权限、手势、导入导出和卸载前备份说明见 Android 使用指南。
- 笔记默认保存在设备本地，无需创建账户。
- 单个笔记本使用开放归档结构的
.papernote文件。 - Windows 和 Android 共用 PaperInk 墨迹与页面对象模型。
- 支持单笔记导入导出、指定页面提取、带 SHA-256 校验的整库备份与恢复。
- PDF 文本、原目录、内部链接和文字评论与页面一起保存在
.papernote，无需联网。 - 启动时可恢复较新的临时草稿；恢复中心可以另存损坏文件中的可读内容且不覆盖原文件。
- 录音附件与笔记一起留在本地资料库，并纳入整库备份；波形只在本机提取或采样，播放时可高亮关联笔迹。
- 个人素材库只保存在当前设备，可跨本机笔记复用；素材插入笔记后会进入
.papernote，但素材库文件本身不随单个笔记自动迁移。 - Android 应用私有数据会随卸载被系统删除，卸载前请先导出或备份。
- 当前不提供内置云同步；你可以自行使用网盘、数据线或局域网工具传递文件。
| 文档 | 内容 |
|---|---|
| 用户指南 | Windows 与 Android 的资料库、编辑器、页面、PDF、搜索与备份操作 |
| Android 指南 | 安装、权限、手势、文件传递和数据安全 |
| 功能全览 | 当前已经实现的功能与尚未包含的能力 |
| 数据格式 | .papernote、PaperInk、备份格式和跨平台兼容性 |
| Android 构建 | Android 开发环境、编译、签名和设备测试 |
| 发布指南 | Windows 与 Android 安装包的验证和发布流程 |
| 开发路线 | 后续版本方向与优先级 |
| 参与贡献 | 开发约定、提交要求和协作方式 |
从源码构建
- Windows 10/11
- .NET SDK
10.0.302 - 构建 Android 客户端时需要对应的 .NET for Android / MAUI 工作负载与 Android SDK
git clone https://github.com/Jiejie-Tech/PaperNote.git
cd PaperNote
dotnet restore PaperNote.sln
.\scripts\test.ps1 -SkipAndroidRuntime有可用 Android 模拟器或设备时，可运行完整后台验证：
.\scripts\test.ps1生成 Windows 发布包、Android ZIP/APK 和签名文件前，请阅读 发布指南。密钥、密码、真实笔记和构建产物不得提交到仓库。
欢迎提交问题、改进文档或贡献代码。在开始较大的功能改动前，建议先阅读 贡献指南 和 开发路线，并通过 Issue 说明使用场景和预期行为。
如果 PaperNote 对你有帮助，欢迎点亮 Star，让更多需要本地手写笔记的人发现它。
PaperNote 使用 MIT License 开源。第三方组件及字体许可见 THIRD-PARTY-NOTICES.md。
本节是当前离线版本能力边界的统一说明。
- Windows 与 Android 共用 PaperInk、页面对象和格式 21 数据模型；支持压力、倾角、平滑、整笔/局部擦除、透明度、图层、对象组合、锁定、层级和自由形状混合套索。
- 几何工具覆盖直线与 45° 吸附、矩形/椭圆规整、长度测量、可设长度和角度的标尺线、角度辅助线、平行线及垂线构造。
- PDF 支持 200 MB/500 页边界、范围导入、进度/取消/失败续接、SHA-256 缓存、原文与字词坐标提取、搜索/复制、目录、内部链接、评论、批注筛选、页面旋转、范围导出与提取。
- 高级 PDF 覆盖层支持文本填写框、复选框、必填校验、图片/选区签名和测量比例校准；可合并本地笔记本并安全重映射页面、图层、笔迹、对象、链接、目录和录音时间点 ID。
- 本地识别支持当前页与整本批量 OCR、进度/取消、区域/置信度/校对状态保存、选区手写转文字；基础数学规则可生成并编辑 LaTeX，复制公式并导出 SVG。
- Windows 提供独立参考页窗口和可编辑双画布笔迹窗口；Android 手机使用可收起参考卡，平板支持并排双画布编辑。两端均可保存工具栏布局，移动端关键按钮保持至少 48 dp 触控尺寸。
- 个人素材库和共享模板支持分类、搜索、收藏及本地资源包导入/导出；声明式本地扩展只允许受限文字操作，不加载 DLL、不运行脚本或第三方代码。
- 页面录音支持波形、播放/暂停、时间标记、笔迹双向跳转、标记移动/重命名/删除；PCM WAV 可实际裁剪并保留首次备份，其他格式使用非破坏播放范围；Android 另提供省空间、标准、高质量三档录音质量。
- 保存采用临时文件验证后替换；恢复中心、只读损坏检查、历史版本、整库备份格式 3、PNENC2 笔记级密码保护和 PNENC1 兼容均已纳入测试。
- 当前
.papernote内部格式为FormatVersion 21：格式 20 引入动态笔迹和 PDF 原文标注；格式 21 新增保存修订/事务、自定义笔刷、稳定与预测、笔尖及纹理参数。 - 后台回归覆盖 Core、格式 21 往返、PDF/公式/合并/资源包/安全扩展、Windows 隐藏 UI、Android Release 编译、APK 静态检查、18 步运行界面测试，以及 12 轮生命周期恢复与 350 次随机事件压力；整个测试过程不操控用户鼠标。
- 数学识别是基础规则转换，不是成熟公式识别模型；复杂手写公式仍需手动编辑 LaTeX。
- PDF 表单、签名和测量以 PaperNote 页面覆盖层保存，不直接写回原 PDF 的 AcroForm；本地签名是图片签名，不是证书型数字签名。
- PDF 内部链接仅在目标页已导入当前笔记时可跳转；已支持按词/按行选择、复制、高亮、下划线、删除线及 XFDF 批注交换，但不会直接修改原 PDF。
- Windows 录音仍使用系统默认录音设备，Android 提供三档录音质量；PCM WAV 可实际裁剪并保留首次裁剪备份，其他音频格式只保存非破坏播放范围。
- Windows 提供可编辑双画布笔迹窗口并保存主副页面、工具、缩放和位置；Android 手机使用可收起参考卡，平板支持并排双画布编辑。
- 扩展系统只执行声明式文字命令；不会加载不受信任代码。无障碍提供基础语义、键盘焦点和高对比度资源，但未宣称通过完整 WCAG、TalkBack 或 Narrator 专项认证。
- 200 MB/500 页边界、模拟器低内存通知、前后台切换、横竖屏、强制停止恢复和随机事件压力已自动化验证；多品牌真机后台限制、真实触控笔、发热、耗电、超长录音和长期书写仍需真机验证。
- 账号、云同步、联网 AI、遥测、广告、多人协作和在线商店不在本地离线版本范围内。
- APK、ZIP、签名密钥、构建输出和私人笔记属于发布产物或本地数据，不提交到源码仓库。
- 进入后台、窗口停止或销毁时会触发带 10 秒超时保护的安全保存；重复请求会自动合并，避免并发覆盖。
- Android 使用系统原生分区统计判断真实可用空间，避免把仍有数 GB 的设备错误识别为“仅剩几十 MB”。空间确实不足时会在写入临时文件前停止，原笔记不会被覆盖。
- 设置页可执行“立即检查安全保存”、主动导出本地诊断报告或清除诊断记录。诊断默认不记录笔记正文、标题、密码、密钥和私人文件名，也不会联网上传。
- 已通过无人值守模拟器测试：18 步核心操作、12 轮前后台/旋转/进程恢复、低内存通知、350 次随机事件、最终冷启动，未发现 PaperNote 崩溃或 ANR。
- 上述结论只代表模拟器范围；真实品牌设备的后台限制、触控笔、发热、耗电和录音质量仍按路线图继续验证。
.\scripts\test.ps1 -SkipAndroidRuntime
.\scripts\build-release.ps1 -SkipTests
.\scripts\build-android.ps1
.\scripts\test-android.ps1 -SkipBuild -SkipUi
.\scripts\test-android-stability.ps1 -SkipBuild- Windows 与 Android 都可以为单个笔记本启用、更改或关闭密码保护。
- 加密容器为
PNENC2，正文使用 AES-GCM，加密密钥由 PBKDF2-SHA256（210,000 次）从至少 8 个字符的密码派生。 - 密码不会写入设置、笔记文件或日志；退出应用后再次打开需要重新输入，忘记后无法找回。
- 书架标题、文件夹、封面、页数、收藏/置顶和回收站状态保留为可见元数据，但会作为认证数据参与完整性校验；页面、笔迹、PDF 内容和录音信息全部加密。
- 自动保存、历史版本和整库备份均保持加密；历史版本支持跨越“启用保护/更改密码/关闭保护”的状态恢复。
- 文档内部格式为
FormatVersion 21，加密外壳单独版本化为PNENC2；旧PNENC1文件仍可打开。
Windows 与 Android 现已支持本地胶带遮挡、常用元素（重点、疑问、完成、星标、分隔线和公式框）、不写入笔记的激光笔与演示模式。录音期间书写的笔迹可反向跳转到对应时间点。
- 四种本地笔刷：圆珠笔、钢笔、铅笔、马克笔；统一处理压力、速度、倾角和起收笔渐细。
- Android 原生输入已接入智能掌触抑制和触控笔侧键临时橡皮的代码基础；真实设备差异仍需后续实机验收。
- PDF 原文支持按行/按词选择、复制、高亮、下划线和删除线，标注随
.papernote本地保存。 - 套索支持混合选择、同色/同笔刷筛选、对齐、均匀分布、网格吸附和页面参考线吸附。
- 平板支持双页同时编辑；手机使用主画布 + 可收起参考卡，并可切换参考页编辑状态。
- 手写转文字会先按视觉行分组，再逐行调用离线 OCR；不上传笔记内容。
- 手机端无论工具栏布局如何，书写工具、粗细、颜色和撤销/重做始终可访问。
本轮完成了 Core、Windows 编译/预览兼容、Android 编译、静态检查和后台模拟器自动化。普通 Android 真机、真实触控笔压力/倾角/侧键/掌触、厂商后台回收、发热耗电与 TalkBack 专项仍标记为“未实机验证”。