# @pi-in-go/pigpen-subagents 中文文档

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

版本：0\.2\.0
npm 元数据更新时间：2026-11-02T03:50:59.638Z
中文译文更新时间：2026-11-02T04:25:57.264Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：14 MB，993 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-06T00:03:25.700Z
- 最新版本发布：2026-11-02T03:50:59.225Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Go端口pi-subagents：代理和链定义，它们的发现，子代理工具的列表和get操作，单代理和链运行通过子pig进程（部分：没有并行，异步，工作流，工作树或舰队功能）

## 安装

```sh
npm install @pi-in-go/pigpen-subagents
```

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

## README

# pi-subagents （Go端口，部分）

PiG的Go扩展：将工作委托给markdown文件中定义的专家代理。它是一个港口 **pi-subagents** 由尼克 Bailon(见 [CREDITS.md](https://npmcn.com/package/%40pi-in-go/pigpen-subagents/CREDITS.md))，用 [扩展移植技能](https://npmcn.com/package/%40pi-in-go/extension-port/README.md)，不需要Node。

## 使用

中定义代理 `.pi/agents/<name>.md` （项目）或 `~/.pi/agent/agents/<name>.md` （你），原件的格式：

```markdown
---
name: helper
description: Helps with things
model: provider/model
tools: read, grep
---

You help.
```

该模型看到两个工具。 `subagents_enable` 使 `subagent` 工具可用(在此之前不提供，如 原始);然后:

-   `subagent {action: "list"}` 列出代理(`agentScope`（用户、项目或两者）， `{action: "get", agent: "helper"}` 显示一个;
-   `subagent {agent: "helper", task: "..."}` 在子节点中运行一个代理 `pig --print` 处理并返回其答案；
-   `/run-chain <chain> <task>` 运行一个 `.chain.md` 链(`.pi/chains/` 或者 `~/.pi/agent/chains/`)：每一步的答案都流入 下一个是 `{previous}`，要求如下： `{task}`.

13个代理商随包裹一起发货（原装） `scout`， `worker`， `reviewer`,……)。 `PIG_SUBAGENT_PIG_BINARY` 猪的名字 为孩子开始；否则猪跑这个扩展，那么a `pig` 那么，除了这个程序 `PATH`． 一个孩子得到了 stdin上的任务，像原始的后台子节点一样发现扩展（模型提供程序和它的登录名来自一个），并且 可能自己只委托给深度2 (`PI_SUBAGENT_MAX_DEPTH`（如原文）；一次最多运行4个子进程，一个被取消的调用（Escape）会停止它的子进程。代理人 `systemPromptMode: replace` 不能在小猪二进制子程序中运行（二进制程序有自己的系统提示符）。

代理选择其子代理的扩展名与原始代理一样。 `extensions: a, b` 只装载那些（空的） `extensions:` 负载 没有，甚至没有模型提供程序)，以及 `subagentOnlyExtensions: c` 负载 `c` 在孩子身上，在其他人身上。条目是什么？ `pig --extension` 取：路径(`./` 和 `../` （相对于代理文件）， `builtin:<name>`，或 `npm:`/`git:` 源。对于两者都不具备的代理， `subagents.defaultExtensions` 和 `subagents.defaultSubagentOnlyExtensions` 在 `settings.json` 是默认的：PiG自己的文件(`.pig/settings.json` 在人群中， `~/.pig/agent/settings.json`)及 原始的(`.pi/settings.json` 在项目的根， `~/.pi/agent/settings.json`)都是read， project over user和PiG的 在每一层的Pi上

```json
{ "subagents": { "defaultSubagentOnlyExtensions": ["/path/to/child-only-extension"] } }
```

一个孩子的模式和思维水平首先最强，来自呼唤 `model`， `subagents.agentOverrides.<name>.model` 和 `.thinking` （`false` 清除代理自己的)，然后清除代理的前台 `subagents.defaultModel` 和 `defaultThinking`，从相同的文件中读取，每个从第一个设置它的文件中读取。没有他们，孩子继续跑 主机的默认型号。其他 `agentOverrides` 字段, `defaultProvider` 和 `modelScope` 未读：

```json
{ "subagents": { "defaultModel": "provider/small-model", "agentOverrides": { "oracle": { "model": "provider/large-model", "thinking": "high" } } } }
```

```sh
pig install ./components/subagents
```

## 移植了什么

前端内容解析、代理和链定义（项目中的发现、用户目录和内置集）； 项目优先于用户优先于内置、包、别名、名称解析)、markdown链文件（解析和写入） `subagent` 工具的 `list` 和 `get`, `subagents_enable` 加载器，并通过子进程运行一个代理或链 另外：原始版本通过它自己的执行器和脚本工作流运行子版本)。

**不被接纳，被拒绝；** 并行、异步和后台运行、脚本工作流程(`workflow`， `workflowScript`， `workflowScriptPath`)和遗产 `tasks`/`chain` 输入，理事会模式，工作树隔离，舰队和状态视图，转向和 主管频道，看门狗，任务，档案， `agentOverrides` 除了 `model` 和 `thinking`， `.chain.json` 连锁，管理行为其他 比 `list` 和 `get`． 工具荣誉 `agent`， `task`， `agentScope`， `cwd`， `model` 和 `async: false` （端口总是在前台运行）和for `list` 和 `get`， `action`， `agent` 和 `agentScope`． 任何其他 参数或动作，以及工具 `bg_wait` 和 `subagent_supervisor` （声明让模型看到原作的工具），被拒绝 只有一条消息，什么都不运行：

> @pi-in-go/pigpen-subagents （Go端口）不支持异步（后台）运行(`async: true`)。安装原来的扩展，npm:pi-subagents@0.73.1，它在PiG中运行不变。

原始的斜杠命令，而不是端口自己的 `/run-chain` （`/run`， `/subagents`， `/subagents-stop`， `/prompt-workflow`)不是 注册，也没有它的技能和提示模板。看到 [港口/ PORT.md](https://npmcn.com/package/%40pi-in-go/pigpen-subagents/port/PORT.md).

## 常见问题

### @pi-in-go/pigpen-subagents 是什么？

Go端口pi-subagents：代理和链定义，它们的发现，子代理工具的列表和get操作，单代理和链运行通过子pig进程（部分：没有并行，异步，工作流，工作树或舰队功能）

### 如何安装 @pi-in-go/pigpen-subagents？

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

### @pi-in-go/pigpen-subagents 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/pi-in-go\_\_pigpen-subagents 是否存在。

### @pi-in-go/pigpen-subagents 可以商用吗？

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

### @pi-in-go/pigpen-subagents 还在维护吗？

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