DOCX Diff — Word 文档本地差异对比
工作流
用户给出两个文件路径后，按以下步骤执行：
第一步：确认依赖
pip install python-docx
如果已安装过，跳过。
第二步：找到 skill 脚本路径
脚本在 skill 目录下的 scripts/compare_docx.py。
OpenClaw 的 skill 目录通常在：
- Windows:
%USERPROFILE%\.openclaw\skills\docx-diff\scripts\compare_docx.py - macOS/Linux:
~/.openclaw/skills/docx-diff/scripts/compare_docx.py
第三步：运行对比
python "路径/scripts/compare_docx.py" --file1 "旧文档.docx" --file2 "新文档.docx"
Windows 示例（路径含空格时加引号）：
python "%USERPROFILE%\.openclaw\skills\docx-diff\scripts\compare_docx.py" ^
--file1 "E:\ZTE\project\report_V1.0.docx" ^
--file2 "E:\ZTE\project\report_V1.1.docx" ^
--output "E:\ZTE\project\diff_output"
第四步：报告结果
运行完成后，告诉用户：
- 统计数字：删除/新增/修改了多少段落，图片有无变化
- 具体改动内容（从
*_diff.txt读取后摘要） - 输出文件位置：
*_diff.html（推荐用浏览器打开）、*_diff.docx
参数说明
| 参数 | 默认 | 说明 |
|---|---|---|
--file1 | 必填 | 旧文档（基准） |
--file2 | 必填 | 新文档（对比目标） |
--output | 与 file2 同目录 | 输出目录 |
--threshold | 0.6 | 段落配对相似度 0~1，越低越宽松 |
--mode | all | all / text / image |
输出文件
| 文件 | 说明 |
|---|---|
*_diff.html | 交互式报告，浏览器打开，支持按类型筛选 |
*_diff.docx | 高亮标注版 Word 文档（红=删除，绿=新增） |
*_diff.txt | 纯文本报告 |
标注说明
| 标记 | 含义 |
|---|---|
[-] 红色 | 旧文档有、新文档没有（删除） |
[+] 绿色 | 新文档有、旧文档没有（新增） |
[修改前/后] | 内容相似但有改动 |
[样式] 黄色 | 文字相同但格式发生变化 |
注意事项
- 仅支持
.docx，不支持旧版.doc（需先用 Word 另存为 .docx） - 表格内容也会被扫描，不会遗漏
- 图片通过 MD5 比对，改名不会误判
- HTML 报告内嵌图片，可直接分享单个文件
常见问题
Q: threshold 怎么调？
- 两段文字差别很大但被判为「修改」→ 提高到 0.8
- 相似段落被判为「删除+新增」→ 降低到 0.4
Q: 文档结构差异极大，结果乱？
- 先用
--mode text只看文本，忽略图片干扰