返回工具区 TOOLS

Pi 工具链手册

本机 pi 装了哪些包、每个包怎么用、命令与配置在哪、哪些文档根本没写。

采集日期 2026-10-24 pi 核心 @earendil-works/pi-coding-agent 1.4.0 已装包 11 个

版本基线

这张表是这一版内容的基线：下面的命令与配置都是对着这些版本抄的。

包版本来自
pi-mcp-adapter6.0.0npm:pi-mcp-adapter
pi-web-access0.44.0npm:pi-web-access
@juicesharp/rpiv-ask-user-question2.15.0npm:@juicesharp/rpiv-ask-user-question
pi-background-tasks2.6.10npm:pi-background-tasks
@plannotator/pi-extension0.28.30npm:@plannotator/pi-extension
pi-agent-browser-native0.9.6npm:pi-agent-browser-native
context-mode1.0.169npm:context-mode
pi-subagents0.82.1npm:pi-subagents
pi-tui-plus 本地路径0.4.1本地路径 ~/.pi/packages/pi-tui
pi-compact-transcript0.12.0npm:pi-compact-transcript
@yusukeshib/pi-working-status0.1.1npm:@yusukeshib/pi-working-status

速览

208pi 自身命令面

pi 自己就有的命令与配置，装上就有。

85包与扩展

用 pi install 装的包，每个包能改哪些行为。

3MCP server

外接的 MCP server，以及它是怎么被接进来的。

69技能清单

模型按需加载的技能，含谁带来的。

61内置工具

会话里能直接调用的工具，分核心与包提供。

我装了哪些包命令与配置在哪有哪些技能

数字是条目或表格行数，不是字数；每一项都能在左侧目录点进去，或在下面的过滤框里搜。

术语速查

词本页的用法
包（package）pi 用 `pi install` 装进来的 npm 包或本地路径包，靠 package.json 的 `pi` 字段声明要加载什么。
扩展（extension）包（或 <PI_HOME>/extensions/）导出的代码，给 pi 加工具、改界面、拦事件。一个包可以带多个扩展。
插件（plugin）口语词，本页不用它做技术分类：一个包可能同时带扩展、技能和 prompt。
MCP server外部进程，按 Model Context Protocol 把工具暴露给 pi；本机由适配器包接管，不走 pi 内置实现。
技能（skill）一段带 frontmatter 的 SKILL.md，模型按需加载；来源可以是用户目录、pi 自带目录，或某个包。
工具（tool）模型在会话里能直接调用的函数。可能由 pi 核心提供，也可能由某个包注册。
真源 / 生成物真源是 data.json（手改这个）；生成物是这一页（重跑生成器才变）。

显示 19 / 19 条

pi 自身命令面

pi 命令行：子命令与 flag

来自 pi 核心版本 1.4.0

pi 自己的命令行面：顶层子命令加全部 flag，收自 docs/cli.md。

共 82 行，展开查看
命令 / flag参数形态作用出处
pipi [options] [--] [@files...] [messages...]主入口：无参数且 stdin/stdout 是终端时进 TUIcli.md:8
@path@<相对路径>把文本文件或图片并入首个 prompt；相对 cwd 解析cli.md:35
--分隔符终止选项解析，使 prompt 可以 - 开头cli.md:37
pi installpi install <source> [options]安装包cli.md:9
pi removepi remove <source> [options]移除包及其 settings 条目cli.md:10
pi uninstallpi uninstall <source> [options]remove 的别名cli.md:11
pi updatepi update [target] [options]无 target 时更新 pi 自身cli.md:12
pi listpi list列出已配置的包cli.md:13
pi configpi config [options]配置哪些包资源被加载cli.md:14
pi authpi auth <check|print-api-key|print-bearer-token> [options]凭据检查/打印cli.md:15
pi mcppi mcp <list|login|logout> [options]MCP 管理入口（synopsis 仅列三个子命令）cli.md:16
-p, --print无值跑完 prompt，把最终助手文本写到 stdout 后退出cli.md:45
--mode text字面量文本输出；但 stdin/stdout 是终端时仍开 TUIcli.md:46
--mode json字面量输出 JSONL 事件到 stdout 后退出cli.md:47
--mode rpc字面量从 stdin 读 JSONL 命令，向 stdout 写响应与事件cli.md:48
--export--export <input> [output]把会话文件导出为 HTML 后退出；省略 output 时自行推导cli.md:49
--provider--provider <name>把 --model 查找限制到单一 provider；必须配 --modelcli.md:63
--model--model <pattern>精确 ID 或模糊 ID/name 匹配，支持 provider/id 与 :<thinking> 后缀cli.md:65
--api-key--api-key <key>非持久化 API key 覆盖；需先经 --model/--models 选定模型cli.md:67
--thinking--thinking <off|minimal|low|medium|high|xhigh|max>设置思考等级，覆盖 --model 后缀并按模型能力 clampcli.md:69
--models--models <patterns>逗号分隔的启动/循环模型范围，支持精确 ID、模糊、大小写不敏感 glob 与 :<thinking>cli.md:71
--list-models--list-models [search]列出可用模型（可模糊过滤）后退出cli.md:73
-c, --continue无值继续当前项目最近的会话cli.md:86
-r, --resume无值打开会话选择器cli.md:88
--session--session <path|id>按路径/精确 ID/部分 ID 打开；优先当前项目，跨项目匹配会提示 forkcli.md:90
--session-id--session-id <id>打开指定项目会话 ID，不存在则创建；字符限于字母数字 . _ -cli.md:92
--fork--fork <path|id>把已有会话 fork 成当前项目的新会话cli.md:94
--session-dir--session-dir <dir>覆盖存储与查找；优先于 PI_CODING_AGENT_SESSION_DIR 与 sessionDircli.md:96
--no-session无值使用不落盘的内存会话cli.md:98
-n, --name--name <name>设置会话显示名cli.md:100
-t, --tools--tools <list>以逗号分隔的 allowlist 替换默认工具选择；条目可为名字或含 * 的模式cli.md:119
-xt, --exclude-tools--exclude-tools <list>在其他所有选择选项（含 MCP）之后禁用指定工具cli.md:121
-nbt, --no-builtin-tools无值关默认内置工具，保留扩展与自定义工具cli.md:123
-nt, --no-tools无值内置/扩展/自定义/MCP 全部关闭启动cli.md:125
-e, --extension--extension <path>加载扩展文件/目录或内置扩展（如 builtin:mcp）；可重复cli.md:194
-ne, --no-extensions无值关发现/配置/内置扩展；显式 -e 仍加载cli.md:196
--no-mcp无值本次运行关内置 MCP 支持（无服务器、无 MCP 工具、无 /mcp）cli.md:198
--skill--skill <path>加载 skill 文件/目录；可重复cli.md:200
-ns, --no-skills无值关发现/配置的 skills；显式 --skill 仍加载cli.md:202
--prompt-template--prompt-template <path>加载 prompt 模板文件/目录；可重复cli.md:204
-np, --no-prompt-templates无值关发现/配置的模板；显式路径仍加载cli.md:206
--theme--theme <path>加载主题文件/目录；可重复cli.md:208
--use-theme--use-theme <name[/name]>选定本次运行的初始交互主题cli.md:210
--no-themes无值关发现/配置的主题；显式 --theme 仍加载cli.md:212
-nc, --no-context-files无值关 AGENTS.md 与 CLAUDE.md 发现cli.md:214
--system-prompt--system-prompt <text|path>用文本或已存在文件内容替换默认系统提示cli.md:229
--append-system-prompt--append-system-prompt <text|path>向系统提示追加文本或文件内容；可重复cli.md:231
--tui-mode--tui-mode <fullscreen|regular>终端模式；文档标注 fullscreen 为默认cli.md:233
--verbose无值显示详细启动信息，覆盖 quietStartupcli.md:235
-a, --approve无值本次进程信任项目本地配置与资源cli.md:237
-na, --no-approve无值本次进程忽略受信任门控的项目本地配置与资源cli.md:239
--offline无值关自动联网（含模型目录刷新）；等价 PI_OFFLINE=1cli.md:241
-h, --help无值显示帮助（含扩展注册的 flag）后退出cli.md:243
-v, --version无值显示 pi 版本后退出cli.md:245
--local / -l无值用于 install/remove/uninstall/config，改用项目 settings 而非全局cli.md:267
pi update --extensions无值更新所有已装包cli.md:276
pi update <source>位置参数更新单个已装包cli.md:277
pi update --models无值刷新模型目录cli.md:278
pi update --all无值同时更新 pi 与所有已装包cli.md:279
--force无值当选中更新包含 pi 时重装 picli.md:281
pi update --self / self / pi位置参数/flagpi update 的别名族cli.md:288
pi update --extension <source>位置参数pi update <source> 的别名cli.md:289
--provider（auth 子命令）--provider <provider>为某 provider 解析凭据（三子命令通用）cli.md:309
--model（auth 子命令）--model <model>从模型解析凭据；可与 --provider 组合cli.md:310
--json（auth check）无值以 JSON 输出结构化结果cli.md:311
--credentials（auth check）无值ready 时一并输出解析到的凭据cli.md:312
--no-refresh（auth check）无值不刷新过期 OAuth 凭据（默认会刷新）cli.md:313
--min-expiry（print-bearer-token）--min-expiry <ms|s|m|h>要求剩余有效期，如 30mcli.md:314
pi mcp addpi mcp add <server> [options] -- <command> [args...]新增/替换 stdio server 到 mcp.jsoncli.md:324
--env（mcp add）--env KEY=VALUE设置 stdio server 环境变量；可重复cli.md:324
--cwd（mcp add）--cwd <dir>设置 stdio server 工作目录cli.md:324
--url（mcp add）--url <url>新增/替换 streamable HTTP servercli.md:325
--header（mcp add）--header KEY=VALUEHTTP 请求头；可重复cli.md:325
--bearer-token-env-var--bearer-token-env-var <NAME>发送 Authorization: Bearer ${NAME}cli.md:325
--oauth-client-id / --oauth-client-secret / --oauth-callback-port / --oauth-client-name各自带值配置 HTTP server 的 OAuth 认证cli.md:325
pi mcp removepi mcp remove <server>从 mcp.json 移除 server；已存 OAuth 凭据保留cli.md:326
pi mcp listpi mcp list [--json]连接所有启用 server 并打印状态/工具/错误；异常时退出码 1cli.md:327
pi mcp loginpi mcp login <server> [--timeout <seconds>]OAuth 登录；--timeout 默认 300 秒cli.md:328
pi mcp logoutpi mcp logout <server>删除该 server 已存 OAuth 凭据cli.md:329
--local / -l（mcp）无值add/remove 改写当前目录 .pi/mcp.json 而非 ~/.pi/agent/mcp.jsoncli.md:331
--exposure（mcp add）--exposure <mode>设置 MCP 工具暴露模式cli.md:331
--description（mcp add）--description <text>设置 server 描述cli.md:331

