🔒 图片需 后查看

这篇把「一句话建 3D 游戏 → 治好真机黑屏与胶囊遮挡 → 一把通过审核接流量主」的全流程拆透,附上免费开源插件、4 大 Agent 一键安装命令、提示词与 11 张真机过审范本,没写过代码也能跟着做出正式成品

很多用 AI 写过小游戏的朋友都卡在同一个地方:在电脑浏览器里看着还能跑,一丢进手机微信十有八九当场翻车——不是黑屏静音,就是按钮被右上角胶囊挡死,更别提 4 MB 主包红线和那套动不动就被打回的资质审核

做个跑不进真机的半成品 Demo 没意思,我直接拿自己搓的 3D 物理奇物三消 《一箱见底》(AppID wxb30466d4fdc08460)真刀真枪跑完了整条路:靠个人主体一把通过审核发布,当天顺手推的 1.0.7 热修也在几小时内直接放行,零强制插屏、预埋好激励视频流量主变现口,现在打开微信搜一搜「一箱见底」或者扫下面太阳码就能真机体验

更省心的是,这套建游、内置微信预审体检、自动压包瘦身和命令行直传体验版的能力,全都被我们打包进了免费开源插件 @zseven-w/dsh-game-studio(v0.1.0-rc.6),原生打通 Codex、Claude Code、Antigravity、DeepSeek Harness 四大主流工具;下面按真实上线顺序拆成 4 步可照抄施工单,照着跑 30 分钟就能在自己手机微信里扫出第一款 3D 体验版 👇

🔒 图片需 后查看

上线实拍铁证:上为微信公众平台首版过审记录(后续 1.0.7 热修亦已当天过审上线),左下为三主题选箱与 3D 局内实机,右侧为微信永久正式版太阳码,扫码或搜一搜「一箱见底」即可真机体验

先给第一次动手的新手留一条 30 分钟最小闭环坡道: 不用一上来就塞 3 个宇宙和 42 款模型,今天照着 Step 1 到 Step 3 跑通一款单关卡 3D 小游戏,先拿到手机微信里能打开的体验版二维码,剩下的皮肤、音效、过审材料与搜一搜运营素材按 Step 4 照单补齐就行

文中所有安装命令、建游提示词、微信过审 11 张截图清单、五大系统填写范本与上线后通用封面规范均可直接复制,动手前建议先点收藏放在手边

本篇完整通关路线图(共 4 步):

摸清规则:搞懂个人主体免版号门槛、账号额度与起名省次数的实战常识

Step 1:两行命令把 DSH Game Studio(15 个 MCP 工具)装进你顺手的 AI Agent

Step 2:一句话建游 + 内置微信预审体检与胶囊模拟,彻底告别盲写白屏 HTML

Step 3:一套源码同时导出网页版和 < 4.00 MB 微信原生包,CLI 一键传体验版

Step 4:绕开最容易被打回的 3 个审核雷区,照抄过审范本与上线后运营素材规范

一|先算清规则账:个人发小游戏,其实不需要等版号

动手写代码之前,先把劝退 90% 独立开发者的账号与合规账算清楚,别被过时的二手攻略吓跑:

个人无内购直接免版号:只要游戏采用纯中文名称、不接现金充值和道具内购(只走微信广告流量主 IAA 变现),个人主体无需苦等版号就能直接提审上线,常规休闲单机也没有繁琐前置门槛

1 张身份证可开 5 个号,1 个号只发 1 款游戏:每个小游戏 AppID 永久绑定 1 款作品,个人身份证最多注册 5 个账号;前期开发和测试零费用,只有准备开通流量主变现的号才需要交 ¥30/年 微信认证费

起名查重与「简称留空」省额度:每个账号每年只有 2 次改名机会;如果你起的是 2~5 个纯汉字的清爽名字(比如我们从重名的「奇妙玩具箱」突围定下的 《一箱见底》),注册后台里的「小程序简称」直接保持未设置(留空)——微信下拉栏和搜一搜会完整展示正式名,省掉一次简称审核和年度修改次数

