MiniGameConverter：团结引擎 / Unity 项目一键转团结微信小游戏

近两年来，小游戏市场用户规模与收入体量快速攀升，开发者与产品供给加速涌入。团结引擎通过底层的深度优化，解决了小游戏平台在内存、性能和渲染上的核心瓶颈，让存量 App 游戏能够以更低的成本和更高的品质，快速接入这个高速增长的市场。

然而与原生 App 相比，小游戏存在特有的技术挑战，例如即点即玩/边下边玩，以及如何在内存和性能相对受限的情况下，提供接近原生 App 的体验。因此，开发者需要投入大量的时间了解小游戏出包和适配，完成资源加载改造，性能优化等工作。

为此，我们推出MiniGameConverter，将小游戏专家经验集成到其中，助力开发者快速完成小游戏迁移工作。

MiniGameConverter ：35 项技能，助力小游戏转换

MiniGameConverter 是一个基于 Tuanjie Cowork 的技能扩展，包含35个转小游戏的技能，用于将 Unity / 团结引擎项目自动转换为微信小游戏。按功能分可分为五组：主流程编排、兼容性与代码适配、资源管线与字体、构建部署与工程维护、测试与调试。

MiniGameConverter 提供更高效、更可靠的小游戏自动转换

MiniGameConverter把"资深引擎程序员数天至数周手工活"和"不可控的 AI 即兴发挥"，变成一条可断点续传、可重试、可审计、无人值守的自动化产线——流程、知识与验证全部固化，人只做一次决策、看一次结果。从问题本质上来看，小游戏转换是一件"流程长 + 知识冷 + 必须真机验证"的工程活。一次完整转换包含"安装开发环境 → 修编辑器报错 → 平台适配 → 资源加载改造 → 性能优化 → 构建小游戏包 → CDN 部署 → 真机自动化测试" 等数十个环节。

更高的转换成功率

MiniGameConverter 包含了 35 个技能，基于团结引擎专门接口打造，把转小游戏时最常见的问题逐个做成了成熟方案。激活 skill 即注入专家流程 + 错误处理经验库。

纯 promt 转换的方式可以生成小游戏包，但缺乏工具让 ai 验证生成的产物。依赖人工进行测试不仅费时费力，且人工转述测试结果给 ai，效果远不如 ai 自主测试。MiniGameConverter 提供的自动化测试 skill 确保最终生成的产物是可以运行无报错的。对比纯 prompt 驱动 AI 转换，成功率从15%提升到77%。

更优质的产物

小游戏转换时的一大痛点，是许多工程使用同步加载与阻塞等待的方式处理资源包，不被小游戏平台支持。想要将其改造为异步实现，又牵一发而动全身，需要将异步实现沿调用链传播到全工程，手工改造不仅耗时耗力，而且极易遗漏。MiniGameConverter 提供了技能来自动实现上述流程；配合 AutoStreaming 缩减首包，实现小游戏快速加载，点开即玩。

更快更省token

使用纯prompt转换小游戏时，全部流程说明、领域知识、报错历史挤在一个对话里，造成上下文爆炸、能力退化、token 用量翻倍。MiniGameConverter 将转换流程与错误处理固化进 skills / tools 与状态机，任务拆分为 subagent 执行，避免上下文过长。

对比 7 款较为简单的、纯 prompt 也能转换成功的游戏，使用 MiniGameConverter 的 token 消耗是纯 prompt 驱动时的一半或更少。

端到端全自动

输入一条 prompt 即可端到端完成打包编译测试全部流程。状态机驱动的 skill 按无人值守设计，你可以开启YOLO模式，跑完直接看结果。

全流程自动化迁移，贯通适配、构建与真机验证

将 Unity/团结引擎项目转换为微信小游戏，整体要经历 “准备与配置 → 代码适配 → 资产与加载适配 → 资源构建与产物生成 → 自动化验收” 五个阶段。全程由一个状态驱动的编排器（minigame-convert-e2e）按固定顺序推进，每个步骤执行完立即持久化状态，因此流程中断后可随时从断点续传。

1. 准备与配置。转换从搭建工具环境开始：先添加自定义工具，让 Tuanjie Cowork 能够执行编辑器脚本；再生成 BuildProfile，写入微信小游戏转换的各项参数；随后把编辑器当前显示的报错清零，保证工程处于可构建的健康状态。

2. 代码适配。对代码做静态兼容性扫描，找出小游戏平台上不可用的 API 并逐一修复（如 System.Net、System.Threading 相关 API）；为工程添加 minigame 平台的宏，让平台相关的代码逻辑能通过宏开关正确区分。如果目标游戏需要触屏操作，还可在此阶段按配置添加屏幕控制。

3. 资产与加载适配。小游戏环境不支持同步加载和本地文件加载，因此转换前必须检测项目实际使用的资源加载方式，并进行相应适配，改造为小游戏可用的异步等价实现。当前支持三种常见的资源管线：Addressables、原生 AssetBundle、YooAsset。

4. 资源构建与产物生成。先检测项目使用的 AssetBundles 管线，确保小游戏平台的资源生成和运行时加载路径正确，并完成资源构建；根据配置文件的 UseCDN 决定是开启 autostreaming 统一上传资源还是单独将产物文件上传到 UOS CDN；随后执行构建，生成微信小游戏产物，并注入日志转发 hook，便于在真机测试时读取小游戏日志。

5. 自动化验收。对生成的产物运行自动化测试，验证转换结果在小游戏环境中可以正常工作。只有测试通过，整个转换流程才算完成，状态标记为 success。

