Pi 引擎接入 Micheleww/dsh-pi-agent

dsh-pi-agent

把 Pi coding agent（npm 包 @earendil-works/pi-coding-agent）作为 agent loop 跑在 DeepSeek Harness（npm 包 @deepseek-ai/dsh）里：一个 DSH Agent 插件，驱动无头模式的 pi --mode rpc 子进程，DSH 前端（会话日志、hooks、preset、Web UI）无需任何改动即可使用。

在找以下任何一个？
- “怎么在 DeepSeek Harness / DSH 里用 pi？” —— 来对地方了。
- “把 DSH 的 agent-loop 换成 pi coding agent 的 loop？” —— 本插件用 pi --mode rpc 子进程替换工厂。
- “给 pi 配一个 Web UI / 浏览器前端？” —— dsh-pi-agent + 官方 DSH web app 给 pi 完整的 Web 界面：会话持久化、hooks、preset、模型切换。
- “在 DSH 里用极简纯净的提示词？” —— pi 引擎保持 ~300 token 系统提示词和四工具，DSH 的提示词组装永远到不了模型面前。零提示词注入。
- “DSH 里能不能像接 Claude Code / Codex 那样接 pi？” —— 可以，本插件就是把 pi 加为同等的引擎选项。

DSH 前端（会话、hooks、preset、SQLite 持久化、Web UI） │ dsh-pi-agent（本插件：AgentFactory + 事件翻译 + 历史衔接） │ spawn 子进程 + stdio 上的 JSONL 协议 │ 命令：set_model / prompt / steer / abort ▼ pi --mode rpc --session <重建的历史>（原汁原味的 Pi agent loop）

每次 create/resume 时，插件都会从 DSH 的持久化事件日志重建 Pi 会话文件并用 --session 启动子进程——新子进程的上下文窗口里已经装着完整对话，包括切换前在 DSH 原生 loop 下跑的轮次（见中途衔接）。

为什么

Pi 是一个极简 harness：~300 token 的系统提示词、四个工具（read/bash/edit/write）、会话中途零注入。DSH 是一个插件化平台：持久会话、策略、审批链和完整的提示词组装注册表。

本插件让你同时拥有两者：DSH 的工程外壳 + Pi 的纯净内核。插件激活时，模型看到的内容与在同一目录直接运行 pi 完全一致——没有额外的提示词段落、没有额外的工具、没有隐藏的 reminder。DSH 自己的提示词组装（dsh-system-prompt）和工具面在由此工厂驱动的会话中被完全绕过。

它同时是一个干净的 A/B 实验：同一前端、同一会话格式，开关本插件即可对比 DSH 原生 loop 与裸 Pi loop 的表现。

改变与不改变

| 层面 | 行为 |
| 系统提示词 / 工具 / 上下文 | 原封不动——与在同一目录运行 pi 完全一致（AGENTS.md 等上下文文件由 Pi 自行加载） |
| 模型路由 | 每会话 set_model；被委派的 subagent 请求的模型优先于工厂默认值 |
| 转向（steering） | DSH 的 send(..., 'next-turn' \| 'next-step') 映射为 Pi 的 steer——可在运行中途插入指令 |
| 会话持久化 | DSH 的会话事件始终是持久化的唯一事实源；每次 create/resume 都从它重建 Pi 会话文件，子进程启动即带完整历史 |
| 审批 / 权限 | 适用 Pi 的本地信任模型——Pi 的工具调用不经过 DSH 的审批链 |
| 回退 | 禁用本插件条目，DSH 自己的 dsh-agent-loop 立即恢复生效 |

中途衔接

会话不一定要“出生在 Pi 下”才能被 Pi 驱动。如果某个会话已经在 DSH 原生 loop 下跑了几轮（或在一个更早的 Pi 子进程下跑过），通过本插件恢复它就能无缝续接：DSH 的事件日志（user/message、assistant/message、tool/call、tool/result）会被转换成 Pi 会话文件，新子进程用 --session 加载它——完整历史（包括切换前 DSH 原生轮的对话）直接进入上下文窗口。

- DSH 始终是唯一事实源；Pi 文件只是重建的快照，每次 create/resume 重新生成（无漂移、无重复）。
- DSH 消息块原生映射：text → text、reasoning → thinking、tool-call → toolCall（arguments 重新解析）、tool/result → toolResult（工具名从调用日志恢复）。
- 图片块当前跳过（attachment 引用需要运行时附件服务）；文本历史足以承载上下文。
- 会话文件落在 ~/.dsh/pi-sessions/<session-id>.jsonl，便于审计。

DSH 标准模式： 第 1 轮 ── 第 2 轮 ── 第 3 轮 （原生 loop） │ 通过本插件 resume ─────────┘ 从 DSH 日志重建 Pi 会话 ▼ Pi 模式： [历史已加载] ── 第 4 轮 ── … （Pi loop，完整上下文）

Subagent 也走 Pi

与主 loop 分离配置：provider 插件是独立的 profile 行，两个引擎可独立开关——主 loop 用 pi + sub 用原生、主 loop 用原生 + sub 用 pi、或两者都用 pi，任意组合。

Subagent 委派走 Pi 引擎（与主 loop 行互不影响）：
- insert:
- id: subagent-pi
name: 'dsh-pi-agent/subagent'
config:
providerName: pi
piPath: 'pi' # 默认从 PATH 查找 model: 'provider/model' # 省略则用 pi 自己配置的默认模型 timeoutMs: 600000

- id: tool-subagent
name: '@deepseek-ai/dsh-tool-subagent'
config:
provider: pi # 换回 'spawn'/'fork' 即 DSH 原生子代理 toolName: subagent backgroundMode: one-shot maxDepth: 'provider-managed'

每次委派在父会话的工作目录里 spawn 一个全新的 pi -p <任务>：纯 Pi 系统提示词、自己的工具、自己发现 AGENTS.md。父会话的对话、人格、工具面一概不出进程边界——inheritsParentContext: false，零提示词碰撞。

依赖

- Node.js ≥ 20
- pi（npm i -g @earendil-works/pi-coding-agent）在 PATH 上（或传入 piPath）
- DSH（npm i -g @deepseek-ai/dsh），profile 需暴露 sessions 与 agents 服务（标准前端装配）
- peer 依赖：@deepseek-ai/cordis、@deepseek-ai/dsh-agent、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-scope、@deepseek-ai/dsh-session

安装

在你的 DSH 检出目录内（或 profile patch 可加载的任意位置）
npm install dsh-pi-agent

使用

在 profile patch 层（cordis.patch.yml）挂载：

所有新会话使用 Pi loop。
- insert:
- id: pi-agent
name: 'dsh-pi-agent'
config:
piPath: 'pi' # 或绝对路径 cwd: '/path/to/your/project' # Pi 会话的工作目录 model: 'anthropic/claude-sonnet-4-5' # provider/model 路由 debug: false

回退到 DSH 自有 loop：禁用此条目并重新启用 agent-loop。
- id: pi-agent
disabled: true

配置

| 键 | 类型 | 默认值 | 说明 |
| piPath | string | 'pi' | Pi 可执行文件；从 PATH 解析 |
| cwd | string | process.cwd() | Pi 会话的工作目录 |
| model | string | — | Pi 模型路由（provider/model） |
| debug | boolean | false | 将协议诊断追加到 /tmp/dsh-pi-agent.log |

调试

设置 debug: true（或挂载时传入 logger）：每条 RPC 命令、事件、子进程退出和工厂生命周期步骤都会追加到 /tmp/dsh-pi-agent.log。Pi 自身的 stderr 也转发到同一日志。

许可证

MIT