auto-control-miniprogram
把 AI 编码、自动构建、体验版上传与手机验收连成闭环，让微信小游戏从开发到提审都能在手机端推进。
开源AI CodingCLI微信小程序微信小游戏TypeScriptNode.jsCommandercosmiconfigminiprogram-citsup开源项目
- 1 行
- 体验版上传
- 4 类
- 微信项目类型
- 3 种
- 二维码输出
- 0
- 桌面开发者工具
ENGINEERING HIGHLIGHTS
难点与亮点
手机驱动的开发闭环
用手机向 AI 下达任务，代码完成后由 CLI 自动构建并上传体验版，扫码验收后继续反馈修改。
屏蔽官方 CI 复杂度
将配置加载、构建命令、项目创建、进度回调和 miniprogram-ci 参数收敛为简单命令。
体验与发版分流
preview 直接产出终端、图片或 Base64 二维码；upload 则携带版本号和描述进入开发版列表。
明确的人机边界
构建、上传和体验版生成交给自动化；自开发账号的提审与发布保留为手机后台人工确认。
项目定位
auto-control-miniprogram 解决的不只是“少输入几条命令”，而是把 手机指挥 AI 开发 与微信体验版交付链路连在一起。开发者在手机上描述需求，AI 在开发环境中写代码和修改项目；完成后直接触发构建与体验版上传，再回到手机扫码验收。
如果体验发现问题，在手机上把反馈继续交给 AI；如果验收通过，则在手机端登录微信公众平台后台手动提审，审核通过后再发布。这套流程不需要打开桌面微信开发者工具。
手机端交付架构
CLI 分层
| 层级 | 职责 |
|---|---|
| 接入层 | Commander 提供 init、preview、upload 和 pack-npm 四类命令，也暴露 TypeScript 编程 API |
| 配置层 | cosmiconfig 搜索多种配置文件，补全默认值、解析绝对路径，并在执行前校验 AppID、私钥与产物目录 |
| 编排层 | 按需执行业务项目的 build 命令，再根据 miniProgram、miniGame 或插件类型创建标准 CI Project |
| 适配层 | 向官方 miniprogram-ci 透传编译设置、忽略规则和 Robot 编号，统一处理上传进度与错误输出 |
两条交付通道
快速验收：Preview
acmp preview 在构建完成后上传体验版，二维码可输出为终端 ASCII、图片或 Base64。这使 AI 可以把体验入口直接返回到手机对话中，开发者扫码即可进入实机验收。
准备提审：Upload
acmp upload --ver <version> --desc <desc> 将已验收产物上传到微信后台的“开发版”列表。自开发账号没有提审和发布 API，因此这两个高风险动作明确保留为手机后台人工确认，而不是伪装成“全自动发布”。
安全与工程化
acmp init自动生成配置、创建.keys/目录，并把私钥目录与二维码产物写入.gitignore，降低凭证误提交风险。- 私钥既可来自文件路径，也可以字符串形式从 CI Secret 注入，兼容本地开发与远程执行环境。
- 配置、CLI 和编程 API 共用同一组 TypeScript 类型，再由 tsup 同时输出 ESM、CommonJS 与类型声明。