pi-minimode

Pi 扩展（extension）：提供 /minimode 命令，控制 Pi 暴露给 LLM 的工具与 skills 信息。

用途

Pi 默认会把全部可用工具（内置 + 所有扩展注册的工具）暴露给 LLM，并把 skills 列表注入系统提示。minimode 开启时只保留 Pi 默认开启的工具（defaultTools 设置或出厂默认 read/bash/edit/write），其余工具与系统提示中的 skills 列表不再暴露——减少 LLM 上下文的噪音与 token 开销。

• 工具名单按名字判断：同名覆盖（如 aft-pi 增强版 read/write/edit/grep）视为同一工具，可用；其它扩展专属工具隐藏。
• 用户主动 /skill:xxx 调用不受影响（不再暴露的是"模型可见的 skills 列表"，不拦截用户行为）。

安装

pi install npm:pi-minimode

或在 ~/.pi/agent/settings.json 的 packages 中加入：

"packages": ["npm:pi-minimode"]

开发期也可本地加载（指向扩展入口文件）：

pi -e /path/to/pi-minimode/extensions/pi-minimode/index.ts

使用

/minimode        # 显示当前状态（底部状态栏 + 会话记录）
/minimode on     # 开启：只暴露 Pi 默认工具；系统提示剥离 skills 列表
/minimode off    # 关闭：恢复为从未开启过 minimode 的状态

• 状态指示：TUI 底部状态栏常驻显示 minimode on/off；会话历史中留有 minimode-status 自定义条目（供程序/调试读取）。
• 状态按项目（cwd）隔离，持久化于 <cwd>/.pi/minimode.json；会话切换/重载后自动恢复。

行为要点

• minimode on：在发给 LLM 的请求上实时过滤（工具定义只留 Pi 默认集、系统提示剥离其它工具描述与 skills 列表），不是安全边界；Pi 自身工具面板等仍显示全量。
• minimode on 期间：任何时刻新增/重新加载的工具，下一次 LLM 请求即被过滤（无需校正、无状态需要维持）。
• minimode off：停止过滤 = 完全恢复为从未开启过的状态；不触发 reload，对其它扩展（aft 进程、magic-context 在途任务等）没有任何影响。

License

MIT