前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過擴展組件增強功能。對於希望在 DSH 會話 UI 中直接使用 Agent Client Protocol (ACP) Agent 的用戶，dsh-acp-adapter 插件提供了集成方案。它允許在 DSH 環境中繼承原生會話、工具審批和團隊協作能力，同時保持對 ACP Agent 的控制。
安裝¶
安裝前需確認運行 DSH 的主機上已安裝並登錄對應的 Agent CLI。根據運行環境選擇對應的安裝命令：
Desktop 環境：
dsh plugin --profile desktop add @zaimokuza/dsh-acp-adapter@next
Web 環境：
npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add @zaimokuza/dsh-acp-adapter@next
安裝完成後，需手動在插件管理器中點擊“立即啓用”。啓用後，請完全退出並重新打開 DSH 以確保插件加載生效。
使用步驟¶
- 連接 Agent： 打開 DSH 的 插件 → ACP adapter 面板。插件內置了 ACP 官方 Agent 目錄快照，可直接添加；也可手動添加目錄外的 Agent。
- 驗證連接： 添加 Agent 後，檢查連接狀態，確保 Agent CLI 已正確登錄。
- 發起會話： 在新會話中，從模型選擇器中切換到已配置的 Agent 模型。
- 執行命令： 在會話中直接使用 Agent 的 ACP 命令，例如
devin acp或codebuddy --acp。
核心功能¶
- 原生集成： 在 DSH 會話 UI 中直接使用 AI Agent，繼承原生會話管理、工具審批和團隊協作機制。
- 自動批准： 自動批准當前會話的 DSH 原生工具請求，減少人工干預。
- 原生審批卡： 當 Agent 請求審批時，顯示 DSH 原生審批卡片，保持界面一致性。
- 會話控制： 支持停止當前輪次，按 Enter 可排隊輸入，支持 Agent 在同一會話中繼續。
- 子代理查看： 提供子代理的只讀詳情視圖，便於監控 Agent 行爲。
- 診斷導出： 支持 ACP 診斷記錄的導出功能，用於排查問題。
注意事項¶
- 更新與卸載： 插件管理器不會自動更新。卸載插件不會移除已安裝的 Agent CLI 或退出賬號。
- 前置依賴： Agent CLI 必須在運行 DSH 的主機上安裝並登錄。
- 工具控制權： Agent 自帶工具仍由 Agent 本身控制，插件不干預這些工具的執行邏輯。
- 安全分享： 在導出 ACP 診斷記錄或 DSH 原生會話日誌時，請檢查並移除敏感信息（如提示詞、文件路徑、憑證等）。
