小程序开发版构建与上传

构建、上传开发版、设体验版、提审、正式发布是不同动作。开发者工具仍用于真机调试与日志；官方miniprogram-ci可在本机上传，无需每次手工打开工具上传。

前提

微信公众平台管理员生成代码上传私钥，按平台要求配置上传IP白名单。只需要上传密钥，不是AppSecret或账号密码。当前项目AppID为wx71576fb1826904b3。私钥存本机受保护目录、文件600/目录700，不进入源码、Build静态资源或Release。

总仓库local-tools不随Git克隆；现有本机upload-miniprogram.cjs与其package-lock锁定SDK。新成员需维护者提供工具来源/受审副本，或按官方miniprogram-ci文档重新配置，不假设克隆后路径和密钥已存在。

标准步骤

在小程序仓库先检查状态与提交，类型及Build通过后回总仓库调用本机工具：

cd yunstack-uniapp
pnpm install --frozen-lockfile
pnpm type-check
pnpm build:mp-weixin
cd ..
node local-tools/upload-miniprogram.cjs --version 0.7.1   --desc "版本修改说明" --upload

上传目录只能是yunstack-uniapp/dist/build/mp-weixin。默认robot1，后续同机器人上传会更新其开发版本；回执记录版本、组件SHA、有无未提交改动和服务端结果。不带--upload只检查本地已有Build，不证明上传权限或IP已验证。

SDK恢复示例：npm --prefix local-tools install --save-exact miniprogram-ci，依赖留本机工具目录，不加业务依赖。默认密钥在local-tools/.private/private.wx71576fb1826904b3.key，也可--key指定仓库外路径；工具缺失先恢复，不能只创建同名空文件假装上传成功。

若服务端WXSS编译失败，以错误定位修正后重新Build上传；本机Build成功不能代替微信服务端编译。上传后在微信后台/开发者工具确认开发版本，再在手机打开相应版本；原体验版不会自动包含最新上传。设体验、提审和正式发布须另行明确操作，不把Git push结果当微信已发布。