返回目錄

dsh-locus-bridge

精選清單收錄維護狀態: 活躍

kide-lee/dsh-locus-bridge

作為 Locus 客戶端的 DSH 外掛,通過 Unity 原生 broker(Win32 命名管道 / Unix 域套接字)與 Unity 通訊。

前往 GitHub
$ dsh plugin --profile <profile> add github:Kide-Lee/dsh-locus-bridge

57

星數

0

Fork

C#

語言

GPL-3.0

授權條款

2026-11-10

建立於

2026-11-18

最近推送

GPL-3.0 的 DSH 外掛,把 DeepSeek Harness 變成操作 Unity 編輯器的 Locus 用戶端——18 個 `unity_*` 工具、5 個 Roslyn `code_*` 工具、網頁版 `locus-asset` 右側欄面板與五份可切換的 Unity 技能。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-18

授權條款

GPL-3.0

01它能幫你完成什麼?

  • 在 DeepSeek Harness 對話裡直接操作開著的 Unity 編輯器

    18 個 `unity_*` 工具,涵蓋狀態檢查、C# 執行、Play 模式、Console、重新編譯、測試、資產、場景檢索與截圖

    想讓 agent 檢查並改動真實專案、又不想離開 DSH 的 Unity 開發者

  • 在 DSH 網頁版裡就地檢視與編輯 Unity 資產

    `locus-asset` 右側欄標籤:屬性樹、Save / Revert、縮圖、prefab 旋轉預覽與 three.js 模型檢視器

    在 `dsh web` 上使用、希望像 Inspector 一樣檢視 `.prefab` / `.asset` / `.mat` / `.anim` / `.controller` 的團隊

  • Unity 編輯器沒開時也能瀏覽 C# 程式庫

    5 個基於 Roslyn 的 `code_*` 工具:符號搜尋、跳轉定義、引用查找、懸停簽章與診斷

    已有 `.sln` / `.csproj`、需要語意層級導覽但不想開編輯器的 C# / Unity 開發者

02如何將外掛接入 DeepSeek Harness?

先決條件

  • Unity 專案裡需要裝有 Locus 套件——設定頁的「Unity 橋接」可以代為安裝,但編輯器開著時會拒絕
  • 要用右側欄資產面板,DSH Host 必須帶 `webServer`;CLI / TUI 工作階段不會註冊 `/locus/api` 路由

安裝步驟

  1. 01

    直接讓 DSH 自己幫你裝,或者你自己執行 `dsh plugin --profile <profile> add github:Kide-Lee/dsh-locus-bridge` 這條指令來安裝

    $ dsh plugin --profile <profile> add github:Kide-Lee/dsh-locus-bridge

  2. 02

    重新啟動 DSH,模型隨後會看到 18 個 `unity_*` 工具和 5 個 `code_*` C# 分析工具

  3. 03

    開啟設定裡的「Unity 橋接」頁,選擇工作區與 Unity 專案;Locus 膠囊會顯示四種狀態:已連線 / 未開啟 Unity / 連線失敗 / 沒有外掛

驗證整合成功

  • 呼叫 `unity_status`:它會回報編輯器狀態、開啟的場景、capabilities 與網域重載狀態,缺外掛時直接給出安裝指令

復原

  • 在設定 → Unity 橋接裡關掉功能開關:關閉「Unity 操纵」會在 Host 端註銷十一個 `unity_*` 工具,`DSH_LOCUS_CSHARP=0` 則是部署層級開關,可整組關閉 `code_*`

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

以 DSH 外掛包形式發佈,分成 Host 與用戶端兩半:Host 註冊 `unity_*` / `code_*` 工具、`/locus/api/*` 路由與一個設定頁,用戶端提供 `locus-asset` 右側欄標籤;Unity 端透過 Locus 原生 broker 通訊。

  • Unity 工具集(`unity_*`)

    模型發起的工具呼叫及其參數→編輯器狀態、執行過的 C# 結果、Console 日誌、測試結果、資產屬性樹、截圖

    在 Unity 主執行緒上執行 C#可以切換 Play / Edit 模式、觸發重新編譯,並在記憶體中修改資產
  • 右側欄資產檢視器(`locus-asset`)

    從檔案樹交過來的 `.prefab` / `.asset` / `.mat` / `.anim` / `.controller` 檔案位址→屬性樹、縮圖、prefab 旋轉預覽,以及 `.fbx` / `.glb` 的模型檢視器

    改動只留在記憶體裡,按 Save 才寫回磁碟預覽影格會快取到 `Library/Locus/asset-preview-cache/`
  • C# 語意分析(`code_*`)

    已有 `.sln` / `.csproj` 的 C# 專案裡的符號名稱或原始碼位置→符號搜尋、定義跳轉、引用查找、懸停文件,以及 Roslyn / Unity 分析器診斷

    會啟動一個 `dotnet` Roslyn 語言伺服器子行程首次查詢下載約 90 MB 元件並快取在外掛目錄裡
  • 五份可切換的 Unity 領域技能

    一個 Unity 工作區,加上設定頁裡每條技能的開關→debugger / profiler / graphics-debugger / ui-toolkit / view 五個技能進入模型的技能目錄

    開關打開後,該專案第一次 `unity_execute` 時會把隨外掛分發的 C# 原始碼編譯進編輯器
  • 設定頁(工作區 / 功能 / 技能)

    在設定頁選擇工作區與 Unity 專案→立即生效的功能開關,不需要重新啟動 DSH

    把偏好寫進使用者資料目錄下外掛自己的 `settings.json`,而不是 `cordis.patch.yml`

