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

docs/PROGRESS.md

@@ -2,6 +2,34 @@
 
 最后更新：2026-08-26
 
+## v0.6.4 环境自适应与 macOS 打包
+
+- `AGENTS.md` 不再硬编码 Windows 绝对路径与强制 PowerShell 语法；会话启动检查改为
+  动态确认仓库根目录，命令语法跟随当前会话实际 Shell。
+- 新增 macOS 桌面打包能力：`electron-builder` 增加独立 `mac` 配置块，产出 `dmg`，
+  按 arm64、x64 分别单独构建、不产出 universal 包；Pandoc 运行时清单新增
+  `darwin/arm64`、`darwin/x64` 两个官方发行项（含独立许可证文件来源，因为 macOS
+  官方 zip 本身不随附许可证文本），`prepare-pandoc-runtime.mjs` 与桌面 Pandoc
+  候选路径均已泛化为按 `--platform`/`--arch` 参数选取目标。
+- 顺手发现并修复两个此前从未在 macOS 全新环境下暴露过的真实 bug：
+  解压内置 Pandoc 时未保留 Unix 可执行权限位（`unzipSync` 不保留压缩包内权限，
+  已补 `chmod 0o755`）；根 `package.json` 的 `build:web-runtime`/`dev`/`desktop:dev`
+  把 `@md-to-pdf/application` 排在其依赖的 `@md-to-pdf/preview-engine` 之前构建，
+  在没有历史 `dist/` 残留的全新环境中会导致类型解析失败，已调整构建顺序。
+- 本机 macOS（Apple Silicon）实测：`npm run package:mac:arm64` 全链路成功，内置
+  darwin-arm64 版 Pandoc 3.9.0.2 完成下载、哈希校验与真实 DOCX 冒烟转换；未打包
+  应用（`--dir`）可正常启动，主/渲染/GPU/网络服务进程均稳定运行，可正常退出。
+  实际截图确认窗口、macOS 原生菜单栏、编辑器工具栏、中文字体与实时预览（标题、
+  任务列表、表格、行内公式、引用块）均渲染正常。
+- 跳过依赖真实语料的 `test:docx-real-world-corpus`、`test:docx-release-gate-suites`
+  后，其余全部工作区测试、全项目类型检查和生产构建均通过；这两步依赖 Git 忽略、
+  需从可信来源单独提供的真实客户文档（`tmp/`），本机没有该目录，留待接入真实
+  语料的机器上执行。
+- 本版本仅完成开发基础设施与验证，未构建正式发行文件：没有产出真实签名的
+  dmg、没有重新构建 Windows 安装包，也没有重新构建 Docker 镜像；下一步是统一
+  DOCX 发布门禁的产出目录规范（版本号动态化，不再写死）并新增清理脚本，随后
+  评估四套 140 门禁矩阵的并行执行策略。
+
 ## v0.6.2 DOCX 发布门禁结论
 
 - 原整批 560 已停用，有效门禁由四套相互独立的 140 组成，未启动、恢复或重建旧 560 流程。