pi 斜杠命令

来自 pi 核心版本 1.4.0

会话里能敲的斜杠命令全表，收自 docs/slash-commands.md。

命令作用出处
/settings打开设置slash-commands.md:11
/model [provider/model]选择模型slash-commands.md:12
/thinking [level]设置思考等级slash-commands.md:13
/scoped-models配置交互循环使用的模型slash-commands.md:14
/login [provider]添加 provider 认证slash-commands.md:15
/logout移除 provider 认证slash-commands.md:16
/llama管理已配置 llama.cpp router 上的模型slash-commands.md:17
/new开新会话slash-commands.md:23
/resume切换到另一个已存会话slash-commands.md:24
/name [name]设置会话显示名；省略时显示当前名slash-commands.md:25
/session显示当前会话信息与统计slash-commands.md:26
/tree在会话树中导航slash-commands.md:27
/fork从更早的用户消息创建新会话slash-commands.md:28
/clone在当前位点复制当前会话slash-commands.md:29
/compact [instructions]压缩当前上下文，可带自定义指令slash-commands.md:30
/import <path>导入并恢复一个 JSONL 会话slash-commands.md:31
/copy复制最后一条助手消息slash-commands.md:37
/export [path]把会话导出为 HTML 或 JSONLslash-commands.md:38
/share上传会话并返回查看链接slash-commands.md:39
/bug [description]准备给 pi 开发者的私有缺陷报告slash-commands.md:40
/trust保存项目信任决定供后续 pi 进程使用slash-commands.md:48
/reload重载键位、扩展、skills、模板、主题、上下文文件slash-commands.md:49
/hotkeys显示生效的键盘快捷键slash-commands.md:50
/changelog显示 changelog 条目slash-commands.md:51
/quit退出 pislash-commands.md:52
扩展注册的命令带各自参数与补全行为slash-commands.md:56
每个 prompt 模板以模板名作为命令slash-commands.md:57
/skill:nameskill 命令（enableSkillCommands 开启时）slash-commands.md:58

pi 环境变量

来自 pi 核心版本 1.4.0

pi 认的环境变量与默认值，收自 docs/environment-variables.md。

变量含义默认值出处
AI_AGENT=pi通用进程标记，供工具识别启动者由 CLI/RPC 入口自动设为 pienvironment-variables.md:15
PI_CODING_AGENT=truepi 专用标记，供子进程判断自己跑在 pi 内由 CLI/RPC 入口自动设为 trueenvironment-variables.md:16
PI_SESSION_ID当前会话 ID每个 shell 命令启动时注入environment-variables.md:26
PI_SESSION_FILE当前会话 JSONL 的绝对路径临时会话下不设environment-variables.md:27
PI_PROVIDER当前选中的 model provider随模型切换environment-variables.md:28
PI_MODEL当前选中的 model ID随模型切换environment-variables.md:29
PI_REASONING_LEVEL当前生效推理等级：off..max随思考等级变化environment-variables.md:30
PI_CODING_AGENT_DIR覆盖配置目录~/.pi/agentenvironment-variables.md:81
PI_CODING_AGENT_SESSION_DIR覆盖会话存储目录文档未载；被 --session-dir 覆盖environment-variables.md:82
PI_PACKAGE_DIR覆盖包目录（Nix/Guix store 路径用）文档未载environment-variables.md:83
PI_OFFLINE关自动联网（含模型目录刷新）文档未载（等价 CLI --offline）environment-variables.md:84
PI_SKIP_VERSION_CHECK关闭对 pi.dev 的版本查询文档未载environment-variables.md:85
PI_TELEMETRY覆盖安装/更新遥测与 provider 归属头；接受 1/true/yes 或 0/false/no文档未载environment-variables.md:86
PI_CODEMODE_MAX_WORKERS进程内跨会话同时存活的 codemode worker 上限；每个脚本最多 256 MB2environment-variables.md:87
PI_CACHE_RETENTION设为 long 启用（受支持的）provider 长 prompt 缓存文档未载environment-variables.md:88
PI_SHARE_VIEWER_URL覆盖 /share 使用的 base URL文档未载environment-variables.md:89
PI_RADIUS_GATEWAY覆盖 /bug 上传用的 Radius gateway origin文档未载environment-variables.md:90
PI_HARDWARE_CURSOR设为 1 显示硬件光标文档未载environment-variables.md:91
PI_CLIPBOARD_OSC52设为 1 在本地剪贴板写入后同时用 OSC 52 发送到终端文档未载environment-variables.md:92
PI_HYPERLINKS覆盖 OSC 8 超链接探测，取值 1/0/auto文档未载environment-variables.md:93
PI_PROGRAM_STATUS覆盖 OSC 7501 program status 探测：1 总上报、0 从不上报，否则待终端确认文档未载environment-variables.md:94
PI_IMAGE_PROTOCOL覆盖内联图片探测：kitty/iterm2/none/auto文档未载environment-variables.md:95
PI_TRUE_COLOR覆盖 truecolor 探测：1/0/auto文档未载environment-variables.md:96
PI_TUI_ESC_TIMEOUT单个 ESC 之后等待多久才当作 Escape，单位毫秒SSH 下 100，其他情况 10environment-variables.md:97
VISUAL, EDITORexternalEditor 未设置时的外部编辑器回退文档未载（按 shell 环境）environment-variables.md:98
HTTP_PROXY, HTTPS_PROXY出站 HTTP 代理文档未载environment-variables.md:99

settings.json 配置键

来自 pi 核心版本 1.4.0

settings.json 里能写的键（含嵌套路径），收自 docs/settings.md。

