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
- 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
- 02
Restart DSH — the model then sees 18 `unity_*` tools plus 5 `code_*` C# analysis tools
- 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
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 memorySidebar 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 directoryFive 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 enablingSettings 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.
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.
07Related DSH workflows
dsh-our-free-model
by ebony-vinyl
Adds model choices, availability checks, usage panels, and a local OpenAI-compatible forwarder.
dsh-routing-suite
by yjh051108
dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).
dsh-ops
by t-auto
Run Bash and PowerShell commands, search and edit local files, and manage long-running background jobs from DSH.
dsh-connect-workbuddy
by dingminhua
Connect locally signed-in WorkBuddy models to DeepSeek Harness with a read-only credits overview and model management.
08Data and sources
dsh-locus-bridge 是一个 **DeepSeek harness 插件**。它能让 DSH 直接扮演 Locus 客户端,通过 Locus 原生 broker 操作 Unity 编辑器。
这些路由挂在 `/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.
