前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在構建複雜的智能體協作流程時，用戶、主 Agent 和外部 AI 之間的交互往往缺乏標準化的協議，導致狀態難以追蹤和流程難以固化。dsh-web-relay 插件旨在解決這一協作斷層，將三方交互固化爲可執行的協議。
插件定位¶
- 名稱：
victormshan/dsh-web-relay - 維護者：victormshan
- 核心價值：把「用戶 / 主 agent / 外部 AI」的協作固化爲可執行協議，並接入 Claude Code 混合審覈鏈與無介入續跑。
核心功能¶
該插件實現了以下核心能力：
- 三方協作協議 v2.0：定義用戶定調、外部 AI 規劃（含機器可讀 steps）、主 agent 執行、五級審覈及收口發佈的完整流程。
- Step List 狀態機：管理
pending/executing/review/approved/rejected狀態，支持 DAG 依賴門控、原子打回及重結構。 - 五級審覈鏈：提供從
external到manual的多級審覈通道，全程記錄reviewedBy。 - 混合架構：通過
D:\cc-tasks（Linux:~/cc-tasks）派發任務給 Claude Code，失敗時自動降級回三方鏈。 - alternatives 裁決：支持多方案打分擇優，記錄
step.decision及軌跡。 - 無介入續跑：通過
sessionId注入與心跳時間驅動（15min），配合 watchdog 實現自愈託管。 - 能力持久化：提供
lessons、registry、skills等跨會話可檢索的能力體系。
安裝與啓用¶
本包未發佈到 npm，安裝必須使用 Git 源。
# 安裝插件
dsh plugin --profile web add git+https://github.com/victormshan/dsh-web-relay.git
安裝後，請重啓 DSH Web 服務以加載插件。
自檢與驗證¶
安裝完成後，建議進行自檢以確認環境配置正確。
- 運行自檢腳本：
node <profile>/node_modules/dsh-apiproxy-shim/test/selftest.mjs
- 檢查插件狀態：
curl.exe -s "http://127.0.0.1:3080/dsh-web-relay/status?token=<TOKEN>"
關注返回結果中的 `apiProxyAvailable` 字段。
注意事項¶
- 安裝即運行：安裝第三方插件即運行第三方代碼。在安裝前，請務必 review 源碼及許可證。
- 安全護欄：
review:false不能解除安全護欄。主 agent 的危險命令攔截和越界文件策略爲運行時最高硬約束。 - apiProxy 硬注入：
apiProxy服務爲硬注入依賴。 - 兼容性限制：4.9.2 及更早版本與 0.1.5+（新線）不兼容。新線已移除
apiProxy服務，若不安裝隨包的shim，插件將停在pending並導致宿主啓動斷言失敗。
總結¶
dsh-web-relay 通過協議化和狀態機機制，解決了 DSH 生態中三方協作的標準化問題。它提供了從規劃、執行到審覈的全鏈路支持，適合需要嚴格流程控制和審計能力的場景。相關文檔與源碼請查閱其 GitHub 倉庫。