单机小游戏可先上线攒 UV,同步等备案:在后台选择单机游戏后,资质审核通过即可提交代码版本审核上线,一边发给朋友攒满首波 100 UV 开通流量主,一边等管局备案办结

别急着开「新游种子计划」:微信给新上架小游戏的官方冷启动流量扶持在发布 90 天内只有一次开启机会,务必等第 1 关新手引导和留存打磨稳妥后再点开启

二|Step 1:两行命令把游戏工坊装进你顺手的 AI Agent

以前写游戏插件往往锁死在某一家客户端里,这次 v0.1.0-rc.6 我们直接把整套 15 个 MCP 工具 做成了跨宿主原生插件——无论你主力是 Codex、Claude Code、Antigravity 还是 DeepSeek Harness(带右侧栏实时试玩),都能无缝接入

🎯 本步交付物

你当前主力 Agent 成功挂载 dsh-game-studio 的全部 15 个工具(建游、构建、无头试玩、微信预审体检、AI 换皮、版本回滚、导出网页、导出微信包、CLI 上传体验版),且本机体检全绿

❌ 最容易废掉的一步

很多朋友在图形界面客户端(比如 Codex Desktop)里直接装裸 MCP,结果遇到 GUI 环境变量 PATH 和终端不一致,导致 node 或 playwright-core 找不到而报错

我们的安装脚本会自动把本机 node 绝对路径和仓库目录写入 ~/.dsh-game-studio/,并在装完后直接跑一轮真实协议验活,彻底杜绝「装完连不上」

📋 直接抄作业(二选一:一句话让 Agent 自装,或终端四行命令)

方式 A · 直接发给 Codex / Claude Code / Antigravity(最省心):

按照 🔒 外部链接需 后查看 的 INSTALL.md 帮我安装并验证 DSH 游戏工坊插件,跑完 npm run doctor 确认 15 个 MCP 工具全部可用

方式 B · 本地终端手动安装(支持单装或四大宿主全装):

git clone https://github.com/ZSeven-W/dsh-game-studio.git
cd dsh-game-studio && npm install
npm run setup:all     # 也可单选 setup / setup:claude / setup:agy
npm run doctor        # 体检浏览器、生图服务与微信 CLI

如果你用的是自带右侧栏实时预览的 DeepSeek Harness,一行命令就够了:

dsh plugin add @zseven-w/dsh-game-studio

🔒 图片需 后查看

三|Step 2:一句话建游 + 微信预审体检,别再盲写白屏 HTML

普通人直接让大模型写一个 Three.js 小游戏,电脑浏览器里看着好像能动,一丢进手机微信 90% 当场黑屏、静音或按键被挡死

核心原因就藏在真机微信环境的 5 个隐形杀手里:

WASubContext 沙箱遮蔽:真机微信把 game.js 裹在 CommonJS 沙箱里,直接调用 window、document、localStorage 或 requestAnimationFrame 经常拿到 undefined

单 WebGL 上下文硬上限:主场景跑 Three.js 时,如果图鉴缩略图或动效随手再开第二个 WebGLRenderer,手机端立刻崩溃白屏

右上角原生胶囊遮挡:微信固定在右上角悬浮着 ••• | ◎ 胶囊按钮,电脑端看着完美的设置键或静音键,上真机直接被盖得严严实实

iPhone 静音拨片导致全游戏无声:不显式设置 obeyMuteSwitch: false、或者用微信旧内核不兼容的 WebAudio 振荡器节点,真机一点声音都没有

主包 4.00 MB 硬红线:Three.js 运行时加上几张未压缩的 AI 高清贴图,分分钟撑破 4 MB 连上传门都进不去

好消息是,你完全不需要把这些底层技术词背下来写进提示词——我们直接把 微信预审体检(auditGameForWechat) 和 微信胶囊模拟试玩 做进了 dsh-game-studio 工具链:自动在试玩画面叠绘真实比例的右上角胶囊防遮挡,自动拦截多 WebGL 上下文黑屏风险、英文残留词汇与 4 MB 主包超限

🎯 本步交付物