6. 容错与回退机制。转换流程内置两级容错，保证“能自动修的自动修、修不动才交还给人”：其一，任一步骤失败时，会带着错误上下文原地重试同一步骤，最多重试 3 次（MaxRetryStep）；其二，若自动化测试失败，则回退到专门的运行时修复步骤（runtime-fix），修复完成后从资源构建开始重走“构建 → 部署 → 测试”，形成“修复→重建→重测”的闭环，最多重建 5 次（MaxRebuild）。超过任一上限，流程即中断并向用户报告失败详情与建议。

同步加载转异步

小游戏的 Web 运行环境用不了同步加载与阻塞等待，这是 Unity 项目转小游戏最常见的硬伤。工作流先检测全工程的资源加载方式，再按管线选定替换方案：Addressables、原生 AssetBundle、YooAsset 各有对应的迁移策略，其余通用同步方法统一改造为异步实现。

当方法签名从同步改为异步时，变更会像涟漪一样沿调用链向上扩散：每个调用方需要加 await 并改为 async，而调用方自身签名的变化又会波及它的调用方——直到撞上真正的终止点（MonoBehaviour 生命周期回调、协程、lambda）。对较大的项目，修改一个同步加载可能就意味着数百个脚本、上千处调用点需要在一次任务中全部改对；漏掉任何一处都不是编译错误，而是运行时的静默 bug。

上千处调用点无法塞进一次 AI 会话的上下文；更麻烦的是级联的动态性——修复一批调用点必然产生新的签名变更，新的签名变更又制造出下一批待修调用点，总量事先不可知。任何"一次性修完"的尝试都注定遗漏。我们在 skill 中用一个由 Python 脚本编排的 Ralph Loop，让机器去保证"修完"。循环分两个交替的阶段：Step A 修复返回值不同造成的编译错误，把当前所有报错按根因和文件分组成小批次，一批批喂给 AI 子Agent去修，直到报错清零；Step B 修复无返回值不会造成编译报错的调用点，同样小批量喂给 AI 修。两个阶段被外层循环包起来反复交替，直到编译错误为零、待修调用点为零。

另一个难点是 AI 有强烈的"抄近路"动机，当一次异步修改会造成上百个新增报错时，AI 会强烈倾向于不添加 await，或使用 .Forget() 来中止异步传播，即使已经在 skill 中明确禁止这一行为。解决方案是在循环中增加两道检测闸门，扫描项目中新增的可疑 .Forget() 以及 “无 await 警告”，将其重新加入待修改队列中。

真机自动化测试

出包不等于能玩。真机测试环节，AI能够在真机上检验游戏是否正常运行，模拟真人游玩游戏的过程，确认转换工作是否成功。过程中，日志收集、测试执行、问题修复等skill相互配合，各司其职，比AI独立摸索测试更高效。具体步骤如下：首先，小游戏会被自动推装到手机（通过微信开发者工具，需要提前登录账号），然后AI会执行截图-分析-执行操作三步循环，分析当前画面，给出具体的操作（例如点击、拖动等），像真人一样从菜单进入游戏、开始游玩。过程中AI会监测日志，结合游戏截图，检查游戏是否正常。如果遇到任何问题（例如崩溃、UI无效等），AI会停下测试循环，汇总错误信息，然后进入修复操作。修复完成后重新构建游戏（必要时重新打包资产），再次启动测试，直到遇到的问题均修复或达到重试上限。

使用方法

安装

在 Tuanjie cowork 的扩展市场中搜索并安装 tuanjie-minigame-converter

使用

1. 准备配置文件

输入/prep即可匹配到 prepare-minigame-config-from-user skill，它校验项目目录，生成配置文件MinigameConvertConfig.json，引导用户填写小游戏 AppID、引擎路径等字段。

2. 打开项目

输入「用 open-with-tuanjie 打开当前项目」，将会初始化 Git、以批处理模式修复报错、打开团结编辑器。

Unity / 旧版本团结项目将会自动适配到你所使用的新版本团结引擎。

3. 转换与测试

输入「用 minigame-convert-e2e 生成小游戏并测试」，它按状态机执行 14 步工作流，端到端完成平台适配、AssetBundles 生成、小游戏产物编译、UOS CDN 部署、真机自动化测试与修复等过程。

每完成一步，进度落盘到状态文件并单独 git commit。会话中断、手动停止都不丢进度：输入「继续 minigame-convert-e2e 小游戏转换」，读取状态文件，工作流从断点继续。

让小游戏迁移更高效

当前 35 个 skill 主要解决"转得成、跑得起来"的正确性问题，对"跑得好不好"的性能优化覆盖较少；同时受限于 AI 上下文长度，虽有状态机断点续传、subagent 隔离与诊断文件外置的缓解，超大工程的完整转换成功率仍有待提升。下一步将把Profiling 数据引入闭环，构建"发现性能问题→定位→修复→复测"的性能诊断 skill，补齐 DrawCall/合批优化、内存与 GC 治理、卡顿优化、首包瘦身、资源压缩等能力，将交付标准从"转换成功"升级为"成功且性能达标"。

MiniGameConverter 让小游戏转换从一场逐项手改的消耗战，变成了一条端到端全自动、可断点续跑、自带真机验证的流水线。无论是想快速试水小游戏渠道的独立团队，还是维护大型工程与复杂资源管线的项目组，它都能成为你小游戏转换管线的新基石。

立即在你的 Tuanjie cowork 中安装 MiniGameConverter，体验一句 prompt 转微信小游戏的魅力吧！

Unity 官方微信

第一时间了解 Unity 引擎动向，学习进阶开发技能

每一个“点赞”、“在看”，都是我们前进的动力