用途
preview-diff 是一个内部工具,用于预览 Git 变更,并以 GitHub 风格的格式化方式呈现。它通过 /preview-diff 命令访问,适合在开发过程中快速查看当前工作区或分支之间的差异。
主要能力
视觉设计
- 带有清晰统计摘要的渐变标题栏
- 使用 diff2html 库实现 GitHub 风格的格式化
- 现代 UI,圆角与平滑过渡
- 通过优化的字体和间距提升可读性
功能
- 手风琴式文件:点击标题可展开或折叠
- 智能默认:第一个文件展开,其余折叠
- 全部展开/折叠按钮,便于快速控制
- 实时搜索:按文件名过滤文件
- 视图切换:在统一视图和并排视图之间切换
- 统一视图(默认):传统的逐行差异
- 并排视图:左右对比
- 变更统计:文件变更数、新增行数、删除行数
- 行号与语法高亮
- 跨会话保持视图偏好
- 显示所有变更:已跟踪、已暂存和未跟踪文件
使用方式
当用户要求预览差异时,不要手动构建 HTML。使用 Bash 工具执行该技能的 run.sh 脚本:
# 预览当前变更
git diff HEAD | ./run.sh
# 预览特定分支对比
git diff main..feature-branch | ./run.sh
脚本会处理所有 HTML 生成,并自动在浏览器中打开结果。不要手动打开文件,以避免重复标签页。
选项
脚本使用合理的默认值,但也支持以下标志以提供灵活性:
-o, --output PATH- 自定义输出路径--no-browser- 跳过浏览器,仅输出文件路径
技术
- diff2html:GitHub 风格的差异渲染
- git diff:统一差异格式
- JavaScript/CSS:基于浏览器的渲染
适用场景与限制
该工具适用于需要以可视化方式查看 Git 变更的开发者,尤其是希望获得类似 GitHub 界面体验的场景。它依赖 git diff 命令和 Bash 环境,通过脚本生成 HTML 并在浏览器中查看。资料中未提供关于平台兼容性、安装步骤、收费模式或性能限制的更多信息。