共 72 行，展开查看
键（含嵌套路径）含义默认值出处
defaultProvider启动时的 AI provider自动（文档写 Automatic）settings.md:13
defaultModel启动模型 ID自动settings.md:14
defaultThinkingLevel启动思考等级：off..max"medium"settings.md:15
modelThinkingLevels按精确 provider/modelId 指定各模型启动思考等级无settings.md:16
thinkingBudgetsminimal/low/medium/high 四档的 token 预算内置预算settings.md:17
enabledModels启动选择与模型循环用的模型模式，格式同 --models全部可用模型settings.md:18
hideThinkingBlock在 transcript 中隐藏 thinking 块falsesettings.md:19
showCacheMissNotices提示显著缓存未命中、缓存预热成功、压缩用量、provider 恢复falsesettings.md:20
cacheWarming保活 provider prompt 缓存：off/streaming/idle；仅全局设置"streaming"settings.md:21
steeringMode排队 steering 消息的投递方式：all/one-at-a-time"one-at-a-time"settings.md:31
followUpMode排队 follow-up 消息的投递方式：all/one-at-a-time"one-at-a-time"settings.md:32
externalEditor外部编辑器键位打开的编辑器命令$VISUAL → $EDITOR → 平台默认settings.md:33
doubleEscapeAction空编辑器下双击 Escape 的动作：tree/fork/none"tree"settings.md:34
treeFilterMode/tree 初始过滤：default/no-tools/user-only/labeled-only/all"default"settings.md:35
defaultProjectTrust项目信任回退行为：ask/always/never；只能在 agent 目录设置里设"ask"settings.md:36
defaultTools启动启用的工具；纯名字替换默认，+name/-name 增删，空数组关全部内置（不含扩展/SDK 工具）read、bash、edit、writesettings.md:42
codemode.modecodemode 激活时如何呈现工具：on/only"on"settings.md:43
codemode.inlineBudgetcodemode 工具描述可用于工具声明的估算 token 数（字符/4）；0 只列命名空间3000settings.md:44
sessionDir会话存储目录；相对路径按工作目录解析，被 PI_CODING_AGENT_SESSION_DIR 与 --session-dir 覆盖agent 会话目录settings.md:66
sessionShareDestination/share 目标：auto/gist/radius"auto"settings.md:67
compaction.enabled启用自动压缩truesettings.md:73
compaction.reserveTokens低于该空闲上下文 token 数触发自动压缩16384settings.md:74
compaction.keepRecentTokens保留不摘要的最近 token 数20000settings.md:75
compaction.modelOverrides按精确 provider/modelId 的 token 设置无settings.md:76
branchSummary.reserveTokens摘要分支历史时预留的 token16384settings.md:88
branchSummary.skipPrompt跳过分支摘要提示，默认不做摘要falsesettings.md:89
theme内置或自定义主题名；system 从终端主题取色"system"settings.md:95
quietStartuptrue 隐藏启动头与已加载资源列表；"header" 保留头部但隐藏模型范围行与资源列表falsesettings.md:96
tuiMode交互终端模式：regular/fullscreen"fullscreen"settings.md:97
fullscreenExitOutput全屏退出时打印的内容：transcript/resume-hint"transcript"settings.md:98
fullscreenScrollbar全屏 transcript 滚动条：auto/always/hidden"auto"settings.md:99
fullscreenCopyOnSelect全屏模式下自动复制选中文本truesettings.md:100
fullscreenWheelScrollLines全屏每格滚轮行数，1–100 或 auto"auto"settings.md:101
editorPaddingX编辑器水平内边距，0–3 格0settings.md:102
outputPadtranscript 水平内边距1settings.md:103
autocompleteMaxVisible可见补全条目数，3–205settings.md:104
showHardwareCursor用终端光标替代 pi 自绘光标falsesettings.md:105
terminal.showImages支持时显示内联图片truesettings.md:106
terminal.imageWidthCells内联图片首选宽度（终端格）60settings.md:107
terminal.clearOnShrink渲染内容变短时清空空行falsesettings.md:108
terminal.showTerminalProgress在终端标签显示 OSC 9;4 进度falsesettings.md:109
terminal.hyperlinks覆盖 OSC 8 超链接探测"auto"settings.md:110
terminal.images覆盖内联图片协议探测：kitty/iterm2/auto/false"auto"settings.md:111
terminal.trueColor覆盖 true-color 探测"auto"settings.md:112
images.autoResize发给模型前把图片缩到最大 2000×2000truesettings.md:113
images.blockImages阻止图片发给模型falsesettings.md:114
markdown.codeBlockIndent代码块渲染缩进前缀" "settings.md:115
markdown.mermaidMermaid 渲染模式：off/final/streaming"streaming"settings.md:116
transportprovider 首选传输：auto/sse/websocket/websocket-cached"auto"settings.md:124
httpProxy由 pi 管理的 HTTP 客户端代理 URL，写入 HTTP_PROXY/HTTPS_PROXY；只能在 agent 目录设置里设无settings.md:125
httpIdleTimeoutMsHTTP 头与体空闲超时毫秒；0 关闭300000settings.md:126
websocketConnectTimeoutMsWebSocket 连接超时毫秒；0 关闭15000settings.md:127
retry.enabled启用 agent 级瞬时失败重试truesettings.md:128
retry.maxRetriesagent 级最大重试次数3settings.md:129
retry.baseDelayMs指数退避初始延迟毫秒2000settings.md:130
retry.maxAgentDelayMsagent 级最大重试延迟毫秒60000settings.md:131
retry.provider.timeoutMsprovider 请求超时毫秒同 httpIdleTimeoutMssettings.md:132
retry.provider.maxRetriesprovider 级重试次数0settings.md:133
retry.provider.maxRetryDelayMs服务器要求延迟的上限毫秒；0 取消上限60000settings.md:134
shellPath自定义 shell 可执行路径，支持前导 ~平台默认settings.md:142
shellCommandPrefix前置到每条 shell 命令的前缀无settings.md:143
npmCommandnpm 包查找与安装用的命令与参数npmsettings.md:144
packagesnpm/git/本地 pi 包来源[]settings.md:154
extensions扩展文件或目录[]settings.md:155
skillsskill 文件或目录[]settings.md:156
promptsprompt 模板文件或目录[]settings.md:157
themes主题文件或目录[]settings.md:158
enableSkillCommands把 skills 注册为 /skill:name 命令truesettings.md:159
collapseChangelog更新后显示精简 changelogfalsesettings.md:169
enableInstallTelemetry匿名安装/更新上报与部分 provider 归属头；不控制更新检查truesettings.md:170
enableAnalytics选择加入分析数据共享（当前仅实验性首次运行设置使用）falsesettings.md:171
warnings.anthropicExtraUsageAnthropic 订阅认证可能产生额外计费时告警truesettings.md:172

包与扩展

context-mode

来自 npm:context-mode版本 1.0.169版本源 <PI_HOME>/npm/node_modules/context-mode/package.json

把代码执行搬进隔离沙箱、只把 stdout 倒回上下文的 MCP 插件，用来省上下文窗口。

使用场景

  • 日志、接口响应、快照这类大输出：在沙箱里跑代码分析，只把结论写回上下文 <PI_HOME>/npm/node_modules/context-mode/README.md:1178
  • 大段 markdown 切块进 SQLite FTS5，按需检索而不是整篇读进上下文 <PI_HOME>/npm/node_modules/context-mode/README.md:1188
  • 超出 5KB 且给了 intent 时自动转成「索引全文 + 按意图取相关片段」 <PI_HOME>/npm/node_modules/context-mode/README.md:1184
名称参数作用出处
ctx_batch_execute一次调用跑多条命令 + 多个检索查询；I/O 型任务可开 concurrency 1-8<PI_HOME>/npm/node_modules/context-mode/README.md:1165
ctx_execute在 12 种语言运行时里跑代码，只有 stdout 进入上下文<PI_HOME>/npm/node_modules/context-mode/README.md:1166
ctx_execute_file在沙箱里处理文件，原文不出沙箱<PI_HOME>/npm/node_modules/context-mode/README.md:1167
ctx_index按标题切块写进 FTS5 / BM25 索引<PI_HOME>/npm/node_modules/context-mode/README.md:1168
ctx_search一次多查询检索已索引内容<PI_HOME>/npm/node_modules/context-mode/README.md:1169
ctx_fetch_and_index取 URL → 转 markdown → 切块 → 索引；缓存 TTL 默认 24h<PI_HOME>/npm/node_modules/context-mode/README.md:1170
ctx_stats看省了多少上下文、调用次数与会话统计<PI_HOME>/npm/node_modules/context-mode/README.md:1171
ctx_doctor诊断运行时、hook、FTS5、版本<PI_HOME>/npm/node_modules/context-mode/README.md:1172
ctx_upgrade从 GitHub 升到最新、重建、重配 hook<PI_HOME>/npm/node_modules/context-mode/README.md:1173
ctx_purge永久删除知识库全部内容（不可恢复）<PI_HOME>/npm/node_modules/context-mode/README.md:1174
context-mode doctor不开 AI 会话，直接在终端诊断<PI_HOME>/npm/node_modules/context-mode/README.md:1447
context-mode index<path> --source <标签>终端里索引本地文件或目录<PI_HOME>/npm/node_modules/context-mode/README.md:1448
context-mode search<query> --source <标签>终端里检索已索引内容<PI_HOME>/npm/node_modules/context-mode/README.md:1449
context-mode upgrade终端里升级<PI_HOME>/npm/node_modules/context-mode/README.md:1450
context-mode insight打开托管的 Insight 面板<PI_HOME>/npm/node_modules/context-mode/README.md:1451

环境变量

变量含义出处
CONTEXT_MODE_DIR存储根目录；sessions 与 content 都在它下面。空值视为未设置，非空必须是绝对路径（~ 不展开）<PI_HOME>/npm/node_modules/context-mode/README.md:1600
CONTEXT_MODE_EXTERNAL_MCP_NUDGE_EVERY每隔多少次工具调用重注入「把大 payload 包进 ctx_execute」的提示；范围 1-100，非法值回落 10<PI_HOME>/npm/node_modules/context-mode/README.md:1606

相关文件

路径含义
<PI_HOME>/npm/node_modules/context-mode/包目录：pi 侧扩展入口与 8 个内置技能都在这里

pi-subagents

来自 npm:pi-subagents版本 0.82.1版本源 <PI_HOME>/npm/node_modules/pi-subagents/package.json

把活派给子 Pi 会话：单个委派，或脚本化的多代理工作流。

使用场景

  • 实现完先让 reviewer 子代理过一遍再总结 <PI_HOME>/npm/node_modules/pi-subagents/README.md:52
  • 同一改动并行跑多个 reviewer（正确性 / 测试 / 清理） <PI_HOME>/npm/node_modules/pi-subagents/README.md:81
  • 决策本身没底时让 oracle 挑刺，再决定要不要动手 <PI_HOME>/npm/node_modules/pi-subagents/README.md:78
  • 要跑长活时丢到后台，主线继续 <PI_HOME>/npm/node_modules/pi-subagents/README.md:87
