# @fitchmultz/pi-subagents 中文文档

规范地址：https://npmcn.com/package/%40fitchmultz/pi-subagents/

版本：0\.52\.40
npm 元数据更新时间：2026-11-14T19:00:30.689Z
中文译文更新时间：2026-11-14T20:36:16.270Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fitchmultz/pi-subagents
原文对照：https://npmcn.com/package/%40fitchmultz/pi-subagents/?lang=original
项目主页：https://github.com/fitchmultz/pi-subagents#readme
源码仓库：https://github.com/fitchmultz/pi-subagents

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.1 MB，310 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.22\.3 \<25 \|\| \>=26\.13\.1
- 运行依赖：0 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-agent-core \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-10-05T22:55:22.198Z
- 最新版本发布：2026-11-14T19:00:30.399Z
- 近 30 天下载量：10228（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

副剂管弦乐和当地会话协调的扩展

## 安装

```sh
npm install @fitchmultz/pi-subagents
```

也可以使用：`pnpm add @fitchmultz/pi-subagents`、`yarn add @fitchmultz/pi-subagents`、`bun add @fitchmultz/pi-subagents`

## README

# 亲水师

1个Pi分机,用于授权和地方代理通信。 三个工具,一个 代理类型,没有配置文件.

```bash
pi install npm:@fitchmultz/pi-subagents
```

儿童的主要任务是:

```js
delegate({
  prompt:
    "Inspect the authentication changes. Return concrete defects with file and line evidence. Do not edit files.",
  name: "auth-review",
  thinking: "low",
});
```

授权总是同步的:工具返回收据并完成 稍后作为通知送达. 做其他工作或结束转弯;不投票. `context: "fresh"` 默认; `context: "fork"` 保护本地人 对话框,包括先前的工具结果。 没有隐藏角色提示, 报告写后缀、配置文件选择或模型倒置目录. 可选 `thinking` 确定孩子的努力而不改变父母。 别管了 继承父母的努力。 Pi将请求夹住孩子的模型能力. 引导和保存的续作保持了孩子的节省精力.

```js
agent_runs({ action: "list" });
agent_runs({ action: "inspect", id: "<run-id>" });
agent_runs({
  action: "continue",
  id: "<run-id>",
  prompt: "Now inspect the refresh-token path. Do not edit.",
});
agent_runs({ action: "stop", id: "<run-id>" });
```

## 跟探员说话

```js
intercom({ action: "list" });
intercom({ action: "send", to: "auth-review", message: "Focus on token rotation." });
intercom({ action: "last", to: "auth-review" });
```

`send` 默认方向 . `last` 读取端点上一个已完成的助手回复 而不唤醒它;大回音被呼出,而不是默默地被截断. 发现 在同一 OS 用户下工作跨项目目录和 Pi 代理目录.

主要及其子女组成一个群体:

-   该组内的每一对都能够发现并相互交流.
-   主要会话可以发现,传递,并读取其他主语.
-   儿童无法发现或与另一团体的代理人联系,即使有确切的身份证.
-   只有主力才能授权. 有一种儿童水平,而不是再生产卵.

这些是协调规则,而不是针对同一用户代码的OS沙盒. 同伴 列表中包含连接的,符合条件的会话,而不是机器上的每个 Pi 进程.

