\r \r

文档格式刷 (Doc Format Brush)\r

\r

概述\r

\r 本 skill 提供多格式文档格式整理功能：提取模板文档的格式 → 应用到任意格式的目标文档。\r \r

核心功能\r

\r

1. 多格式支持：输入/输出支持 Word(.docx)、Markdown(.md)、纯文本(.txt)\r
2. 智能标题层级识别：自动识别标题、一级标题（"一、"）、二级标题（"（一）"）、正文\r
3. 格式精确复制：字体、字号、加粗、对齐、首行缩进（字符级）、段前间距、段后间距、行间距、页边距\r
4. 内置公文格式：支持一键应用 GB/T 9704-2012 国家标准公文格式\r \r ---\r \r

使用方式\r

\r

方式一：使用内置公文格式（推荐）\r

\r 当用户需要将文档调整为标准公文格式时：\r \r

python apply_multi_format.py \x3C输入文档> --official --output \x3C输出文档>\r
```\r
\r
**支持的输入格式**：.docx, .md, .txt\r
**支持的输出格式**：.docx, .md, .txt\r
\r
**示例：**\r
```bash\r
# Markdown 转 Word 公文格式\r
python apply_multi_format.py 报告.md --official --output 报告_公文.docx\r
\r
# 纯文本转 Markdown\r
python apply_multi_format.py 笔记.txt --official --output 笔记.md\r
\r
# Word 转为 Word（使用公文格式）\r
python apply_multi_format.py 财务报告.docx --official --output 财务报告_公文格式.docx\r
```\r
\r
---\r
\r
### 方式二：参照模板文档\r
\r
当用户提供了特定的模板文档时：\r
\r
**从模板提取格式后应用到目标：**\r
```bash\r
python apply_multi_format.py \x3C目标文档> \x3C模板.docx> --output \x3C输出文档>\r
```\r
\r
**示例：**\r
```bash\r
# 参照 Word 模板，调整 Markdown 文件\r
python apply_multi_format.py 报告.md 模板.docx --output 报告_新格式.docx\r
\r
# 参照模板，转换 Word 到 Word\r
python apply_multi_format.py 源文件.docx 模板.docx --output 目标文件.docx\r
```\r
\r
---\r
\r
### 方式三：使用格式描述文件\r
\r
可以先提取模板格式为 JSON，然后复用：\r
\r
```bash\r
# 提取格式\r
python extract_format.py 模板.docx --output 格式.json\r
\r
# 应用格式\r
python apply_multi_format.py 输入.md --format-json 格式.json --输出 输出.docx\r
```\r
\r
---\r
\r
## 内置公文格式规范（GB/T 9704-2012）\r
\r
| 段落类型 | 字体 | 字号 | 对齐 | 缩进 | 段前 | 段后 | 行距 |\r
|---------|------|------|------|------|------|------|------|\r
| 标题 | 方正小标宋体 | 22pt（二号） | 居中 | 0 | 0pt | 0pt | 1.5倍 |\r
| 文号 | 仿宋_GB2312 | 16pt（三号） | 居中 | 0 | 0pt | 0pt | 1.5倍 |\r
| 一级标题 | 黑体 | 16pt（三号） | 左对齐 | 0 | 0pt | 0pt | 1.5倍 |\r
| 二级标题 | 楷体_GB2312 | 16pt（三号） | 左对齐 | 0 | 0pt | 0pt | 1.5倍 |\r
| 正文 | 仿宋_GB2312 | 16pt（三号） | 两端对齐 | 2字符 | 0pt | 0pt | 1.5倍 |\r
\r
**页面设置：**\r
- 纸张：A4（21cm × 29.7cm）\r
- 页边距：上 3.7cm，下 3.5cm，左 2.8cm，右 2.6cm\r
\r
---\r
\r
## 标题层级识别规则\r
\r
### Word/文本识别规则\r
\r
| 类型 | 识别规则 | 示例 |\r
|------|---------|------|\r
| 标题 | 第一个非空段落 | 关于xxx的请示 |\r
| 文号 | 第二个段落，符合公文号格式 | X发〔2024〕10号 |\r
| 一级标题 | 以"一、"、"二、"等开头 | 一、基本情况 |\r
| 二级标题 | 以"（一）"、"（二）"等开头 | （一）主要业绩 |\r
| 正文 | 其他段落 | 正文内容... |\r
\r
### Markdown 识别规则\r
\r
| Markdown 标记 | 对应层级 |\r
|--------------|---------|\r
| # Title | 标题 |\r
| ## Heading | 一级标题 |\r
| ### Subheading | 二级标题 |\r
| - List item | 正文（列表项） |\r
| 普通文本 | 正文 |\r
\r
---\r
\r
## 格式转换矩阵\r
\r
| 输入格式 | 支持的输出格式 | 说明 |\r
|---------|---------------|------|\r
| .docx | .docx, .md, .txt | 保留格式信息 |\r
| .md | .docx, .md, .txt | 识别标题层级 |\r
| .txt | .docx, .md, .txt | 智能识别标题 |\r
\r
---\r
\r
## 脚本位置\r
\r
本 skill 包含以下脚本：\r
\r
| 脚本 | 功能 |\r
|------|------|\r
| `extract_format.py` | 从 Word 模板提取格式 → 输出 JSON |\r
| `apply_format.py` | 应用格式到 Word 文档 |\r
| `apply_multi_format.py` | **【推荐】**多格式统一处理入口 |\r
| `format_bridge.py` | 多格式文档读写核心库 |\r
\r
脚本目录：`C:\Users\14032\.codebuddy\skills\doc-format-brush\scripts\`\r
\r
---\r
\r
## 常见错误与修正\r
\r
| 错误现象 | 原因 | 修正方式 |\r
|----------|------|----------|\r
| 首行缩进显示为厘米而非字符 | 使用了 `Cm()` 而非 XML 属性 | 使用 `w:firstLineChars` 设置字符数 |\r
| 段后间距仍有 10pt | Word Normal 样式默认值未覆盖 | 强制 `pf.space_after = Pt(0)` |\r
| 对齐方式为左对齐而非两端对齐 | 未正确设置 JUSTIFY | 使用 `WD_ALIGN_PARAGRAPH.JUSTIFY` |\r
| 中文字体未变化 | 只设了 `font.name` | 同时设置 `w:eastAsia` 属性 |\r
| 文件保存报 PermissionError | 目标文件在 Word 中打开 | 换一个新文件名保存 |\r
\r
---\r
\r
## 典型对话示例\r
\r
**用户 A：** "把这份 Markdown 报告改成公文格式 Word"\r
\r
**AI：** 使用内置公文格式处理 Markdown：\r
```bash\r
python apply_multi_format.py 报告.md --official --output 报告_公文格式.docx\r
```\r
\r
**用户 B：** "参照这个 Word 模板，调整我的笔记文件"\r
\r
**AI：** 参照模板格式处理：\r
```bash\r
python apply_multi_format.py 我的笔记.md 模板.docx --output 笔记_整理.docx\r
```\r
\r
**用户 C：** "把这个文本文件转成带格式的 Markdown"\r
\r
**AI：** 使用内置格式输出 Markdown：\r
```bash\r
python apply_multi_format.py 原始笔记.txt --official --output 格式化笔记.md\r
```\r