# @diegopetrucci/pi-extensions 中文文档 规范地址：https://npmcn.com/package/%40diegopetrucci/pi-extensions/ 版本：0\.1\.86 npm 元数据更新时间：2026-11-10T21:28:03.019Z 中文译文更新时间：2026-11-12T07:44:58.547Z 软件包许可：MIT AND Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40diegopetrucci/pi-extensions 原文对照：https://npmcn.com/package/%40diegopetrucci/pi-extensions/?lang=original 项目主页：https://github.com/diegopetrucci/pi-extensions#readme 源码仓库：https://github.com/diegopetrucci/pi-extensions ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.6 MB，188 个文件 - TypeScript 类型：未声明 - Node.js 要求：\>=22\.19\.0 - 运行依赖：3 个 - peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \* - 首次发布：2026-04-15T20:18:38.168Z - 最新版本发布：2026-11-10T21:28:02.703Z - 近 30 天下载量：3028（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：79（近 12 个月 79 个） ## 中文简介 Pi 扩展和技能集,用于注释 UIs,上下文管理,工作流程审计,逆向审查,审查-评论分解,通知,Brrr推出提示,安全卫士,GitHub研究,回波本地知识,todos,工具渲染,模型 ## 安装 ```sh npm install @diegopetrucci/pi-extensions ``` 也可以使用：`pnpm add @diegopetrucci/pi-extensions`、`yarn add @diegopetrucci/pi-extensions`、`bun add @diegopetrucci/pi-extensions` ## README # pi 扩展 [![Total npm downloads](https://img.shields.io/npm/dt/%40diegopetrucci%2Fpi-extensions?label=total%20npm%20downloads)](https://www.npmjs.com/package/@diegopetrucci/pi-extensions) 收集资料 [毕](https://pi.dev/) 我做了代理扩展。 (Btw,(英语:, [临Τи p](https://github.com/diegopetrucci/the-last-harness)看看这听起来很有趣! ) ### 副剂 - [`code-reviewer`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/code-reviewer): 添加一个 `code_reviewer` 具有只读内置工具外加已配置的MCP工具的子代理工具(运行时未经确认,可能会有副作用,Pi QQ1.0.4),该副代理工具在不执行修正的情况下,会审查本地变化的适合票位,diff不匹配,正确性,安全性,简洁性,以及验证漏洞等,在可用时自动选择一个反式的反提供方审查模型,并请求对所选模型的能力进行思考的夹子. - [`contrarian`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/contrarian): 添加一个有只读内置工具的反向工具并加上配置的MCP工具(未经确认而运行,可能会有副作用,Pi QQ1.0.4),通过将最强的对立子体进行钢人化来旋转一个孤立的子进程来进行压力测试计划,设计,假设,bug假说和结论. - [`developer`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/developer): 添加一个 `developer` 使用当前会话模式和思维在孤立的儿童代理中执行一项任务的子代理工具 `read`, (中文(简体) ), `write`, (中文(简体) ), `edit`, (中文(简体) ), `grep`, (中文(简体) ), `find`, (中文(简体) ), `ls`,无限制 `bash`,并配置了 MCP 工具(未经确认运行,可能会有副作用,Pi QQ-1.0.4); `write`编号 :`edit` 仅限于离职. - [`diff-summarizer`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/diff-summarizer): 添加只读 `diff_summarizer` 子代理工具,用于汇总 diff 或当前本地变化,并使用本届会议模式突出审查风险 `medium` 考虑,与 `read`, (中文(简体) ), `grep`, (中文(简体) ), `find`, (中文(简体) ), `ls`,只读守护 `bash` (单位:千美元) `git`编号 :`gh`编号 :`pwd` 并配置了MCP工具(未经确认运行,可能具有副作用,Pi QQ1.0.4). - [`librarian`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/librarian): 在 OS 用户缓存目录下添加一个 GitHub 研究搜索器, 并默认禁用本地 Repo 取出缓存, 可切换到 `/librarian-cache`,可配置的子剂模型/思维默认通过 `/librarian-config`,缓存在未使用后7天到期,并配置了MCP工具(未经确认运行,可能具有副作用,Pi QQ1.0.4). - [`oracle`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/oracle): 添加一个 Amp 风格的 oracle 工具, 带有只读内置工具外加配置的 MCP 工具( 未经确认而运行, 可能具有副作用, Pi + 1.0.4) , 自动选择当前提供者/ 订阅上最强的推理模型, 支持持续 `/oracle` 模型/思考默认,默认请求x高推理并夹住模型能力,运行时显示活状态. - [`repo-scout`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/repo-scout): 添加只读 `repo_scout` 使用当前会话模式扫描仓库和报告堆栈、常规、命令和热点的子代理工具 `medium` 考虑,与 `read`, (中文(简体) ), `grep`, (中文(简体) ), `find`, (中文(简体) ), `ls`,只读守护 `bash` (单位:千美元) `git`编号 :`gh`编号 :`pwd` 并配置了MCP工具(未经确认运行,可能具有副作用,Pi QQ1.0.4). - [`test-runner`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/test-runner): 添加一个 `test_runner` 使用当前会话模式运行精确验证 shell 命令的子代理工具 `low` 思考,在第一次失败时停止,每一步报告PASS/FAIL;工具不受限制 `bash` 并配置了MCP工具(未经确认运行,可能具有副作用,Pi QQ1.0.4). - [`web-scout`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/web-scout): 添加只读 `web_scout` 通过主机 Exa MCP 端点在网络上研究问题的子代理工具( 不需要 API 密钥; 可选) `EXA_API_KEY` 使用当前会议模式 `medium` 考虑,与 `web_search`, (中文(简体) ), `fetch_url` (仅https), `read`, (中文(简体) ), `grep`, (中文(简体) ), `find`, (中文(简体) ), `ls`,并配置了MCP工具(未经确认运行,可能具有副作用,Pi QQ1.0.4). ### 供应商 - [`fast`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/fast)页:1 `/fast` 加上仅会话 `/ultrafast` 切换到支持的直接 OpenAI API, OpenAI Codex, 和 Anthropic Claude 模型; Ultrafast 仅限于 API 键 `gpt-6-astra` 或者说 `gpt-6.1-sol` 在OpenAI的犬类反应端点上. ### 用户 - [`git-footer`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/git-footer): 将 TLH 风格的 git 脏数,前入/后入,和可选的PR数加到 pi 的内置页脚状态区域. 此软件包仅是独立的,不由自动装入 `@diegopetrucci/pi-extensions` 收藏软件包. - [`minimal-footer`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/minimal-footer): 将 pi 的内置页脚替换为最小可配置的双行布局: 分支外加缓存的 git 脏/ ahead/ PR 状态并重播于一行, 上下文/ 二行模式, 可选 `DUMB ZONE`选项 `xp` 标记,加上 OpenAI 以报告的持续时间标出代码的窗口. - [`quiet-tools`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/quiet-tools): 总是使已崩溃的内置工具行和 `mcp__*` 列作为单行引用加扩展提示而不改变模式可见的工具结果;检查状态 `/quiet-tools status`。 。 。 . ### / 斜线命令 - [`agent-workflow-audit`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/agent-workflow-audit)页:1 `/agent-workflow-audit`,它运行一个孤立的 repo 工作流程审计子代理,配有配置的 MCP 工具(未经确认而运行,可能具有副作用,Pi QQ1.0.4),并且只将最后的分馏报告返回主会话. - [`annotate-git-diff`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/annotate-git-diff)页:1 `/annotate-git-diff`,一个本地的Glimpse UI,其中明确提交向代理发送结构化反馈,近距离恢复会保留编辑器中的未发送草稿. - [`annotate-last-message`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/annotate-last-message)页:1 `/annotate-last-message`,一个本地的Glimpse UI,用于注释最新的助理回复,并将面向规划的反馈直接发送给代理. - [`review`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/review)页:1 `/review` 财务报告和审定财务报表 `/end-review` 用于对本地变化、承诺、公关和所选路径进行交互代码审查. - [`triage-comments`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/triage-comments)页:1 `/triage-comments` (单位:千美元) `triage_comments` 带有只读内置工具的子代理工具外加配置的 MCP 工具(未经确认而运行,可能具有副作用,Pi QQ1.0.4),可以自动检测当前分支的PR,过滤解析/过期的内行注释,将选定的审查评论与证据分类,并建议处理选项而不执行更改 ### 内容管理 - [`context-cap`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/context-cap):默认情况下在 350k 上下文窗口上盖有效的模型,所以 pi 避免 `dumb zone`; 临时切换与 `/context-cap`。 。 。 . - [`context-inspector`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/context-inspector)页:1 `/context`,一个本地自成一体的 HTML 仪表板,该仪表盘将当前会话环境的走向细分,包含类别概览、顶级罪犯和钻入搜索. - [`dynamic-context-pruning`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/dynamic-context-pruning): 自动翻转工具结果、 stale 错误输入和替换缓存- 意识网益门后长会话的文件- op输出, 并带有 `/prune` 拾取器和 `/context-pruning` 状态/控制命令. ### 安全问题 - [`confirm-destructive`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/confirm-destructive): 在清除、切换和叉等破坏性会话动作之前确认. - [`dirty-repo-guard`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/dirty-repo-guard): 当当前 git repo 有未承诺的更改时, 在新会话、 会话开关或叉前提示 . - [`permission-gate`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/permission-gate): 在危险打击命令之前发出确认提示并保护 `write`编号 :`edit` 目标如 `.git`, (中文(简体) ), `node_modules`和隐秘的 `.env` 文件; 拒绝名称 `powershell` 工具调用为不支持. ### 生活质量 - [`brrr`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/brrr): pi完成代理转接后发送brr推出通知,并准备输入,可选的macOS闲置取出. - [`gnosis`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/gnosis): 显示 `gn` 地方知识库CLI作为搜索和记录持久的项目决定、限制和意图的代理工具. - [`illustrations-to-explain-things`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/illustrations-to-explain-things): 添加生成干净,荒谬的"小平"风格文章插图,镜头列表,图像编辑和视觉比喻的技能. - [`inline-bash`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/inline-bash): 展开 `!{command}` 用户提示中的片段, 在提示到达代理前通过bash运行它们 . - [`notify`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/notify):在 pi 完成并准备输入时发送可配置终端,桌面,铃声等声音通知,包括tmux-aware终端通知. - [`project-mcp-json`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/project-mcp-json): 读取 Claude 代码样式 `.mcp.json` 从项目工作目录中注册配置的 Pi 服务器 `pi.registerMcpServer`。需要一个可信赖的项目,并遵循 Pi 的项目信任语义——运行 `/trust` 在工程中允许加载. - [`todo`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/todo): 添加分支意识 `todo` 用于代理的工具和一个 `/todos` 用户浏览器.. ### 折旧 - [`claude-fast`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/claude-fast):已贬值的独立所剩. 它不再更改提供者请求; 使用 [`fast`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/fast)。 。 。 . - [`openai-fast`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/openai-fast):已贬值的独立所剩. 它不再更改提供者请求; 使用 [`fast`](https://npmcn.com/package/%40diegopetrucci/pi-extensions/extensions/fast)。 。 。 . ## 安装 完整收藏 : ```bash pi install npm:@diegopetrucci/pi-extensions ``` 或特定的扩展 : ```bash pi install npm:@diegopetrucci/pi-quiet-tools ``` 然后重新装入 pi : ```text /reload ``` ## 发展 运行 `npm run format` 用于支持的源文件和测试文件; CI 运行 `npm run format:check`。 。 。 . 共同的格利姆斯执行和宣言 `shared/glimpse/`后端就住在这 `shared/footer/git-status.ts`。只编辑 Canonial 文件,然后运行 `npm run sync:shared` 在注释和页脚扩展名中更新生成的软件包本地副本. `npm run sync:shared:check` 核实每个允许的列表副本都存在且不写当前; CI 运行此检查 。 要撤消条形文字编辑,请恢复下面的文件 `shared/glimpse/` 或者说 `shared/footer/` 并再次运行同步命令。 要撤消只生成的输出, 请恢复软件包本地副本而不直接编辑它们 。 为了反转取出页脚,首先恢复每个消费者的本地后端和进口,保持独立 `git-status.ts` 文档和显示条目,直到没有消费者导入它们,然后删除页脚允许列表条目和条脚源;没有运行时源,不要留下任何独立的软件包. ## 常见问题 ### @diegopetrucci/pi-extensions 是什么？ Pi 扩展和技能集,用于注释 UIs,上下文管理,工作流程审计,逆向审查,审查-评论分解,通知,Brrr推出提示,安全卫士,GitHub研究,回波本地知识,todos,工具渲染,模型 ### 如何安装 @diegopetrucci/pi-extensions？ 在项目目录运行 npm install @diegopetrucci/pi-extensions，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-ai（\*）、@earendil-works/pi-tui（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @diegopetrucci/pi-extensions 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/diegopetrucci\_\_pi-extensions 是否存在。 ### @diegopetrucci/pi-extensions 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @diegopetrucci/pi-extensions 可以商用吗？ @diegopetrucci/pi-extensions 使用 MIT AND Apache-2\.0 许可。声明的许可为 MIT AND Apache-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @diegopetrucci/pi-extensions 的下载量有多少？ 根据 npm 官方下载统计，@diegopetrucci/pi-extensions 在 2026/10/12 – 2026/11/10 这 30 天内被下载 3,028 次，日均约 101 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @diegopetrucci/pi-extensions 还在维护吗？ 最新版本 0\.1\.86 发布于 2026/11/11（1 天前）；至今共发布 79 个版本，其中过去 12 个月发布了 79 个；首次发布于 2026/04/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。