Back to directory

dsh-locus-bridge

In a curated listMaintenance: Active

kide-lee/dsh-locus-bridge

DSH plugin acting as a Locus client for the Unity native broker (Win32 named pipe / Unix domain socket)

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

57

stars

0

forks

C#

Language

GPL-3.0

License

2026-11-10

Created

2026-11-18

Last push

GPL-3.0 DSH plugin that turns DeepSeek Harness into a Locus client for a live Unity editor — 18 `unity_*` tools, 5 Roslyn `code_*` tools, a `locus-asset` web sidebar panel and five toggleable Unity skills.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-18

License

GPL-3.0

01What can it help you accomplish?

  • Drive a live Unity editor from a DeepSeek Harness conversation

    18 `unity_*` tools covering status, C# execution, play mode, console, recompile, tests, assets, scene search and screenshots

    Unity developers who want the agent to inspect and change a real project without leaving DSH

  • Inspect and edit Unity assets next to the chat in the DSH web GUI

    A `locus-asset` sidebar tab with property trees, Save / Revert, thumbnails, prefab orbit previews and a three.js model viewer

    Teams on `dsh web` who want an Inspector-like view of `.prefab` / `.asset` / `.mat` / `.anim` / `.controller` files

  • Navigate a C# codebase while the Unity editor is closed

    5 `code_*` Roslyn tools: symbol search, go-to-definition, find references, hover and diagnostics

    C# / Unity developers with a `.sln` / `.csproj` who need semantic navigation without an open editor

02How to install into DeepSeek Harness

Prerequisites

  • A Unity project with the Locus package installed — the Unity 桥接 settings page can install it for you and refuses while the editor is open
  • A DSH Host with a `webServer` if you want the sidebar asset panel; CLI / TUI sessions do not register the `/locus/api` routes

Installation steps

  1. 01

    Ask DSH to install it, or run `dsh plugin --profile <profile> add github:Kide-Lee/dsh-locus-bridge`

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

  2. 02

    Restart DSH — the model then sees 18 `unity_*` tools plus 5 `code_*` C# analysis tools

  3. 03

    Open Settings → Unity 桥接 and pick the workspace and the Unity project; the Locus capsule then reads 已连接 / 未打开 Unity / 连接失败 / 没有插件

Verify the integration

  • Call `unity_status`: it reports editor state, open scene, capabilities and domain-reload state, and prints an install command when the Locus package is missing

Rollback

  • Turn the 功能 switches off in Settings → Unity 桥接: disabling Unity 操纵 unregisters the eleven `unity_*` tools on the Host, and `DSH_LOCUS_CSHARP=0` disables the whole `code_*` group at deployment level

03DSH integration and capability boundaries

DSH integrationNative runtime

Ships as a DSH plugin bundle with a Host half (registers the `unity_*` / `code_*` tools, the `/locus/api/*` routes and a settings section) and a client half (the `locus-asset` sidebar tab); Unity is reached through the Locus native broker.

  • Unity tool surface (`unity_*`)

    a tool call from the model with that tool's arguments→editor status, executed C# results, console logs, test results, asset property trees, screenshots

    runs C# on the Unity main threadcan switch Play / Edit mode, trigger a recompile and edit assets in memory
  • Sidebar asset inspector (`locus-asset`)

    a `.prefab` / `.asset` / `.mat` / `.anim` / `.controller` file address handed over from the file tree→property tree, thumbnails, prefab orbit preview, model viewer for `.fbx` / `.glb`

    edits stay in memory until Save writes the asset to diskpreview frames are cached under `Library/Locus/asset-preview-cache/`
  • C# semantic analysis (`code_*`)

    symbol names or source positions in a C# project that has `.sln` / `.csproj`→symbol search, definitions, references, hover docs, Roslyn and Unity analyzer diagnostics

    spawns a `dotnet` Roslyn language-server subprocessdownloads about 90 MB of components on the first query and caches them in the plugin directory
  • Five toggleable Unity domain skills

    a Unity workspace plus the per-skill switches in the settings page→debugger / profiler / graphics-debugger / ui-toolkit / view skills in the model's skill catalog

    compiles the bundled C# skill package into the editor on the first `unity_execute` after enabling
  • Settings section (workspace / features / skills)

    workspace and Unity project selection from the settings page→feature toggles that take effect immediately, without restarting DSH

    writes the plugin's own `settings.json` in the user data directory instead of `cordis.patch.yml`

