zhaohui-yang 公文 docx 导出
把已成稿的中文公文 Markdown 渲染成符合机关版式的 .docx。这是「版式渲染」能力，不起草内容——起草走根目录「公文写作」skill，本 skill 只在 Markdown 结构正确后做导出与版式调整。
与「公文写作」共用同一份 prompts/ 主源（字体方案、版式方案、文种绑定），不复制规则。
文件索引
src/scripts/generate_docx.py # 导出器主入口（CLI）
src/scripts/install_fonts.sh # 安装 assets/fonts/ 下字体到系统
src/scripts/download_fonts.sh # 拉取开源替代字体
prompts/font-profiles/*.toml # 字体方案（标题/正文/层级字体字号）
prompts/layout-profiles/*.toml # 版式方案（固定行距、各段后距、首行缩进）
prompts/doc-types/<id>-<文种>/meta.toml # 文种 → font_profile / layout_profile 绑定
assets/fonts/catalog.toml # 字体族 → assets/fonts/ 具体文件映射
docs/references/font-usage.md # 字体速查、导出已知坑、自检命令（面向读者）
docs/references/layout-rules.md # 版式规范、已自动化/未自动化清单、页边距
调用方式
- 先确认 Markdown 结构正确（标题、主送单位、正文、落款、附注、附件等用
##分块）。 - 按文种自动套字体与版式：
--doc-type <文种>（中文别名或英文 ID 均可），脚本据meta.toml解析font_profile/layout_profile。 - 或手动指定：
--font-preset、--title-font、--body-font等槽位。 - 导出前可用
--show-font-plan/--show-layout-plan预览实际落到的字体、字号、版式参数。
python3 src/scripts/generate_docx.py 成稿.md -o 成稿.docx --doc-type 通知
python3 src/scripts/generate_docx.py --doc-type 报告 --show-font-plan # 预览不导出
默认版式（主源）
- 页边距：按 GB/T 9704-2012，上 37mm、下 35mm、左 28mm、右 26mm（版心 156mm×225mm；常量真身在
src/docgen/constants.py的MARGIN_*_TWIPS，经src/scripts/generate_docx.py再导出）。 - 行距、各段后距、首行缩进：由文种绑定的
prompts/layout-profiles/*.toml决定，不在文档里重复硬编码数值。 - 标题/正文/层级字体字号：由
prompts/font-profiles/*.toml+assets/fonts/catalog.toml决定。 - 调整版式优先改对应
*.toml主源；只在一次性需求时用 CLI 覆盖。
已知坑（症状 / 成因 / 对策）
- 换机器字体变样：脚本只写字体名、不嵌入
.ttf；目标机器先bash src/scripts/install_fonts.sh，锁定视觉时导出 PDF。 - 图片没出现：仅支持本地
png/jpg/jpeg，用独立成块，优先放附件/附图/附录。 - 首页无页脚页码：预期行为（自第二页起显示）；完全不要页码加
--hide-page-number。 - 页脚灰底：是编辑器“域底纹”显示，非文档底纹。
更完整的字体速查与命令见 docs/references/font-usage.md，版式规范见 docs/references/layout-rules.md。
边界
- 不在自动化范围：机关红头套版、印章压成文日期、完整套红线——仍需用本单位 Word 模板做最后核定。
- 改字体/版式后若涉及
*.toml主源，跑python3 src/adapters/skill/build.py --check确认产物同步。