publish

Author: sunnylqm

site/pages/docs/publish.mdx

@@ -149,6 +149,49 @@ Would you like to bind packages to this version?(Y/N)
 
 恭喜你，至此为止，你已经完成了植入代码热更新的全部工作。
 
-## 测试与回滚
+## 灰度发布
 
-请参考最佳实践中的[测试与回滚](bestpractice#测试与回滚)章节。
+灰度发布（又称金丝雀发布、渐进式发布）是一种降低热更新发布风险的策略，通过逐步扩大更新范围来验证新版本的稳定性。
+
+### 什么是灰度发布
+
+灰度发布是指在正式全量发布热更新之前，先将更新推送给一小部分用户（如 5%、10%），观察这部分用户的使用情况后，再逐步扩大更新比例，直到最终推送给所有用户。
+
+### 灰度发布的作用
+
+- **降低风险**：如果新版本存在 bug，只会影响小部分用户，可以及时发现并回滚
+- **验证稳定性**：通过小范围用户的真实使用反馈，验证新版本在各种设备和网络环境下的表现
+- **平滑过渡**：避免突然的全量更新对服务器造成的压力峰值
+- **快速止损**：一旦发现问题，可以立即停止灰度，将影响范围控制在最小
+
+### 工作原理
+
+当你设置了灰度比例（如 10%）后，检查更新时会根据每个用户的设备 UUID 进行哈希计算，确定该用户是否在灰度范围内：
+
+- 灰度范围内的用户会收到新版本的更新推送
+- 灰度范围外的用户会收到上一个全量版本（如果有），或显示为已是最新
+- 同一用户的灰度状态是稳定的，不会因为多次检查更新而变化
+
+### 使用方法
+
+#### 通过网页端操作
+
+1. 登录 [Pushy 管理后台](https://update.reactnative.cn)
+2. 选择对应的应用和原生包版本
+3. 点击"发布"按钮
+4. 选择灰度发布比例
+
+#### 通过命令行操作
+
+请查看[命令行工具文档中的 rollout 参数](cli#pushy-update)
+
+### 注意事项
+
+<Callout type="warning">
+  **重要提示**：灰度版本与全量版本是独立的绑定关系。
+</Callout>
+
+- **同时只能有一个灰度版本**：每个原生包版本只能绑定一个灰度热更版本（比例小于100%）和一个全量热更版本
+- **优先级**：如果同时存在灰度版本和全量版本，灰度范围内命中的用户会收到灰度版本，没有命中的用户会收到全量版本
+- **提升为全量**：将灰度比例设置为 100% 后，该版本会自动提升为全量版本，替换原有的全量版本
+- **客户端版本要求**：`react-native-update` >= 10.32.0 才能支持同时发布灰度和全量版本。