微信小游戏出海本地化工作流

解决的问题

微信小游戏出海时，中文通常不只散落在 JS/TS 字符串里，还可能出现在 JSON、CSV/TSV、WXML、Cocos 场景、Unity 资源、UI 图片和编译产物中。人工搜索容易漏掉配置表或注释中的同名文本，直接批量替换又容易破坏模板字符串、拼接表达式、i18n 初始化和多语言资源。这个技能把出海本地化拆成可执行的工作流：先确认项目路径、引擎、本地化策略和目标语言，再扫描、规划、翻译、替换和复核。

工作方式

技能以脚本为核心，避免 AI 直接编辑源码。scan-chinese.js 用 AST 解析字符串字面量，覆盖 JS、TS、JSON、CSV/TSV、WXML、Cocos、Unity、C#、XML 等格式，并要求用 grep 交叉对比，降低遗漏。若启用图片本地化，流程会走 MCP 图片翻译链路：上传、OCR、翻译、替换和验证都通过脚本或 MCP 工具完成，而不是让模型自行识别图片。

翻译阶段会生成执行计划和术语表，等待确认后再执行，保证游戏名词、品牌词和界面口径一致。资源应用阶段支持两种策略：直接替换中文为目标语言文本，或生成语言包并把代码中的中文替换为类似 i18n.t("key") 的调用。replace-text.js 提供备份、dry-run、逐条校验、逐文件回滚和全局验证；generate-langpack.js 面向 Cocos Creator、LayaAir、Egret、Unity 和原生微信小游戏生成语言包。最后可用 verify-build-strings.js 对编译产物中的残留中文做二次复核。

适用边界

该技能适合以代码和静态资源为主的微信小游戏本地化，尤其是需要覆盖配置表、引擎资源和 UI 文本的项目。图片翻译依赖 MCP 服务及项目凭据；若服务不可用，只能标记疑似含文字图片并继续文本流程。术语表确认前不会进入替换，编译产物复核属于可选步骤，动态拼接、运行时生成文本仍需要结合具体引擎逻辑人工验证。