团结引擎 × AI 开发技术文档

面向 Unity / 团结引擎开发者的 AI 辅助开发生态全景与落地指南 整理日期：2026-08-07

一、背景与总览

团结引擎（Tuanjie Engine）是 Unity 中国基于 Unity 2022 LTS 深度自研的实时 3D 创作引擎，针对国内小游戏、开源鸿蒙、车机等平台做了本土化适配。随着 2.0 版本发布，Unity 中国把"AI 原生"作为引擎的核心重构方向，提出 Loop Engineering（闭环工程） 理念：把 AI 的价值从"生成代码"推进到"交付经过验证的结果"。

当前开发者要把 AI 用进团结引擎，主要有两条技术路线：

本文分别展开两条路线，并给出可直接照抄的配置与实战案例。

二、官方原生 AI 能力

2.1 团结 Codely（Tuanjie AI）架构

团结 Codely 不是"代码补全工具"，而是一个能理解整个 Unity 工程上下文的 AI Agent。它已在整个 Unity 中国内部高强度使用近两年（90% 员工大部分时间在开发/使用它），2026 年 5 月才开放给外部开发者。核心组成：

① Agent Loop（自我迭代闭环） 用户输入指令后，Codely CLI 负责理解并规划，通过 Unity Bridge CLI 工具链连接引擎执行操作，执行结果（Console 信息、截图、性能数据）回传给 AI，AI 分析后决定下一步，继续迭代。

完整反馈闭环为：

指令下达 → AI 写代码 → 自动编译 → 读 Console 报错 → 自动修复 → 再编译        → Play Mode 测试 → 截图验证 → 性能分析 → 结果反馈至下一轮迭代

② Codely CLI 组成模块

• Skills：可固化工作流的技能包（如一键生成标准 Package 结构），支持用户自建
• Subagents：专业子代理系统，可并行加速（如一个子代理专做资产生成、一个专做测试）
• Extensions：一站式功能扩展包
• LSP：语言服务，理解 C# / 引擎 API
• Codely Context（RAG 知识库）：基于 RAG 的项目专属知识库，让 AI 理解你的代码规范

③ Unity Insight（AI 的"透视眼"）

Unity 项目文件又多又复杂（一个场景文件可能几万行），传统文件工具读一次消耗大量 token、信息密度极低。Unity Insight 是基于 SQLite 索引的虚拟文件系统（VFS），把项目的实体路径和虚拟路径（GameObject、Component）合并为图结构。对项目做完 index 后提供 5 个工具：

• vfs_ls：浏览语义结构
• vfs_glob：按路径或节点名发现
• vfs_read：读取指定内容
• vfs_grep：内容搜索
• vfs_refs：查引用关系（"谁引用了谁"，核心能力）

它是只读分析工具，token 消耗远低于传统文件读取。

④ Unity Tools（AI 的"双手"）

Codely CLI 内置 18 个 Unity Editor 实时控制工具，在编辑器内完成大部分操作：批量改光源强度、烘焙 NavMesh、截图 Game 视图、控制编译与 Play Mode 等。与 Unity Insight 的分工很清晰：Insight 负责"看"，Tools 负责"做"。

⑤ TJ Generators（AI 资产生成全家桶）

接入 Rodin AI、Tripo P1、Hunyuan 3.1、SeeDance 等多模态模型，覆盖 15 种资产生成类型：

• 3D 类：模型、带动画角色、绑骨与动作、地形、天空盒
• 2D 类：精灵、表面材质、序列帧、精灵表序列帧
• 音频类：背景音乐、音效、TTS
• 视觉类：图片、视频

兼容性：支持 Unity 2019 到最新版本，以及所有团结引擎版本。

2.2 AI Graph（引擎内置 AIGC 工作流）

深度集成在引擎内的 AIGC 平台，与腾讯混元等大模型合作，允许开发者直接在引擎内调用 AI 生成 2D/3D 资产。关键特性：支持 MCP 协议，把引擎模块 Agent 化，让 AI 能像操作节点一样操作引擎能力。这把"美术资产制作成本和时间"大幅降低——美术在引擎里就能完成从文生图到 3D 资产落地的闭环。

2.3 AI Assistant（原 Muse Chat）

集成在引擎内的 AI 助手，帮开发者解答问题、排查 Bug、提供代码和逻辑建议。适合"卡住了问一句"的轻量场景。

2.4 快速上手

• 产品形态：Codely CLI（命令行，Gemini CLI 的专业增强版，与 Claude Code / Codex 同类）+ Tuanjie Cowork（网页端）
• 获取：Tuanjie AI 官网 https://codely.tuanjie.cn/^[1] ，目前以内测申请为主
• 官方文档：https://codely-docs.tuanjie.cn/^[2]

三、MCP 协议：让任意 AI 工具控制团结引擎

3.1 什么是 MCP，三种传输方式

MCP（Model Context Protocol） 是 Tuanjie AI 与外部系统集成的标准协议。通过 MCP Server，AI 可以访问数据库、API、文件系统、Git 仓库，以及——最重要的——正在运行的 Unity / 团结引擎编辑器。三种传输方式：

