pi-improve-interation

English | 中文

Summary

给 pi 原生与上游 pi 插件已有交互叠加增强的伴生包。交互不变，能力更强。

• 不 fork 上游：只走宿主公开扩展 API，上游升级最多改一处 adapter
• 不引入平行概念：增强的就是你已经在敲的 @、已经在派的活

增强了什么

当前增强对象是 pi-subagents（子 agent 编排包）：

场景	之前	之后
输入框敲 @	只有文件补全	同时补全 agent（@rev → @agent:reviewer，含内置 + 你的自定义 agents）
派活给子 agent	自己拼 subagent 调用话术	直接写 @agent:<name> <任务>，扩展自动转成显式委派指令
怀疑增强层没接上	翻配置、看日志	/plus-doctor 一条命令定位

如何安装

pi install npm:pi-subagents             # 前置
pi install npm:pi-improve-interation

重启 pi，敲 /plus-doctor。看到 OK pi-subagents (pi-subagents): delegation event transport resolved … 即接线成功。

本地开发装法：pi install /path/to/pi-improve-interation

贡献

本包按 adapter 组织：每个被增强的上游包对应一个 PluginAdapter（probe 只返回诊断、永不抛错），增强功能宿主无关。

extensions/plus.ts          pi 扩展入口：/plus-doctor、@ 面板、input 转换
src/adapters/types.ts       PluginAdapter 契约（唯一来源）
src/adapters/index.ts       adapter 注册表
src/adapters/pi-subagents/  当前唯一 adapter

给下一个插件加增强：

1. 实现 src/adapters/<pkg>/，契约见 src/adapters/types.ts（probe 永不抛错，只返回诊断）
2. 追加进 src/adapters/index.ts，在 test/wiring.test.ts 补一条注册表断言
3. npm run typecheck && npm test

Roadmap（欢迎认领）：

• delegation event transport 编排增强（进度可见、重试、预算控制）
• 第二个 adapter

License

MIT