unity-dsh-bridge：通過本地 HTTP 橋接控制 Unity / 團結引擎

前言¶

DeepSeek Harness (DSH) 通過插件機制提供功能擴展。在開發需要直接操作 Unity 編輯器或團結引擎的智能體時，手動點擊或簡單的腳本往往難以滿足場景搭建、腳本編寫和實時調試的需求。unity-dsh-bridge 插件通過本地 HTTP 橋接，爲 DSH 提供了控制 Unity / 團結引擎編輯器的能力。

是什麼¶

unity-dsh-bridge 是一個由維護者 142gg-GZX 開發的 DSH 插件。該項目同時包含 DSH 插件 bundle、Unity Editor 插件和 Python 客戶端。

其核心功能是通過本地 HTTP 通信（監聽 127.0.0.1），實現以下操作：
* 場景與組件操作：搭建場景、查找層級、創建或銷燬物體、修改 Transform 和屬性。
* 腳本編寫與編譯：寫入 C# 腳本、觸發編譯、捕獲編譯錯誤與控制台日誌。
* 運行與調試：控制 Play Mode、截圖、模擬輸入。
* 資源管理：保存場景、創建材質等。

安裝與啓用¶

使用 DSH 的 CLI 命令安裝插件：

dsh plugin --profile desktop add github:142gg-GZX/unity-dsh-bridge

安裝完成後，重啓 DSH，該技能即可在技能目錄中找到。

典型用法¶

該插件提供了 Python 客戶端進行交互，支持命令行和腳本化調用。

1. 檢查連接狀態：

    py client/unity_client.py ping

2. 創建場景物體：

    py client/unity_client.py create_primitive '{"type":"cube","name":"Floor","scale":[10,1,10]}'

3. 運行演示腳本：

    py demo/demo_game.py
    py demo/demo_camera.py
    py demo/demo_input.py

適用場景與注意事項¶

• 兼容性：支持 Unity 2019.4+、2020.3、2022.3 以及團結引擎 2022.3。
• 編譯限制：團結引擎不提供 CompilationPipeline API，編譯錯誤通過控制台日誌報告，而非 API 返回。
• 網絡安全：服務僅監聽 127.0.0.1，不會暴露到外網。
• 項目結構：該倉庫集成了 DSH 插件、Unity 插件和 Python 客戶端，安裝時請注意區分。

通過本地 HTTP 橋接，該插件將 DSH 的控制力延伸至 Unity 編輯器層面，適合需要自動化測試、場景生成或遠程調試的開發場景。更多細節請參考 GitHub 倉庫。