wechat-minigame-publisher-skill：个人上架小游戏

一、核心亮点与背景概述

• 工具定位：wechat-minigame-publisher-skill 是一套基于 GitHub 开源的全链路自动化脚本，帮助个人开发者在 微信小游戏 平台完成从源码获取、代码替换、版本上传到广告位配置的全部流程，几乎不需要手写代码。
• 成本优势：仅需支付 30 元人民币 完成微信公众平台的实名认证，即可获得 AppID 并开始发布。个人账号每个身份证限 5 个小程序/小游戏，满足大多数个人创作者需求。
• 技术突破：通过 Claude/ChatGPT（统称 codex） 进行提示词驱动的代码修改、资源替换、广告位注入，实现 零代码 上线。整个流程可在 两天 内完成，从源码到首笔广告收益。
• 开源地址：https://github.com/oscargzh/wechat-minigame-publisher-skill

内容整理自 X 博主 clanhj（@clanhj611）的推文。

二、核心机制与技术细节拆解

1. 账号与资质

   • 在微信公众平台（https://mp.weixin.qq.com/）选择 小程序 → 类目 游戏 → 主体 个人，完成身份证实名、邮箱绑定（推荐使用网易邮箱，可注册 5 个）。
   • 记录后台 AppID（管理 → 开发管理 → appid），后续所有 API 调用均基于此 ID。

2. 源码获取

   • 在闲鱼搜索关键词 cocos 小游戏源码，挑选几千元以下的 Cocos2d‑x 项目（如《跳一跳》类、消除类）。
   • 下载后解压，得到 project 文件夹结构：src/, assets/, project.config.json 等。

3. Skill 自动化流程

   • Skill 本质是一个 Node.js 脚本集合，内部封装了以下子任务：
     • 名称/图标/简介替换：通过 OpenAI 提示词生成游戏名称、头像（Base64）和简介文本，写入 project.config.json。
     • 代码皮肤化：使用正则批量替换游戏内部文字、道具名称，确保不触发版权风险。
     • 广告位占位：在游戏主逻辑（如 GameScene.js）预留 rewardAdId 与 interstitialAdId 两个变量，供后续注入。
     • 构建与上传：调用 微信开发者工具 CLI（wxcli）完成 npm run build → wx upload，自动生成 开发版 并提交审核。
   • 只需在终端执行：

     npx wechat-minigame-publisher-skill \
       --src ./downloaded_game \
       --appId YOUR_APPID \
       --rewardAdId REWARD_AD_ID \
       --interstitialAdId INTERSTITIAL_AD_ID
     

   • 脚本会在 5 分钟 内完成全部文件修改、构建、上传并返回版本号。

4. 广告位配置

   • 在小游戏后台 功能 → 游戏功能地图 → 游戏圈 中创建 官方号，发布 5 条吸引用户的帖子（提示词：生成五篇这个游戏的游戏圈的帖子，包括标题和内容，要足够吸引用户），邀请 5 位好友点赞。
   • 完成点赞后即可在 广告管理 中开启 流量主，新建两类广告位：
     • 激励广告（Rewarded Video）
     • 插屏广告（Interstitial）
   • 将生成的广告位 ID 填入前一步的 --rewardAdId 与 --interstitialAdId 参数，Skill 会自动在预留位置插入调用代码，并加入 失败兜底 与 频率控制（插屏广告在关卡结束后延迟 1.5~2 秒弹出，最高频率约 10 分钟一次）。

三、安装配置与实操上手

1. 环境准备

   • Node.js >= 16.x（推荐使用 LTS 版本）
   • 微信开发者工具（最新版）并在系统 PATH 中加入 wxcli（微信官方提供的 CLI）
   • Git（用于克隆 Skill 仓库）
   • Python 3.9+（若使用 OpenAI API 进行提示词生成）

2. 克隆并安装 Skill

   git clone https://github.com/oscargzh/wechat-minigame-publisher-skill.git
   cd wechat-minigame-publisher-skill
   npm install
   

3. 获取广告位 ID

   • 登录微信公众平台 → 广告管理 → 新建广告位，分别创建 激励广告 与 插屏广告，记录返回的 adUnitId（如 adunit-xxxxxx）。

4. 完整工作流示例

   # 1. 下载闲鱼源码（手动）并解压到 ./mygame
   # 2. 运行 Skill 完成所有自动化步骤
   npx wechat-minigame-publisher-skill \
     --src ./mygame \
     --appId wx1234567890abcdef \
     --rewardAdId adunit-reward-123456 \
     --interstitialAdId adunit-inter-123456
   

   • 脚本输出示例：

     [INFO] 替换游戏名称为 “星际跳跃”
     [INFO] 生成游戏头像并写入 project.config.json
     [INFO] 注入激励广告 ID: adunit-reward-123456
     [INFO] 注入插屏广告 ID: adunit-inter-123456
     [INFO] 调用 wxcli 完成构建 & 上传，版本号 1.0.3
     [SUCCESS] 提交审核成功，预计 2 天内出结果
     

5. 审核与备案

   • 小游戏备案：在后台 首页 → 备案与认证 上传游戏截图与描述，等待 10~15 天。
   • 小程序备案：同路径再提交一次，约 3 天。
   • 完成备案后进行 微信认证，即可在全网搜索到游戏。

四、适用场景与避坑建议

• 适用人群：
  • 没有编程经验、想快速验证游戏创意的个人开发者。
  • 具备基础美术或策划思路、希望通过低成本渠道实现广告变现的创业者。
• 核心价值：
  • 零代码：所有代码修改均交给 AI 完成，开发者只负责业务需求与素材准备。
  • 快速迭代：从源码到上线 ≤ 48 小时，适合做 A/B 测试 与 市场验证。
• 常见坑点
  1. 身份证绑定上限：每个身份证只能注册 5 个小游戏，提前规划好项目数量。
  2. 广告位频率：插屏广告频率过高会导致用户流失，务必遵守脚本默认的 1.5~2 秒延迟与 10 分钟上限。
  3. 备案时间：备案是必经环节，若急于投放广告，请提前提交备案，避免因审核延迟导致收入滞后。
  4. 素材版权：闲鱼购买的源码往往缺少商业授权，务必确认版权或自行更换关键美术资源，以免侵权。
• 扩展思路：
  • 将 ChatGPT 替换为 Claude 或 Gemini，通过不同模型的提示词优化生成的文案与 UI 文本。
  • 使用 GitHub Actions 自动触发 Skill，实现 CI/CD 流程，代码推送即自动构建并提交审核。
  • 结合 数据分析 SDK（如腾讯分析）监控用户留存，动态调节广告展示策略。

---

参考链接

• 微信公众平台注册入口：https://mp.weixin.qq.com/
• Skill 项目仓库：https://github.com/oscargzh/wechat-minigame-publisher-skill
• 原推文：https://x.com/clanhj611/status/2115691094759612921