release: 发布 v0.6.4 环境自适应与 macOS 打包

新增能力：桌面端新增 macOS 打包支持，electron-builder 增加独立 mac 配置块，
产出 dmg，按 arm64、x64 分别单独构建、不产出 universal 包；Pandoc 运行时清单
新增 darwin/arm64、darwin/x64 两个官方发行项（含独立许可证文件来源），桌面
Pandoc 候选路径与 prepare-pandoc-runtime.mjs 均已泛化为按 --platform/--arch
参数选取目标，不再只认 Windows x64。AGENTS.md 不再硬编码 Windows 绝对路径与
强制 PowerShell 语法，改为按当前 Shell 与仓库实际位置自适应。

问题修复：修复解压内置 Pandoc 时未保留 Unix 可执行权限位的问题（unzipSync
不保留压缩包内权限，已补 chmod 0o755）；修复根 package.json 中
build:web-runtime/dev/desktop:dev 三个脚本的构建顺序错误
（@md-to-pdf/application 被排在其依赖的 @md-to-pdf/preview-engine 之前，在
没有历史 dist 残留的全新环境中会导致类型解析失败）；修正
packages/docx-engine/tests/pandoc-runtime.test.ts 与
apps/desktop/tests/markdown-file.test.ts 中依赖宿主 OS 或路径分隔符的测试
断言，避免这些用例只能在特定平台上通过。

验证结果：docx-engine 包 93 项测试、desktop 包 62 项测试（61 通过 + 1 项
Windows 专属用例按预期跳过）均通过；全项目类型检查、生产构建通过，
git diff --check 无空白错误。跳过依赖 Git 忽略的真实客户文档语料（tmp/）的
test:docx-real-world-corpus 与 test:docx-release-gate-suites 后，其余全部
工作区测试均通过；这两步需要接入真实语料的机器上单独执行。本机 macOS
（Apple Silicon）实测 npm run package:mac:arm64 全链路成功，内置 Pandoc
3.9.0.2 完成下载、哈希校验与真实 DOCX 冒烟转换；实际截图确认窗口、macOS
原生菜单栏、编辑器工具栏、中文字体与实时预览渲染正常。

兼容与部署：版本统一为 0.6.4。本版本仅完成开发基础设施与验证，未构建正式
发行文件：没有产出真实签名的 dmg、没有重新构建 Windows 安装包，也没有重新
构建 Docker 镜像；正式 macOS 发行产物与 Windows/Docker 同步验证留待 DOCX
发布门禁阶段完成后一并发布。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K5N6pcbjV4jVfXrcH3NcLP

CHANGELOG.md

@@ -13,6 +13,52 @@ Gitea Release 页面正文的基础；构建产物、校验和及详细验收记
 
 - 暂无。
 
+## [0.6.4] - 2026-08-26
+
+### 新增
+
+- 桌面端新增 macOS 打包能力：`electron-builder` 增加独立 `mac` 配置块，产出
+  `dmg`，按 arm64、x64 分别单独构建，不产出 universal 包（内置完整
+  Chromium/Electron 与固定版本 Pandoc，合并双架构会让单包体积翻倍）。
+- Pandoc 运行时清单新增 `darwin/arm64`、`darwin/x64` 两个官方发行项及独立
+  许可证文件来源（macOS 官方 zip 本身不随附许可证文本）；桌面 Pandoc 候选
+  路径与 `prepare-pandoc-runtime.mjs` 均已泛化为按 `--platform`/`--arch`
+  参数选取目标，不再只认 Windows x64。
+
+### 修复
+
+- 修复 `apps/desktop/scripts/prepare-pandoc-runtime.mjs` 解压内置 Pandoc 时
+  未保留 Unix 可执行权限位的问题（`unzipSync` 不保留压缩包内的权限信息），
+  macOS/Linux 上解压出的二进制此前无法直接执行。
+- 修复根 `package.json` 中 `build:web-runtime`、`dev`、`desktop:dev` 三个
+  脚本的构建顺序错误：`@md-to-pdf/application` 依赖
+  `@md-to-pdf/preview-engine`，但被排在其构建之前，在没有历史 `dist/`
+  残留的全新环境（如全新克隆 + 全新 `npm install`）中会导致类型解析失败。
+- 修正 `AGENTS.md` 中硬编码的 Windows 绝对路径与强制 PowerShell 语法，改为
+  按当前 Shell 与仓库实际位置自适应。
+- 修正测试用例 `packages/docx-engine/tests/pandoc-runtime.test.ts` 中硬编码
+  反斜杠路径分隔符的断言，避免该测试仅能在 Windows 宿主上通过。
+
+### 验证
+
+- `docx-engine` 包 15 个测试文件、93 项测试通过；类型检查通过。
+- 本机 macOS（Apple Silicon）实测：`npm run package:mac:arm64` 全链路成功，
+  内置 darwin-arm64 版 Pandoc 3.9.0.2 完成下载、哈希校验与真实 DOCX 冒烟
+  转换；未打包应用（`--dir`）可正常启动，主进程/渲染进程/GPU 进程/网络
+  服务进程均稳定运行，AppleScript 可正常触发退出。实际截图确认窗口、
+  macOS 原生菜单栏、Markdown 编辑器工具栏、中文字体与实时预览（标题、
+  任务列表、表格、行内公式、引用块）均渲染正常。
+- 补跑跳过真实语料依赖的全部工作区测试与全项目类型检查、生产构建均
+  通过；`test:docx-real-world-corpus` 与 `test:docx-release-gate-suites`
+  依赖 Git 忽略的真实客户文档语料（`tmp/`），本机没有该目录，这两步
+  在当前环境下无法验证，留待接入真实语料的机器上执行。
+
+### 兼容与部署
+
+- 本版本仅完成开发基础设施与验证，未构建正式发行文件：没有产出真实签名
+  的 dmg、没有重新构建 Windows 安装包，也没有重新构建 Docker 镜像；正式
+  macOS 发行产物、Windows/Docker 同步验证留待后续门禁阶段完成后一并发布。
+
 ## [0.6.2] - 2026-08-26
 
 ### 修复
@@ -221,7 +267,8 @@ Gitea Release 页面正文的基础；构建产物、校验和及详细验收记
 - 支持真实分页预览、固定 Chromium PDF 导出和 PDF 精确预览。
 - 支持长文档分页、页码导航、滚动同步以及 AIO Docker 容器部署。
 
-[Unreleased]: https://gitea.rk-health.com/yixiong/MorphDoc/compare/v0.6.2...main
+[Unreleased]: https://gitea.rk-health.com/yixiong/MorphDoc/compare/v0.6.4...main
+[0.6.4]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.6.4
 [0.6.2]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.6.2
 [0.6.1]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.6.1
 [0.6.0]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.6.0