非模版节点js 伴行可以导入 `@fitchmultz/pi-subagents/intercom-client` 为了发现, 精确的守护发送, 贴有最后回复页和原始消息收据。 这个 [支持的客户端 API](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/intercom.md#supported-non-model-client) 仅连接 给已有的经纪人; 它不装入 Pi SDK, 型号, TUI 或对话日志 .

## 包扎技能

包装了两种与可用工具相匹配的技能. [`pi-subagents`](https://npmcn.com/package/%40fitchmultz/pi-subagents/skills/pi-subagents/SKILL.md) 覆盖 `delegate` 财务报告和审定财务报表 `agent_runs`, (中文(简体) ), 它只接收主要会议. [`pi-intercom`](https://npmcn.com/package/%40fitchmultz/pi-subagents/skills/pi-intercom/SKILL.md) 覆盖 `intercom`,每个会议都有,包括儿童和主要 从来没有代表。 装入 `/skill:pi-subagents` 或者说 `/skill:pi-intercom`。 。 。 .

## 监视特务,不让他们注意

在交互式 Pi 中, 上面编辑的部件名称包含有圆圈的单个孩子 指标。 部件只列出活动工作( 和不可读运行) 并消失 一旦一个完整的扫描没有发现。 这个 `/agents` picker 隐藏完成运行; 失败, 停止,中断,无法运行 仍然可见在那里. 在全屏模式下单击已命名行观看; `/agents` 仍然是键盘 路径。 长结果/消息卡倒闭 使用 Pi 本地扩展 (默认为Ctrl+O). 缩写+ O还扩展了模型/cwd的细节. 使用 `/agents <run-id>` 观看 任何保存的运行,包括一个已完成的儿童原生文本、工具调用和结果. 这是只读的:它既不花一个模型转弯,也不用发送、引导或停止 工作时 未出版的代理代理三角洲不是日记流 。 探员还在 人类观察不是第二个工作流程UI.

## 何为不言而喻

完成在下一个工具边界上引导活动父程序 。 闲置完成 积压按顺序发布,并开始一个父回合,而不是每个回合.

发射验收尚未完成. 经纪人接受不是接收日记 持续或答复。 停止请求不是程序退出的证明. 已保存运行 检查报告是分开的,没有发明成功的 当进程消失时产生结果.

儿童使用本地的Pi课程和选定的东道主的SDK,资源,工具, 项目说明和模型配置。 可选 `cwd` 财务报告和审定财务报表 `model` 超接属于启动; 普通的继续重用其保存的对话 和发射配置。 没有编辑或咨询用户代理 Markdown 文件 作为简介。 搭乘Fitchmultz/pi叉车 `toolExposure` 设置, [`subagents.toolExposure`](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/reference.md#tools-a-child-declares) 保存工具 儿童很少需要满足他们的要求.

## 移徙和证件

此重建会刻意去除配置编辑器, 工作流程/ 链/ fanout DSL, Claude代码后端,自定义代理 覆盖,主管 -问题复兴协议, 和远程发射/控制/目录API。 Grok bots 保留信件但丢失远程 产卵/恢复/会话/短片/组/广播接入;这些已退役的命令是: 而不是桥外症状。 更新已保存的 bot 提示/ 例程以关联 `send` 切换之前.

现有设施必须完成飞行中的工作并重新装入 **每个参与者 皮会** 在恢复远程通信之前, 输入同一批准版本。 旧 新的经纪人不会跨名称空间前进 保存上一个软件包并保存 状态用于回滚; 将助手和 Box 客户端/工作人资格定为不可改变的一对, 和同伴的离线收发和解门. 此仓库更改 不部署或重新启动任何东西.

升级让已退休的SQLite历史指数到位. 已包选入 [离线归档命令](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/retired-history-maintenance.md) 保持它的完整 在所有人被迫参加考试和可观察到的安全检查后进行恢复. 它在启动/安装期间从未运行,删除数据,或回收磁盘空间.

-   [工具和生命周期](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/reference.md)
-   [本地信息和中介迁移](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/intercom.md)
-   [经认证的远程信件/ Grok 同伴](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/intercom-bridge.md)
-   [发展和资格](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/development.md)
-   [诊断、基线和可衡量重建大门](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/single-agent-rebuild.md)

支持官方Pi和保养 `fitchmultz/pi` 分叉为1.5.2或更后; 两个主机分别获得资格,包括本地的Android/Termux. 节点.js 需要;见 [发展先决条件](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/development.md)来源 安装在Android上还需要一个Android-native `tsgo` 在 PATH; 预建 npm 上 软件包不需要编译器。 见 [原生Android/ Termux 软件](https://npmcn.com/package/%40fitchmultz/pi-subagents/docs/development.md#native-androidtermux)麻省理工学院有执照.

## 常见问题

### @fitchmultz/pi-subagents 是什么？

副剂管弦乐和当地会话协调的扩展

### 如何安装 @fitchmultz/pi-subagents？

在项目目录运行 npm install @fitchmultz/pi-subagents，或使用 pnpm add / yarn add / bun add。

### @fitchmultz/pi-subagents 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fitchmultz/pi-subagents 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fitchmultz/pi-subagents 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.22\.3 \<25 \|\| \>=26\.13\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fitchmultz/pi-subagents 可以商用吗？

@fitchmultz/pi-subagents 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fitchmultz/pi-subagents 的下载量有多少？

根据 npm 官方下载统计，@fitchmultz/pi-subagents 在 2026/10/15 – 2026/11/13 这 30 天内被下载 10,228 次，日均约 341 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fitchmultz/pi-subagents 还在维护吗？

最新版本 0\.52\.40 发布于 2026/11/15（今天）；至今共发布 56 个版本，其中过去 12 个月发布了 56 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。