# 上游来源

- 上游：<https://github.com/tintinweb/pi-subagents>
- 导入 tag：`v0.18.0`
- 导入 commit：`3f9d35cd078d18a141eb5a6d8f4fc5010d756280`
- 快照日期：2026-08-20
- 上游包版本：`0.18.0`
- 许可证：MIT

## 本地维护

本目录由 `my-pi` 仓库直接维护。它不是 submodule，且不得包含嵌套 `.git`、上游 `.pi` 状态、`node_modules`、覆盖率输出或生成的构建产物。

初始导入保留了上游 TypeScript 源码、测试、示例、文档、媒体、包元数据和许可证。上游 `.github/` 自动化与本地 `.pi/` 状态有意未导入。

源码包含在根包中，通过根 `file:./pi-subagents` 依赖安装，并由宿主自有的 `extensions/subagents.ts` wrapper 经根 `pi.extensions` 默认加载。本地快照新增了文档化的权限子会话生命周期桥接、根 authority 转发身份、活跃 Agent 身份，以及宿主自有的精确路径 mandatory extension 策略。组合包 wrapper 保护 `extensions/permission-system.ts` 免受 Agent 控制的扩展过滤，并在该入口不可用时 fail closed。另新增三个 opt-in 扩展选项（`basePrompt`、`bundledAgentsDir`、`excludedExtensionPaths`，经 `createPiSubagentsExtension` → `AgentManager` → agent-runner → `buildAgentPrompt` 透传），不传时保持上游逐字节行为。根编排工具归入 Tool Search 已提交的 `subagents` 分组，Pi host peer 标记为 optional，以免组合包安装第二套 Pi runtime。