Zh quotes

中文引号格式化（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）
• ✅ 表格内单元格文字
• ✅ 脚注和尾注（通过 lxml 模式）
• ✅ 文本框中的文字
• ✅ 保留所有字体、字号、加粗、斜体、颜色等格式

注意事项

1. 引号嵌套：如果同一段落内包含嵌套引号，此工具按平面配对处理，不会智能区分嵌套层级。如有嵌套引号需求，手动调整。
2. 已存在的弯引号：如果文档中已存在中文弯引号（\u201c/\u201d），工具会跳过它们并保持其配对状态计数器同步，确保后续替换正确。
3. 备份：默认创建 .bak 备份文件，使用 --no-backup 可禁用。
4. 依赖：需要 python-docx（推荐）或 lxml。安装：pip install python-docx

与 docx 技能的关系

本技能是 docx 文编技能的子集，专门处理引号格式修复这一高频需求。如果你需要进行更复杂的 docx 操作（创建文档、插入图片、处理修订等），请使用 docx 技能。