unity-dsh-bridge

让 DeepSeek Harness(DSH)直接控制 Unity / 团结引擎(Tuanjie)编辑器:搭场景、写 C# 脚本、编译排错、进 Play Mode、截图、模拟输入,实现"边看效果边调试"的闭环。

一个项目同时是:DSH 插件 bundle + Unity Editor 插件 + Python 客户端。

架构

DSH(agent)  ←HTTP JSON 127.0.0.1:8790→  Unity Editor 插件(DshBridge.cs)
   │                                        ├─ 场景/组件/材质/脚本
   │                                        ├─ 编译与报错捕获
   └── client/unity_client.py                ├─ Play Mode / 截图
                                             └─ 状态面板(编辑器窗口 + 网页)

安装方式(任选)

A. 作为 DSH 插件安装(推荐)

# 直接从 GitHub 安装
dsh plugin --profile desktop add github:142gg-GZX/unity-dsh-bridge

# 或本地目录
dsh plugin --profile desktop add <本仓库路径>

装完重启 DSH,技能 unity-dsh-bridge 即出现在技能目录。

B. 只装 Unity 侧插件(手动)

把 assets/UnityPlugin/Assets/Editor/DshBridge/DshBridge.cs 复制到任意 Unity 项目(Unity 2019.4+/2020.3/2022.3,或团结引擎)的 Assets/Editor/ 下,打开项目即自动启动。菜单 DshBridge → Status Window 打开面板;浏览器 http://127.0.0.1:8790 看网页状态页。

C. 只用 Python 客户端(不装 DSH 插件)

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

命令速查

场景 new_scene hierarchy find create_primitive create_empty destroy set_transform set_active 组件 add_component remove_component get_components set_property get_property 脚本 write_script read_file list_dir 编译 compile compile_status 运行 playmode playmode_state console 调试 invoke_static screenshot create_material set_status 资源 save_scene open_scene quit

演示

py demo/demo_game.py     # 搭场景→写脚本(故意报错)→编译纠错→Play Mode→截图
py demo/demo_camera.py   # 写摄像机环绕脚本 + 搭场地
py demo/demo_input.py    # 按键控制相机 + AI 模拟输入

兼容性

• Unity 2019.4+ / 2020.3 / 2022.3,以及团结引擎(Tuanjie)2022.3。
• 团结引擎无 CompilationPipeline.Get*Messages API,插件已用 Console 日志报告编译错误。
• 服务仅监听 127.0.0.1,不暴露外网。

License

MIT