公文排版转换器GitTOU/dsh-tool-gbt9704

dsh-tool-gbt9704

面向模型的 gbt9704_convert 工具：将 Markdown（.md）或 Word（.docx）源文件重新排版为符合 GB/T 9704-2012 党政机关公文格式的正文版式，并输出为新的 .docx。

该转换器是自包含的：它使用 Node 的 fs 读取源文件，通过共享文档模型（Markdown 使用 mdast，现有 .docx 文件使用 OOXML 提取器）解析，将模型渲染到手写构建的 OOXML 文档上（通过 fflate 构建的最小 .docx 容器），并写出输出文件。它不注册任何服务，也不保存任何状态；一次调用就是纯粹的路径输入/路径输出转换。

应用的版式（GB/T 9704-2012 正文规则）

| 元素 | 规则 |
|---|---|
| 纸张 | A4 210 mm × 297 mm |
| 页边距 | 天头 37、订口 28、地脚 35、翻口 26 mm → 版心 156 mm × 225 mm |
| 正文 | 三号仿宋_GB2312（16 pt），两端对齐，首行缩进两字符 |
| 网格 | 每页 22 行，每行 28 字，固定行距 28.95 pt（579 twips） |
| 标题 | 二号小标宋（22 pt），居中，后空两行 |
| 层次标题 | 一、黑体 / （一）楷体_GB2312 / 1. 和 （1）仿宋，首行缩进 |
| 主送机关 | 顶格，以全角冒号结尾，正文前空一行 |
| 署名/成文日期 | 右对齐；日期的首字位于署名首字右侧两字符处（右缩进根据两者长度计算，依据 §7.3.5.2） |
| 页码 | 四号宋体“—1—”，奇数页右空一字，偶数页左空一字（evenAndOddHeaders） |

所有值都是 Config 字段，并采用该标准的默认值；部署时可以从 cordis.yml 覆盖字体、字号、页边距或行距。

书写约定（约定位置解析）

该工具不需要元数据块；它按位置读取文档：

- 第一个标题（或当源文件没有标题时的第一个短段落）是标题。
- 以 一、 / （一） / 1. / （1） 开头的行会成为四个层次标题级别，无论 Markdown 标题深度如何。
- 第一个以全角冒号结尾的短段落是主送机关。
- 最后两段是发文机关署名和成文日期，当最后一段匹配日期形式（2024年1月5日 或 二〇二四年一月五日）时。
- GFM 表格、有序/无序列表项、代码行、块引用和 PNG/JPEG 图像分别转换为表格、正文段落、正文段落、正文段落和居中图像。

配置

所有字段都是可选的；适用该标准的默认值。src/index.ts 中的 z schema。

| 键 | 默认值 | 含义 |
|---|---|---|
| bodyFont | 仿宋_GB2312 | 正文/主送机关/三级四级标题字体 |
| titleFont | 方正小标宋简体 | 标题字体 |
| heading1Font | 黑体 | 一级标题字体 |
| heading2Font | 楷体_GB2312 | 二级标题字体 |
| latinFont | Times New Roman | 拉丁/数字字体 |
| pageNumberFont | 宋体 | 页码字体 |
| bodySizePt / titleSizePt / pageNumberSizePt | 16 / 22 / 14 | 字号（磅） |
| linePitchTwips | 579 | 固定行距（twips） |
| topMarginMm / leftMarginMm / bottomMarginMm / rightMarginMm | 37 / 28 / 35 / 26 | 页边距（mm） |

模型体验

请求上下文与条件

模型看到的内容
该工具的完整描述加上标准的版式摘要；模型提供源路径和可选覆盖项。描述逐字固定了转换约定，使模型知道哪些 Markdown 形式映射到哪些公文要素。

Token 影响

一个工具描述，固定不变；无数据依赖的提示增长。面向模型的结果是一段简短摘要（输出路径、检测到的标题、块计数、警告）。

KV 缓存影响

工具描述是稳定的前缀；它不会使缓存复用失效。结果因调用而异，但属于结果轮次内容，而非请求上下文。

已知限制与推迟的工作

- Docx→docx 保真度 — 读取器仅提取段落/表格文本和图像；复杂的 Word 特性（页眉/页脚、批注、修订、图表、文本框、逐 run 字体）不会带入重建的文档。用它来规范化普通公文，而不是对任意 Word 文件进行往返转换。
- 图像 — 仅嵌入 PNG 和 JPEG；行内（段落中间）图像和表格单元格内的图像会被丢弃。Markdown 中的远程 http(s) 图像 URL 会作为警告报告。
- 红头和版记 — 版头（发文机关标志、发文字号、红色分隔线、份号/密级）和版记（抄送/印发机关、分隔线）不在范围内；转换器生成主体版式以及页码。
- 字体可用性 — 仿宋_GB2312、方正小标宋简体 和 楷体_GB2312 在 Windows 公文部署中很常见，但在其他地方可能缺失；Word 在打开时会替换字体。当部署标准化为不同名称时，可通过 Config 覆盖。
- 无沙箱中介 — 该工具自行执行 fs 读写，不经过 ctx.fs 服务，因此其写入不会被记录为 agent 观察到的文件状态，也不受文件系统沙箱限制。面向模型的文件变更工具仍是沙箱路径；此工具是专用转换器。