MathNotes macOS 0.3.7 Preview

MathNotes macOS 0.3.7

面向 Apple silicon Mac 的原生预览版，内置 PWA 0.3.4、笔记 Core 和 Node 运行时。日常本机笔记与手机连接不需要 Windows 电脑在线。本次只发布 Mac 安装包；已有 Windows、Android 和独立 PWA 发行版保持不变。

0.3.7 更新

• 分享包文件选择框改为异步打开，等待 Notebooks 窗口关闭后挂到发起操作的工作区窗口，消除关闭动画与阻塞式文件对话框重叠的调用方式。
• 修复 Mac 压缩文件夹后 ZIP 未设置 UTF-8 标志时中文文件名乱码、图片缺失的问题。
• 按文件扩展名与文件夹分别筛选，不依赖 ZIP/Markdown 的系统类型识别；支持直接拖入 ZIP 或分享文件夹到主界面。
• 导入识别 Windows 默认导出的 <!-- block:id=… source=… --> 标记，恢复独立内容块、原顺序、有效块 ID 和来源；分隔注释不再作为正文显示。
• Mac 分享 ZIP 导出保留块标记，支持分块结构再次导入；图片仍随包保留。
• 代码示例、数学公式、引用里的类似标记不会被误拆。Windows 合并后的续接块未记录内部切分位置时，保留合并正文并明确提示，不强行拆坏公式或表格。

没有块标记的旧分享包只能保留为完整正文；导出文件未携带的锁定状态、编辑历史等信息无法从 Markdown 恢复。分享包格式仍是 Markdown + assets，正文 8 MB、单资源 64 MB、总包 256 MB。Windows GUI 的带资源分享包回导和真实跨机同步仍待后续实现/验收；本轮不修改 Windows/Android 界面。

已包含的主要功能

• 修复手机连接后台启动失败和局域网 HTTP 连接；首次连接手机时可自动准备缺少的接收位置。
• 修复连续预览一直加载；支持公式渲染、Notebook/Session 悬停预览、单击打开和块标题原始图片/PDF 预览。
• 紧凑侧栏和创建入口；AI 对话、阅读与展开按钮浮在正文上方，不再占据整行。
• Notebook/Session 右键重命名、移至废纸篓与恢复。
• 固定选区按原文字顺序拆成前段、固定块、后段，保持连续公式和表格的渲染。
• AI 修改单个块或整个 Session 的候选方案、差异与修改摘要；固定块由程序保护，另外列出未应用的建议。
• 识别结果可内嵌本次原图；源码/预览双向定位、阅读位置恢复、⌘F 查找替换与撤销。
• 内置最新 PWA 0.3.4，保留上传、裁剪旋转、识别预览等功能，并修复手机视口的编辑面板裁切。

安装与验证范围

下载 MathNotes-macOS-native-arm64-0.3.7-…-unsigned.zip，核对同名 SHA-256 文件，解压后将 MathNotes.app 放入 Applications。应用支持声明为 macOS 14 或更新版本；当前实际本机验收为 Apple silicon、macOS 26。Intel Mac 和较早系统尚未实测。

此包使用 ad-hoc 签名，没有 Apple Developer ID 签名或公证。macOS 可能拦截首次打开；确认下载来源和校验和后，可按系统“隐私与安全性”页面提供的“仍要打开”流程处理。无需关闭 Gatekeeper、修改网络或删除钥匙串。更新前建议备份自己的笔记目录。

本机已通过 Core 425 项（另 2 项跳过）、原生合同 99 项、UI 合同 205 项及真实预览回归；用户已确认修复版文件框点选与导入可用。Windows 格式 ZIP 与 Mac 实际压缩 ZIP 均在独立库验证内容块、原图和公式恢复。本机合成库另已验证保存、固定块、AI 候选应用、查找替换和目录恢复；PWA 浏览器上传流程使用受控识别服务验证。真实模型输出质量、不同手机的相机权限及后台行为仍依赖各自环境，不能把合成测试当作所有设备验收通过。

跨 Windows 同步：实验性，尚待真实跨机验证

按主机隔离的 Mac 本地副本、编辑队列、冲突保留、新建/改名/删除/恢复协议已实现。与 Windows PR #39 的实际 Core 代码完成了 23 项跨版本协议测试和 Mac 正式界面的隔离操作验收。

Mac ↔ Windows 的真实跨机写入、断网重连和双方同时编辑尚待验证，本次不作为已验收功能宣传。 当前发布以各电脑独立使用为主。相关代码和复测步骤保留在仓库，今后有需要可以继续开发；详见 Mac 开发与验收状态 和 目录协议。

代码、构建版本及发行资产校验和以本 Release 对应的提交和随附文件为准。