04適合誰?何時不該用?

適合

  • 想讓 agent 檢查並改動真實專案、又不想離開 DSH 的 Unity 開發者
  • 在 `dsh web` 上使用、希望像 Inspector 一樣檢視 `.prefab` / `.asset` / `.mat` / `.anim` / `.controller` 的團隊
  • 已有 `.sln` / `.csproj`、需要語意層級導覽但不想開編輯器的 C# / Unity 開發者

不適合

  • 有兩處能力是本機實作而非上游實作:背景排程鉤子只在 Windows 上真正打補丁(需要 Unity 的 PDB 私有符號);卡死診斷在 Linux / macOS 上用 `ptrace` 走堆疊,證不出受控碼影格時直接回報 `unsupported`。
  • `unity_asset_graph` 沒有全專案掃描:產生的片段只走訪目前開啟的場景,所以 `references` / `usages` 必須由呼叫方給 `file_path`,`.prefab` 也要先在編輯器裡開啟才能被掃到。
  • Roslyn 編譯服務是選用元件:沒裝 .NET 10 或沒跑 `npm run build:compiler` 時,工具會如實回報不可用並退回編輯器內編譯,執行時不會下載 SDK。

05相容性、維護與安全提醒

  • 有兩處能力是本機實作而非上游實作:背景排程鉤子只在 Windows 上真正打補丁(需要 Unity 的 PDB 私有符號);卡死診斷在 Linux / macOS 上用 `ptrace` 走堆疊,證不出受控碼影格時直接回報 `unsupported`。
  • `unity_asset_graph` 沒有全專案掃描:產生的片段只走訪目前開啟的場景,所以 `references` / `usages` 必須由呼叫方給 `file_path`,`.prefab` 也要先在編輯器裡開啟才能被掃到。
  • Roslyn 編譯服務是選用元件:沒裝 .NET 10 或沒跑 `npm run build:compiler` 時,工具會如實回報不可用並退回編輯器內編譯,執行時不會下載 SDK。
  • 右側欄資產面板只在帶 `webServer` 的 Host 上存在,且 `.unity` 場景是唯讀的:讀取要求場景已在編輯器裡載入,寫入會被直接拒絕並附上原因。
2026-11-102026-11-15v1.1.0

GPL-3.0 · README 分支 main · 最新 release v1.1.0 (2026-11-16)

06常見問題

dsh-locus-bridge 要怎麼安裝?

用 README 提供的提示詞讓 DSH 自己安裝,或執行 `dsh plugin --profile <profile> add github:Kide-Lee/dsh-locus-bridge` 後重新啟動 DSH。重新啟動之後模型就能看到 18 個 `unity_*` 工具和 5 個 `code_*` C# 分析工具。

還需要同時開著 Locus 桌面端嗎?

不需要。外掛只取走「跨行程呼叫 Unity」這一項能力,直接和 Locus 原生 broker 通訊,桌面端的主介面、知識庫、skills 執行環境與 agent 迴圈都不參與。當 broker 具備 `broker_multi_client_v1` 時,DSH 和桌面端可以同時連著同一個編輯器。

Unity 專案裡需要裝什麼?

需要 Locus 套件。設定裡的「Unity 橋接」頁用膠囊顯示四種狀態——已連線 / 未開啟 Unity / 連線失敗 / 沒有外掛——並提供「安裝」按鈕,只寫 marker、不啟動 Unity;編輯器正佔著套件的組件檔案時會以 409 `editor_running` 拒絕。

可以只開一部分能力嗎?

可以。設定 →「Unity 橋接」裡的三個功能開關立即生效、不需要重新啟動:關掉「Unity 操縱」會在 Host 端註銷十一個 `unity_*` 工具,關掉「C# 分析」會移除五個 `code_*` 工具並停掉 Roslyn 行程,關掉「檔案預覽」則不再註冊右側欄標籤。`DSH_LOCUS_CSHARP=0` 是部署層級開關,設定頁無法覆蓋。

Unity 關著的時候 C# 分析還能用嗎?

能,前提是專案裡有 `.sln` / `.csproj`:五個 `code_*` 工具不走 broker,而是在本機以 `dotnet` 子行程啟動 Roslyn 語言伺服器,透過 LSP/stdio 對話。第一次查詢會下載約 90 MB 的元件,之後快取在外掛目錄裡重複使用。

08資料與來源

  • 作者聲明github.com359d49fca44c…

    dsh-locus-bridge 是一个 **DeepSeek harness 插件**。它能让 DSH 直接扮演 Locus 客户端,通过 Locus 原生 broker 操作 Unity 编辑器。

  • 作者聲明github.com359d49fca44c…

    这些路由挂在 `/locus/api/*`,只在存在 `webServer` 的 Host 上注册(CLI/TUI 不受影响)

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。