@heyhuynhgiabuu/pi-diff
基于Shiki的终端代码差异高亮渲染器
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@heyhuynhgiabuu/pi-diff。 它的用途是:基于Shiki的终端代码差异高亮渲染器 完整的 Skill 内容见:https://321skill.com/skills/heyhuynhgiabuu-pi-diff/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘用pi比较一下当前文件和上一个提交的差异’,它会调用pi-diff渲染出一个语法高亮、单词级高亮的并排差异视图,让你清晰看到每一处具体的代码增删和修改。
介绍
pi-diff 解决了在终端中查看代码变更时,缺乏语法高亮和精细化差异对比的问题。它能够将代码差异以更直观、美观的方式在终端中呈现,提升代码审查和版本对比的体验。
使用方式非常直接,它是一个为pi命令行工具设计的插件。安装后,在pi的diff相关命令中,它会自动接管渲染过程,将原本单调的文本差异输出,替换为支持语法高亮、并可按单词级别(word-level)高亮变化的视图,同时支持并排(split)和合并(unified)两种显示模式。
这个Skill非常适合需要在命令行环境下频繁进行代码差异对比的开发者,例如进行Git代码审查、检查配置文件变更,或者对比不同版本脚本的输出。它尤其适合那些追求高效命令行工作流,又希望获得接近IDE或GUI工具视觉体验的用户。
建议在安装了pi工具的环境中使用。由于它依赖Shiki进行语法高亮,首次使用特定语言时可能需要下载对应的语法定义,可能会有短暂的延迟。确保你的终端支持真彩色(True Color)以获得最佳的视觉效果。
核心特点
核心区别在于它专为`pi`命令行工具深度集成,提供单词级别的差异高亮,而非仅行级对比,并且利用Shiki引擎实现了与VS Code等编辑器相媲美的精准语法高亮,在终端中即可获得GUI级别的diff体验。
注意事项
仅适用于`pi`工具生态,不适用于原生的`git diff`或其他diff工具的输出渲染。
常见问题
pi-diff 和 git diff 有什么区别?
pi-diff是pi工具的插件,用于美化pi产生的diff输出,提供高亮;git diff是Git原生命令。
支持哪些编程语言的语法高亮?
支持Shiki引擎支持的所有语言,涵盖主流编程语言和标记语言。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/heyhuynhgiabuu-pi-diff/raw/index.md 读取 @heyhuynhgiabuu/pi-diff 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/heyhuynhgiabuu-pi-diff/raw/index.md(查看排版版本)