Pi 工具显示增强

这个 Agent 能做什么，适合哪些场景？

pi-tool-display 是面向 Pi coding agent 的扩展，通过 Pi 的扩展机制接管所选内置工具及明确配置的自定义工具渲染。它为 read、grep、find、ls、bash、edit 和 write 提供紧凑输出，并可将结果隐藏、汇总或预览。edit 和 write 的差异视图会根据终端宽度选择分栏或统一布局，也支持流式调用期间的待处理编辑预览。扩展还提供 MCP 工具显示模式、思考标签、原生用户消息框和 /tool-display 设置命令。可从本地扩展目录、npm 或 Git 安装；它运行在 Pi 的终端界面内，不是独立应用。

安装并加载扩展后，它为 read、grep、find、ls、bash、edit 和 write 注册可配置的渲染器，把工具结果显示为隐藏输出、摘要或有限行预览；bash 另有 opencode 折叠模式。MCP 输出可设为隐藏、摘要或预览，其他扩展工具则需在 customToolOverrides 中明确启用，并可选择 generic 或 mcp 类型。edit 和 write 共用差异渲染器，可使用 auto、split 或 unified 布局；流式参数期间还可显示受当前工作区范围约束的待处理差异预览。它会在流式及最终消息中标注思考块，并在下一次模型轮次前清理这些展示标签。用户可通过 /tool-display 打开设置，或用 /tool-display show、reset 和 preset 命令查看及调整配置。

1. Pi 用户在终端中频繁调用 read 或搜索工具，希望默认收起冗长结果。
2. 开发者使用 edit 或 write 修改文件，希望在展开结果前查看清晰的差异和待处理预览。
3. 启用了 MCP 的 Pi 用户希望按摘要或预览模式控制工具结果占用的界面空间。
4. 同时使用多个 Pi 扩展的团队，希望逐个设置内置工具归属，减少渲染器冲突。
5. 扩展作者希望通过 pi-tool-display/tool-display-api-consumer 为自己的工具接入渲染适配器。

如何安装或部署这个 Agent？

先安装并运行 Pi coding agent。选择一种 README 支持的扩展安装方式：

如何使用这个 Agent？

安装后在 Pi 中打开设置，或直接应用预设：

/tool-display

查看当前有效配置：

/tool-display show

切换到简洁预设：

/tool-display preset opencode

若需让其他扩展接入渲染器，可导入 consumer API：

import { decorateToolForDisplay, decorateMcpToolForDisplay } from "pi-tool-display/tool-display-api-consumer";

在配置文件中按工具设置渲染规则，例如：

{
  "customToolOverrides": {
    "custom_mcp_gateway": {
      "enabled": true,
      "kind": "mcp",
      "outputMode": "preview"
    }
  }
}

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.5.0 2026-07-03
   发布说明摘录

   [0.5.0] - 2026-07-03 Added - Added an enabled config toggle that gates tool override registration, with reload cleanup that disposes overrides and patches on session_shutdown. ([c78163d](https://github.com/MasuRii/pi-tool-display/commit/c78163dddc0f94b7a542d2d1e01109c903bc70cc)) - Added regression coverage for the active backlog: expanded large-diff rendering in constrained tmux-style panes (#23) and the esbuild lockfile bump from PR #24. ([7e46231](https://github.com/MasuRii/pi-tool-display/commit/7e4623191583f31a056602d8a08f1a4a7accd8b6)) Changed …

   在 GitHub 查看 ↗
2. v0.4.3 2026-06-16
   发布说明摘录

   ### Added - Added customToolOverrides for explicit opt-in rendering of non-built-in extension tools, with generic as the default kind and optional mcp rendering for MCP proxy-style arguments. - Added custom tool override coverage for malformed config, output modes, late tool registration, argument shapes, and runtime contract preservation. Changed - Preserved configured MCP output mode even when MCP tools are not detected at startup, so dynamically registered MCP tools can still be decorated later. Fixed …

   在 GitHub 查看 ↗
3. v0.4.2 pi-tool-display 0.4.2 2026-06-01
   发布说明摘录

   [0.4.2] - 2026-06-01 Changed - Deferred config modal, settings inspector, and built-in tool metadata loading until needed to reduce startup work. - Replaced shared agent-directory lookup with a local PI_CODING_AGENT_DIR-aware resolver for config and capability checks. - Widened peer dependency ranges to ^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0. Fixed - Corrected classic-mode diff line-number gutter spacing.

   在 GitHub 查看 ↗

常见问题