@andy8647/pi-toolbox

圆角透明工具箱,美化pi编码代理输出

开发流程 美化终端界面统一终端界面 通用 更新于 2026-09-13

安装使用

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

帮我安装这个 AI Skill:@andy8647/pi-toolbox。
它的用途是:圆角透明工具箱,美化pi编码代理输出
完整的 Skill 内容见:https://321skill.com/skills/andy8647-pi-toolbox/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'安装pi-toolbox,然后重启pi,让所有工具框变成圆角透明并带有语法高亮。' 你会看到每次工具调用后,输出框的边框变为圆角,背景透明,bash命令中的关键词、参数、字符串等被着色,执行状态通过边框颜色直观呈现。

介绍

这个Skill解决了pi编码代理默认工具框外观简陋、缺乏视觉层次的问题。在实际开发中,AI代理会频繁调用各种工具(内置命令、MCP服务、子代理等),每次输出都使用相同的方框样式,难以区分状态和内容,尤其在终端透明背景下显得杂乱。

使用方式很简单,你只需要执行pi install npm:@andy8647/pi-toolbox并重启pi即可生效。之后所有工具框都会自动升级为圆角边框,背景变为透明,边框颜色会根据执行状态(灰色执行中、绿色成功、红色错误)动态变化,bash命令区域还会获得逐词语法高亮。无需额外配置,开箱即用。

它非常适合需要长时间在终端中与AI编码代理协作的开发者,尤其是那些使用透明终端背景、注重界面美观和可读性的人。也是智能体开发、后端开发、全栈开发者在日常编码中提升视觉体验的实用工具。

建议在配置终端主题时,将工具背景色设置为空字符串("toolPendingBg": ""等)以获得最佳透明效果。需要注意的是,该扩展仅适用于pi编码代理,不兼容其他IDE或终端。滚动场景下的缓存机制能有效避免重渲染,但若遇到极端大量输出(300+框),仍有轻微性能开销。

常见问题

如何安装pi-toolbox?

执行 `pi install npm:@andy8647/pi-toolbox` 或 `pi install git:github.com/Andy8647/pi-toolbox`,然后重启pi。

如何关闭bash语法高亮?

在 `~/.pi/agent/settings.json` 中设置 `"toolbox": { "highlightBash": false }`。

给 AI 助手的安装指引

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

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