04Who is it for? When not to use it?

Good for

  • Unity developers who want the agent to inspect and change a real project without leaving DSH
  • Teams on `dsh web` who want an Inspector-like view of `.prefab` / `.asset` / `.mat` / `.anim` / `.controller` files
  • C# / Unity developers with a `.sln` / `.csproj` who need semantic navigation without an open editor

Not for

  • Two capabilities are implemented locally instead of upstream: the background-scheduling hook only really patches on Windows (it needs Unity PDB private symbols), and stall diagnosis on Linux / macOS walks the stack with `ptrace` and reports `unsupported` when it cannot prove a managed frame.
  • `unity_asset_graph` has no full-project scan: the generated snippets only walk the currently open scene, so `references` / `usages` need a `file_path` from the caller and a `.prefab` must be opened in the editor before it can be scanned.
  • The Roslyn analysis service is an optional .NET 10 component: without .NET or without `npm run build:compiler` the tools report unavailable and fall back to in-editor compilation, and no SDK is downloaded at runtime.

05Compatibility, maintenance and safety notes

  • Two capabilities are implemented locally instead of upstream: the background-scheduling hook only really patches on Windows (it needs Unity PDB private symbols), and stall diagnosis on Linux / macOS walks the stack with `ptrace` and reports `unsupported` when it cannot prove a managed frame.
  • `unity_asset_graph` has no full-project scan: the generated snippets only walk the currently open scene, so `references` / `usages` need a `file_path` from the caller and a `.prefab` must be opened in the editor before it can be scanned.
  • The Roslyn analysis service is an optional .NET 10 component: without .NET or without `npm run build:compiler` the tools report unavailable and fall back to in-editor compilation, and no SDK is downloaded at runtime.
  • The sidebar asset panel only exists on a Host with a `webServer`, and `.unity` scenes are read-only there: reading one requires the scene to be loaded in the editor, and writes are refused with a reason.
2026-11-102026-11-15v1.1.0

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

06Frequently asked questions

How do I install dsh-locus-bridge?

Ask DSH to install it with the prompt the README provides, or run `dsh plugin --profile <profile> add github:Kide-Lee/dsh-locus-bridge` and restart DSH. After the restart the model sees 18 `unity_*` tools plus 5 `code_*` C# analysis tools.

Do I need the Locus desktop app running?

No. The plugin takes only the cross-process Unity capability: it talks to the Locus native broker, and the desktop UI, knowledge base, skills runtime and agent loop are not involved. When the broker offers `broker_multi_client_v1`, DSH and the desktop app can stay connected to the same editor at once.

What has to be installed in the Unity project?

The Locus package. Settings → Unity 桥接 shows a four-state capsule — 已连接 / 未打开 Unity / 连接失败 / 没有插件 — and offers an 安装 button that writes the marker without starting Unity; it refuses with 409 `editor_running` while the editor holds the package assemblies.

Can I switch parts of it off?

Yes — in Settings → Unity 桥接 the three feature switches take effect immediately without a restart. Disabling Unity 操纵 removes the eleven `unity_*` tools from the model's tool list at the Host, disabling C# 分析 removes the five `code_*` tools and stops the Roslyn server, and disabling 文件预览 unregisters the sidebar tab. `DSH_LOCUS_CSHARP=0` is a deployment-level switch that the settings page cannot override.

Does C# analysis work with Unity closed?

Yes, as long as `.sln` / `.csproj` exist: the five `code_*` tools do not go through the broker but start a local Roslyn language server as a `dotnet` subprocess and talk LSP over stdio. The first query downloads about 90 MB of components and caches them in the plugin directory.

08Data and sources

  • Author-claimedgithub.com359d49fca44c…

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

  • Author-claimedgithub.com359d49fca44c…

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

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-18. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.