SkyJourneyandClaude Sonnet 5
c4df499680
新增能力：桌面端新增 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
@md-to-pdf/docx-engine
纯 Node.js 的 DOCX 模板和 Pandoc 编排核心。当前阶段负责读取固定 Pandoc
版本的默认 reference.docx、验证 ZIP 安全边界，将归一化主题令牌和
兼容样式预设映射为 Word 样式，并生成纸张、页边距、字体、段落、代码、表格、
页眉、页脚和页码均已映射的动态模板。Pandoc 转换器通过静态 Lua Filter
将普通图片、Mermaid 和 ECharts 节点替换为受控 PNG，同时保留 Markdown
正文、标题、列表、表格、代码和公式的可编辑文档结构。统一语义文档模型
会先转换为主题无关的 Pandoc 结构计划，Lua Filter 再绑定标准 Markdown
样式与 Md* 结构样式；生成后的 OOXML 收口层负责真实分节、封面页眉页脚
隔离、正文页码重启、表格内容区全宽和分页控制。
设计边界
- 不依赖 Fastify、Electron 或浏览器 UI；
- ZIP 使用纯 JavaScript
fflate； - OOXML 使用
@xmldom/xmldom，不拼接未经转义的用户 XML； - 不解析任意主题 CSS，只消费
@md-to-pdf/docx-theme-engine的受限 语义令牌；docxStyle预设在槽位缺失时提供兼容降级； - 槽位只映射到稳定的标准或
Md*Word 样式，不包含主题 ID 分支； - Front Matter 结构、标题策略和分节意图只消费统一语义文档模型，不按 主题 ID 编写转换分支；
- 生成结果会复验全部 XML、包内关系、内容类型、最终节和关键样式；
- 最终 DOCX 必须清除全部内部结构标记，并校验实际样式使用、分节、
SECTIONPAGES、全宽表格和标题去重； - 每次转换使用独立临时目录、隔离 Pandoc data 目录并在
finally清理； - 媒体映射检查顺序、PNG、像素、单图/总大小和物理显示尺寸；
- 并发排队、跨端用例编排和错误协议映射由
@md-to-pdf/application的DocxExportService统一负责。
安全限制
- 输入模板压缩包不超过 2 MiB；
- ZIP 条目不超过 256 个；
- 解压后总大小不超过 64 MiB；
- 拒绝加密、ZIP64、未知压缩方法、重复路径和路径穿越；
- 必须包含文档、样式、字体、编号、设置、关系和内容类型等关键部件。
- 最终 DOCX 不超过 64 MiB、512 个部件和 128 MiB 解压内容。
验证
npm run test -w @md-to-pdf/docx-engine
npm run typecheck -w @md-to-pdf/docx-engine
npm run build -w @md-to-pdf/docx-engine
npm run verify:docx-reference
npm run verify:docx-conversion
npm run verify:docx-acceptance
npm run verify:docx-theme-styles
npm run verify:docx-themes
verify:docx-reference 要求本机 PATH 中存在 Pandoc 3.9.0.2，也可以通过
DOCX_PANDOC_PATH 指定可执行文件。脚本从 Pandoc 读取原始默认模板，
分别验证公文 A4 与自定义横向模板，并在系统临时目录中完成转换和清理，
不会保留用户文档或验收产物。
verify:docx-acceptance 使用综合 Markdown 夹具和固定 Pandoc 生成技术
文档 A4、公文 A4、技术文档 Letter 横向三套 DOCX，自动检查纸张、页边距、
原生段落、标题、编号、表格、链接、脚注、OMML、PNG、页眉页脚、页码、
关键样式和 altChunk 禁用门禁。DOCX 与 JSON 报告写入被 Git 忽略的
output/docx-acceptance/，供 Word/WPS 互操作验收使用。根级命令还会
依次执行动态模板、媒体转换、Server HTTP 和 Desktop 原生保存验收；
仅需重跑三配置矩阵时可使用 npm run verify:docx-matrix。
verify:docx-theme-styles 使用 Playwright 与 Electron 分别采集 14 套
内置主题的 60 个槽位，检查跨引擎令牌一致性，并使用固定 Pandoc 默认
模板生成 14 份动态 reference.docx。模板矩阵检查标准 Markdown 样式、
结构化 Md* 样式、正文字体、字号、字体表和缓存指纹。
根级 verify:docx-themes 会先重新构建运行时并使用 Playwright Chromium
生成本轮真实主题令牌，再以固定 Pandoc 生成 14 份最终 DOCX。矩阵硬门禁
覆盖标准样式、原生页眉页脚、结构字段完整率、封面真实分节、正文页码
重启、SECTIONPAGES、内容区全宽表格、标题去重、内部标记清理和
altChunk 禁用；不会使用陈旧快照或合成令牌降级。