一个可玩、60 FPS、脚本零报错、通过微信预审体检、避开右上角胶囊且带新手引导的 3D 竖屏游戏工程(单源 game.json + game.js)

❌ 最容易废掉的一步

只停留在「第一版能运行」就急着上架

我们在打磨《一箱见底》时发现,哪怕 3D 物理堆叠已经很顺滑,早期版也有两个致命留存杀手:设置弹窗文字拥挤、新玩家进第 1 关根本不知道「可以按住箱子左右拨开上面压着的玩具」

后来我们专门加了第 01 箱两步聚光灯强引导:进关先锁亮 3 个同款教玩家点选消除,紧接着锁死单击、用金色聚光框罩住整箱,必须亲手按住拨开一次玩具才解锁倒计时;同时用 AI 补齐 3D 糖果立体字与透明玩具图标,整套质感瞬间从「Demo 塑料感」跨进「成品潮玩」

📋 直接抄作业(两段递进提示词)

第 1 句 · 立项建游 + 微信胶囊预审验帧(你只管说要做微信小游戏):

帮我用 dsh-game-studio 做一个【替换为你的玩法,如:3D 潮玩物理消消乐】,准备上架微信小游戏 要求竖屏单手操作、全界面 100% 纯中文、零外部网络请求,建完后直接跑 game_studio_playtest(platform: "wechat"),确认 60 FPS、0 报错且右上角不被微信胶囊遮挡

第 2 句 · 留存与手感拉升(跑通基础玩法后再发):

请针对首关留存做一轮精修:加入两步聚光灯新手引导,确保零说明就能学会核心手势,选完开局后直接进第 1 关不要绕回主页
音频改用 WebAudio PCM 采样合成短音效,兼顾手机静音键兼容,并给主界面按钮补足立体果冻按压反馈
改完重新跑一遍 wechat 平台自动试玩并贴出截屏给我验收

🔒 图片需 后查看

留存拉升实拍对比:左为早期拥挤线框设置页,中为第 1 关聚光灯锁定「点 3 个一样的」,右为锁单击强学「按住箱内左右拨开玩具」

⚠️ 差错自查

如果非方向键玩法(如三消、卡牌、放置)无头试玩不动:让 Agent 在 game.js 里补一个 window.__autoplay(state) 钩子,试玩器就会按你的真实玩法逻辑自动打完一整局并抓帧汇报

如果对角色或图标颜值不满意:直接调 game_studio_generate_asset,它会先弹费用确认卡再出带编号的透明底候选图,挑中哪张回个数字自动替换,改崩了随时 game_studio_restore_version 一键回滚

四|Step 3:单源直出 < 4 MB 微信包 + CLI 一键传体验版

过去大家做 H5 游戏转微信小游戏,最痛苦的就是「改完网页版,微信分支又得重改一遍」

现在你只需要维护同一份 game.js + game.json,game_studio_export_wechat 会自动完成下面四件脏活,把工程直接变成微信开发者工具打开就能跑的 wx-minigame/ 目录:

自动注入真机兼容层与预审静态体检:自动写入 GameGlobal 反遮蔽前言与 weapp-adapter.js(统一抹平 WebGL2、Canvas2D、Pointer 触控和 WebAudio 差异),同时在导出前扫描多 WebGL 上下文、英文残留、外链脚本等真机雷区

主包自动压进 4.00 MB 红线:SVG 槽位自动栅格化,配合 8-bit 透明 PNG 量化(《一箱见底》41 枚 3D 图标单张压到 6~23 KB,3 大宇宙共 42 款纯代码 3D 物理模型 加上 3 首原创配乐,整套微信原生包实测只有 3.60 MB,还留出 ~420 KB 安全余量;同源码打出的离线单文件网页版为 4.09 MB)

满 100 UV 前后零改码 IAA 变现预埋:激励视频占小游戏广告收入 90%+,而强制插屏只占约 2% 却极易把玩家劝退;因此我们默认 0 插屏强弹、0 局内横幅遮挡,只留主动求助激励视频口——在没满 100 UV 拿到 adunit ID 前,wx-config.js 自动运行在 noAdFallbackMode: 'free'(显示「首发限免」直领,防空广告报错被拒审),等开通流量主后填进一行 adunit ID 全游戏自动切入正式变现