名称参数作用出处
subagents_enable载入器：授权委派后，下一次模型请求才拿到完整 subagent schema<PI_HOME>/npm/node_modules/pi-subagents/README.md:47
subagent启动子会话；前台在对话里流式输出，后台在游离进程里继续跑<PI_HOME>/npm/node_modules/pi-subagents/README.md:45
bg_wait等后台工作结束（不激活也一直可用）<PI_HOME>/npm/node_modules/pi-subagents/README.md:47
/council<议题>多顾问辩论一个决策<PI_HOME>/npm/node_modules/pi-subagents/README.md:82
/subagents-fleet打开实时探测器：浏览子代理、读转录、steer 或停掉<PI_HOME>/npm/node_modules/pi-subagents/README.md:99
/parallel-review打包好的并行评审快捷方式<PI_HOME>/npm/node_modules/pi-subagents/README.md:93
/review-loop打包好的评审循环快捷方式<PI_HOME>/npm/node_modules/pi-subagents/README.md:93
键含义默认值出处
toolActivation控制全新会话是直接拿到 subagent，还是先只给 subagents_enable 载入器文档未载<PI_HOME>/npm/node_modules/pi-subagents/README.md:47
maxSubagentSpawnsPerRun一棵运行树里累计允许的逻辑子代理数，与并发数和会话级预算分开算64<PI_HOME>/npm/node_modules/pi-subagents/README.md:103

相关文件

路径含义
<PI_HOME>/npm/node_modules/pi-subagents/包目录：bundle 入口、13 份 agent 定义、prompts 与 docs 都在这里

pi-background-tasks

来自 npm:pi-background-tasks版本 2.6.10版本源 <PI_HOME>/npm/node_modules/pi-background-tasks/package.json

后台跑长命令、派只读代理、跑本机取证的 Pi 子进程，以及固定用途的 Fusion 多模型流程。

使用场景

  • 起 dev server、watch、跑长测试这类不阻塞对话的活 <PI_HOME>/npm/node_modules/pi-background-tasks/README.md:186
  • 让只读代理带着当前会话的上下文去调研，主进程继续干别的 <PI_HOME>/npm/node_modules/pi-background-tasks/README.md:187
  • 同一决策要三份独立意见：Fusion 合成 / 调查 / 研究 / 评审 <PI_HOME>/npm/node_modules/pi-background-tasks/README.md:189-192
名称参数作用出处
bg_delegateREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
bg_killREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
bg_logsREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
bg_resultREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
bg_runREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
bg_run_pi_attestedREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
bg_statusREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
fusion_investigateREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
fusion_reasonREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
fusion_researchREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
fusion_validateREADME 公共工具清单里登记的工具<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:48
/bgREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/bg-clearREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/bg-tasksREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/bg-updateREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/claude-cacheREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/fusionREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/fusion-modelsREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/jobsREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/killREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/logsREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
/tasksREADME 公共命令清单里登记的斜杠命令<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:46
键含义默认值出处
tool:bg_delegate受 feature:delegate 控制yes<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:57
tool:bg_result受 any(feature:delegate, feature:fusion) 控制yes<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:58
tool:bg_run_pi_attested受 feature:attested 控制yes<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:59
tool:fusion_reason受 feature:fusion 控制yes<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:61
dock:ctrl+alt+bfooter 任务的快捷键no<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:64

环境变量

变量含义出处
PI_BG_FEATURES严格的白名单集合，从 process / delegate / fusion / attested 等里选，用来关掉不想要的能力面<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:167

相关文件

路径含义
<PI_HOME>/npm/node_modules/pi-background-tasks/包目录：dist 扩展、docs、以及 BACKGROUND-TASKS-INSTRUCTIONS.md 都在这里

pi-mcp-adapter

来自 npm:pi-mcp-adapter版本 6.0.0版本源 <PI_HOME>/npm/node_modules/pi-mcp-adapter/package.json

接管 MCP：把 MCP server 的工具接进 pi，替代 pi 内置的那套 MCP 实现。

使用场景

  • 内置 MCP 实现不够用（导入登录、按项目禁用、面板与语义检索）时换这个适配器 <PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:19
名称参数作用出处
/mcp-adapter交互面板与首次运行引导<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:140
/mcp同 /mcp-adapter<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:141
/mcp-adapter setup引导式配置：导入、最小 .mcp.json、精选 server、配置路径自检<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:142
/mcp-adapter jev setup限制哪些 server 可以共享语义检索数据<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:143
/mcp-adapter edit[project|global]打开 .mcp.json 或全局 mcp.json 的编辑器<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:144
/mcp-adapter tools列出全部工具<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:145
/mcp-adapter prompts列出已注册成斜杠命令的 MCP prompt<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:146
/mcp-adapter reconnect重连全部 server<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:147
/mcp-adapter reconnect<server>只连/重连一个 server<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:148
/mcp-adapter disable<server>在项目级覆盖层里禁用（要 /reload 生效）<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:149
/mcp-adapter enable<server>通过项目级覆盖层启用（要 /reload 生效）<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:150
/mcp-adapter logout<server>清掉该 server 存的 OAuth 凭据并断开<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:151
/mcp-auth[<server>]打开 OAuth 选择器，或给指定 server 做授权<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:152-153
mcp{ search }按关键词搜工具<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:106
mcp{ tool, args }直接调一个 MCP 工具<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:117
键含义默认值出处
settings.autoAuth为 true 时 mcp 调用会在需要时自动走 OAuth 并重试一次文档未载<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:155

相关文件

路径含义
<PI_HOME>/mcp.jsonMCP server 清单（本机只登记了 rea）
~/.config/mcp/mcp.json全局 MCP 配置（/mcp-adapter edit global 打开）
<REPO>/.pi/mcp-adapter.json项目级覆盖层：disable / enable 写在这里

pi-web-access

来自 npm:pi-web-access版本 0.44.0版本源 <PI_HOME>/npm/node_modules/pi-web-access/package.json

给 pi 加联网能力：搜索、取页面、克隆 GitHub 仓库、读 PDF、看 YouTube 与本地视频。

使用场景

  • 查资料：先搜索再抓原文 <PI_HOME>/npm/node_modules/pi-web-access/README.md:148-152
  • 把一个 GitHub 仓库直接拉进来读 <PI_HOME>/npm/node_modules/pi-web-access/README.md:155
  • 看 YouTube 视频或本地录屏，问里面讲了什么 <PI_HOME>/npm/node_modules/pi-web-access/README.md:158-161
名称参数作用出处
web_search{ queries[], numResults, recencyFilter, provider }联网搜索；可一次给多个查询<PI_HOME>/npm/node_modules/pi-web-access/README.md:166
fetch_content{ url | urls[], mode, prompt }抓页面/仓库/PDF/视频；readable、raw、answer 三种模式<PI_HOME>/npm/node_modules/pi-web-access/README.md:198
get_search_content{ responseId, url | urlIndex, findText }取回已存结果的分页内容，或直接定位段落<PI_HOME>/npm/node_modules/pi-web-access/README.md:230
source_check{ claim, queries[] }为一条论断收集来源，并给出带精确引文的结构化证据<PI_HOME>/npm/node_modules/pi-web-access/README.md:245
/websearch<query>在会话里直接发起搜索<PI_HOME>/npm/node_modules/pi-web-access/README.md:411
/curator打开搜索结果的策展界面<PI_HOME>/npm/node_modules/pi-web-access/README.md:424
/search搜索的设置/历史入口<PI_HOME>/npm/node_modules/pi-web-access/README.md:437
/google-accountGoogle 账号相关的搜索配置<PI_HOME>/npm/node_modules/pi-web-access/README.md:441
键含义默认值出处
web-search.json搜索提供方与抓取配置；未指定 PI_CODING_AGENT_DIR 时默认读 ~/.pi/agent/web-search.json~/.pi/agent/web-search.json<PI_HOME>/npm/node_modules/pi-web-access/README.md:459

环境变量

变量含义出处
BRAVE_API_KEYBrave 搜索的密钥<PI_HOME>/npm/node_modules/pi-web-access/README.md:281
DATALAB_API_KEYPDF 转换（Datalab/Marker）的密钥，也可写在配置里<PI_HOME>/npm/node_modules/pi-web-access/README.md:365
NO_PROXY命中这些主机的请求绕过代理（localhost、127.0.0.1、[::1] 默认就绕）<PI_HOME>/npm/node_modules/pi-web-access/README.md:390
PI_CODING_AGENT_DIR覆盖默认配置目录（影响 web-search.json 位置）<PI_HOME>/npm/node_modules/pi-web-access/README.md:459

相关文件

路径含义
<PI_HOME>/web-search.json搜索提供方与抓取配置

@juicesharp/rpiv-ask-user-question

来自 npm:@juicesharp/rpiv-ask-user-question版本 2.15.0版本源 <PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/package.json

给模型一个结构化问卷工具：本该猜的时候改成给你 2-4 个带说明的选项。

使用场景

  • 任务里埋着真决策（比如选哪种缓存策略）时，让模型停下来问你而不是替你选 <PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:24-28
  • 一次问清最多四个问题，提交前一屏复核 <PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:43
