pi-bash-live-view

为pi的bash工具添加实时终端渲染功能

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-bash-live-view。
它的用途是:为pi的bash工具添加实时终端渲染功能
完整的 Skill 内容见:https://321skill.com/skills/pi-bash-live-view/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'用 bash usePTY=true 执行 `ping -c 5 google.com`',它会启动一个带有 PTY 支持的 bash 会话,并实时显示每一次 ping 请求的往返时间,让你可以像在本地终端一样观察网络测试的全过程。

介绍

pi-bash-live-view 是一个 pi 扩展,它解决了在 AI 助手环境中执行 bash 命令时输出不实时、交互体验差的问题。通过为 pi 内置的 bash 工具引入 PTY(伪终端)支持,它能够像在真实终端中一样,实时、流式地渲染命令执行过程与结果。

使用方式非常简单,在调用 pi 的 bash 工具时,只需设置参数 usePTY=true 即可启用此扩展。启用后,执行命令的输出将不再是等待命令完全结束后一次性返回,而是逐行、实时地显示,让你可以清晰地看到命令执行的进度和中间输出。

这个扩展非常适合需要在 AI 助手(如 Claude)中频繁执行命令行操作,并希望获得更接近本地终端体验的开发者和运维人员。无论是调试脚本、监控进程状态,还是执行需要观察实时输出的长时任务,它都能显著提升交互效率和体验。

使用建议是,对于需要实时反馈的命令(如 pingtail -f、长时间编译等)强烈建议启用此扩展。需要注意的是,由于它模拟了真实终端环境,某些依赖于特定终端特性的命令或交互式程序(如 vimtop)可能仍无法完美运行,且可能会比非 PTY 模式消耗稍多的资源。

核心特点

核心区别在于,它通过 `usePTY=true` 参数为 pi 的 bash 工具启用了伪终端支持,实现了命令输出的实时流式渲染,而同类工具通常只提供命令执行完毕后的静态结果输出。

注意事项

不适合运行重度依赖图形界面或复杂终端交互(如全屏文本编辑器)的命令。

常见问题

如何启用实时终端渲染?

在 pi 的 bash 工具调用命令中添加参数 usePTY=true。

支持哪些 AI 助手?

主要设计用于与 pi 配合使用,在支持 pi 的环境(如 Claude Desktop)中运行。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-bash-live-view/raw/index.md 读取 pi-bash-live-view 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。