孙不输教育局公文（文稿格式转换）
概述
把任意来源的文稿统一重排为 教育局文稿格式（A4、左右 3cm/上下 2.54cm 页边距、宋体二号居中标题、仿宋三号首行缩进正文、黑体/楷体/仿宋加粗分级标题、楷体三号居中作者日期、底端居中页码），
输出为可直接打印的 .docx。完整规范见 references/gongwen_spec.md，生成由
scripts/build_gongwen.py 完成（纯 python-docx，不依赖外部文件）。
适用输入
- 纯文本 / Markdown 草稿（
.txt/.md） - Word 文档（
.docx/ 旧版.doc，.doc经本机 WPS COM 抽取文本） - PDF（先抽文本再转换）
- 知识图片 / 课件截图（多模态读取后整理为文字草稿）
工作流
第 1 步：采集源文稿
- 文本类（txt/md/docx/doc/pdf）：直接读取内容。
.doc由脚本经 WPS COM 抽取，无需手动处理。 - 图片类：用 Read 工具读取图片，提取标题、作者、日期、各级标题与正文要点。
第 2 步：识别结构与字段
将内容映射为下列结构（每个文稿一份）：
- title（主标题）、author（作者/单位）、date（成文日期）
- 正文块序列，类型：h2（一、）、h3（（一））、h4（1. / （1） / 1、）、body（正文）、blank（空行）
- 标题层级判定：二级「一、二、」→ 黑体；三级「（一）」→ 楷体；四级「1. / （1） / 1、」→ 仿宋加粗
第 3 步：生成
两种方式任选其一：
1. 自动转换（推荐处理已有草稿）：直接把源文件交给脚本，自动识别标题层级与作者日期。
bash
PY="C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python"
$PY scripts/build_gongwen.py 草稿.md 输出.docx --title "标题" --author "单位" --date "2026年X月X日" --md5
2. 结构化生成（推荐处理图片/复杂排版）：先把理解结果写成 JSON，再生成，控制最精确。
bash
$PY scripts/build_gongwen.py input.json 输出.docx --md5
JSON 字段见脚本头部注释；author_position 可设 "top"（标题下居中，默认）或 "end"（文末落款右对齐）。
内置样例（无素材快速验证）：$PY scripts/build_gongwen.py --demo 示例.docx --md5
第 4 步：自检（交付前必做）
对照 references/gongwen_spec.md 回读生成文件确认：
1. 页面 A4，页边距 左/右 3.0cm、上/下 2.54cm；
2. 主标题 宋体 二号(22pt) 居中；作者/日期 楷体_GB2312 三号(16pt) 居中；
3. 正文 仿宋_GB2312 三号(16pt)、首行缩进约 1.13cm、固定行距 30 磅；
4. 二级黑体 / 三级楷体 / 四级仿宋加粗，字号均三号；
5. 页脚居中页码（PAGE 域）；
6. 全文黑色、无外网依赖、可直接打印。
附《自检表》（格式符合度 / 内容完整性 / 课时或文种匹配 / 无外网依赖）随交付说明一并提供。
资源
scripts/build_gongwen.py— 转换器（txt/md/docx/doc/json → 标准教育局文稿 docx，支持 --demo / --md5 / --title/--author/--date 覆盖）references/gongwen_spec.md— 教育局文稿格式权威规范assets/教育局文稿格式_参考.docx— 源格式说明文档（转换目标参照）
字体约定
默认「宋体 / 黑体 / 楷体_GB2312 / 仿宋_GB2312」。如运行环境缺 GB2312 字型导致显示异常，
改 build_gongwen.py 顶部 FONT_* 常量为本机可用字体（如「仿宋」「楷体」）即可。
