feat: 将主题令牌接入 DOCX 动态模板

packages/docx-engine/README.md

@@ -1,8 +1,8 @@
 # @md-to-pdf/docx-engine
 
 纯 Node.js 的 DOCX 模板和 Pandoc 编排核心。当前阶段负责读取固定 Pandoc
-版本的默认 `reference.docx`、验证 ZIP 安全边界，将主题 DOCX 样式声明
-解析为完整样式预设，并生成纸张、页边距、字体、段落、代码、表格、
+版本的默认 `reference.docx`、验证 ZIP 安全边界，将归一化主题令牌和
+兼容样式预设映射为 Word 样式，并生成纸张、页边距、字体、段落、代码、表格、
 页眉、页脚和页码均已映射的动态模板。Pandoc 转换器通过静态 Lua Filter
 将普通图片、Mermaid 和 ECharts 节点替换为受控 PNG，同时保留 Markdown
 正文、标题、列表、表格、代码和公式的可编辑文档结构。
@@ -12,7 +12,9 @@
 - 不依赖 Fastify、Electron 或浏览器 UI；
 - ZIP 使用纯 JavaScript `fflate`；
 - OOXML 使用 `@xmldom/xmldom`，不拼接未经转义的用户 XML；
-- 不解析任意主题 CSS，主题通过 `docxStyle` 提供受限结构化覆盖；
+- 不解析任意主题 CSS，只消费 `@md-to-pdf/docx-theme-engine` 的受限
+  语义令牌；`docxStyle` 预设在槽位缺失时提供兼容降级；
+- 槽位只映射到稳定的标准或 `Md*` Word 样式，不包含主题 ID 分支；
 - 生成结果会复验全部 XML、包内关系、内容类型、最终节和关键样式；
 - 每次转换使用独立临时目录、隔离 Pandoc data 目录并在 `finally` 清理；
 - 媒体映射检查顺序、PNG、像素、单图/总大小和物理显示尺寸；
@@ -37,6 +39,7 @@ 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
 ```
 
 `verify:docx-reference` 要求本机 `PATH` 中存在 Pandoc 3.9.0.2，也可以通过
@@ -51,3 +54,8 @@ npm run verify:docx-acceptance
 `output/docx-acceptance/`，供 Word/WPS 互操作验收使用。根级命令还会
 依次执行动态模板、媒体转换、Server HTTP 和 Desktop 原生保存验收；
 仅需重跑三配置矩阵时可使用 `npm run verify:docx-matrix`。
+
+`verify:docx-theme-styles` 使用 Playwright 与 Electron 分别采集 14 套
+内置主题的 56 个槽位，检查跨引擎令牌一致性，并使用固定 Pandoc 默认
+模板生成 14 份动态 `reference.docx`。模板矩阵检查标准 Markdown 样式、
+结构化 `Md*` 样式、正文字体、字号、字体表和缓存指纹。