# Zh Quotes

> 在 Word 文档(.docx)中将英文直引号替换为中文全角弯引号（左引号 U+201C、右引号 U+201D），成对交替，保留原格式。当用户需要处理中文标点符号、整理中文排版、将英文直引号转为中文前后引号、修复 docx 文件中的引号格式时使用。适用于学术论文、报告、公文等中文文档的标点规范化。该技能是 docx 技能的子技能，专精于引号格式修复，不用于创建或编辑其他文档内容。

- Skill: `marecgents/zh-quotes` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add marecgents/zh-quotes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/marecgents/zh-quotes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: MarecGents (https://skillmd.com/u/marecgents)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/marecgents/zh-quotes

---


# 中文引号格式化（zh-quotes）

将 `.docx` 文件中的所有英文直引号（`"`）替换为中文全角弯引号（左 `\u201c`、右 `\u201d`），**成对交替**替换，同时**完整保留原文所有格式**（字体、字号、加粗、斜体、颜色等）。

## 使用场景

- 学术论文中英混排文档的中文引号规范化
- 从英文模板创建的中文文档标点修复
- 批量处理多个 docx 文件中的直引号问题
- 引用中包含书名号、引号嵌套的中文排版

## 工作原理

docx 文件本质是 ZIP 压缩包，内部以 XML 存储文本内容和格式。脚本遍历文档的每一个 `<w:r>`（run）元素，在**段落级别**识别 `"` 字符并按**段落内出现顺序**成对交替替换：

- 段落内第 1 个 `"` → 左引号 `\u201c`
- 段落内第 2 个 `"` → 右引号 `\u201d`  
- 第 3 个 `"` → 左引号 `\u201c`
- 第 4 个 `"` → 右引号 `\u201d`
- …依次类推，每个段落独立计数

## 使用方法

```bash
python scripts/replace_quotes.py <输入文件.docx> [选项]
```

### 参数说明

| 参数 | 说明 |
|------|------|
| `<输入文件>` | 要处理的 `.docx` 文件路径（必需） |
| `--output OUTPUT` / `-o` | 输出路径（默认覆盖原文件） |
| `--no-backup` | 不创建备份（默认自动创建 `.bak` 备份） |

### 示例

```bash
# 直接修改原文件（自动创建备份）
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）
- ✅ 文本框中的文字
- ✅ 保留所有字体、字号、加粗、斜体、颜色等格式

## 注意事项

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

## 与 docx 技能的关系

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