名称参数作用出处
ask_user_question{ questions[] }弹结构化问卷；可选项带 preview，支持自定义答案与逐题备注<PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:28
键含义默认值出处
collapseKey收起/展开对话框的键；"off" 关掉快捷键ctrl+]<PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:54
notesKey打开备注编辑器的键n<PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:55
guidance.description整体替换模型看到的工具描述（不合并）内置描述<PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:56
guidance.promptSnippet系统提示里那一行描述，决定模型多主动地问内置片段<PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:57
guidance.promptGuidelines给模型的使用准则列表内置 4 条<PI_HOME>/npm/node_modules/@juicesharp/rpiv-ask-user-question/README.md:58

相关文件

路径含义
~/.config/rpiv-ask-user-question/config.json可选配置；只读不写，JSON 坏了就退回默认值

@plannotator/pi-extension

来自 npm:@plannotator/pi-extension版本 0.28.30版本源 <PI_HOME>/npm/node_modules/@plannotator/pi-extension/package.json

计划评审与代码评审界面：带批注的计划、可批注的助手消息、代码与 PR 评审。

使用场景

  • 先让代理写一份计划，你在界面上批注再批准 <PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:114
  • 开评审界面看当前改动、别的 worktree 或一个 PR <PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:402
名称参数作用出处
/plannotator-plan-mode切换计划模式：代理写 markdown 计划并提交路径<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:401
/plannotator-review[DIRECTORY | PR_URL]打开代码评审界面<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:402
/plannotator-annotate<file>在批注界面打开 markdown 文件<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:403
/plannotator-last批注最后一条助手消息<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:404
plannotator工具：打开/列出/关闭评审（关掉时由斜杠命令代替）<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:406
plannotator_inbox工具：往 Inbox 写、从 Inbox 读<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:387
pi --plan直接以计划模式启动<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:412
键含义默认值出处
per-phase behavior按阶段配置行为（计划模式各阶段的开关）文档未载<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:163

环境变量

变量含义出处
PLANNOTATOR_AGENT_TOOL设成 0 可以让 plannotator 工具不进模型的工具列表<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:90

相关文件

路径含义
<PI_HOME>/npm/node_modules/@plannotator/pi-extension/包目录：扩展入口、内置技能与图表引擎

pi-agent-browser-native

来自 npm:pi-agent-browser-native版本 0.9.6版本源 <PI_HOME>/npm/node_modules/pi-agent-browser-native/package.json

把 agent-browser 包成 pi 的原生工具：点控件、填表单、读页面、存文件。

使用场景

  • 要看或操作真网页：打开、快照、点击、填表 <PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:39
  • 固定步骤用 batch --bail，循环与分支用 agent_browser_code <PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:43-44
名称参数作用出处
agent_browser{ args[] }单条浏览器命令，或固定的 batch --bail 序列<PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:43
agent_browser_code{ code }同一个浏览器里跑 JS 循环与分支<PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:44
agent_browser_tools{ enable[] }按需打开 action / qa / electron / source / network 工具<PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:45
agent_browser_web_search可选：走 Exa 或 Brave 的搜索<PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:46
pi-agent-browser-doctor诊断 npm/PATH 与二进制安装<PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:94

相关文件

路径含义
<PI_HOME>/npm/node_modules/pi-agent-browser-native/包目录：dist 扩展与 docs

pi-compact-transcript

来自 npm:pi-compact-transcript版本 0.12.0版本源 <PI_HOME>/npm/node_modules/pi-compact-transcript/package.json

把转录压紧：思考摘要折叠起来，工具调用只留一行预览。

使用场景

  • 长会话里不想被大段思考与工具输出刷屏 <PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:7-11
名称参数作用出处
/compact-transcript开关切换<PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:89
/compact-transcripton|off显式设置<PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:90
/compact-transcript status看当前状态<PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:91
键含义默认值出处
summaryStyleplain / quote / off：活动摘要的样式或隐藏plain<PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:81
highlightToolActions加粗工具名与 shell 命令，方便扫读false<PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:82
enabled默认开关；会话里的 /compact-transcript 优先级最高true<PI_HOME>/npm/node_modules/pi-compact-transcript/README.md:84

相关文件

路径含义
~/.pi/agent/compact-transcript.json用户级配置
<REPO>/.pi/compact-transcript.json项目级配置（项目未被信任时忽略）

@yusukeshib/pi-working-status

来自 npm:@yusukeshib/pi-working-status版本 0.1.1版本源 <PI_HOME>/npm/node_modules/@yusukeshib/pi-working-status/package.json

把 pi 那句 Working... 换成一行实时状态，跟着一轮里的每个阶段变。

名称参数作用出处
/working-status[on|off]开关这一行状态显示<PI_HOME>/npm/node_modules/@yusukeshib/pi-working-status/README.md:61

相关文件

路径含义
<PI_HOME>/npm/node_modules/@yusukeshib/pi-working-status/包目录：extensions 与预览图

pi-tui-plus

来自 本地路径 ~/.pi/packages/pi-tui版本 0.4.1版本源 ~/.pi/packages/pi-tui/package.json

pi-open-tui 的自有分支：Starship 风格底栏、可点模型选择器、网关积分状态行。

使用场景

  • 想换掉默认 TUI：底栏分段、光标样式、图标与遥测都能配 ~/.pi/packages/pi-tui/README.zh-CN.md:9
名称参数作用出处
/open-tui打开设置窗口：常规 / 外观 / 底栏 / 遥测四页~/.pi/packages/pi-tui/README.zh-CN.md:54
键含义默认值出处
cursorStyle光标样式（示例值 block）block~/.pi/packages/pi-tui/README.zh-CN.md:61
footerSegments底栏显示哪些段：cwd / gitBranch / gitStatus / runtime / context / tokens / cost / extensionStatuses 等文档未载~/.pi/packages/pi-tui/README.zh-CN.md:65-78

相关文件

路径含义
~/.pi/agent/open-tui.json设置文件的落点

MCP server

rea

来自 stdio（由 pi-mcp-adapter 接管）

本机唯一登记的 MCP server：以 stdio 启动的 rea-agents，逆向工程与运行时证据类工具都在它那边。

名称参数作用出处
mcp{ action: "list" }列出该 server 暴露的工具<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:145
mcp{ describe }看某个工具的参数<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:106
mcp{ tool, args }调用一个工具<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:117
键含义默认值出处
mcpServers.rea.typestdio：由 pi 起子进程，不用 HTTPstdio<PI_HOME>/mcp.json
mcpServers.rea.command / argsnode 可执行文件 + rea-agents 的 mcp 入口脚本（npx 缓存路径）文档未载<PI_HOME>/mcp.json
builtin:mcpsettings.json 的 extensions 里用 -builtin:mcp 关掉 pi 内置 MCP，能力交给适配器已禁用（本机）<PI_HOME>/settings.json

相关文件

路径含义
<PI_HOME>/mcp.jsonMCP server 登记处

技能清单

技能清单（全量）

来自 多个来源

这台机器上 pi 能加载的全部技能，按来源分组：用户级目录、pi 自带目录、各包内置。

