wx-mini-program-publisher

一个可通过 npx 直接调用的微信小程序自动发布脚本，适合在 CI/CD 流水线中使用。

通过 npx 调用

npx -y [email protected]

也可以带参数：

npx -y [email protected] \
  --project-path ./miniprogram \
  --desc "ci auto release" \
  --robot 1

版本描述用 --desc 指定；省略时会读取环境变量 CI_COMMIT_MESSAGE（CI 里常用）。机器人编号用 --robot，省略时默认为 1。

建议在 CI 中始终使用 -y（跳过交互确认）并固定版本号（如 @0.1.7）以保证发布流程稳定可复现。

发布版本号生成规则：

• 微信上传 version 使用三段格式：YY.MMDD.xxx
• version 自动生成规则：
  • 优先：YY.MMDD.BUILD_NUMBER（BUILD_NUMBER 去除非数字后作为第三段）
  • 兜底：YY.MMDD.HHmm（当没有 BUILD_NUMBER 时，第三段使用当前时间 HHmm）
• 示例：26.0328.789、26.0328.1457

环境变量

必填

• WX_APPID（或 APPID）
• 私钥（二选一）
  • WX_PRIVATE_KEY_BASE64（或 PRIVATE_KEY_BASE64）：推荐，放 base64 编码后的私钥内容
  • WX_PRIVATE_KEY（或 PRIVATE_KEY）：明文私钥，支持 \n 自动转真实换行

脚本会在运行时把私钥写入临时文件，并将该临时文件路径传给 miniprogram-ci 的 privateKeyPath，发布结束后自动删除。

可选

• WX_CI_SETTING_JSON：自定义 miniprogram-ci upload.setting JSON 字符串

CI 使用示例（GitHub Actions）

- name: Publish mini program
  env:
    WX_APPID: ${{ secrets.WX_APPID }}
    WX_PRIVATE_KEY_BASE64: ${{ secrets.WX_PRIVATE_KEY_BASE64 }}
  run: |
    npx -y [email protected] \
      --project-path ./miniprogram \
      --desc "${{ github.event.head_commit.message }}" \
      --robot 1