自动生成五大系统提审草稿:导出目录自带 WECHAT_SUBMISSION_DRAFT.md,把适龄说明、核心玩法和五大系统功能初稿提前帮你写好

🎯 本步交付物

本地 < 4.00 MB 的 wx-minigame/ 完整原生包 + 上传至微信后台的体验版二维码

❌ 最容易废掉的一步

上传体验版时的 --desc 项目备注随便写了个 fix bug v1.0.3 或英文开发日志——记住,备注在后台会被直接引用,务必写成面向玩家的纯中文一句话游戏简介

📋 直接抄作业(一句话导出并直传体验版)

直接在对话框对 Agent 下指令:

用 game_studio_export_wechat 导出微信小游戏包(AppID 填【你的 AppID】),跑完微信预审体检确认体积小于 4 MB、零英文残留,再用 game_studio_upload_wechat 上传 1.0.0 体验版,备注写「【一句话纯中文玩家简介】」

底层工具会自动调用本机微信开发者工具 CLI 执行上传,首次触发时你在微信开发者工具弹窗里点一次确认即可完成回传:

# 如需在终端手动复核上传,也可直接跑这行命令
/Applications/wechatwebdevtools.app/Contents/MacOS/wechatide -c dsh-game-studio upload \
  --project /你的项目路径/wx-minigame \
  --upload-version 1.0.0 \
  --desc "满满一箱3D玩具,凑齐三个同款就消除!解压三消一箱见底"

🔒 图片需 后查看

零外部 3D 模型文件:赛博极客仓、软萌毛绒屋、颗粒积木坊三大主题共 42 款 3D 物理玩具全部由程序几何体驱动,完整微信包仅 3.60 MB

⚠️ 差错自查

如果导出时触发 4.00 MB 体积超限报错:不要手动删代码,让 Agent 先对 assets/ 下的 PNG 执行紧裁透明边 + FASTOCTREE 8-bit 透明量化,再把背景音乐压成 48–64 kbps 单声道 MP3,通常一轮就能瘦下 1~2 MB

如果体验版在 iPhone 真机完全没声音:检查音频初始化是否带了 wx.setInnerAudioOption({ obeyMuteSwitch: false, mixWithOther: true }) 且首触发送了静音脉冲解锁

五|Step 4:过审 3 大雷区、11 张截图清单与上线后搜一搜加分项

代码传完体验版后,首次点「提交审核」一定会弹出一个 「缺少资质材料 → 前往补充」 拦截页——这步才是新手最容易反复被打回、白耗三五天的地方

把我们《一箱见底》实测一次过审的全部实战细节摊开给你,照着准备 15 分钟就能填完:

雷区 1(最隐蔽):千万别拿游戏内自绘的绿色「8+」方块当适龄证明

很多开发者自己在 Canvas 底部画了一个绿色圆角 8+ 小图标,截屏交进「01-场景」资质栏,结果很容易被判定为非标准适龄标识

稳过做法:直接在自己手机微信里扫码打开体验版,趁刚启动那 1 秒截取「微信小游戏原生黑底启动页」——底部自带微信官方渲染的白框绿底标准 8+ CADPA 适龄提示 徽章与《健康游戏忠告》,拿这张当场景首图最稳妥

雷区 2:绝对不能拿电脑浏览器截图顶替真机截屏

11 张提审图全部必须在手机微信内真实打开体验版截屏,右上角必须保留微信原生的 ••• | ◎ 胶囊按钮,同时确认游戏主界面标题与微信后台注册名称一字不差(不能多挂副标题或英文后缀)

雷区 3:商城/抽奖入口不写概率或含糊写支付

只要游戏里有抽皮肤、抽盲盒或兑换工坊,哪怕只用免费游戏币,填写「商城系统」时也必须明确写清:展示抽取概率、仅消耗游戏内免费获得的货币、当前版本不提供现金充值或提现