共 69 行，展开查看
技能一句话触发方式来源
anatomy画等轴测 SVG 技术图解，带交互动效，可出 A4 PDF/skill:anatomy；描述含 isometric illustration / explainer 等用户级 · ~/.agents/skills/
ask-matt路由器：问该用哪个技能或哪套流程仅 /skill:ask-matt（disable-model-invocation）用户级 · ~/.agents/skills/
chief-of-staff在单会话内协调子代理推进长期目标仅 /skill:chief-of-staff用户级 · ~/.agents/skills/
claude-handoff把当前对话交给新开的后台代理接手仅 /skill:claude-handoff用户级 · ~/.agents/skills/
code-review双轴评审改动：编码标准与规格，并行子代理/skill:code-review；"review a branch/PR"、"review since X"用户级 · ~/.agents/skills/
codebase-design深模块设计的共享词汇/skill:codebase-design；"design/improve a module's interface"用户级 · ~/.agents/skills/
diagnosing-bugs难 bug 与性能回归的诊断循环/skill:diagnosing-bugs；"diagnose" / "debug this" / 报错变慢用户级 · ~/.agents/skills/
doc-cleanerPDF/DOCX/XLSX/文本转干净结构化 Markdown/skill:doc-cleaner；触发词未载用户级 · ~/.agents/skills/
domain-modeling建立并打磨项目领域模型（词表与 ADR）/skill:domain-modeling；讨论术语 / 写 GLOSSARY / 记 ADR用户级 · ~/.agents/skills/
find-skills发现并安装可用的 agent 技能/skill:find-skills；"find a skill for X"、"how do I do X"用户级 · ~/.agents/skills/
git-guardrails-claude-code装 Claude Code hook 在执行前拦危险 git 命令/skill:git-guardrails-claude-code；想禁 push/reset --hard 等用户级 · ~/.agents/skills/
grill-me拷问式访谈打磨方案（内部转 grilling）仅 /skill:grill-me用户级 · ~/.agents/skills/
grill-with-docs拷问式打磨方案，并顺带产出 ADR 与词表仅 /skill:grill-with-docs用户级 · ~/.agents/skills/
grilling逐轮拷问计划/决策直到达成共识/skill:grilling；任何 'grill' 触发短语用户级 · ~/.agents/skills/
handoff把对话压成交接文档给下一个代理仅 /skill:handoff用户级 · ~/.agents/skills/
hyperframes视频/动效请求的强制入口：选并装工作流/skill:hyperframes；描述自称 mandatory entry point用户级 · ~/.agents/skills/
hyperframes-animationHyperFrames 全部动效知识与七种运行时适配/skill:hyperframes-animation；任何 motion / animation 任务用户级 · ~/.agents/skills/
hyperframes-audio已放置音频的混音：淡入淡出、闪避、效果链/skill:hyperframes-audio；混音/音量/效果等需求用户级 · ~/.agents/skills/
hyperframes-cliHyperFrames CLI 开发循环与渲染排错/skill:hyperframes-cli；构建或渲染失败诊断用户级 · ~/.agents/skills/
hyperframes-core合成契约：如何构建一个可渲染项目/skill:hyperframes-core；写合成 HTML 之前用户级 · ~/.agents/skills/
hyperframes-creative非动效创意方向：调色、字体、旁白、beat/skill:hyperframes-creative；设计规范/品牌风格决策用户级 · ~/.agents/skills/
hyperframes-keyframes推拉摇移、Ken Burns 等可寻址关键帧/skill:hyperframes-keyframes；镜头移动/关键帧需求用户级 · ~/.agents/skills/
hyperframes-registry搜索并安装 registry 区块与组件/skill:hyperframes-registry；brief 命名某个视觉/效果/转场时用户级 · ~/.agents/skills/
hyperframes-studioStudio 协作：要不要改、计划、时间线布局/skill:hyperframes-studio；在 Studio 里做项目用户级 · ~/.agents/skills/
implement依据 spec 或工单实现一块工作仅 /skill:implement用户级 · ~/.agents/skills/
implement-spec落地 /to-spec 与 /to-tickets 的产物代码仅 /skill:implement-spec用户级 · ~/.agents/skills/
improve-codebase-architecture扫描深化机会、出 HTML 报告、逐个拷问仅 /skill:improve-codebase-architecture用户级 · ~/.agents/skills/
ja-zh-translator中日互译、日语释义读音、语法教学与查错/skill:ja-zh-translator；日汉翻译/敬语/读音/校对用户级 · ~/.agents/skills/
loop-me就你想搭的工作流发问，只产出 workflow spec仅 /skill:loop-me用户级 · ~/.agents/skills/
markitdown用 markitdown CLI 把本地文档转 Markdown/skill:markitdown；"convert to markdown"、"read PDF"、"OCR image" 等用户级 · ~/.agents/skills/
media-use素材解析/生成/操作/复用的媒体操作系统/skill:media-use；BGM、配音、字幕、调色、去背等用户级 · ~/.agents/skills/
migrate-to-shoehorn把测试里的 as 断言迁到 shoehorn/skill:migrate-to-shoehorn；提到 shoehorn 或替换测试 as用户级 · ~/.agents/skills/
pr撰写 PR 正文/skill:pr；"writing a PR body"用户级 · ~/.agents/skills/
prototype造一次性原型回答设计问题/skill:prototype；想验证状态模型或 UI 观感用户级 · ~/.agents/skills/
qa-archive把指定问答归档为离线可检索 HTML 知识库/skill:qa-archive（描述明示：仅执行明确发出的归档命令）用户级 · ~/.agents/skills/
research查一手资料并把结论写成仓库内 Markdown/skill:research；想研究主题/收文档事实用户级 · ~/.agents/skills/
retro对编码会话做复盘仅 /skill:retro用户级 · ~/.agents/skills/
reverse-engineer-anything用 REA 逆向原生/打包/固件/浏览器目标/skill:reverse-engineer-anything；以成品或运行时证据解释功能用户级 · ~/.agents/skills/
scaffold-exercises生成带节/题/解/讲义的练习目录结构/skill:scaffold-exercises；想搭练习或课程章节用户级 · ~/.agents/skills/
setup-matt-pocock-skills配置本仓 issue tracker、triage 词表、领域文档布局仅 /skill:setup-matt-pocock-skills用户级 · ~/.agents/skills/
setup-pre-commit装 Husky + lint-staged、类型检查、测试钩子/skill:setup-pre-commit；想加 pre-commit 钩子用户级 · ~/.agents/skills/
setup-ts-deep-modules用 dependency-cruiser 把每个包变成深模块仅 /skill:setup-ts-deep-modules用户级 · ~/.agents/skills/
tdd测试先行开发（红绿重构）/skill:tdd；"red-green-refactor"、想写集成测试用户级 · ~/.agents/skills/
teach在本工作区内教用户一项技能或概念仅 /skill:teach用户级 · ~/.agents/skills/
to-questionnaire把答不了的决策转成他人填的问卷仅 /skill:to-questionnaire用户级 · ~/.agents/skills/
to-spec把当前对话综合成 spec 并发到 issue tracker仅 /skill:to-spec用户级 · ~/.agents/skills/
to-tickets把计划/spec 拆成带阻塞边的 tracer-bullet 工单仅 /skill:to-tickets用户级 · ~/.agents/skills/
triage让 issue 与外部 PR 走 triage 状态机仅 /skill:triage用户级 · ~/.agents/skills/
wait-what让上一条没讲清的消息重新讲一遍仅 /skill:wait-what用户级 · ~/.agents/skills/
wayfinder把超大工作量规划成决策工单地图仅 /skill:wayfinder用户级 · ~/.agents/skills/
wizard生成交互式 bash 向导带人走只有人能做的步骤/skill:wizard；开基础设施/配凭据/CI 密钥/一次性迁移用户级 · ~/.agents/skills/
writing-beats写作（开采）：把素材编成 beats 旅程仅 /skill:writing-beats用户级 · ~/.agents/skills/
writing-for-agents写给代理看的文档（技能、AGENTS.md、CLAUDE.md）/skill:writing-for-agents；创建/编辑技能或 AGENTS.md用户级 · ~/.agents/skills/
writing-fragments写作（探索）：只挖碎片，先不给结构仅 /skill:writing-fragments用户级 · ~/.agents/skills/
writing-shape写作（成稿）：把素材逐段塑成文章仅 /skill:writing-shape用户级 · ~/.agents/skills/
xlsx以表格文件为输入或交付物的任务/skill:xlsx；按名/路径提到 xlsx/xlsm/csv/tsv 等用户级 · ~/.agents/skills/
xlsx-to-markdown把 Excel「表内文档」型设计书忠实转 Markdown/skill:xlsx-to-markdown；「このxlsxをMarkdown化したい」等用户级 · ~/.agents/skills/
herdr控制 Herdr 终端复用器：窗格/标签/工作区/命令/别的代理/skill:herdr；仅当用户明确提到 Herdr 才用pi 自带 · <PI_HOME>/skills/
context-mode用 ctx_execute 等工具处理大输出，不走 Bash/cat/skill:context-mode；描述里列了大量触发词（analyze logs、summarize output、parse JSON、git log 等），并对超 20 行的 MCP 输出触发包内置 · context-mode
ctx-doctor跑 context-mode 诊断：运行时、钩子、FTS5、插件注册/skill:ctx-doctor（frontmatter user-invocable: true，description 写 Trigger: /context-mode:ctx-doctor）包内置 · context-mode
ctx-index把本地文件或目录索引进 FTS5 知识库/skill:ctx-index（Trigger: /context-mode:ctx-index）包内置 · context-mode
ctx-insight打开 Insight 团队分析看板/skill:ctx-insight（Trigger: /context-mode:ctx-insight）包内置 · context-mode
ctx-purge清空知识库（破坏性，不可撤销）/skill:ctx-purge（Trigger: /context-mode:ctx-purge）包内置 · context-mode
ctx-search在 FTS5 知识库里检索已索引内容/skill:ctx-search（Trigger: /context-mode:ctx-search）包内置 · context-mode
ctx-stats看本会话省了多少上下文窗口/skill:ctx-stats（Trigger: /context-mode:ctx-stats）包内置 · context-mode
ctx-upgrade从 GitHub 更新 context-mode 并修钩子/设置/skill:ctx-upgrade（Trigger: /context-mode:ctx-upgrade）包内置 · context-mode
council-mode跑一轮有界的、由主管主持的顾问团评议/skill:council-mode；"council mode"、"convene advisors"、"debate a decision"、"/council"包内置 · pi-subagents
pi-subagents经操作者许可把工作委派给 pi 子代理/skill:pi-subagents；"operator asks for it"（描述原文：after the operator asks for it）包内置 · pi-subagents
plannotatorPlannotator 使用参考：计划/代码评审、标注、导出、Inbox仅 /skill:plannotator（disable-model-invocation: true）包内置 · @plannotator/pi-extension

内置工具

pi 核心提供的工具

来自 pi 核心版本 1.4.0

不装任何包也有的工具：文件读写、搜索、shell、以及随包附带的那几类。

