MarecGents 中文引号格式化（zh-quotes）
将 .docx 文件中的所有英文直引号（"）替换为中文全角弯引号（左 \u201c、右 \u201d），成对交替替换，同时完整保留原文所有格式（字体、字号、加粗、斜体、颜色等）。
使用场景
- 学术论文中英混排文档的中文引号规范化
- 从英文模板创建的中文文档标点修复
- 批量处理多个 docx 文件中的直引号问题
- 引用中包含书名号、引号嵌套的中文排版
工作原理
docx 文件本质是 ZIP 压缩包，内部以 XML 存储文本内容和格式。脚本遍历文档的每一个 <w:r>（run）元素，在段落级别识别 " 字符并按段落内出现顺序成对交替替换：
- 段落内第 1 个
"→ 左引号\u201c - 段落内第 2 个
"→ 右引号\u201d - 第 3 个
"→ 左引号\u201c - 第 4 个
"→ 右引号\u201d - …依次类推，每个段落独立计数
使用方法
python scripts/replace_quotes.py <输入文件.docx> [选项]
参数说明
| 参数 | 说明 |
|---|---|
<输入文件> |
要处理的 .docx 文件路径（必需） |
--output OUTPUT / -o |
输出路径（默认覆盖原文件） |
--no-backup |
不创建备份（默认自动创建 .bak 备份） |
示例
# 直接修改原文件（自动创建备份）
python scripts/replace_quotes.py 论文.docx
# 输出到新文件
python scripts/replace_quotes.py 论文.docx -o 论文_格式化.docx
# 批量处理当前目录下所有 docx
Get-ChildItem *.docx | ForEach-Object {
python scripts/replace_quotes.py $_.Name --no-backup
}
处理范围
- ✅ 文档正文段落
- ✅ 页眉（header）和页脚（footer）
- ✅ 表格内单元格文字
- ✅ 脚注和尾注（python-docx 后端通过 related_parts XML 访问；lxml 后端遍历全部 w:p）
- ✅ 文本框中的文字
- ✅ 保留所有字体、字号、加粗、斜体、颜色等格式
注意事项
- 引号嵌套：如果同一段落内包含嵌套引号，此工具按平面配对处理，不会智能区分嵌套层级。如有嵌套引号需求，手动调整。
- 已存在的弯引号：如果文档中已存在中文弯引号（
\u201c/\u201d），工具会跳过它们并保持其配对状态计数器同步，确保后续替换正确。 - 备份：默认创建
.bak备份文件，使用--no-backup可禁用。 - 依赖：需要
python-docx（推荐）或lxml。安装：pip install python-docx
与 docx 技能的关系
本技能是 docx 文编技能的子集，专门处理引号格式修复这一高频需求。如果你需要进行更复杂的 docx 操作（创建文档、插入图片、处理修订等），请使用 docx 技能。