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