审核一次过实拍对照:左图红框内自绘绿块 8+ 易被打回,中图绿框内手机截取微信原生黑底启动页自带官方 CADPA 8+ 徽章一次稳过,右侧为 11 张真机原图完整清单

🎯 本步交付物

通过微信内容资质审核与版本审核,拿到可永久扫码和微信搜一搜直达的正式版小游戏,并补齐搜一搜展示运营素材

📋 直接抄作业(11 张真机图 + 五大系统填写范本)

手机上按下面清单截齐 11 张真机原图(全部带右上角微信胶囊):

01-场景(3 张):微信原生黑底启动页(带官方标准 CADPA 8+ 标)+ 2 张不同核心主题关卡画面

02-玩法(3 张连贯动作链):动作前(拨开玩具)→ 动作中(点选入槽)→ 动作结果(凑齐三个触发消除)

03-系统功能(5 张逐项对应):按下面《一箱见底》实测过审模板改掉你的游戏名词即可直接填表

01-货币系统:玩家通过【通关/消除/签到】获得【游戏内货币名】,余额显示在主页左上角,可用于解锁主题与道具,当前版本不提供现金充值或提现 02-道具系统:玩家可在关卡中使用【列举 2–3 种道具名及具体作用】,当前版本提供免费补充次数 03-设置系统:玩家可在设置面板分别开关音效与背景音乐、调节音量、切换曲目与震动反馈 04-商城系统(游戏内名称为【如:工坊】):玩家可消耗游戏内免费获得的【货币名】升级或随机抽取【涂装/外观】,页面明确展示抽取概率,未开通现金支付 05-自定义系统(游戏内名称为【如:图鉴】):按主题记录已收集内容,支持查看进度与自由切换已解锁外观

💡 刚上线第 1 件事:顺手补齐「运营素材管理」(搜一搜曝光加分项)

过审上线后,后台顶部往往会弹一条黄色提醒:「暂未上传游戏通用封面,建议上传以获得更好的推广表现」,顺手把下面 4 项一起传了,搜一搜卡片会好看一大截:

通用素材封面(官方红线极严):尺寸严格 650×250 px 直角无圆角、.jpg 格式且 < 80 KB;严禁带任何文字、Logo、Icon 或自带黑色渐变蒙版,主体必须居中偏右(右 434×250),左 216×250 留给微信前端自动叠字与图标

游戏简介:上限严格 20 个字(例如我们的 拨开一箱3D潮玩,凑齐三个同款解压清空!),直接写清核心爽点

详细推广图:竖版 720×1280 × 3 张 + 横版 1280×720 × 3 张,均压缩至 ≤ 200 KB(记得把截图右上角微信胶囊修掉更干净)

⚠️ 差错自查

如果提交版本审核时被提示某个页面出现英文单词:全仓搜索 assets/ 与 game.js 里的 HUD 文本(连 FPS、Combo、NEW 这种词也尽量换成中文),重新导出上传即可

如果刚上线发现首局体验有小瑕疵:不用等大版本,直接改完 game.js 跑一轮三端验收,用 game_studio_upload_wechat 推热修补丁提审(比如我们上线 1.0.6 后马上修掉新手选完主题绕回主页的小绕路,当天推的 1.0.7 几小时内就直接过审上线了)

六|立刻试玩、免费开源,以及下篇预告

整套工具链我们都已经全部免费开源,不卖课、不藏脚本,今天就能直接装进你的主力 AI Agent 开工:

真机实测标杆作品:打开微信搜一搜 「一箱见底」(或扫描文内首图官方永久太阳码),亲自感受一下 AI 做出的 3.60 MB 3D 物理消消乐在手机上的手感与帧率

在线免费 2D/3D 游戏墙:finiking.github.io/dsh-games/wall/ — 手机电脑点开即玩,10+ 款靠这套工坊跑出来的实测小游戏都在墙上

开源仓库与一键安装:github.com/ZSeven-W/dsh-game-studio(npm 包 @zseven-w/dsh-game-studio@0.1.0-rc.6,原生支持 Codex / Claude Code / Antigravity / DeepSeek Harness)

