微思敦正式公文交付标准规范 · 落实与校对
Purpose
把《【合规部】正式公文交付标准规范》变成可复用的工程能力：给定一份草稿/待发公文（.docx），
能够自动重排为合规格式并产出可量化的合规校验报告，覆盖规范中的页面布局、页眉页脚、
标题层级、正文、表格、附件、署名等全部可量化条款。
When to use
- 用户要「按合规部规范出一份公文」「把这篇文档排成合规格式」「公文交付前校对一下」。
- 触发词：公文规范、公文交付标准、合规部规范、公文格式检查、公文校对、落实公文标准。
- 不适用：纯 PDF/纸质排版微调、与规范无关的自由排版（这些超出本技能范围）。
规范要点（速查，完整条款以《【合规部】正式公文交付标准规范.docx》为准）
| 项目 | 规范值 |
|---|---|
| 页面边距 | 上/下 25mm，左/右 19mm |
| 页眉 | 左上角公司 Logo；中间「内部资料 禁止外传」（小五号宋体）；右上角发文编号「XX部第[XX]号文件20XX」 |
| 页码 | 每页编码，居中，小五号，「第X页/总页数」格式（如 1/4） |
| 主标题 | 小二号、黑体、居中；段前段后各 1 行；行距固定值 36 磅 |
| 标题层级 | 一、（一）、1、（1）…；一/二级顶格，三级首行缩进 2 字符、四级 3 字符 |
| 一级标题 | 四号、黑体、顶格 |
| 二级标题 | 小四号、宋体、顶格 |
| 三级标题 | 五号、宋体、首行缩进 2 字符 |
| 正文 | 五号、宋体、1.5 倍行距、首行缩进 2 字符；英文/数字用 Times New Roman |
| 表格 | 标题居中置于表正上方、空一行；外框粗实线 1.5 磅、内线细实线 0.5 磅；表内五号宋体居中；表序「表1」按插入顺序；附注小五号宋体写在表下 |
| 附件 | 正文下空一行，首行缩进 2 字符写「附件」+全角冒号+名称；多附件用阿拉伯数字顺序号；名称后不加标点 |
| 署名 | 落款部门（如「微思敦合规部」）五号宋体居右；日期「××××年××月××日」五号宋体居右 |
| 交付 | 校对无错漏 → 默认 PDF 外发 + 带公司 Logo 的图片水印 |
单位换算速查（脚本已内置，人工微调时用）
- 1 mm = 56.69 dxa；25 mm ≈ 1417 dxa；19 mm ≈ 1077 dxa
- 两套单位别混（这是早期一个 bug 的根源）：
- dxa（=twips）：用于页边距、缩进、表格宽度。1 pt = 20 dxa；1.5 pt = 30 dxa；0.5 pt = 10 dxa。
- 边框
w:sz：单位是 1/8 磅，不是 dxa！1.5 磅外框 →sz=12；0.5 磅内线 →sz=4。
（早期误写成 sz=30/10，实际是 3.75/1.25 磅，粗了 2.5 倍，已被修正。） - 字号（磅 / OOXML sz 半磅）：小二 18/36，四号 14/28，小四 12/24，五号 10.5/21，小五 9/18
- 首行缩进 2 字符（五号）≈ 21 pt = 420 dxa；行距 1.5 倍 = line 360 / lineRule auto
Capabilities / Workflow
跨平台运行（重点，避免 venv 路径踩坑）
本技能脚本需在 Python 下运行。WorkBuddy 托管 Python 的 venv 在不同系统路径不同：
- Windows：<WB_HOME>/.workbuddy/binaries/python/envs/default/Scripts/python.exe
- macOS / Linux：<WB_HOME>/.workbuddy/binaries/python/envs/default/bin/python
直接硬编码 venv 子路径极易写错（本技能早期在 Windows 上曾误用 bin/python，导致「No such file」）。
一律通过启动器调用，由它按当前系统自动选对解释器，并在需要时自动安装 python-docx：
bash run.sh scripts/check_compliance.py <文档.docx> [--json report.json] # Git Bash / macOS / Linux
powershell -File run.ps1 scripts/check_compliance.py <文档.docx> [--json ...] # Windows 原生 PowerShell
run.sh / run.ps1 会：① 定位 WorkBuddy 托管 Python（venv 缺失时回退到版本解释器）；
② 运行 apply_standard.py 前确保已装 python-docx（缺则自动 pip 安装）。
check_compliance.py 为纯标准库，任何 Python 3 直接跑，无需依赖。
能力 1：合规校验（校对）— scripts/check_compliance.py
纯标准库（zipfile + xml），零依赖，对任意 .docx 做可量化校验，输出 PASS/WARN/FAIL 报告与 JSON 摘要。
校验项：页边距、页眉文字与 Logo、页码域、标题层级字体/字号/缩进、正文、表格边框/表序/表内字体、署名居右。
存在 FAIL 时退出码为 1（可作自动化门禁）。
逐项清单：每次校验都会输出一份「逐项检查清单」，按状态分组明确列出全部检查项：
✅ 已满足 · 无需修改 / ⚠️ 需关注 · 建议修改 / ❌ 不合规 · 必须修改（如「页边距：上边距 = … 符合规范 25mm」）。
--brief 仅输出汇总 + 逐项清单（省略逐条明细），供落实步骤调用。
bash run.sh scripts/check_compliance.py <文档.docx> [--json report.json] [--brief]
# Windows 原生 PowerShell： powershell -File run.ps1 scripts/check_compliance.py <文档.docx> [--json report.json]
能力 2：标准落实（重排）— scripts/apply_standard.py
用 python-docx 把草稿公文自动重排为合规格式：设页边距、建页眉（三栏：Logo/内部资料禁止外传/发文编号）、
建页脚页码（第X页/共X页）、按编号自动套用标题/正文/附件/署名样式、修表格边框与表内字体并补表序。
标题层级按编号约定（一、（一）、1、）识别，无需文档自带样式。
环境（重点）：在 WorkBuddy 上无需手动配环境——经 run.sh / run.ps1 调用时，脚本检测到缺 python-docx 会自动 pip install
（WorkBuddy 自带托管 Python 3.13），拿来即用。check_compliance.py 为纯标准库，任何有 Python 3 的机器零依赖直接跑。
非 WorkBuddy 环境则先建隔离 venv：macOS/Linux 用 <venv>/bin/pip install python-docx，Windows 用 <venv>/Scripts/pip install python-docx。
交付清单 + 修改项清单：落实后脚本会自动打印两份逐项清单：
- 「修改项清单」：逐项标注每个修改大类是 【已修改】 / 【已满足·无需修改】 / 【未启用】——状态由「修改前是否已合规」真实判定（页边距/页眉/页码/表格等若原已合规则标「已满足·无需修改」，而非一律「已修改」）。
- 「交付清单（✓ 已自动完成 / ⚠ 仍需手动处理）」：逐项标注哪些是脚本已自动做掉的（如：内置 Logo 已嵌入、加了 --watermark 时水印已注入），以及哪些仍需你手动处理（PDF 导出、字体安装确认、四级标题缩进、正文人工通读、页码文字包裹复核等），并附复校验汇总。
交付文档时请务必带上这两份清单，逐条处理后再外发。
内置资源（Logo + 水印图）：skill 已自带 Logo 与水印图，落实时无需再到别处找图：缺省自动嵌入 Logo；加 --watermark 即自动注入图片水印。
- 本地开发目录：
assets/logo.png+assets/watermark.png（二进制原图），方便查看/替换。 - 上传发布：部分技能市场/平台禁止上传二进制
.png，甚至连.b64也会拒绝。此时用python build_upload_zip.py <输出路径>生成上传包，
该包会自动把图片编码进scripts/assets_embedded.py，并排除整个assets/目录。 - 运行时：
bundled_asset()会优先使用本地assets/*.png（开发/用户覆盖）；若无本地二进制，则自动从内嵌 Python 模块解码到
~/.workbuddy/.cache/formal-doc-compliance/assets/后再使用，完全不需要联网。上传包只含.py等文本文件也能正常工作。
bash run.sh scripts/apply_standard.py input.docx output.docx \
[--logo logo.png] \ # 缺省自动用 skill 内置 assets/logo.png
[--watermark] \ # 用内置 assets/watermark.png 自动注入图片水印
[--watermark-img your.png] \ # 自定义水印图，覆盖内置图
[--dept "微思敦合规部"] \
[--docnum "合规部第[01]号文件2022"] \
[--date "2022年03月17日"] \
[--no-sign] \ # 不自动加署名落款（避免错误归属），同时彻底跳过落款判定
[--convert-numpr chinese|arabic|off] \ # 把 Word 自动编号（numPr）转为手打前缀并删 numPr 节点
[--numpr-lvltext "1=（%1）,2=（%1）,3=%1、"] # 按 numId 覆盖 lvlText 模板（避撞车）
# Windows 原生 PowerShell：把首行换成 powershell -File run.ps1 scripts/apply_standard.py ...
标题层级与正文混用 — 关键判定逻辑（2026-08 经验沉淀）
restyle_content() 不只看段落 p.text，还会看 pPr/numPr——这是为了解决"手动「1.」+ Word 自动「2.3.」混用"导致的字号/行距/缩进不一致问题：
| 段落特征 | 判定分支 | 样式 |
|---|---|---|
文本以 一、 开头 |
L1 一级标题 | 黑体/四号/无缩进 |
文本以 （一） 开头 |
L2 二级标题 | 宋体/小四/无缩进 |
文本以 1、1. 等开头 |
L3 三级标题 | 宋体/五号/首行缩进 2 字符 |
pPr/numPr 存在（Word 自动编号） |
视为 L3 标题 | 宋体/五号/无首行缩进（Word 列表自带悬挂缩进） |
| 上述都不匹配 | 普通正文 | 宋体/五号/1.5 倍行距/首行缩进 2 字符 |
| 长度 ≤ 30 且匹配「微思敦…部/公司/组/中心」或日期 | 落款 | 五号/居右（--no-sign 时整分支跳过） |
为什么这样设计：手动打的 1. 文本里就是「1.xxx」，但 Word 自动 2. 3. 的 text 里没有前缀——脚本读到的就是「xxx」。原版处理时只匹配文本的版本会把所有 numPr 段当正文，字体缩进全乱。
能力 3：交付兜底（PDF 仍需人工/Word/LibreOffice）
规范「交付说明」要求最终 PDF 外发。PDF 导出不在脚本自动范围，需：
- PDF：用 Word/LibreOffice 将落实后的 .docx「另存为 PDF」（LibreOffice: libreoffice --headless --convert-to pdf）。
- 图片水印已可由 --watermark 自动注入（弱化版置于页眉、相对页面居中、置于文字后层）；在 Word 中复核显示即可，
若想更强的水印效果也可在 Word 内再做一次「设计 → 水印 → 图片水印」。
能力 4：Word 自动编号 → 手打编号（--convert-numpr，2026-08 新增，根治「手动+自动混用」）
背景问题：公文里常见「手动 1. + Word 自动 2.3.」混用列表。原脚本只读 p.text 判层级，
自动编号段 text 里没有 2./3. 前缀 → 被当普通正文处理，字号/缩进/行距跟手动段不一致。
restyle_content() 新增 numPr 判定可让样式统一，但编号格式（手动 1、 vs 自动 1.）仍可能不一致。
--convert-numpr 根治：解析 word/numbering.xml，拿到每个 numId → abstractNum → ilvl 的
lvlText / numFmt / start，按 Word 真实渲染规则推算每段编号前缀并写进段首文本，然后删除 numPr 节点。
转换后所有编号都是手打的 text，样式可被脚本精准统一，不再出现"手动/自动"结构差异。
chinese：数字按中文「一二三」渲染（与手打「（一）」「一、」风格一致）arabic：保留原 numFmt（decimal 十进制等）off：默认，不转换
bash run.sh scripts/apply_standard.py input.docx out.docx --convert-numpr arabic
# 产研部门分层示例：numId=1 用全角「（%1）」、numId=2/3 用半角「(%1)」、numId=4 用顿号「%1、」避免撞车
bash run.sh scripts/apply_standard.py input.docx out.docx --convert-numpr chinese \
--numpr-lvltext "1=（%1）,2=（%1）,3=（%1）,4=%1、"
关键行为（务必知晓）：
1. 撞车风险：不同章节可能用相同术语（如「标准化产品」出现在「产品定价」和「结算场景」两处）。用 --numpr-lvltext 给不同 numId 设不同括号风格（全角 （一）与半角 (1)），用视觉区分层级、避免另一章标题撞车。
2. fmt 自动推断：numId 被 --numpr-lvltext 显式覆盖时，含全角「（）」→ 自动用中文数字；否则保留 decimal（防止「3、」被渲染成「三、」撞 L1 标题）。
3. 循环续编计数：以 (numId, ilvl) 为 key 维护计数器模拟 Word 续编（同 numId 内自动 1→2→3）。
4. bullet / 空 numId 自动跳过：numFmt == "bullet" 的段只删 numPr、不加数字前缀（避免「•」变「1、」丢符号语义，除非 --numpr-lvltext 显式给 bullet 字符）；numId=NONE（样式引用，不显示编号）段只静默删 numPr 不动文本。
5. 暂只覆盖 ilvl=0：多级嵌套列表（不同 ilvl 混用）需扩展 --numpr-lvltext 为按 (numId, ilvl) 覆盖，当前未实现。
何时必须配 --numpr-lvltext 手调：当文档里手动+自动混用、且自动段渲染编号值（1.2.3.）与手动段（1、2、）风格不一致，或不同章节撞车时。产研部门份最典型：numId=1 用 （一）、numId=2/3 用 (1)、numId=4 用 1、 才最干净。
推荐流程（闭环）
- 落草：用户给草稿 docx（或不合规文档）。
- 校验（基线）：
bash run.sh scripts/check_compliance.py draft.docx --json before.json→ 看 FAIL 清单。 - 落实：
bash run.sh scripts/apply_standard.py draft.docx std.docx [--logo ... --docnum ... --date ...]。 - 若文档含「手动+自动混用」：加
--convert-numpr arabic（或 chinese，必要时--numpr-lvltext "1=（%1）,2=（%1）"调层级避撞车）。 - 若不要自动落款：
--no-sign（同时彻底跳过落款判定，避免含「微思敦…公司/部门」的长正文段被误判为落款居右）。 - 若要水印：
--watermark（内置水印图）或--watermark-img your.png（自定义）。 - 复校验：
bash run.sh scripts/check_compliance.py std.docx --json after.json→ 目标 0 FAIL。 - 交付：Word/LibreOffice 转 PDF + 加 Logo 水印，再人工确认页眉 Logo 位置/大小与页码文字包裹。
完整调用范例（典型结算方案）
bash run.sh scripts/apply_standard.py input.docx output.docx \
--no-sign \
--watermark \
--convert-numpr arabic
# 含手动+自动混用且需调层级的（如产研部门）
bash run.sh scripts/apply_standard.py input.docx output.docx \
--no-sign --watermark \
--convert-numpr chinese \
--numpr-lvltext "1=（%1）,2=（%1）,3=（%1）,4=%1、"
上传 / 分享技能包
若技能市场/平台禁止上传二进制文件（如你遇到的 logo.png、watermark.png，甚至 .b64 都被拒绝），
不要直接打包整个 skill 目录，请用内置脚本生成上传包：
python build_upload_zip.py C:/Users/xxx/Desktop/formal-doc-compliance.zip
该脚本会：
1. 把 assets/*.png 编码进 scripts/assets_embedded.py（图片以 Base64 形式内嵌到 Python 源码）；
2. 打包时排除整个 assets/ 目录（无 .png、无 .b64），只保留 Python 脚本与文档。
上传包在运行时，apply_standard.py 的 bundled_asset() 会自动从 scripts/assets_embedded.py 解码出图片到本地缓存，
不影响功能，使用方无需任何手动操作。
已知限制 / 注意事项
check_compliance.py对「标题层级」按编号约定启发式判断；若文档用自定义样式名或非常规编号，可能误报 WARN，需人工复核。- 落款判定 false positive（2026-08 已根治）：校验器
check_compliance.py落款判定加len(text)<=30短行门槛（与落实器对齐）；
对短正文含「微思敦…公司/部门」已被落实器--no-sign跳过落款分支，二者逻辑一致。仅 WARN 不影响交付。 - 校验器 numPr 识别（2026-08 已同步）：
check_headings_and_body检测到段落含w:numPr（Word 自动编号）时，只查字号、跳过首行缩进/1.5 行距 WARN
（自动列表用悬挂缩进，本就不要求首行缩进 2 字符）。无论文档是否--convert-numpr转手打，复校都不再因编号段误报缩进 WARN。 apply_standard.py的「首行缩进 2 字符」以五号 10.5pt 近似换算为 Pt(21)；四级（3 字符）未自动处理，需手动。- 标题层级正则限制：
RE_L1=^[一二三四五六七八九十百零]+、、RE_L2=^（[一二三四五六七八九十百零]+）（仅全角中文括号（））、
RE_L3=^\d+[、.）]。若文档用半角(一)或(1)，不会被识别为标题而落为正文（缩进/行距会与同级不一致）。
人工处理时注意区分全半角。 - 页眉 Logo 为可选项（--logo）；未提供时校验会 WARN，不影响其他项。
- 编辑器通道（editor_sdk / tencent-local-office-edit）在本机对 docx 的「流式打开」读取不稳定；
本技能改用 python-docx + 标准库直接处理 docx，更可靠。如用编辑器通道做细微交互编辑，
仍可在落实后用doc_*工具人工微调（先open_file取 file_id，再按 SKILL 文档操作）。 - 正文段「抽样检查」仅做 WARN 提示（不 FAIL），避免噪声；发布前仍建议人工通读。
--convert-numpr只覆盖ilvl=0；遇到多级嵌套列表（不同 ilvl 混用不同编号层级）需扩展为按(numId, ilvl)覆盖。
踩过的坑（2026-08 实战沉淀）
以下是真实排查出的 bug 复盘，新人/后续维护者务必知晓：
坑 1：落款判定无长度门槛 + 不受 --no-sign 控制（已修）
- 症状：合规版里 5 段正文（产研 4 段、社媒 1 段）被误设右对齐。
- 根因：
restyle_content()落款正则RE_SIGN_DEPT=微思敦.+?(部|公司|组|中心)①无长度门槛、②不受--no-sign控制。
正文段含「微思敦公司各部门」「其他微思敦公司部门合作客户」被当落款居右。 - 修复：
restyle_content(no_sign=False)参数化，--no-sign时整分支跳过；落款判定加len(text)<=30短行门槛（与校验器对齐）。 - 校验器对齐：落实器已彻底跳过落款分支（
--no-sign），校验器落款判定也用len<=30短行门槛，二者一致。若走--no-sign，正文段绝不居右，校验器无落款 WARN 浮出。
坑 2：手动「1.」+ Word 自动「2.3.」混用样式不一致（已修）
- 症状：文档里"前一段手动打
1.、后面两段 Word 自动续编"时，三段字体/字号/缩进/行距全不一致。 - 根因：原脚本只读
p.text，自动编号段 text 里没有2./3.前缀就漏判为正文。 - 修复：
restyle_content()加has_numPr = pPr.find(qn("w:numPr")) is not None判定，带 numPr 段走 L3 标题样式（无首行缩进，因 Word 列表自带悬挂缩进）。 - 校验器对齐：
check_compliance.py现已识别 numPr 段（只查字号、跳过缩进/行距 WARN），不再因自动编号段误报"正文无首行缩进"。若用--convert-numpr转手打，段变成普通正文且落实器补了首行缩进，复校同样干净。
坑 3：numId 渲染格式与手动段不统一（已修，但需手动调 lvlText）
- 症状：手动段
1、与 Word 自动段1.2.3.（半角括号+点+阿拉伯）格式不一致，混用很乱。 - 根因：
word/numbering.xml里的lvlText/numFmt模板不统一（如（%1）+chineseCountingThousand vs(%1)+decimal）。 - 修复：新增
--convert-numpr chinese/arabic/off把 numPr 段按 Word 真实渲染规则转为手打前缀并删 numPr 节点；--numpr-lvltext "1=（%1）,2=（%1）"按 numId 覆盖模板避撞车。 - 撞车案例：产研部门段 5「（一）标准化产品」与段 15「标准化产品：营销大部...」用同样术语，强行 chinese 化会让段 15 渲染为「（一）标准化产品：...」跟段 5 撞 → 改 numId=2/3 用半角
(1)(2)(3)视觉区分上下两层。 - fmt 自动推断：用户显式覆盖 lvlText 时，含全角「（）」→ 用中文数字；否则保留 decimal（防止「3、」误转「三、」撞 L1 标题）。
- bullet 跳过：
numFmt=="bullet"只删 numPr 不加数字（避免「•」变「1、」丢符号）；numId=NONE（空样式引用）静默删 numPr 不动文本。