3.2 官方 MCP（免费开放）

Unity 在 Unite 上确认 CLI 和 MCP 服务器会向所有人免费开放。在 Codely CLI 中配置 MCP：

// 用户级：~/.codely-cli/settings.json// 项目级：<project>/.codely-cli/settings.json（覆盖用户级同名配置）{"mcpServers":{"serverName":{"command":"path/to/executable","args":["--arg1","value1"],"env":{"API_KEY":"$API_KEY"},"cwd":"./working/directory","timeout":30000,"trust":false}}}

常用命令：

codely mcp add tjlocal https://ai-generator.tuanjie.cn/mcp   # 添加 TJGenerators MCP/mcp list          # 查看所有 MCP 服务器连接状态/mcp reload        # 重新加载配置

连接成功后，Tuanjie AI 会自动发现服务器提供的所有工具，直接用自然语言描述需求即可。

3.3 第三方 MCP 适配器

A. tuanjie-mcp（dj-huang）——最成熟的社区适配器

一个 stdio MCP Server，对接团结 Codely 已有的 cn.tuanjie.codely.bridge TCP 服务，不修改任何 Unity package 代码，运行在引擎外部。支持多个同时打开的编辑器实例，可启动时绑定进程、运行时切换实例，或指向某个项目 / 端口。

安装与构建：

cd /path/to/tuanjie-mcpnpm installnpm run build# 启动命令始终为：node /absolute/path/to/tuanjie-mcp/dist/index.js

在各 AI 客户端注册（统一用这个 stdio 命令）：

// Cursor: ~/.cursor/mcp.json{"mcpServers":{"tuanjie":{"command":"node","args":["/absolute/path/to/tuanjie-mcp/dist/index.js"],"cwd":"/absolute/path/to/tuanjie-mcp","trust":true}}}

# Codex: ~/.codex/config.toml[mcp_servers.tuanjie-mcp]command = "node"args = ["/absolute/path/to/tuanjie-mcp/dist/index.js"]

其他支持本地 stdio MCP 的客户端（Claude Desktop、VS Code Copilot、Windsurf、Cline、Roo Code、OpenCode）配置方式一致。

核心工具：

• unity_list_instances / unity_select_instance：多编辑器实例管理（按 pid / project / port 选择）
• unity_ping：确认连接与项目身份
• unity_initialize_bridge：为尚未接入 Bridge 的项目注入 cn.tuanjie.codely.bridge
• read_console：读取 Console
• manage_scene / manage_gameobject：场景与对象操作
• execute_menu_item / execute_csharp_script：执行菜单项与 C# 脚本

连接选择器优先级：--unity-pid > --unity-project > --unity-port > --unity-host。不选时自动发现 ~/.unity-tcp 下的实例状态文件，多实例可达时返回歧义错误而非猜测。默认回退端口 25916。

B. Funplay MCP for Unity —— 工具最全

MIT 协议的开源 Unity 编辑器 MCP 服务器，让 Claude Code、Cursor、Windsurf、Codex、VS Code Copilot 等直接操作运行中的 Unity 项目。一句话描述游戏，AI 通过 91 个内置工具自动创建场景、编写脚本、验证运行态、模拟输入、分析性能。

• 开源仓库：https://github.com/FunplayAI/funplay-unity-mcp^[3]
• 渲染管线兼容：内置 / URP / HDRP 在团结 1.8.0 均兼容
• 结构化返回 {success, message, data} + 稳定 instanceId 链式调用，自带 execute_code 的 IFunplayCommand 模板（新模板自动 Undo）

C. CoplayDev/unity-mcp + Trae / Cursor 生产线

社区教程《构建 Unity（团结引擎）MCP + Trae/Cursor 生产线》给出了一套可抄的完整流程，用于在 Unity 2022.3 或团结引擎 1.8 上准备 UnityMCP，并把 AI 接口交给 Trae / Cursor 调用：

1. 新建团结引擎工程，打开 PackageManager2. 【Add package from git url】依次加入：   - github.com/CoplayDev/unity-mcp   - github.com/boxqkrtm/codely-...（或 aerror2/com...，对应 Cursor / Trae 环境）3. 在 External Tools 中即可访问到对应 AI 软件并完成项目配置4. 扩展窗口安装插件：Claude Code Chat / Claude Code for VS Code / Cline MCP5. C# 环境用 DotRush 即可

3.4 在 Cursor / Claude Code 接入的通用配置

任意本地 stdio MCP 服务器，在客户端 MCP 设置里都只需填同一组字段：

保存后重启 / 重载客户端即可。

四、第三方开源实战

4.1 bcli-anything-tuanjie（CLI-Anything 框架）

一位技术大佬在 WSL 环境下，基于 CLI-Anything 框架构建了一套 Python CLI 桥接层 bcli-anything-tuanjie，把 AI 与闭源团结引擎"桥接"起来。包含 11 个命令组：

project / scene / object / material / component / light / camera / build / asset / session / repl

