📄 docx-editor-cn

🎓 中文学术文档风格排版Skill 用于 AI Agent 按照规定格式编辑 Word 文档或将 Markdown 转换为 docx 适用文档：中文课程论文；中文毕业设计论文；中文数学建模论文 …

---

✨ 功能特性

使用方式：直接下载docx-editor-cn文件夹，放到对应skills目录下。 参考： https://support.claude.com/en/articles/12512180-use-skills-in-claude https://skillsmp.com/zh/docs#when-to-use https://opencode.ai/docs/zh-cn/skills/

---

🔄 工作流 Workflow

本 Skill 支持两种主要工作流：

工作流 1：Markdown → Word 转换

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Markdown 文件  │ ──► │   解析内容      │ ──► │  生成 .docx     │
│  (论文源文件)   │     │  (标题/公式/表格)│     │  (格式化输出)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                              │
                              ▼
                    ┌─────────────────────────┐
                    │ LaTeX 公式 → Word Math  │
                    │ (temml + mathmlToDocx)  │
                    └─────────────────────────┘

步骤：

1. 读取 Markdown 文件内容
2. 解析标题层级、正文、公式、表格、图片、参考文献
3. 调用 new_doc.js 中的辅助函数构建文档结构
4. LaTeX 公式通过 temml → MathML → mathmlToDocxChildren 转换为 Word 原生公式
5. 输出符合学术规范的 .docx 文件

工作流 2：编辑现有 Word 文档

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  现有 .docx     │ ──► │   解包 XML      │ ──► │   编辑内容      │
│                 │     │  (unpack.py)    │     │  (Python/JS)    │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                                                       │
                                                       ▼
                                              ┌─────────────────┐
                                              │   重新打包      │
                                              │  (pack.py)      │
                                              └─────────────────┘

步骤：

1. 使用 office/unpack.py 解压 .docx 为 XML 文件
2. 编辑 document.xml（正文）、styles.xml（样式）等
3. 使用 office/pack.py 重新打包为 .docx
4. 可选：使用 office/validate.py 验证文档完整性

核心转换流程（公式处理）

LaTeX 字符串                    Word 原生公式
     │                              ▲
     ▼                              │
┌──────────┐    ┌──────────┐    ┌──────────┐
│  temml   │ ─► │  MathML  │ ─► │  docx.js │
│ (解析器) │    │  (XML)   │    │  Math()  │
└──────────┘    └──────────┘    └──────────┘

---

📐 默认格式模板

本 Skill 预设基本符合 中国大陆高校常见学术论文（课程论文、毕业设计、数学建模论文等）标准 的格式规范。

📄 页面设置

🔤 字体规范

英文字体可选 Times New Roman等，这里为了保持与中文字体风格协调，采用Cambria Math。

📊 三线表样式

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓  ← 顶线 (1.5pt 粗线)
┃   表头1    │    表头2       ┃
┠──────────────────────────────┨  ← 栏目线 (0.75pt 细线)
┃   数据1    │    数据2       ┃
┃   数据3    │    数据4       ┃     (无竖线、无横线)
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛  ← 底线 (1.5pt 粗线)

➗ 公式排版

┌─────────────────────────────────────────────────┐
│                                                 │
│   (左留白)    E = mc²    (1)                  │
│               ↑            ↑                    │
│          居中公式      右对齐编号               │
│                                                 │
└─────────────────────────────────────────────────┘
        (整个布局使用无边框三列表格实现)

---

🛠️ 辅助函数

scripts/new_doc.js 提供以下便捷函数：

// 📌 标题（自动编号）
h1Manual('一、引言')     // 中文数字编号
h1('研究背景')           // → 1 研究背景
h2('问题定义')           // → 1.1 问题定义
h3('数学模型')           // → 1.1.1 数学模型

// 📝 正文（自动检测公式和引用）
body('Q-learning 算法由 Watkins 提出[1]')  // [1] → 上标

// ➗ 公式
formula('E = mc^2', 1)   // 居中公式，编号 (1)

// 📊 表格
tableCaption('表 1-1 符号说明')
threeLineTable(['符号', '说明'], [['α', '学习率'], ['γ', '折扣因子']])

// 🖼️ 图片
figCaption('图 1-1 系统架构')

// 📚 参考文献
ref('Watkins C J C H. Q-learning[J]. Machine Learning, 1992.')

// ⚡ 辅助
blank()      // 空行
pageBreak()  // 分页符

---

🎨 自定义格式指南

---

🧩 案例介绍

Word版本：Microsoft Office LTSC Word 2021 以下是一个使用OpenCode+OMO+ 本Skill 生成的示例课程论文文档，展示了各种格式元素：

• 向Agent提供调用指令（示例）

使用skill `docx-editor-cn` ，按照其中流程和要求，帮我将`测试论文.md`转为排版好的docx格式的word文件

• 标题层级与摘要、正文段落

• 居中公式与编号

• 三线表

• 图表标题

• 上标引用

• 参考文献列表

• 等等…

---

✅ 已解决问题清单

本 Skill 已修复以下常见问题：

最新更新内容：

• 2026-05-11：修复多级标题自动编号问题，新增 buildNumberingConfig(chapterCount) 函数动态生成 Word 编号引用，实现章节内 H2/H3 自动编号和跨章节重置。
• 2026-05-11：优化了公式检测的正则表达式，提高了鲁棒性。

---

📁 文件结构

📂 docx-editor-cn/          ← 本文件
├── 📚 SKILL.md             ← 完整技术文档
└── 📂 scripts/
    ├── 🎯 new_doc.js       ← 主模板脚本 (推荐入口)
    ├── ➗ mathml-to-docx.js ← MathML → Word 公式
    ├── 🐍 formula.py       ← 公式 XML 插入
    ├── 🐍 table.py         ← 表格 XML 插入
    ├── 🐍 comment.py       ← 批注处理
    ├── 🐍 accept_changes.py
    └── 📂 office/
        ├── unpack.py       ← DOCX 解包
        ├── pack.py         ← DOCX 打包
        ├── validate.py     ← 文档验证
        └── soffice.py      ← LibreOffice 调用

---

📦 依赖项

必需 (npm)

npm install docx temml fast-xml-parser

若尚未安装 Node.js，请参考安装教程：https://blog.csdn.net/qq_45824320/article/details/136601535

可选 (用于编辑现有文档)

• 🐍 Python 3.x
• 📝 LibreOffice (.doc 转换、接受修订)
• 📄 Pandoc (内容提取)

---

📄 许可证

MIT License - 详见 LICENSE.txt

---

🚩 Todo

• [x] 支持更多文档元素（目录、多级标题）
• [ ] 增强 Markdown 转换（适应word公式编辑器公式语法规定）
• [ ] 优化工作流性能（大文档处理速度）