mcpField
W
word-power-tools

word-power-tools

github.com/chi111i文档处理1138 次安装40 周前更新
代码仓库

关于 word-power-tools

word-power-tools 是面向 Claude Code 的 Word 文档处理 Skill，借助脚本执行提取、转换、排版校验和编辑，强调操作可复现且默认不覆盖原文件。

主要功能

  1. 01查看文档信息与章节大纲
  2. 02提取正文、表格和图片
  3. 03转换多种文档格式
  4. 04批量替换并写入元数据
  5. 05校验及统一排版格式
  6. 06合并、拆分和生成文档

适用场景

  1. 01将 DOCX 转为 PDF 或 Markdown
  2. 02提取 Word 表格和图片
  3. 03检查论文格式并生成报告
  4. 04按标题拆分或合并文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/chi111i/word-power-tools --skill word-power-tools

安装后在 Claude Code 中输入/word-power-tools确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
.gitignore
requirements.txt
docs/
FORMAT_RULES.md
SECURITY.md
TROUBLESHOOTING.md
INSTALL.md
USAGE.md
installers/
uninstall.ps1
install.ps1
install.sh
uninstall.sh
scripts/
selftest.py
word_tool.py
scripts/wordlib/
common.py
convert.py
__init__.py
extract.py
edit.py
metadata.py
toc.py
validate.py
templates/
replace_rules.example.yaml
metadata.example.yaml
format_thesis_qfnu_science.yaml
format_thesis_qfnu_arts.yaml
thesis_skeleton.example.yaml

详细介绍

来自项目 README

Word Power Tools

本 Skill 的目标：让 Claude Code 在本地（Linux/macOS/Windows）把 Word 文档当作可编程文档来可靠处理。

⚠️ 核心原则

必须优先使用本 Skill 提供的脚本 scripts/word_tool.py，最好不要自己编写临时脚本或一次性代码。

所有文档操作都应通过 word_tool.py 的子命令完成，确保可复现性和稳定性。

适用场景（触发关键词）

  • “把 docx/doc 转 pdf/markdown/html/txt”
  • “从 Word 提取表格/图片/章节结构/正文文本”
  • “论文排版、格式统一、目录、页码、页眉页脚”
  • “批量替换、合并、拆分、套模板”
  • “格式审查（页边距、字体、行距、标题层级）并输出报告”

原则（减少风险 + 提高可复现性）

  1. 默认不覆盖原文件：所有会改写的操作必须写到新输出文件（-o/--output）。
  2. 先 lint 后 format：排版类任务先生成报告，再应用修复（避免"修坏了但不知道改了什么"）。
  3. 复杂任务用脚本输出：脚本可"零上下文执行"，输出更稳定、可测试。

Quickstart

依赖自检（推荐每个新环境先跑一次）：

python scripts/word_tool.py doctor

文档概览：

python scripts/word_tool.py info path/to/file.docx
python scripts/word_tool.py outline path/to/file.docx

提取：

python scripts/word_tool.py extract-text path/to/file.docx -o out.txt
python scripts/word_tool.py extract-tables path/to/file.docx -o tables/ --format xlsx
python scripts/word_tool.py extract-images path/to/file.docx -o images/

转换：

python scripts/word_tool.py convert input.doc  --to docx -o output.docx
python scripts/word_tool.py convert input.docx --to pdf  -o output.pdf
python scripts/word_tool.py convert input.docx --to md   -o output.md

批量替换（YAML 规则）：

python scripts/word_tool.py replace input.docx --rules templates/replace_rules.example.yaml -o replaced.docx

写入元数据（作者/标题等）：

python scripts/word_tool.py set-metadata input.docx --metadata templates/metadata.example.yaml -o meta.docx

插入目录（TOC 字段，需要在 Word 里“更新域”才能渲染）：

python scripts/word_tool.py toc input.docx --levels 1-3 -o with_toc.docx

排版校验 + 应用统一格式（YAML 配置）：

python scripts/word_tool.py lint   input.docx --config templates/format_thesis_qfnu_science.yaml -o report.md
python scripts/word_tool.py format input.docx --config templates/format_thesis_qfnu_science.yaml -o fixed.docx

合并/拆分：

python scripts/word_tool.py merge a.docx b.docx c.docx -o merged.docx
python scripts/word_tool.py split input.docx --by heading1 -o split_out/

生成新文档骨架（论文/报告模板化）：

python scripts/word_tool.py new --template templates/thesis_skeleton.example.yaml -o thesis.docx

参考文档（按需读取）

  • 安装与环境：docs/INSTALL.md
  • 使用手册（所有子命令）：docs/USAGE.md
  • 排版规则配置：docs/FORMAT_RULES.md
  • 常见问题：docs/TROUBLESHOOTING.md
  • 安全注意事项：docs/SECURITY.md

评论

支持 Markdown