pi-minimalist

English | 简体中文 | Français

本文翻译自英文版 README.md,如有出入以英文版为准。命令、设置名和 JSON 键保持英文原样,方便你在界面里对照。

少滚动,给答案留出更多空间。

让 Pi 的对话记录更安静:把冗长的工具调用折成一行摘要,需要时再展开完整输出。

效果对比

之前: 一次工具调用占掉大半个屏幕。

之后: 同一次调用,只占一行。

点击折叠的一行,会把它展开成多行。点击其中一行,只看这一行的输出。点击展开区域上方的 ▾ Expanded · click to fold,可以重新折叠。

按 Ctrl+O 展开工具输出,包括 diff 和语法高亮。展开后的行会自动换行显示长命令,不会截断。会话内容不会被删除,模型也看得到全部内容;只有显示方式改变。

安装

pi install npm:pi-minimalist

重启 Pi,工具调用就会显示为紧凑的一行。不需要任何配置。

选择你想要的安静程度

运行 /minimalist 可以实时修改设置。可以只用紧凑工具行,也可以走得更远:

• Combine consecutive tool calls(合并连续工具调用):合并成一条摘要,例如 read ×2, edit ×1。
• Collapse earlier activity(折叠早先的活动):让最新的回复保持在视线中心。之前的活动会被替换成耗时或工具计数。
• Compact thinking rows(紧凑思考行),或让思考内容在生成时保持可见。
• Keep running tools visible(保持运行中的工具可见):在合并其他调用的同时,运行中的工具会带计时器显示已耗时间。
• Excluded tools(排除的工具):让指定工具(例如 subagent)保留自己的卡片,不压缩成一行。在 /minimalist 里打开该行,输入关键字搜索,在工具上按 Enter 即可切换。

全新安装默认使用 full 预设(见下文):紧凑工具行、合并调用和紧凑思考行。活动折叠需要手动开启。如果你想逐条看到每次调用,请选择 lite。

预设

/minimalist 顶部的 Preset 一行,可以一次设置四个选项:Compact tool rows、Combine consecutive tool calls、Collapse earlier activity 和 Compact thinking rows。

| 预设 | 效果 | | --- | --- | | off | Pi 原生的工具卡片。 | | lite | 单行工具行,每次调用各占一行。 | | full | lite 加上合并连续调用和紧凑思考行。 | | max | full 加上折叠早先的活动(Worked for …)。 | | custom | 这四个选项使用你自己的值。 |

预设不会覆盖你的设置。选中 off、lite、full 或 max 时,只有那四行会变灰并显示预设的值,在它们上面按 Enter 没有任何作用。其他选项(Left border、Elapsed timer、Symbols 等)仍然归你所有,可以继续编辑。你自己的值会被保留,选回 custom 时会恢复。第一次选择 custom 时,会从 lite 开始。

升级说明: 如果你的设置里已经有 minimalist 配置块,你会继续停留在 custom,什么都不会变。只有完全没有 minimalist 设置的用户才会从 full 开始,这会让思考行变得紧凑。想换一种外观,修改 Preset 即可。

日常操作

| 操作 | 作用 | | --- | --- | | /minimalist | 打开设置(/minimalist config 也可以) | | /minimalist status | 显示当前设置 | | Ctrl+O | 展开或折叠工具输出 | | Ctrl+T | 展开或折叠思考内容 |

设置会作用于已有的对话历史,并保存为全局设置。如果某个符号在你的终端里显示不正常,请选择 Symbols → ASCII。不需要 Nerd Font。

回到 Pi 的默认外观

关闭 Compact tool rows 即可恢复原生工具卡片。也可以选择 off 预设。

要完全禁用这个扩展,运行 pi config,禁用 pi-minimalist,然后重启 Pi。

兼容性

已在 Pi 1.0.0 上测试。Pi 的更新可能影响渲染兼容性;请反馈问题,并附上你的 Pi 版本、终端和一张截图。

MIT 许可证。