Files
MorphDoc/packages/docx-theme-engine
SkyJourney 2c5c1bd317 release: 发布 v0.6.1 DOCX 视觉一致性修复
新增通用 CSS 到 OOXML 翻译修复,统一字体、字距、精确行距、段落、列表、表格、引用、代码块与行内代码连续性,不引入按主题 ID 分支。

新增 MdTP Mono 并统一 Serif、Sans、Mono 三字体包的 Chromium 与 DOCX 使用链;字体声明、嵌入部件和 Word/WPS 实际采用均进入硬门禁。

重建封面整页及正文语义块视觉差分,14 套主题、纵横两个方向、五组页边距共 140 个真实场景全部通过,阻断失败和诊断失败均为零。

源码服务、Docker Web API 与实际安装 Desktop 的 red-briefing 导出均包含 5 个字体部件;Word/WPS 原生渲染和逐页复核通过。修复 Docker 构建上下文与运行层复用软链接,并完善 v0.6.1 版本、发行说明和发布归集。

验证:npm test(116 个文件、616 项测试)、npm run typecheck、npm run build、git diff --check 全部通过。Desktop 安装器与 ZIP、Docker v0.6.1 镜像已生成;Windows 产物仍为未签名内部发行。
2026-08-04 10:30:44 +08:00
..

@md-to-pdf/docx-theme-engine

DOCX 主题映射引擎负责在浏览器主题 CSS 与 Word 样式之间建立稳定、可诊断 的中间协议。

当前阶段包含:

  • 60 个标准 Markdown 与结构化文档语义槽位;
  • 覆盖普通文档、公文、简报、项目报告和标书的标准探针 DOM;
  • Chromium/Electron 计算样式快照协议;
  • 不绑定具体浏览器实现的计算样式采集器;
  • 可安全注入主题 CSS、等待字体并自动清理 iframe 的浏览器运行脚本;
  • 基于主题 CSS SHA-256 指纹的并发合并和 LRU 快照缓存;
  • CSS 长度、颜色、字体、边框和布局值的通用解析器;
  • 60 个语义槽位到 Word 文本、段落、表格、媒体和结构令牌的归一化;
  • 封面最小高度、垂直对齐、轮廓线和隐藏字段语义;
  • 自动映射、显式覆盖和预设降级配置;
  • 样式来源、映射置信度和诊断协议;
  • 旧版 docxStyle.preset 兼容归一化,并自动升级为 auto-with-overrides

本包不负责:

  • 启动 Playwright 或 Electron
  • 读取主题目录或网络资源;
  • 执行 Pandoc
  • 直接修改 OOXML
  • 按主题 ID 维护专属转换分支。

Server Playwright 与 Desktop Electron 适配器负责在现有受限浏览器生命周期 中执行本包脚本;主题 CSS 和字体资源继续使用各平台已有的同源资源协议。 @md-to-pdf/application 已负责指纹、快照缓存和令牌准备, @md-to-pdf/docx-engine 已消费本包令牌生成动态 reference.docx。 Flex、Grid 和超出 Word 上限的装饰边不会静默丢弃,而是保留近似 令牌与诊断,供语义文档结构层选择 Word 表格、分节或段落布局实现。