@heyhuynhgiabuu/pi-pretty
留守终端内部的全面视觉增强扩展:Shiki 语法高亮、树形 ls、内联图片预览、折叠工具输出与内嵌 FFF 检索。
安装命令
pi install npm:@heyhuynhgiabuu/pi-pretty 临时试用 / 替代安装命令
pi -e npm:@heyhuynhgiabuu/pi-pretty 挂接事件钩子与注册入口
session_start / session_shutdownsession_info_changedagent_start / agent_end / agent_settledmessage_update / message_end
内置工具渲染定制(read / bash / ls / find / grep)pi.registerCommand("fff-health" / "fff-rescan")ctx.ui.setWorkingVisible() / setToolsExpanded() / theme / notify() 1. 是什么
@heyhuynhgiabuu/pi-pretty是针对 Pi 默认终端输出的一站式美观与可读性增强扩展。
它还与作者配套的 @heyhuynhgiabuu/pi-diff 协同工作,并直接集成了 @ff-labs/fff-node 接管内置 find / grep 工具。
2. 解决什么问题
原生终端里 read、bash、ls 的输出缺少语法着色、图标层级与折叠收敛,连续调用多次工具后,核心信息很容易被海量纯文本淹没。
3. 作用原理(事件钩子与工具注册层)
覆盖内置工具的渲染外观与默认折叠行为,监听消息与运行状态更新以渲染微光指示条,并维护本地 FFF 文件索引。
- 在 session_start 为当前工作目录初始化内嵌的 FFF 索引(缓存独立存放在 ~/.pi/agent/pi-pretty/fff/)并接管 find/grep 工具名称。
- 默认把工具结果体收起为单行标题+行数摘要(保持排版整洁留白),用户可随时用 Pi 快捷键 Ctrl+O 展开单项或 Ctrl+Shift+O 全部展开。
- 对 read 使用 Shiki 语法高亮加行号(支持在 Ghostty、Kitty、iTerm2、WezTerm 甚至配置了 allow-passthrough 的 tmux 中直接内联显示图片);对 bash 输出带颜色的退出码摘要;对 ls 使用 Nerd Font 图标树形渲染;同时把输入框顶部的 Working… 与思考标签改为渐变微光(shimmer)提示。
4. 怎么装与基本配置
- 安装命令:pi install npm:@heyhuynhgiabuu/pi-pretty。
- 重要冲突提示:因为本包内置并接管了 find/grep 的 FFF 实现,开启内嵌 FFF 模式时请勿同时安装加载 @ff-labs/pi-fff。
- 如在 tmux 中需要看到内联图片,请先开启 tmux set -g allow-passthrough on,并建议使用安装有 Nerd Font 的终端字体。
5. 和同类怎么选
在纯终端美化类扩展中,pi-pretty 覆盖面最全;若只想做“工具折叠”或“只改页脚状态栏”,则有更轻的单点替代。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
pi-tidy | pi-tidy 专注把常规工具调用折叠成可点击单行(失败与 diff 保留展开),不接管 FFF 搜索也不做 Shiki/树形 ls 重绘。 | 已经另行装了 @ff-labs/pi-fff,只想单独解决工具输出刷屏折叠,选 pi-tidy。 |
pi-starline / @narumitw/pi-statusline | 聚焦终端底部页脚状态栏的信息重组,不修改工具正文渲染。 | 只缺高信息密度状态栏时选它们;想全面美化 read/bash/ls 与加载动画选 @heyhuynhgiabuu/pi-pretty。 |
看完「@heyhuynhgiabuu/pi-pretty」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。