dsh-tuanjie-plugin
DeepSeek Harness plugin that drives the Tuanjie (团结引擎) editor — connect to a running editor's Codely bridge, build and modify scenes and GameObjects, edit component properties, run editor commands, and execute C# inside the editor process.
Docs: README.zh.md (中文文档)
Install
dsh plugin add dsh-tuanjie-plugin
Requirements
The Tuanjie editor must already be running with the target project loaded, and that project must ship the Codely bridge (cn.tuanjie.codely.bridge, bundled with Tuanjie by default). This plugin cannot launch the editor for you.
Tools
| Tool | Purpose |
|---|
tuanjie_status | List connectable editor instances (port, project root, state) |
tuanjie_list_commands | List every command the editor exposes, with supported actions |
tuanjie_command | Run a named command, e.g. manage_gameobject + ["create", "--name", "Player"] |
tuanjie_eval | Execute C# inside the editor process with full UnityEngine / UnityEditor access |
tuanjie_cli | Run the underlying bridge subcommands (status / editors / command / shell) |
Reliability (0.1.1)
The 0.1.0 line had one nasty failure mode: a wrong argument type was silently dropped by the bridge while it still answered success: true. 0.1.1 normalizes and validates arguments in the CLI adapter, so these either work or fail loudly:
| Invocation | 0.1.0 | 0.1.1 |
|---|
--position "1,2,3" | silently dropped, nothing moves | coerced to an array, actually applies |
--componentsToAdd BoxCollider | silently dropped, Transform only | wrapped into an array |
--propertyValue "1,2,3" | zeroes out the vector | coerced to an array, no longer zeroed |
--types warning | ignored, returns every type | returns warnings only |
--name=X (equals form) | stored as a key literally named name=X | equivalent to the space form |
delete --name X | Target GameObject ('') not found | rejected, tells you to use --target |
--output out.png | silently ignored | rejected, points at --path / --filename |
misspelled flag (e.g. --filterTypo) | silently ignored | rejected with a spelling suggestion |
apply_text_edits without line/column | inserts at the top of the file, still reports success | rejected before sending |
--imports System.Text | overrides the default namespaces, CS0103 | merged into the defaults |
modify --componentName X --propertyName Y --propertyValue Z | reports success, field keeps its old value | rejected, points at set_component_property / --componentProperties |
modify --componentProperties '{"Typo":{…}}' | One or more component property operations failed, no hint which | names the missing component and lists the ones the object really has |
modify --componentProperties '{"m_LocalPosition.x":5}' | success: true, nothing written | rejected, tells you to nest it under a component |
apply_text_edits --edits '[]' | bridge answers No edits provided. | rejected before sending |
An unknown argument is now caught before the request is sent, and the error lists every parameter that tool accepts. If the bridge answers with No modifications applied, 0 targets found, or not found using method, the envelope is downgraded to a failure.
Even so, verify writes with tuanjie_eval — the plugin cannot change the bridge's own behaviour.
tuanjie_eval accepts quotes and backslashes as written (no escaping needed), and Debug.Log output comes back in data.logs.
Known limitations
- The bridge cannot launch the editor; it only attaches to a running instance.
capture_game_view is disabled by the bridge. Use manage_gameview, or record_game_view on exec_runtime_script (requires ffmpeg).- Screenshots land where
--path + --filename say (relative paths resolve against the project root); read the real path from data.path. --path may name the file directly when it ends in .png (--path screenshots/Foo.png): the value is split into directory + file name, while an extension-less --path still means a directory that the bridge names itself. Captures always write PNG — the bridge appends .png to --filename whatever it is given — so other image extensions (.jpg, .gif, …) are rejected with an error instead of silently turning into a directory.
- Keyboard and mouse-move input via
manage_input needs the Input System package (com.unity.inputsystem). Clicking uGUI elements does not — it goes through the EventSystem.
tuanjie_cli is not the Unity Hub CLI: projects create, templates list, open, pipeline install, test, build, logs are all unsupported.
License
MIT. Derived from @opdsh/unity-plugin 0.1.7 (MIT, Copyright (c) 2026 vibotaku); the transport layer was rewritten for Tuanjie's Codely bridge. Original copyright notice is preserved in LICENSE.
