前言¶
DeepSeek Harness 的设计思路是「一切皆插件」。当需要通过 AI 助手控制游戏引擎时，通常要借助脚本或自动化工具手动操作编辑器。如果目标引擎是团结引擎（Tuanjie），现有的工具往往只能完成部分工作：要么只能读取场景信息，要么只能执行简单的命令。dsh-tuanjie-plugin 把 Tuanjie 编辑器的 Codely 桥接能力封装成 DSH 工具，让 DSH 技能可以远程操作场景、组件、属性和编辑器命令，甚至直接在编辑器进程中执行 C# 代码。
这是什么¶
dsh-tuanjie-plugin 是 DeepSeek Harness 的一个插件，用于驱动正在运行的团结引擎编辑器。维护者为 ThePuristImpurity。它通过 Tuanjie 编辑器自带的 Codely bridge 与编辑器进程通信，把场景构建、GameObject 操作、组件属性修改、编辑器命令执行和 C# 运行时脚本封装成可调用的工具。
安装¶
在 DeepSeek Harness 的命令行中运行：
dsh plugin add github:ThePuristImpurity/dsh-tuanjie-plugin
也可以在 DeepSeek Harness 插件市场搜索 tuanjie 来找到它。
前置条件¶
- 团结引擎编辑器必须已经启动，并且目标工程已加载。
- 工程中包含 Codely bridge（
cn.tuanjie.codely.bridge），这是团结引擎默认自带的组件。 - 本插件不会自动启动编辑器，只能附加到已运行的实例。
工具与能力¶
插件提供以下工具：
| 工具 | 用途 |
|---|---|
tuanjie_status |
列出可连接的编辑器实例（端口、工程路径、状态） |
tuanjie_list_commands |
列出编辑器暴露的所有命令及其支持的操作 |
tuanjie_command |
执行指定的编辑器命令，例如 manage_gameobject + ["create", "--name", "Player"] |
tuanjie_eval |
在编辑器进程中执行 C# 代码，可访问完整的 UnityEngine 和 UnityEditor API |
tuanjie_cli |
执行底层 bridge 的子命令（status / editors / command / shell） |
典型用法¶
- 检查可连接的编辑器实例：
tuanjie_status
- 列出编辑器暴露的所有命令：
tuanjie_list_commands
- 创建一个名为
Player的 GameObject：
tuanjie_command manage_gameobject create --name Player
- 在编辑器进程中执行 C# 代码：
tuanjie_eval "UnityEngine.Debug.Log('Hello from Tuanjie');"
- 使用底层 bridge 子命令查看编辑器列表：
tuanjie_cli editors
可靠性说明¶
0.1.0 版本存在一个问题：错误的参数类型会被 bridge 静默丢弃，但仍然返回 success: true，导致操作实际上没有生效。0.1.1 对 CLI 适配器中的参数进行了标准化和校验，现在这些错误要么成功执行，要么在发送请求前就报错，不会产生误导性的成功反馈。如果 bridge 返回 No modifications applied、0 targets found 或 not found using method，插件会将该调用降级为失败。
即便如此，建议在使用修改类工具后，用 tuanjie_eval 验证结果，因为插件无法改变 bridge 本身的行为。
已知限制¶
- bridge 无法启动编辑器，只能附加到已运行的实例。
capture_game_view被 bridge 禁用。可以改用manage_gameview，或在exec_runtime_script上使用record_game_view（需要ffmpeg）。- 截图会写入
--path+--filename指定的位置（相对路径相对于工程根目录），真实路径可在data.path中读取。如果--path以.png结尾，会被拆分为目录与文件名；没有扩展名的--path表示目录，由 bridge 自己命名文件。截图总是写入 PNG 格式。 - 通过
manage_input进行键盘和鼠标移动输入需要安装 Input System 包（com.unity.inputsystem）；点击 uGUI 元素不需要，它走的是 EventSystem。 tuanjie_cli不是 Unity Hub CLI，不支持projects create、templates list、open、pipeline install、test、build、logs等命令。
适用场景与注意事项¶
适合需要通过 DSH 技能自动化操作团结引擎工程的场景，比如批量创建 GameObject、修改组件属性、执行编辑器脚本或检查场景状态。使用前应确认编辑器已启动并加载目标工程，且工程包含 Codely bridge。由于插件以当前 DSH 进程的权限运行，建议在安装前检查源码与许可证（MIT）。
小结¶
dsh-tuanjie-plugin 把团结引擎编辑器的 Codely 桥接能力直接映射为 DSH 工具，让 DSH 技能可以像调用本地命令一样控制编辑器。它提供了场景与 GameObject 管理、组件属性编辑、命令执行和 C# 运行时脚本的能力，适合需要在 DeepSeek Harness 中集成团结引擎自动化操作的开发者。
- 插件目录：https://www.skillhub.cn/plugins/ThePuristImpurity/dsh-tuanjie-plugin
- GitHub：https://github.com/ThePuristImpurity/dsh-tuanjie-plugin
