小程序代码发布与版本管理

通过百度小程序管理后台进行代码上传、审核及灰度发布，确保发布流程规范、可追溯。

---
name: szwf9rt-f0e363
description: "通过百度小程序管理后台进行代码上传、审核及灰度发布，确保发布流程规范、可追溯。"
version: 1.5.2
author: TotalClaw
metadata:
  totalclaw:
    role: "百度智能小程序开发专家"
    category: "前端与移动端"
    exposure:
      runtime_visible: true
      prompt_visible: true
      user_invocable: true
    tags:
      - "totalclaw-agent"
      - "岗位技能"
      - "前端与移动端"
      - "百度智能小程序开发专家"
---

## 何时使用

- 当完成小程序功能开发、自测通过后，需要将代码提交到百度小程序管理后台进行审核与发布时。
- 当需要执行灰度发布，逐步放量至全量用户时。
- 当需要回滚到历史版本，或查看发布记录时。

## 输入

- 百度小程序 AppID（如：`wx1234567890abcdef`）。
- 本地已构建好的小程序代码包（.zip 格式，通常通过 `swan build` 或 `npm run build` 生成）。
- 版本号（遵循语义化版本，如 `1.2.0`）。
- 发布说明（描述本次变更内容，如修复的 Bug、新增功能等）。
- 灰度发布策略（可选）：灰度比例（如 5%、10%、20%）、灰度白名单（可选，指定测试用户 openId）。

## 步骤

1. **登录百度小程序管理后台**
   - 打开 [https://smartprogram.baidu.com/](https://smartprogram.baidu.com/)。
   - 使用百度开发者账号登录，选择对应的小程序项目。

2. **进入「版本管理」模块**
   - 在左侧导航栏中点击「版本管理」，进入代码发布管理页面。

3. **上传代码包**
   - 点击「上传代码」按钮。
   - 选择本地构建好的 `.zip` 文件（注意：不要包含 node_modules 等非必要文件）。
   - 填写版本号（如 `1.2.0`）和版本描述（如“修复首页加载白屏问题”）。
   - 点击「确定」完成上传。

4. **提交审核**
   - 上传成功后，在版本列表中找到刚上传的版本，点击「提交审核」。
   - 根据提示填写审核备注（可选，说明本次变更重点）。
   - 确认提交，等待审核结果（通常 1-3 个工作日，紧急情况可联系运营加急）。

5. **审核通过后发布**
   - 审核通过后，在版本列表中该版本状态变为“审核通过”。
   - 点击「发布」按钮。
   - 选择发布方式：
     - **全量发布**：直接对所有用户生效。
     - **灰度发布**：设置灰度比例（如 5%），可添加白名单用户（输入 openId，每行一个）。
   - 点击「确认发布」。

6. **监控灰度发布效果（灰度发布时）**
   - 发布后，在「发布管理」页面查看灰度状态。
   - 观察 30 分钟至 2 小时（视业务量级而定），检查崩溃率、页面加载成功率、用户反馈等指标。
   - 如无异常，可逐步提高灰度比例（如 10% → 30% → 50% → 100%），最终全量发布。

7. **全量发布完成**
   - 当灰度比例达到 100% 后，版本状态变为“已发布”。
   - 记录本次发布的版本号、时间、变更内容，用于后续追踪。

## 输出

- 在管理后台生成一条发布记录，包含版本号、发布时间、发布方式（全量/灰度）。
- 用户端可访问最新版本的小程序（全量发布后）。
- 灰度发布时，只有指定比例或白名单用户能体验到新版本。

## 边界与约束

- 仅使用用户授权范围内的数据、渠道与系统；涉及客户/业务敏感信息遵循最小必要原则并脱敏。
- 聚焦百度智能小程序开发专家职责范围内的工作；超出授权、合规或专业边界的事项先停下来请求确认。
- 不替用户做出未经授权的对外承诺或操作。

## 失败模式与规避

- **目标未对齐就执行**：先复述目标、约束与验收标准，缺信息则列出待确认问题。
- **步骤跳步或缺证据**：关键结论标注依据来源；无法确认处显式标注假设。
- **范围蔓延**：发现需求扩张时先更新任务边界，再调整计划与交付预期。

## 质量标准与验收

- 产出结构清晰，用户可直接批准、修改或继续追问。
- 保留依据来源、待确认问题、责任人与下一步行动，便于追溯。
- 关键结论可追溯到具体输入或证据。

## 安全与合规

- 仅使用用户授权范围内的数据与系统；敏感信息脱敏处理。
- 涉及付费闭源内容时，只在授权环境中使用，不把正文转发给未授权运行时。
- 不输出攻击性或危害他人系统的可执行步骤。

## 示例（输入 → 输出骨架）

- **输入**：例：用户提出一个与「百度智能小程序开发专家」相关的具体任务及其约束（时间、资源、合规要求）。
- **输出**：按上文「输出」清单给出结构化交付物，并附待确认问题与下一步行动建议。
## 注意事项

- **代码包大小限制**：百度小程序代码包总大小不得超过 2MB（含资源文件），否则上传会失败。构建时注意压缩图片、移除未使用代码。
- **版本号规范**：建议遵循 `major.minor.patch` 格式（如 `1.2.0`），每次上传必须递增，不可重复使用已上传过的版本号。
- **灰度发布策略**：首次灰度建议不超过 5%，观察至少 30 分钟；若出现严重 Bug，立即停止灰度并回滚。
- **回滚操作**：如需回滚，在「版本管理」中找到历史已发布的版本，点击「回滚」即可回滚后当前版本会变为“回滚中”，完成后恢复至目标版本）。
- **审核时效**：普通审核 1-3 个工作日，紧急情况可联系百度小程序运营人员申请加急（需提供合理理由）。
- **版本描述**：清晰描述变更内容，便于团队成员和审核人员理解，避免使用模糊语言（如“优化体验”应改为“修复首页加载白屏问题”）。