🎁 评论区福利: 如果你心里刚好有一个想做成微信小游戏的脑洞,在评论区丢一句你的玩法想法,我挑 3 个最有意思的设定,直接按这篇文章的真机适配与留存标准,帮你写成一段可以直接贴给 AI Agent 跑通的完整立项提示词 👇

📌 下篇连载预告: 等《一箱见底》冲过首波 100 UV、填进一行 adunit ID 正式开通微信流量主,并开启「新游种子计划」跑完冷启动放量后,我会把首月真实次留数据、激励视频完播率、eCPM 和个人小游戏真实广告收益账本原封不动公开复盘——想蹲真实变现数据的朋友,记得点个关注不迷路

📚 往期精选长文与代表作合集(点击蓝字直达)

🔥 最新爆款与多 Agent 开源工具链

[昨日长文] 《🔥起号焚诀:不露脸做自媒体,如何用一部手机复刻爆款做二创?》 —— 换人变装二创一遍过,附上防穿帮跑法、完整工作流与万能提示词

[长文] 《Google 连发 Hydrogen 与 Orchestrator:跑了 20 多场多 Agent 编排后,我为什么不再拿旗舰模型干杂活》 —— 拆透「主脑规划 + 多工兵并行 + 独立验货」的省额度高效编排实战

[长文] 《黄仁勋掌舵 33 年突然卸任:一个做 3D 游戏显卡的人,给「一人开发时代」留下了什么?》 —— 从实时图形管线聊透「一人带多工兵并行推理」的算力底座

[置顶合集] 《10 款 DeepSeek Harness 开源插件全景清单》 —— 一次认齐 OpenPencil、Game Studio、Crew、QA 与真机自动化武器库

[开源首发] 《DSH 游戏工坊开源:一句话出 2D/3D 游戏 + Agent 自动试玩验收》 —— 生成完自动无头试玩查报错,支持一键发布整面在线游戏墙

🎮 3D 游戏管线与新模型硬核实测

[长文] 《别再用 GPT-Astra 从零捏人物了,这套 3D 流程更靠谱》 —— 拆清纯代码场景建模与角色转模绑骨的分工边界,少走十倍返工弯路

[实机试玩] 《暗黑三国动作肉鸽〈孤枪入夜〉首章双端网页试玩上线》 —— Tripo 不到 900 积分走通角色场景动作,支持电脑键鼠与手机横屏摇杆直玩

[模型实测] 《Gemini 4 Carbon 实测:一段提示词搓出 3D 空战〈裂风 XF-99〉》 —— 峡湾反舰、钻跨海大桥、王牌狗斗与全息盲降(附在线试玩与原版 Prompt)

[模型实测] 《Gemini 4 Carbon 实测:一句话搓出 3D 全息海战棋〈海峡指挥官〉》 —— 附双端在线验货入口与完整单段测试提示词

🎨 OpenPencil 与 AI-Native 设计工程

[长文] 《什么才是 AI-Native 的设计?》 —— 60 个门店按钮实测:AI 出完初稿后,怎么靠继承与覆盖在十轮修改里保住人的设计意图

[长文] 《Codex-OpenPencil 快速上手篇》 —— 从安装插件到做出可编辑 APP 设计稿、选中局部微调、保存 .op 与转代码全流程

[长文] 《不止设计稿:用 Codex-OpenPencil 做可复用的海报、封面、对比图和教程配图》 —— 把无限画布变成日常内容生产台,一次排版长期复用

[工具实测] 《OpenPencil Chrome 插件:几秒把真实网页吸进可编辑画布》 —— 告别对着截图让 AI 盲猜复刻,一键把线上结构拉进画布改新稿

🖼️ 开源生图部署与提示词 Skill

[长文] 《拆解 Qwen-Image 官方「智能改写」:我把生图和改图经验总结成了一个 Skill》 —— 把官方改写逻辑提炼成可复用的生图与局部精修方法论

[长文] 《Qwen-Image 2.1 本地部署实战:从此生图自由》 —— 跑通 RTX 5080 与 MacBook Pro 双端部署,理清 Diffusers / ComfyUI / GGUF 权重路线

主楼