前言¶

DeepSeek Harness (DSH) 支持通過插件擴展能力。官方的 dsh-subagent-codex 插件實現了“真網關”架構，允許本地命令行程序與 DSH 會話直連。dsh-subagent-pi-plus 是基於該架構的移植版本，將直連代理從 Codex 切換爲 Pi，使 Pi 成爲 DSH 中的第一公民。它通過 Pi RPC 協議提供單次 Pi 子代理提供者和真網關功能，適合需要本地化運行 Pi 會話的場景。

插件介紹¶

該插件由 february2015 維護，是一個開源工作流插件（MIT 許可證）。它 fork 自官方 @deepseek-ai/dsh-subagent-codex 插件，僅修改了直連代理對象爲 Pi，保留了完整的“真網關”核心邏輯。

核心功能¶

1. 真網關直連
   通過本地命令綁定當前 DSH 會話與持久化的 Pi 會話。DSH 不再運行中間模型，僅作爲消息透傳通道。

2. 持續對話：隊列 + 直接插入
   當 Pi 忙碌時，新消息自動進入隊列，按順序執行。支持通過浮動面板查看、提升（插隊）、插入、編輯或刪除隊列中的消息。

3. 實時中間輸出
   Pi 的執行進度（消息增量、工具調用、狀態事件）會以近實時方式顯示在 DSH 會話中，默認僅展示不進入模型上下文。

4. 狀態顯示
   綁定成功後，會話標題欄顯示 PI-xxxx 徽章（狀態點 + 會話 ID 前四位），輸入欄顯示狀態行。未綁定會話保持界面整潔。

5. 圖片/附件透傳
   支持直接粘貼或上傳圖片，原樣傳遞給 Pi。視覺理解能力依賴 TeamAI 技能 ocgw-vision，此插件本身不具備視覺理解能力。

6. 委派與網關共存
   一個 DSH 會話可同時使用模型觸發的單次 Pi 委派和用戶掛載的網關會話，互不干擾。

安裝與啓用¶

在安裝前，需確保當前機器已安裝並配置好 pi 命令行工具（包括登錄和模型設置）。

1. 安裝插件¶

使用 DSH 插件管理命令添加本地路徑：

dsh plugin --profile <name> add /path/to/dsh-subagent-pi

2. 啓動 DSH¶

安裝完成後，使用對應的 profile 啓動 DSH：

dsh --profile <name>

典型用法¶

1. 打開任意 DSH 會話（建議 cwd 爲你的項目目錄）。
2. 輸入 /pi-lock。綁定成功後，標題欄會出現 PI-xxxx 徽章，後續輸入的內容將直接發送給 Pi。
3. 當 Pi 正在處理消息時，後續輸入會自動排隊。使用浮動面板查看隊列，可手動提升消息優先級或直接插入新內容。
4. 輸入 /pi-unlock 斷開連接。Pi 會話數據保留，可通過 /pi-lock <piSessionId> 指定會話 ID 重新綁定。

注意事項¶

• npm 包名差異：npm 包名 dsh-subagent-pi 屬於較早的第三方項目，不是此插件。此插件的 npm 包名爲 dsh-subagent-pi-plus。
• 前置依賴：必須在本地安裝並配置 pi 工具。
• 綁定限制：一個 Pi 會話只能綁定到一個 DSH 會話。
• 視覺能力：插件不直接具備視覺理解能力，圖片透傳後由外部技能（如 ocgw-vision）處理。
• 未綁定狀態：未綁定會話不會顯示任何內容，僅作爲普通 DSH 會話運行。

結語¶

該插件爲在 DSH 中使用 Pi 提供了標準化的直連方案，解決了遠程調用與本地編排之間的割裂問題。若需進一步瞭解實現細節，可查閱 GitHub 倉庫文檔。