ARTICLE DETAIL

资讯详情

深耕商务建站与企业官网运营的一线实战洞察。

AI全链路开发微信小游戏:火山AgentPlan + Cocos + MCP自动化流水线实战(TaoToken统一Key接入版)

AI全链路开发微信小游戏:火山AgentPlan + Cocos + MCP自动化流水线实战(TaoToken统一Key接入版) 1. 为什么我把小游戏流水线拆成了三段微信小游戏开发最耗时的部分往往不是核心玩法代码而是素材生产、编辑器里反复拖拽节点、以及构建参数来回改。一个合成消除类 Demo美术素材加音效可能占掉一半以上时间场景搭建和资源绑定又是纯体力活。单人开发者最容易卡在“想法很多但做不完一个能跑的版本”。我这次把流程拆成三段火山 AgentPlan 负责需求拆解和素材生成Cocos Creator 负责引擎侧工程落地MCP 负责把 AI 指令翻译成编辑器操作。三段之间用统一的模型通道串起来避免每接一个能力就换一套 Key 和 Base URL。TaoToken 在这里的作用就是提供统一的 API 入口让 AgentPlan 里的模型调用、Cocos 侧脚本生成、以及后续的对话调试都走同一个 Key。适合谁看做过一点 Cocos、想用 AI 把重复劳动压下去的独立开发者或者刚接触微信小游戏、想先跑通一条自动化 Demo 流水线的人。下面按“先配通道、再配 MCP、再跑端到端”的顺序写每一步都给可复制的配置和验证命令。2. TaoToken 统一 Key 接入把模型通道先固定下来在接 AgentPlan 和 MCP 之前先把模型通道固定住。否则后面每换一个模型就要改一次配置排障时根本分不清是 MCP 的问题还是 Key 的问题。TaoToken 的 API 入口是https://taotoken.net/api兼容 OpenAI 风格的请求格式所以 AgentPlan 的自定义 Skill、Cocos 侧的脚本生成、以及你本地用 curl 做验证都可以共用同一个 Key。先拿 Key。打开https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite登录后新建一个 Key复制出来。注意这个 Key 只在创建时完整显示一次后面配置里用环境变量存不要硬编码进仓库。拿到 Key 后先做一次最小验证确认通道是通的。用 curl 发一个 chat completions 请求export TAOTOKEN_API_KEYsk-你的Key curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 只回复 ok}], max_tokens: 16 }如果返回里choices[0].message.content是ok说明 Key 和通道都正常。这一步很重要因为后面 AgentPlan 和 MCP 报错时你可以先用这条命令排除“是不是 Key 挂了”。模型 ID 怎么选AgentPlan 里做需求拆解和任务编排用长上下文、指令跟随稳的模型Cocos 侧生成 TS 脚本用代码能力强的模型。你可以在https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite看当前可用的模型列表把选好的 Model ID 记下来后面配置里会用到。如果你后面要长期跑编码和 Agent 任务可以看下 Coding Plan 的额度方式https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。短期跑 Demo 的话按量用 API 就够了。3. 可复制配置MCP 服务 Cocos 构建脚本 AgentPlan 任务模板这一节给三份可直接复制的配置。先配 MCP再配 Cocos 构建脚本最后配 AgentPlan 的任务模板。三份配置里的 Base URL 和 Key 都指向同一个 TaoToken 通道。3.1 MCP 服务配置在 Cocos 项目根目录建mcp/config.json内容如下。注意baseUrl用https://taotoken.net/api不要加 UTM 参数到 API 路径里{ mcpServers: { cocos-editor: { command: node, args: [./extensions/funplay-cocos-mcp/dist/server.js], env: { COCOS_MCP_PORT: 8765, COCOS_PROJECT_PATH: ${workspaceFolder}, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: ${env:TAOTOKEN_API_KEY}, TAOTOKEN_MODEL_ID: claude-sonnet-4-20250514 } } } }这里三件套齐了Base URL 是https://taotoken.net/apiKey 走环境变量TAOTOKEN_API_KEYModel ID 是claude-sonnet-4-20250514。如果你在 AgentPlan 里用的是别的模型把TAOTOKEN_MODEL_ID换成对应的 ID 即可。3.2 Cocos 构建脚本在项目根目录建scripts/build-wechat.sh用于把 Cocos 工程构建成微信小游戏包。脚本里把构建参数固定下来避免每次在编辑器里手点#!/usr/bin/env bash set -e COCOS_PATH/Applications/Cocos/Creator/3.8.0/CocosCreator.app/Contents/MacOS/CocosCreator PROJECT_PATH$(pwd) BUILD_PATH${PROJECT_PATH}/build/wechatgame echo 开始构建微信小游戏... $COCOS_PATH --project $PROJECT_PATH \ --build platformwechatgame;debugfalse;md5Cachetrue;outputNamewechatgame echo 构建完成产物在 ${BUILD_PATH}Windows 下把COCOS_PATH换成CocosCreator.exe的路径即可。构建前确认assets目录里素材已经由 MCP 导入完成否则构建出来的包会缺资源。3.3 AgentPlan 任务模板AgentPlan 里新建应用后把下面这段作为系统提示词。它把“拆需求 → 生成素材 → 调 MCP → 构建”串成固定流程你是微信小游戏开发智能体按以下流程执行不要跳步 1. 收到需求后先输出素材清单图片名称、尺寸、用途、音频名称、时长、用途。 2. 调用视觉 Skill 生成图片要求 PNG 透明底、尺寸为 2 的幂次返回公网 URL。 3. 调用语音 Skill 生成音频要求 MP3 格式返回公网 URL。 4. 通过 MCP 下发指令下载素材到 assets 对应目录创建场景节点挂载 Sprite 和 AudioSource 组件。 5. 生成 TypeScript 脚本实现核心玩法逻辑脚本放在 assets/scripts 下。 6. 调用构建脚本 scripts/build-wechat.sh输出微信小游戏包。 7. 每步输出执行结果失败时给出具体错误和修复建议。模板里的模型调用走 TaoToken 通道所以 AgentPlan 的自定义 Skill 里填的 Base URL 也是https://taotoken.net/apiKey 用同一个。这样素材生成和脚本生成不会因为通道不同而出现鉴权不一致的问题。4. 端到端验证从一句话需求到构建产物配置齐了之后跑一次完整流程。我用一个合成消除 Demo 做验证需求输入是开发一款简约合成消除微信小游戏需要背景、数字方块精灵、开始按钮配点击音效、消除成功音效、结束提示音自动搭建场景并写核心消除逻辑。4.1 验证 MCP 服务是否起来先启动 Cocos 编辑器在扩展菜单里启动 MCP Server然后本地验证curl -s http://127.0.0.1:8765/health返回{status:ok}说明 MCP 在监听。如果返回连接拒绝检查端口是否被占用或者扩展是否加载成功。4.2 验证 AgentPlan 能否调通模型在 AgentPlan 的调试面板发一条测试消息看是否返回素材清单。如果返回 401说明 Key 没配对如果返回local proxy failed说明 Base URL 写错了或者网络不通。这一步过了再往下跑素材生成。4.3 验证素材是否落到 assetsAgentPlan 生成素材后MCP 会把图片和音频下载到assets/textures和assets/audio。用命令确认ls -lh assets/textures assets/audio如果目录为空说明 MCP 下载环节失败。常见原因是素材 URL 不是公网可访问或者 MCP 的COCOS_PROJECT_PATH指错了目录。4.4 验证脚本是否生成检查assets/scripts下是否有 AgentPlan 生成的 TS 脚本ls -lh assets/scripts脚本生成后Cocos 编辑器会自动编译。如果编辑器报编译错误看控制台里的具体行号通常是模型生成的 API 名称和 Cocos 3.8 不一致手动改一下即可。4.5 验证构建产物跑构建脚本bash scripts/build-wechat.sh构建成功后build/wechatgame下会有game.js、game.json等文件。用微信开发者工具导入这个目录能预览就说明整条流水线通了。5. 常见报错排查401、local proxy failed、reading choices、OAuth跑这条流水线时我遇到过几类报错按出现频率排一下。401 Unauthorized最常见。先确认TAOTOKEN_API_KEY环境变量在当前 shell 里生效echo $TAOTOKEN_API_KEY看有没有值。如果 Key 是对的还报 401检查请求头里Authorization是不是Bearer开头中间有空格。AgentPlan 的自定义 Skill 里如果填了 Key确认没有多余引号。local proxy failed这个通常是 Base URL 写错或者本地网络到https://taotoken.net/api不通。先用第 2 节的 curl 命令验证通道如果 curl 通但 AgentPlan 报这个错检查 AgentPlan 里的 Base URL 是不是漏了/api或者多了斜杠。reading choices 报错一般是返回体结构不符合预期比如模型返回了错误信息但代码直接去读choices。在 MCP 的请求封装里加一层判断先看response.error是否存在再读choices。另外确认 Model ID 拼写正确拼错的模型 ID 有时会返回非标准结构。OAuth 相关报错如果你在 MCP 配置里用了需要 OAuth 的远程服务但本地没配回调会卡在授权。这条流水线里 MCP 是本地 HTTP 服务不需要 OAuth。如果看到 OAuth 报错检查是不是误配了远程 MCP 地址改回127.0.0.1:8765即可。排障时建议按“先 curl 验通道 → 再验 MCP health → 再验 AgentPlan 单步”的顺序不要一上来就重跑全流程。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面有各语言的请求示例对照着改配置更快。6. 把通道固定下来后面换模型才不痛这条流水线跑通后最大的感受是真正省时间的不是某一次生成而是通道固定之后换模型、加 Skill、调 MCP 都不用动 Key 和 Base URL。AgentPlan 里加一个语音 SkillCocos 侧换一个代码模型都只改 Model ID 那一行。如果你也想先跑一个 Demo建议从第 2 节的 curl 验证开始确认通道通了再往下配。模型对话调试可以用https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite接入文档和 API Key 分别在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite和https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。长期跑编码和 Agent 任务的话Coding Plan 在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。最后留一个实用技巧把TAOTOKEN_API_KEY写进.env并在.gitignore里排除MCP 配置里用${env:TAOTOKEN_API_KEY}引用。这样换机器时只改.env配置文件和脚本都不用动。构建脚本里的COCOS_PATH也建议抽成环境变量团队里不同系统的人各配各的脚本本身保持通用。
返回列表
PREV
查看更多资讯
NEXT
返回资讯列表