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_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite，登录后新建一个 Key，复制出来。注意这个 Key 只在创建时完整显示一次，后面配置里用环境变量存，不要硬编码进仓库。
拿到 Key 后，先做一次最小验证，确认通道是通的。用 curl 发一个 chat completions 请求：
export TAOTOKEN_API_KEY="sk-你的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_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite看当前可用的模型列表，把选好的 Model ID 记下来，后面配置里会用到。
如果你后面要长期跑编码和 Agent 任务，可以看下 Coding Plan 的额度方式：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite。短期跑 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/api，Key 走环境变量TAOTOKEN_API_KEY，Model 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 "platform=wechatgame;debug=false;md5Cache=true;outputName=wechatgame" 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/api，Key 用同一个。这样素材生成和脚本生成不会因为通道不同而出现鉴权不一致的问题。
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 验证素材是否落到 assets
AgentPlan 生成素材后，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_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，里面有各语言的请求示例，对照着改配置更快。
6. 把通道固定下来，后面换模型才不痛
这条流水线跑通后，最大的感受是：真正省时间的不是某一次生成，而是通道固定之后，换模型、加 Skill、调 MCP 都不用动 Key 和 Base URL。AgentPlan 里加一个语音 Skill，Cocos 侧换一个代码模型，都只改 Model ID 那一行。
如果你也想先跑一个 Demo，建议从第 2 节的 curl 验证开始，确认通道通了再往下配。模型对话调试可以用https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite，接入文档和 API Key 分别在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite和https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite。长期跑编码和 Agent 任务的话，Coding Plan 在https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite。
最后留一个实用技巧：把TAOTOKEN_API_KEY写进.env并在.gitignore里排除，MCP 配置里用${env:TAOTOKEN_API_KEY}引用。这样换机器时只改.env，配置文件和脚本都不用动。构建脚本里的COCOS_PATH也建议抽成环境变量，团队里不同系统的人各配各的，脚本本身保持通用。
：把 settings 改到 TaoToken 后 Readme.md 与 cursorrules 的 Git 协作实践)
