Pi 一次性子代理 curiosity654/dsh-subagent-pi

dsh-subagent-pi

dsh-subagent-pi 是一个实验性社区插件，它将 Pi 注册为 DeepSeek Harness（DSH）的原生、由 Session 支持的一次性 SubagentProvider。

每次委派都在一个全新的内存中 Pi 会话中运行，同时一个持久的 DSH 子 Session 通过标准 Subagent UI 暴露受支持的转录、层级结构、活动、token 用量和持续时间。Pi 仍然是唯一的执行权威；DSH Session 是观察和导航的投影，而非 Pi 对话状态。

0.2 版本是 1.0 之前的软件，固定于开发者预览版依赖。它适用于有界的一次性委派，但它不是通用工作流运行器，也不是经过加固的远程研究执行环境。

它提供什么

- 提供者 pi，用于前台工作和通过 pi_subagent 进行的标准一次性后台 Job。
- 一个真实的 DSH 子 Session，在完成和宿主重启后仍可检查。
- 将受支持的 Pi 用户、助手、推理、工具、用量和终端事件投影为官方 DSH Session 事件。
- 通过单独的顶层 pi_trust_project 工具进行需审批的精确 Workspace 信任持久化。
- 明确的模型、Thinking、取消、并发、清理和诊断边界。

兼容性

0.2 版本针对以下确切基线：

| 组件 | 支持的版本 |
| DSH | 0.1.0-rc.7 |
| Pi coding agent 和 Pi AI | 0.84.2 |
| Node.js | >=22.19.0 |

DSH 配置文件必须提供 rc.7 的 Session、Agent、Session 持久化和 Session 投影服务。Pi 身份验证和模型配置必须已经对运行 DSH 的账户可用。当缺少所需服务时，激活会失败，而不是静默降级为无 Session 的提供者。

安全与数据模型

- Pi 是执行权威。DSH 工具过滤器、审批策略、沙箱、提示词、技能和压缩不会被 Pi 子运行继承。
- pi_trust_project 仅批准调用它的顶层 DSH Workspace 的持久信任。它不是对每次 Pi 工具调用的审批门。
- 不受信任的运行仍可能加载 Pi 全局和用户资源；信任控制受保护的项目本地设置、扩展、技能及相关资源。
- 工具权限、审批门、MCP 和沙箱仅在加载的 Pi 扩展提供它们时才存在。在敏感 Workspace 中委派工作之前，请审查有效的 Pi 配置。
- Pi 与 DSH 在同一进程内运行。0.2 版本没有硬性执行或拆卸超时，也无法强制终止隔离的 worker。卡住的原生工具可能会延迟取消、卸载和容量释放，直到 Pi 变为空闲。
- maxConcurrentRuns 限制被接纳的 Pi 运行数量；它不限制 CPU、内存、I/O、递归扫描大小或外部副作用。
- 受支持的 Pi 转录内容通过宿主正常的 DSH Session 保留与持久化策略进行持久化。另外，本插件的 Audit Diagnostics 保持无内容：它们不会复制提示词、助手/推理文本、工具参数/结果、凭据或原始设置。

仅在你理解其原生执行策略的 Workspace 和 Pi 环境中使用本插件。当任务需要更强的强制执行时，添加 Pi 审批或沙箱扩展。

安装

将已发布的包安装到 DSH profile 中：

dsh plugin --profile web add dsh-subagent-pi@0.2.0
dsh --profile web --dump-config

如需开发，请改为克隆并链接检出目录：

git clone https://github.com/curiosity654/dsh-subagent-pi.git
cd dsh-subagent-pi
npm ci
npm run check
dsh plugin --profile web add "link:$PWD"
dsh --profile web --dump-config

该包声明了自己的 dsh.bundle 补丁，因此 profile 协调会添加 subagent-pi 行。在添加、更新或移除插件后，请重启任何长时间运行的 DSH 宿主。

配置

本插件拥有标准的 subagent-pi 设置命名空间：

subagent-pi:
defaultModel:
provider:
model:
thinking: medium
maxConcurrentRuns: 4

defaultModel 是可选的固定 provider/model 对。thinking 是可选的 Pi Thinking 覆盖。maxConcurrentRuns 是正的安全整数，默认值为 4。设置更改仅适用于后续运行。

每次运行都会继承父 Session 的规范 Workspace。Pi 会在全新的 print-mode 会话中解析原生工具、扩展、身份验证、模型回退和受信任资源。

用法

要求 DSH Supervisor 委托一个有界、自包含的任务。例如：

Use the pi_subagent tool to inspect this Workspace and summarize its test structure. Perform read-only operations only.

子项在运行期间会出现在标准 DSH Subagent Catalog 中。其 Session 在完成后保持只读。当任务应表示为 DSH 后台 Job 时，使用标准的 run_in_background 选项。

当有意需要项目本地的 Pi 扩展或技能时，请要求顶层 DSH Supervisor 调用 pi_trust_project。已批准的信任决定会影响后续的 Pi 运行，而绝不会影响已经处于活动状态的运行。

限制

- Pi 子项是一次性的。不支持对 Pi 对话状态进行跟进、引导、继续和冷恢复。
- 委托输入仅限文本。不支持输出 schema、provider 侧工具过滤、persona 和每次调用的 maxTokens。
- 没有 Pi 专用 UI、远程 worker 传输、工作流引擎、内部队列或硬性资源预算。
- 需要交互式 UI 的 Pi 扩展会遵循其原生 print-mode 行为；本插件不会模拟交互式 UI。
- Session Projection 会有意省略没有精确官方 DSH 表示的 Pi 专有数据。
计划中的能力工作请参见 ROADMAP.md。

开发与验证

使用以下命令运行自动化门禁：

npm ci
npm run check

npm run check 会运行 TypeScript 检查、Vitest 测试套件以及生产构建。发布验证还额外要求进行一次已认证的关联 DSH 冒烟测试，覆盖前台和后台工作、取消、Workspace 信任、干净卸载，以及重启后持久化的 Session 历史记录。

0.2 版本的实现遵循 GitHub Issue #2。领域术语和架构决策记录在 CONTEXT.md 和 docs/adr 中。

移除

dsh plugin --profile web remove dsh-subagent-pi

移除后请重启正在运行的 DSH 主机。

许可证

MIT