Agent Skills
返回列表
文档版本差异对比工具

文档版本差异对比工具

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_92725383/doc-diff-expert 技能。

技能介绍

解决什么问题

版本多了以后,「到底改了什么」会变成花时间的事。设计稿旁边的文案、接口返回的 JSON、季度复盘表格、合同 PDF,可能同时存在 v1.docx、v2.xlsx、最终版.pdf 和 final_final.md。手动滚动两份文件比对,容易漏掉角落里改掉的一行配置,或者误以为某段重写是新增内容,实际只是注释格式变了。命令行工具又常常只覆盖单一格式,Word、Excel、PDF 得各找一套方案,结果难以统一。

这个技能把这件事收进一个统一的入口:给它两个路径,它告诉你差异在哪里、属于什么类型、能不能导出成可分享的报告。

核心能力

文件级对比支持 .txt、.md、.csv、.json、.xml、.yaml、.yml 以及 .py、.js、.ts、.html 等源代码文件。对于文本和 JSON,可做到词级精细对比,而不是只看整行有没有变化。

结构化文档对比按各自格式的天然单位展开:Excel 逐单元格检测,PDF 逐页分析,Word 解析段落与文本结构。处理 Excel 时不会把表格结构差异误当成大量内容增删;处理 PDF 时差异被定位到具体页面。

目录递归对比用于工程树、文档仓库或配置目录场景,自动扫描两个文件夹并列出新增、删除、修改的文件,不必先人工确认哪些文件需要参与对比。

多种导出产物:终端彩色输出(红删绿增),可独立打开的 HTML 报告(带语法高亮),适合纳入版本控制的 Markdown 报告,以及供程序消费的 JSON 结构化数据。

忽略模式允许指定只比对内容:跳过空白字符差异、排除注释变化、忽略格式差异。设置差异不敏感规则后,格式化改动不再淹没真正有业务价值的改动。

编码自动检测按 utf-8 → gbk → latin1 回退,面对中文项目里常见的混用编码不会直接报错退出。

工作方式

技能暴露一个 CLI,包含 compare、compare-dir、history、export、stat、ignore 六个子命令。典型流程是先跑 stat 确认差异规模,再决定是否需要导出 HTML 读细节,或导出 JSON 接入后续脚本。history 子命令接受多个版本文件按顺序对比,输出从旧到新的变更轨迹,适合回答「这三版之间到底改了哪些东西」。

适用边界

所有读取、比对和导出都发生在本地,输入文件不会被修改,可放心对正式文档做差异分析。但二进制格式的解析深度有限,复杂排版的 Word 与 PDF 会聚焦在文本内容层面。目录递归对比不做语义合并,重命名和移动会表现为删除加新增。忽略模式也按字面匹配,不保证适配所有注释语法或模板框架。

使用场景

  • 代码配置修改后,用词级对比确认两个 JSON 配置多了哪些字段,导出 JSON 报告归档。
  • 有 v1/v2/v3 三版 Word 方案,跑 history 看从旧到新的变更轨迹,只保留业务改动。
  • 两份产品文档存在两个目录,用 compare-dir 找出新增、删除和修改的文件清单。
  • Excel 结构相同的两个版本表格,逐单元格对比找出数值变动,忽略空白与格式差异。

适合人员

  • 需要审核 Word/Excel/PDF 多版变更的产品经理,想确认合同或方案最终改在哪里。
  • 维护多分支代码配置的后端工程师,要在合并前核对两个版本 JSON 的字段差异。
  • 负责多轮文档迭代的内容运营,需要从 v1 到 vN 中提取有实质意义的内容变更。
  • 管理大量教学材料版本的历史教师,想要自动确认哪些课件被调整并生成对比记录。