文本差异查看器

要解决的问题

比较两个文本文件时，原始 diff 输出经常把变更行、上下文和空行混在一起，人工定位“到底哪几行变了”需要来回滚动。text-diff 把 Python difflib 的逐行比较包装成可读的终端结果，适合快速检查脚本、配置、生成文本或翻译稿之间的差异。

工作方式

它接收两个文本文件路径，然后调用 difflib 生成行级差异。根据参数可选择：

• unified：统一 diff（默认），显示变更附近的上下文
• context：上下文 diff，按 hunk 分组
• side-by-side：左右对照，一行对一行展示

常用选项包括 -c/--context 控制上下文行数，-o/--output 将结果写入文件，--no-color 关闭颜色。退出码明确：0 表示文件相同，1 表示存在差异，便于接入脚本或 CI。

适用边界

该技能面向纯文本文件的行级比较，不解析代码语义、格式或二进制内容。对于大型目录、生成文件噪声较多时，仍建议先用过滤器缩小比较范围；若需要字符级、词级差异或合并冲突处理，text-diff 只能作为快速查看层，不能替代完整 diff 工具链。