运行时依赖
安装命令
点击复制技能文档
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 只看文本,忽略图片干扰