Agent Skills
返回列表
💻

终端语法高亮文件预览

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/terminal-file-preview-guide。

技能介绍

为什么要把「读文件」做到极致

工程师调试时最常用的操作之一,是「看一眼」某个文件的内容——可能是刚改的代码片段,也可能是待评审的配置。但裸 cat 没有语法高亮,长代码行会横向溢出,更看不到 Git 工作区的改动标记;重型编辑器启动慢,打断了「搜索→查看→定位」的连贯流程。这种低效在多文件比对、管道日志处理时会被放大:明明只是想确认「这次改了哪些行」,却要切换工具、手动找差异。

技能如何工作:从基础预览到 Git 感知

核心思路是用 bat 把终端阅读的体验补齐。基础预览直接替代 cat:单文件查看时自动加语法高亮和行号,目录输入会自动分页展开,避免文件太长刷屏;Git 感知是关键差异——结合 git status 在行号旁标记绿色「新增行」和黄色「修改行」,不用打开编辑器就能定位改动;分屏对照支持两份相近文件并排预览,配合 --wrap 控制长行折行,避免横向滚动丢上下文。

生态集成让流程更连贯:导出 BAT_THEME 统一终端配色(比如 ansi-dark 或 OneHalfDark),接管 less pager 保留翻页时的高亮;和 fzf、ripgrep 串联后,搜索命中按回车直接用 bat 预览,形成「搜→读」闭环。输出场景也很灵活:关闭分页后直接重定向到文件或剪贴板,作为代码评审附件;.md 文件先导出再贴入文档,比裸文本更易读。

适用边界与常见陷阱

几个坑要先避开:别全局覆盖 cat 的别名,构建脚本、Makefile 或 CI 里的命令常依赖 cat 的标准行为,覆盖后会导致管道异常;大文件直接用 bat 会卡,先用 head/tail 截取或加 --style=plain 关掉装饰;图片、压缩包这类二进制文件强行预览会刷屏乱码,先 file 判断类型;新机器没同步主题文件时,自定义主题会回退到无高亮,记得提前同步。

使用场景

  • 终端快速查看多个配置文件,对比不同环境的参数差异,不用打开编辑器逐个切换。
  • 管道中对日志输出上色,过滤关键字后直接预览,方便定位错误信息。
  • 终端生成带语法高亮和行号的代码片段,复制到文档中作为评审附件,避免手动排版。
  • 终端并排预览两个不同版本的文件,观察行级差异,不用依赖额外工具。

适合人员

  • 后端工程师:需通过 git status 快速定位代码改动行,避免打开编辑器逐行查找。
  • 运维人员:处理服务器日志时,通过管道高亮过滤关键字,提升错误信息识别速度。
  • 前端开发者:比对两个版本的 CSS 文件差异,需要行号和改动标记辅助确认。
  • 数据工程师:在终端查看 CSV 文件内容,依赖语法高亮区分数据列,避免横向滚动丢失上下文。