覆盖场景编辑、资源管理、构建打包等 80% 的非运行时引擎操作。架构上维护一份完整的 JSON 项目状态模型，每次修改记录在案，支持最多 50 步撤销 / 重做。

核心桥接思路：

AI 生成描述场景变更的结构化指令   → csharp_gen.py 翻译成标准 C# Editor 脚本   → 经由团结引擎批处理模式（batch mode）写入实际项目并执行

针对团结引擎闭源、CLI-Anything 无法直接提取 API 的问题，作者采用工程化的迂回策略：人工梳理一份 C# Editor API 映射表，保证 AI 生成的每条指令都能精确对应到可执行的 C# 方法。最终 69 个测试全部通过，由独立验证子代理给出 PASS 判定——是经得起验证的工业级方案。

4.2 PR 自动化 Code Review 工作流（GitHub Action）

开发者 yuumixcode 在开源项目 Aesir Inspector 中，用 Tuanjie AI 搭建了 PR 自动化 Code Review 工作流（100% 可实践）：

核心流程：

开发者发起 PR → 触发 GitHub Action   → Python 脚本拉取 Diff   → 调用 Codely CLI + Prompt 模板   → 生成 Review 报告 → 回写 PR 评论区

关键点：

• 用 gh cli 操作仓库；API KEY 通过 GitHub Secrets 注入，不写进脚本
• Prompt 模板明确角色（资深 C# / Unity / Tuanjie 开发专家）、项目背景、审查重点（严重缺陷 → 性能 → 可维护性 → SOLID → 引擎特定问题）、输出格式（评审打分 / 代码理解 / 关键问题 / 次要改进 / 总结）
• 适用于 Claude Code 等任意同类工具

该模板特别针对 Unity/Tuanjie 编辑器扩展场景，强调对 UnityEngine.Object 派生类禁用 ?./??、Odin 依赖隔离、程序集边界、版本号双处同步等团队规范。

4.3 AI 开发赛车游戏 Demo（从资产到比赛系统）

开发者在团结引擎中用 AI 完成了赛车游戏全链路开发，是 Loop Engineering 的鲜活范例：

AI 会自动生成路径点、让赛车沿路径行驶并截图确认，这是典型"交付经过验证的结果"而非"交付一段代码"。

4.4 技术大佬的实战经验总结

1. 闭源引擎先做 API 映射表：AI 无法直接读引擎源码时，人工梳理 C# Editor API 映射表，是让指令精准落地的关键
2. 缩小上下文提升精度：用 Unity Insight / VFS 这类语义化工具替代整文件读取，token 消耗与精度双赢
3. 并行子代理加速：把资产生成、测试、代码分发给不同 Subagent，整体效率显著提升
4. 自定义 Skill 固化工作流：把团队高频操作（如生成标准 Package、固定 Review 规范）写成 Skill，一次定义反复用
5. Generator MCP 快速原型：用资产生成 MCP 做原型，比打开引擎手动调快得多

五、方案对比与选型建议

选型建议：

• 团队想"拿来就用、官方保障" → 申请团结 Codely
• 已有 Claude Code / Cursor，只想让 AI 能操控编辑器 → tuanjie-mcp 或 Funplay MCP
• 要完全可控、接入自建 CI → 参考 bcli-anything 思路自己写桥接
• 美术为主、想引擎内生成资产 → AI Graph + TJ Generators

六、实践清单：5 步上手

1. 装引擎：从 unity.cn/tuanjie/releases 下载团结引擎 + 中文语言包
2. 选路线：团队型选 Codely（申请内测）；个人/工具型选 tuanjie-mcp 或 Funplay MCP
3. 接 MCP：npm install && npm run build，在 Cursor/Claude Code 的 mcp.json 注册 stdio 命令
4. 开编辑器：确保团结引擎编辑器在运行且 Codely Bridge 已启用（tuanjie-mcp 用 unity_initialize_bridge 自动注入）
5. 自然语言驱动：在 AI 客户端说"列出当前团结进程并切到我的项目""在场景里所有 Point Light 强度降 20%""写一个 WASD 移动控制器"——看闭环自动跑

七、参考资源

• 团结 Codely 官方：https://codely.tuanjie.cn/^[4]
• Codely 文档：https://codely-docs.tuanjie.cn/^[5]
• tuanjie-mcp（dj-huang）：https://github.com/dj-huang/tuanjie-mcp^[6]
• Funplay MCP for Unity：https://github.com/FunplayAI/funplay-unity-mcp^[7]
• CoplayDev/unity-mcp：https://github.com/CoplayDev/unity-mcp^[8]
• bcli-anything-tuanjie：参考《硬核插进引擎深处》实战文章
• Unity 官方开发者社区（含 PR Review / 赛车 Demo 等实战）：https://developer.unity.cn/^[9]
• 团结引擎手册：https://docs.unity.cn/cn/tuanjiemanual/Manual^[10]
• 综合上手指南（CSDN liwanxing）：Tuanjie AI 公测两个月实战

本文档为技术整理，所有链接与方案请以官方最新发布为准。团结 Codely 处于快速迭代期，部分能力需内测申请，建议以官方文档为最终依据。

引用链接