1实现原理 · 为什么它能做到

分层设计：引擎全部外置到 minimax-skills:minimax-docx（第三方市场插件），本 skill 自称零引擎代码，只带『调试换来的使用知识 + 自研生成器』。

daymade-docs/docx-creator/SKILL.md

Thin incremental layer over **`minimax-skills:minimax-docx`**. Not a document engine.

SKILL.md 直接指示去宿主市场安装路径 (~/.claude/plugins/marketplaces/minimax-skills/skills/minimax-docx/) 读引擎源码；本仓库不含该引擎，其 CLI 行为无法在本 pin 源码内核验。

中文正式文档生成由自带 C# 生成器实现：Program.cs（~260 行 OpenXML + Markdig）把 markdown 解析成 AST 再按 ECMA-376 组装 docx。

daymade-docs/docx-creator/scripts/Program.cs

var mdText = File.ReadAllText(args[0]); var pipeline = new MarkdownPipelineBuilder().UsePipeTables().Build(); var docAst = Markdown.Parse(mdText, pipeline);

用法 `dotnet run -- <in.md> <out.docx>`；csproj 声明 DocumentFormat.OpenXml 3.2.0 + Markdig 1.3.2（net10.0），首次运行需 NuGet 还原。

对齐规则机器可查：含 LineBreakInline（甲方/乙方信息块、签字栏）的段落强制左对齐，其余正文两端对齐——用 inline 树判定而非肉眼。

daymade-docs/docx-creator/SKILL.md

The rule is machine-checkable, so do not eyeball it: if the markdown paragraph's inline tree contains a `LineBreakInline`, left-align that paragraph; otherwise justify it.

ISSUE-004 背景：两端对齐会把多行信息块的每一行（除末行）撑出巨大字间距——中文公文排版最常见的隐性错误。

列表编号正确性靠 OpenXML 语义：每个独立列表拿自己的 NumId + LevelOverride(StartOverrideNumberingValue=1)，复用同一 NumId 会让条款 3 的列表从 4 继续编号。

daymade-docs/docx-creator/SKILL.md

Each independent markdown list must get its **own** `NumId` plus a `LevelOverride` carrying `StartOverrideNumberingValue = 1`. Reuse one `NumId` across clauses and clause 3's list silently continues from 4.

ISSUE-005/006 是 SDK 陷阱（错类名、错元素序）；ISSUE-016 补充 numId=0 即禁用编号的既有 Word 语义。

CJK 字体必须双槽（RunFonts 的 Ascii/HighAnsi/EastAsia），中文加粗切黑体（宋体无真粗体、合成加粗糊字）；尺寸用 OpenXML 半磅。

daymade-docs/docx-creator/SKILL.md

A run must set `RunFonts { Ascii, HighAnsi, EastAsia }`. Setting only the Latin slots leaves Chinese characters to Word's fallback

Program.cs 注释同述：'中文加粗切黑体：宋体没有真粗体字重，渲染器只能算法合成'——这是把 Word 排版机理代码化。

强制视觉验证链：生成→XSD validate（minimax CLI）→LibreOffice headless 转 PDF→pdftoppm 出 PNG→逐页 Read；qlmanage 缩略图被明文禁止（ISSUE-008）。

daymade-docs/docx-creator/SKILL.md

**Banned: `qlmanage` thumbnails as visual proof.** macOS Quick Look renders with a different engine than Word and will happily show a clean-looking page for a document whose info blocks are stretched apart.

验证协议把『每个失败模式』列全（信息块不拉伸/列表从1重启/表格边框/签字栏完整/无孤立分页），还要求装有 Word 时开真 Word 查『兼容性模式』（ISSUE-012：LibreOffice 全绿而真 Word 破版）。

文档路由表把 Word/WPS 稿→PDF、Markdown→PDF 分别导向 word-to-pdf.md 与 pdf-creator，明确禁止把权威 Word 稿绕 markdown 往返。

daymade-docs/docx-creator/SKILL.md

| Existing Word/WPS → repaired layout / selected excerpt → PDF | Keep the Word source; follow `references/word-to-pdf.md` and `references/verification_protocol.md` |

description 开头同样声明了 Word 稿路由；SKILL.md 的 routing 表更细（含 minimax CLI create/管道 B、C 的取舍）。

2核心能力

01markdown → 中文合同级 docx 生成（自研 OpenXML 生成器，甲乙方信息块/签字栏/条款/表格）

02独立列表自动 restart=1、续编保留（NumId/LevelOverride 语义）

03CJK 双槽字体/加粗切黑体/首行缩进（420 twips @10.5pt）等中文排版规则

04A4 页面 + 页脚 PAGE 域页码 + 六边框表格 + tblGrid（ECMA-376 元素顺序纪律）