工具名作用提供者出处
read读文本/图片文件，支持 offset/limit，图片以附件返回pi 核心pi 核心包内/dist/core/tools/read.js:51；导出 index.js:8
bash执行 shell 命令并回传 stdout/stderrpi 核心pi 核心包内/dist/core/tools/bash.js:313；导出 index.js:1
powershell执行 PowerShell 命令（Windows 方言）pi 核心pi 核心包内/dist/core/tools/powershell.js:16；导出 index.js:7
edit唯一精确文本替换（oldText→newText，可多段）pi 核心pi 核心包内/dist/core/tools/edit.js:83；导出 index.js:2
write写文件/整文件覆盖，自动建父目录pi 核心pi 核心包内/dist/core/tools/write.js:23；导出 index.js:10
grep按正则/字面量搜内容，返回文件和行号pi 核心pi 核心包内/dist/core/tools/grep.js:32；导出 index.js:5
find按 glob 找文件pi 核心pi 核心包内/dist/core/tools/find.js:37；导出 index.js:4
ls列目录（可设上限）pi 核心pi 核心包内/dist/core/tools/ls.js:25；导出 index.js:6
tool_search搜索尚未加载的工具并把命中的加载出来pi 核心名称定义 pi 核心包内/dist/extensions/tool-search/tool.js:11（TOOL_SEARCH_TOOL_NAME），定义体 :160-168；注册 pi 核心包内/dist/extensions/tool-search/index.js:11
codemode用脚本批量/编排调用工具，减少往返pi 核心名称定义 pi 核心包内/dist/extensions/codemode/tool.js:32（CODEMODE_TOOL_NAME），定义体 :256；注册 pi 核心包内/dist/extensions/codemode/index.js:19
mcp__<server>__<tool>静态 MCP 服务器的每个工具逐个代理成独立 pi 工具（名字由 server/tool 生成，冲突加哈希后缀）pi 核心注册逻辑 pi 核心包内/dist/extensions/mcp/index.js:283（registerTools）→ :336/:377 的 pi.registerTool(definition)；名字正则渲染器 :279-282；registerCommand("mcp") 在 :1121

包提供的工具

来自 各包

装包之后多出来的工具，每行标提供者 —— 用来判断「不装这个包还剩下什么」。

共 50 行，展开查看
工具名作用提供者出处
bg_run后台跑一条长命令，立即返回 task ID 与输出路径pi-background-tasks包内src/extension.ts:958-959
bg_run_pi_attested直接 spawn 一个 pi --mode json 子进程并产出严格取证 sidecar（config.features.attested 才注册）pi-background-tasks包内src/extension.ts:1066-1068
bg_status单次查看某个或全部后台任务状态（不是等待原语）pi-background-tasks包内src/extension.ts:1136-1137
bg_logs读后台任务的有界输出，截断时给完整文件路径pi-background-tasks包内src/extension.ts:1167-1168
bg_kill按 ID 停掉运行中的后台任务pi-background-tasks包内src/extension.ts:1212-1213
bg_delegate把一段工作委派出去（delegate 扩展）pi-background-tasks名字常量 包内src/core/delegate/types.ts:32；注册 包内src/delegate-extension.ts:500-501
bg_result取被委派工作的结果（delegate 扩展）pi-background-tasks名字常量 包内src/core/delegate/types.ts:33；注册 包内src/delegate-extension.ts:757-758
delegate_read_artifact子代理侧读取委派产物pi-background-tasks包内src/delegate-child-extension.ts:600-601
fusion_reasonFusion 推理工作流（起一个后台 Fusion 任务）pi-background-tasks名字常量 包内src/core/fusion/workflows.ts:23；注册 包内src/fusion-extension.ts:1287
fusion_investigateFusion 调查工作流pi-background-tasks名字常量 包内src/core/fusion/workflows.ts:24；注册 包内src/fusion-extension.ts:1305
fusion_researchFusion 研究工作流pi-background-tasks名字常量 包内src/core/fusion/workflows.ts:25；注册 包内src/fusion-extension.ts:1324
fusion_validateFusion 验证工作流pi-background-tasks名字常量 包内src/core/fusion/workflows.ts:26；注册 包内src/fusion-extension.ts:1344
fusion_web_fetch抓公开 http(s) URL，返回有界文本/Markdown 与来源（researchEnabled === '1' 才注册）pi-background-tasks名字常量 包内src/core/fusion/types.ts:69；注册 包内src/fusion-child-extension.ts:864-865
subagents_enable空参数加载器：打开委派与管理工具面，不启动任何工作pi-subagents名字常量 包内src/extension/tool-activation.js:6；注册 包内src/extension/tool-activation.js:125
subagent委派子代理：单/并行/脚本化流程、异步运行、恢复/引导/停止pi-subagents名字常量 包内src/extension/tool-activation.js:7；注册 包内src/extension/index.js:689-690
bg_wait等后台工作并返回结果（无原生完成通知时的阻塞收集）pi-subagents名字常量 包内src/extension/tool-activation.js:9；注册 包内src/runs/background/wait-tool.js:41
contact_supervisor子代理向父/主管会话求助：要决策、结构化访谈、进度通报pi-subagents名字常量 包内src/intercom/native-supervisor-channel.js:198，定义 :199-203；herdr 桥接侧同名注册 包内src/extension/herdr-pi-bridge.js:96-97
subagent_supervisor父侧通道：reply / pending / status 应答子代理请求pi-subagents名字常量 包内src/intercom/native-supervisor-channel.js:16；定义+注册 :576-578（另有 :719 条件注册）
watchdog_diff评审基线 diff（review fanout 的 watchdog）pi-subagents名字常量 包内src/watchdog/diff-tool.js:4；使用处 包内src/runs/shared/subagent-prompt-runtime.js:18（bundle/chunk-3JCDWF4V.js:823 里 pi.registerTool(createWatchdogDiffTool(...))）
mcpMCP 网关：按 URL 装服务器、看状态、搜索/描述、鉴权、调单个 MCP 工具（mcp({ tool, args })）pi-mcp-adapter包内index.ts:2665-2667（registerProxyTool，name: "mcp"）
每服务器一个命名空间代理工具（工具名为每个 server 动态生成）把某台 MCP 服务器的工具聚成一个命名空间代理入口pi-mcp-adapter包内namespace-tools.ts:260-262（pi.registerTool({ name: spec.toolName, … })）；另有 deferred/direct 工具面 direct-tools.ts、deferred-tool-surface.ts
agent_browser执行单条原生 agent-browser 命令；固定序列用 batch --bailpi-agent-browser-native包内dist/extensions/agent-browser/index.js:35234-35235
agent_browser_code对持久浏览器跑一段新 JS，用 emit/emitImage 选择输出pi-agent-browser-native包内dist/extensions/agent-browser/index.js:35246-35247
agent_browser_tools发现/启用高级能力（action、qa、electron、source、network）pi-agent-browser-native包内dist/extensions/agent-browser/index.js:35338-35339
agent_browser_action用稳定定位器或当前 ref 点击/勾选/填写/选择唯一可访问目标pi-agent-browser-native名字 包内dist/extensions/agent-browser/index.js:35204；注册 :35264-35265
agent_browser_qa对 URL 或已附着页面做可见断言与诊断式 PASS/FAILpi-agent-browser-native名字 :35208；注册 :35278-35279
agent_browser_electron发现、隔离启动、探测、清理自有 Electron 桌面应用pi-agent-browser-native名字 :35212；注册 :35292-35293
agent_browser_source找 DOM/React/本地源码候选（实验性，有界扫描）pi-agent-browser-native名字 :35216；注册 :35306-35307
agent_browser_network_source把失败请求与发起方、本地源码候选关联（实验性）pi-agent-browser-native名字 :35220；注册 :35318-35319
ctx_execute在受控运行时里执行命令并只回传结论（大输出不进上下文）context-mode名字集合 包内server.bundle.mjs（ctx_execute）；包内build/adapters/openclaw/mcp-tools.js:62；注册 包内build/adapters/pi/mcp-bridge.js:858
ctx_execute_file对单个文件执行处理再回结论（读/改文件首选）context-modeopenclaw/mcp-tools.js:77；层级说明 包内build/adapters/pi/extension.js:579-581
ctx_batch_execute一次跑多命令的研究批处理（层级最高）context-modeopenclaw/mcp-tools.js:134；extension.js:579-581
ctx_index把文件/目录索引进 FTS5 知识库context-modeopenclaw/mcp-tools.js:92
ctx_search在知识库中检索已索引片段context-modeopenclaw/mcp-tools.js:106
ctx_fetch_and_index抓网页并索引，后续用 ctx_search 查context-modeopenclaw/mcp-tools.js:120
ctx_stats本会话上下文节省统计context-modeopenclaw/mcp-tools.js:147；extension.js:172-176
ctx_doctor诊断运行时/钩子/FTS5/注册context-modeopenclaw/mcp-tools.js:157
ctx_upgrade更新并修钩子与设置context-modeopenclaw/mcp-tools.js:167
ctx_purge清空知识库（破坏性）context-modeopenclaw/mcp-tools.js:177
ctx_insight打开 Insight 看板context-modeopenclaw/mcp-tools.js:196
web_search网络检索（可指定 provider/queries/domainFilter）pi-web-access注册 包内index.ts:1422-1423；默认名 包内web-tool-core.ts:136-141（DEFAULT_TOOL_NAMES.webSearch）
source_check为某个断言收集来源，产出带逐段引用的结构化研究产物pi-web-access注册 包内index.ts:1972-1973；默认名 web-tool-core.ts:136-141（sourceCheck）
fetch_content抓 URL（含图片、YouTube 转录、GitHub 仓库、PDF、本地视频）pi-web-access注册 包内index.ts:1995-1996；默认名 web-tool-core.ts:136-141（fetchContent）
get_search_content分页取回上次搜索/抓取存下的内容，或找匹配段落pi-web-access注册 包内index.ts:2187-2188；默认名 web-tool-core.ts:136-141（getSearchContent）
web_enable空参数加载器：打开已配置的 web 工具面，本身不搜不抓pi-web-access名字常量 包内tool-activation.ts:11（LOADER_NAME）；注册 包内tool-activation.ts:73-74
ask_user_question向用户提结构化选择题/多选/带预览的问题并取回答案（exposure: "model-only"）@juicesharp/rpiv-ask-user-question名字常量 包内ask-user-question.ts:86；注册 包内ask-user-question.ts:476-477（registerAskUserQuestionTool）
plannotatorPlannotator 主入口：计划评审、代码评审、标注文件/URL/目录/本地应用@plannotator/pi-extension名字常量 包内generated/plannotator-tool.ts:59；注册 包内index.ts:1624-1625（agentToolEnabled 才注册）
plannotator_mark_done把已批准计划里的某一步标记为完成@plannotator/pi-extension名字常量 包内tool-scope.ts:11；注册 包内index.ts:1731-1732
plannotator_submit_plan提交计划文件给用户评审@plannotator/pi-extension名字常量 包内tool-scope.ts:5；注册 包内index.ts:1772-1773
plannotator_inbox读写 Plannotator Inbox：非阻塞地收人稍后回答的问题与消息@plannotator/pi-extension名字常量 包内generated/inbox/connection.ts:36（INBOX_TOOL_NAME）；注册 包内inbox.ts:169-170

