返回目录

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 插件,绝不滥发。