05经 minimax-docx CLI 的 XSD 结构校验（DOTNET_ROLL_FORWARD=Major，ISSUE-003）

06LibreOffice→PDF→PNG 端到端视觉验证（含失败模式清单与真实 Word 复核）

07已有 Word/WPS 稿→PDF 排版修复/摘录交付流程（word-to-pdf.md，保留 Word 源不往返 markdown）

3外部依赖

Kind	Dependency / Endpoint
cli	dotnet SDK / dotnet run
package	DocumentFormat.OpenXml 3.2.0 + Markdig 1.3.2（NuGet）
cli	minimax-docx 引擎 CLI（第三方市场插件 minimax-skills，XSD 校验）
cli	LibreOffice soffice --headless（验证转 PDF）
cli	poppler pdftoppm（PDF→PNG）
cli	Microsoft Word.app（可选，macOS 兼容模式复核）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: dotnet run（本地编译执行自带 Program.cs）
网络端点: 声明外部网络访问: 首次 dotnet run 经 NuGet 还原 DocumentFormat.OpenXml/Markdig（SKILL/README 明示 ~20
本地工作目录: 文件读写与工件输出: 生成/覆盖用户指定的 out.docx（SKILL 提醒先查 ~$ 锁文件）；cp 生成器到文档旁 _docxgen/；验证产物写 /tmp/docx

审计说明： 。无凭证读取、无数据外发；本地工具链为主。升黄理由：① 运行流程强依赖第三方 minimax-skills 市场插件（其 CLI 行为无法在本 pin 源码核验，属供应链注意面）；② 首次 dotnet run 必需联网 NuGet 还原官方包；③ 会覆盖/生成交付文件。均在可预期范围，无删除/清盘操作。

5第二遍独立确认

[ok] 零引擎代码、能力在 minimax-docx — SKILL.md 自述 'This skill contains zero engine code'；本仓 grep minimax-docx 仅命中路径引用，引擎目录不在仓库内——外置关系属实。
[unlocatable] minimax-docx validate CLI 行为 — CLI 位于宿主 ~/.claude/plugins/marketplaces/minimax-skills/…，不在本 pin 源码内，其 XSD 校验具体行为无法在此核验；SKILL 自身亦承认依赖其安装。
[ok] 自研生成器 Program.cs — File.ReadAllText+Markdown.Parse+OpenXML 组装流程与 csproj 依赖（OpenXml 3.2.0/Markdig 1.3.2/net10.0）属实；对齐/NumId/字体双槽注释在源码中可定位。
[ok] qlmanage 禁令与 ISSUE-008 叙事 — SKILL.md Banned 段与 known_issues.md ISSUE-008 记录一致；verification_protocol.md 亦重申。
[ok] ISSUE-012 真 Word 兼容模式案例 — known_issues.md 含根因（元素顺序/缺 tblGrid 等）与 'LibreOffice 全绿、真 Word 兼容模式' 的复现记录；verification_protocol Step 3a 强制 Word 复核。
[ok] NuGet 首次还原需网络 — SKILL.md quick start 注明 '(first run restores DocumentFormat.OpenXml + Markdig, ~20s)'；scripts/README 依赖表 'NuGet reachable' 行一致。
[ok] 无凭证/无外发代码 — Program.cs/README/引用文件 token 扫描：无 env 密钥、无 requests/urllib、无 curl；网络仅 NuGet 还原。
[ok] 元数据 — GitHub API：MIT / 1385 stars / pushed 2026-09-09T12:33:29Z；本地 HEAD==pin d5c4678。

6结论

把中文正式文书的 Word 机理（信息块对齐、宋体加粗要换黑体、双槽字体、NumId 重启）系统代码化并逐条钉到 ISSUE 记录。

验证链按『渲染器保真度递进』设计：qlmanage→LibreOffice→真 Word，ISSUE-012 证明低保真验证会漏真雷。

ECMA-376 元素顺序纪律内建于构造点，把『Word 兼容模式』这类最难察觉的失败从根上防住。

职责切分诚实：不重复造引擎，把 minimax-docx 当 SDK 用，自己只补引擎缺的生成器与使用知识。

适合： 适合需要生产级中文合同/公文/offer docx 的团队与个人（甲乙方块、条款编号、签字栏、盖章版）；要求宿主已装 minimax-docx、.NET SDK、LibreOffice/poppler，且愿意执行 Read 每页的真实验证链。

不适合： 不适合离线/无 .NET 环境；不适合只要纯文本 Word（该走 minimax CLI create）；不适合 Markdown→PDF（那是 pdf-creator）；不适合把权威 Word 稿转 markdown 再生成（SKILL 明文禁止 round-trip）。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload docx-creator.tar.gz

sha256: 31fc8fead4571a90…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit d5c4678cb5.