文档未载 / 两处矛盾

主题出处 A出处 B取舍
pi mcp 子命令集合：synopsis 只写 list|login|logout，正文另有 add/remove<PI_CORE>/docs/cli.md:16<PI_CORE>/docs/cli.md:324、<PI_CORE>/docs/cli.md:326两处并列保留，未替读者取舍
pi --export 目标格式：CLI 只说导出为 HTML<PI_CORE>/docs/cli.md:49<PI_CORE>/docs/slash-commands.md:38 说「导出为 HTML 或 JSONL」两处并列保留，未替读者取舍
/mcp 斜杠命令存在性：cli.md 明说不连 MCP 时「无 /mcp」，暗示存在该命令<PI_CORE>/docs/cli.md:199<PI_CORE>/docs/slash-commands.md:9-52 全表未收录 `/mcp`两处并列保留，未替读者取舍
--use-theme（一次性选主题）与 theme/themes 设置的优先级未说明<PI_CORE>/docs/cli.md:210<PI_CORE>/docs/settings.md:95、<PI_CORE>/docs/settings.md:158两处并列保留，未替读者取舍
代理来源优先级：httpProxy（仅 agent 目录）与 HTTP_PROXY/HTTPS_PROXY 谁生效未说明<PI_CORE>/docs/settings.md:125<PI_CORE>/docs/environment-variables.md:99两处并列保留，未替读者取舍
遥测开关关系：PI_TELEMETRY 与 enableInstallTelemetry 的覆盖顺序未说明<PI_CORE>/docs/environment-variables.md:86<PI_CORE>/docs/settings.md:170两处并列保留，未替读者取舍
会话目录优先级：settings 侧只说两者「覆盖」本设置，未排出二者之间顺序；CLI 侧明确 --session-dir > 环境变量 > 设置<PI_CORE>/docs/settings.md:66<PI_CORE>/docs/cli.md:96两处并列保留，未替读者取舍
defaultProjectTrust 与 --approve/--no-approve 的交互与谁优先未说明<PI_CORE>/docs/settings.md:36<PI_CORE>/docs/cli.md:237、<PI_CORE>/docs/cli.md:239两处并列保留，未替读者取舍
defaultTools 空数组语义只在 settings 侧写明（关全部内置，不含扩展/SDK 工具）<PI_CORE>/docs/settings.md:42<PI_CORE>/docs/cli.md:128 未提空数组两处并列保留，未替读者取舍
短选项前缀冲突风险：-n(name) 与 -nbt/-ne/-ns/-np/-nc/-na 同以 -n 开头，文档未说明解析规则<PI_CORE>/docs/cli.md:100<PI_CORE>/docs/cli.md:123、<PI_CORE>/docs/cli.md:196、<PI_CORE>/docs/cli.md:202、<PI_CORE>/docs/cli.md:206、<PI_CORE>/docs/cli.md:214、<PI_CORE>/docs/cli.md:239两处并列保留，未替读者取舍
--tui-mode 的默认值只在正文括注里出现（fullscreen），未进参数表<PI_CORE>/docs/cli.md:233<PI_CORE>/docs/settings.md:97 的 `tuiMode` 默认 `"fullscreen"`两处并列保留，未替读者取舍
PI_CODING_AGENT_SESSION_DIR 无默认值；settings 侧默认只写「Agent session directory」<PI_CORE>/docs/environment-variables.md:82<PI_CORE>/docs/settings.md:66两处并列保留，未替读者取舍
PI_OFFLINE、PI_SKIP_VERSION_CHECK、PI_TELEMETRY、PI_PACKAGE_DIR、PI_CACHE_RETENTION 默认值<PI_CORE>/docs/environment-variables.md:83-86、<PI_CORE>/docs/environment-variables.md:88四份文档均未给默认值两处并列保留，未替读者取舍
retry.provider.timeoutMs 默认值指向另一键而非字面值<PI_CORE>/docs/settings.md:132<PI_CORE>/docs/settings.md:126两处并列保留，未替读者取舍
--offline 与 PI_OFFLINE 的等价关系有载，但两者同时存在时的优先级未载<PI_CORE>/docs/cli.md:241<PI_CORE>/docs/environment-variables.md:84两处并列保留，未替读者取舍
externalEditor 默认链（$VISUAL→$EDITOR→平台默认）与环境变量节只列 VISUAL、EDITOR 一致，但「平台默认」具体值未载<PI_CORE>/docs/settings.md:33<PI_CORE>/docs/environment-variables.md:98两处并列保留，未替读者取舍
shell 工具会话变量的注入开关（exposeSessionEnvironment）是 API 选项，CLI/settings 无对应开关<PI_CORE>/docs/environment-variables.md:68<PI_CORE>/docs/cli.md 全篇、<PI_CORE>/docs/settings.md 全篇两处并列保留，未替读者取舍
PI_CODEMODE_MAX_WORKERS 的每 worker 256 MB 上限无对应 settings 键<PI_CORE>/docs/environment-variables.md:87<PI_CORE>/docs/settings.md:43、<PI_CORE>/docs/settings.md:44 仅有 `codemode.mode` 与 `codemode.inlineBudget`两处并列保留，未替读者取舍
pi-subagents：7 个内置 agent（scout / researcher / evidence-auditor / worker / reviewer / oracle / delegate）只在 README 的表格里列出用途，本页未逐个展开<PI_HOME>/npm/node_modules/pi-subagents/README.md:61-67留给「内置工具」一节按提供者归并
pi-background-tasks：bg_run / bg_delegate / bg_run_pi_attested 的参数签名散在示例代码里，README 没有一张参数表<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:196-253<PI_HOME>/npm/node_modules/pi-background-tasks/README.md:182-192命令表只记「是什么」，参数按需回去看示例，不在这里猜
@plannotator/pi-extension：plannotator 与 plannotator_inbox 的完整参数表没有集中在 README 里<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:371-392<PI_HOME>/npm/node_modules/@plannotator/pi-extension/README.md:397-406命令表只记用途，参数按需回去看章节
pi-agent-browser-native：本机探测：agent-browser 二进制不在 PATH，工具调用直接返回 missing-binary（README 要求另装 npm install -g agent-browser）<PI_HOME>/npm/node_modules/pi-agent-browser-native/README.md:14按「装了包但没装二进制」如实记录，不写成可用
@yusukeshib/pi-working-status：README 只有 3KB：除一个开关命令外没有配置项，也没有使用场景，属薄条目<PI_HOME>/npm/node_modules/@yusukeshib/pi-working-status/README.md:1如实呈现为薄条目，不补写场景
pi-tui-plus：本页与工具开发区的 pi-tui-plus 详情页内容重叠，这里只保留「手册视角」的最小条目~/.pi/packages/pi-tui/README.zh-CN.md:1<REPO>/tools-dev/pi-tui.html详情、下载与源码仍以工具开发区那页为准
rea：rea 自己的工具面不在 pi 的任何文档里，只有 mcp list 能看到；本页只记录它被怎样接进 pi<PI_HOME>/mcp.json<PI_HOME>/npm/node_modules/pi-mcp-adapter/README.md:19不抄第三方 server 的工具清单，读者用 mcp list 自查

这份页怎么更新

这一页是生成物，不要直接改 tools-dev/pi-toolchain.html。真源只有一份：tools-dev/pi-toolchain.data.json。

  1. 改真源：新增一个包就往 items 里加一条，id 必须唯一且与页内锚点同名；src 一律写成 ~/、<PI_HOME>、<PI_CORE>、<REPO>、<USER> 这类占位符，不许写真实路径。
  2. 重生成：node tools/pi-toolchain-gen.mjs。
  3. 校验：node tools/pi-toolchain-gen.mjs check，再跑 node tools/test.mjs。
  4. 新增包要同时动三处：真源的 items 与 packages、collectedAt 日期、以及包版本变化时的 version/versionFrom。