前言¶
DeepSeek Harness（DSH）的設計理念是「一切皆插件」。在進行 Unity 遊戲開發時，開發者通常需要通過命令行或腳本與 Unity 編輯器交互。DSH 提供了插件機制來擴展其功能。dsh-unity-mcp 插件解決了將 DSH 與 Unity MCP 服務器連接的痛點，它通過 unity-ai-relay 可執行文件作爲中間層，讓 DSH 能夠直接調用 Unity 的工具鏈。
插件簡介¶
該插件由開發者 ComeCaramelos 維護，連接 DSH 與 Unity MCP 服務器。它利用 Unity AI Assistant 包自帶的 unity-ai-relay 可執行文件，並通過 DeepSeek 的標準 MCP 客戶端橋接，在 Web GUI 中提供設置和狀態卡片。
核心功能¶
- 連接 Unity MCP 服務器：通過
unity-ai-relay建立與 Unity 編輯器的通信。 - 工具映射：將 Relay 註冊的工具暴露爲標準的
mcp__unity__*工具，供 DSH 直接調用。 - Web GUI 集成：在 Web 界面的設置中提供狀態卡片，用於配置和監控連接。
- 本地啓動：插件不執行任何下載操作，而是直接啓動本地已安裝的
unity-ai-relay可執行文件。
安裝與啓用¶
通過官方命令行工具安裝該插件：
dsh plugin --profile web add @comecaramelos/dsh-unity-mcp
典型用法¶
使用該插件前，需確保滿足以下前提條件：
1. 在 Unity 編輯器中已安裝 Unity AI Assistant 包（com.unity.ai.assistant）。
2. 保持 Unity 編輯器處於運行狀態。
安裝後，通過以下步驟進行配置：
- 進入 Settings 菜單。
- 導航至 Plugins -> Plugin configuration -> DSH Unity MCP。
- 配置 Relay 可執行文件：點擊「Fetch executables」按鈕搜索本地路徑（包括 WSL 主機可訪問的 Windows 用戶配置文件），選擇正確的
unity-ai-relay路徑。 - 設置額外參數：在「Extra flags」欄中添加啓動參數，例如
--project-path=/home/roberto/game或--name=MyProject。 - 日誌控制：選擇是否將 Relay 的輸出重定向到日誌文件以減少控制台噪音，或在調試時直接輸出到控制台。
適用場景與注意事項¶
- 運行環境：插件以當前 DSH 進程的權限運行。在安裝前，建議檢查源碼與許可證（MIT）。
- 依賴要求：必須依賴 Unity AI Assistant 包，且 Unity 編輯器必須處於運行狀態。Relay 是編輯器的側通道，若編輯器未運行，連接將失敗。
- 配置持久化：配置項保存在 Web GUI 中，若 Relay 程序路徑無效，插件不會自動重新解析，需手動修正。
結語¶
dsh-unity-mcp 提供了標準化的橋接方案，讓開發者能夠在 DSH 環境中無縫調用 Unity 的 MCP 工具。它通過本地執行的方式減少了網絡傳輸開銷，並利用 Web GUI 實現了可視化的配置管理。
