📢 Channel
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
📢 在 Capgo Cloud 中管理应用更新的分发渠道，控制更新如何分发到设备。
➕ 添加
标题为“ ➕ 添加”别名： a
npx @capgo/cli@latest channel add➕ 在 Capgo Cloud 中创建一个新的应用分发渠道，用于管理更新分发。
示例：
npx @capgo/cli@latest channel add production com.example.app --default选项：
| 参数 | 类型 | 描述 |
|---|---|---|
| -d | boolean | 将该 channel 设为默认 |
| —self-assign | boolean | 允许设备自行分配到此 channel |
| -a | string | API 用于关联您的账户的密钥 |
| —supa-host | string | 自定义 Supabase host URL（用于自托管或 Capgo 开发） |
| —supa-anon | string | 自定义 Supabase anon key（用于自托管） |
🗑️ 删除
章节标题为“ 🗑️ 删除”别名： d
npx @capgo/cli@latest channel delete🗑️ 从 Capgo Cloud 中删除频道，并可选择同时删除关联的 bundle 以释放资源。
示例：
npx @capgo/cli@latest channel delete production com.example.app选项：
| 参数 | 类型 | 描述 |
|---|---|---|
| -a | string | API 用于关联您的账户的密钥 |
| —delete-bundle | boolean | 删除与该 channel 关联的 bundle。App Preview key 只能原子化地删除其自身的 preview channel 及关联的、未共享的 bundle。 |
| —success-if-not-found | boolean | 如果未找到该 channel，则返回成功 |
| —supa-host | string | 自定义 Supabase host URL（用于自托管或 Capgo 开发） |
| —supa-anon | string | 自定义 Supabase anon key（用于自托管） |
📋 列出
“ 📋 列表”章节别名： l
npx @capgo/cli@latest channel list📋 列出 Capgo Cloud 中为应用配置的所有 channel，以便检查分发设置。
示例：
npx @capgo/cli@latest channel list com.example.app选项：
| 参数 | 类型 | 描述 |
|---|---|---|
| -a | string | API 用于关联您的账户的密钥 |
| —supa-host | string | 自定义 Supabase host URL（用于自托管或 Capgo 开发） |
| —supa-anon | string | 自定义 Supabase anon key（用于自托管） |
📦 CurrentBundle
“ 📦 CurrentBundle” 章节npx @capgo/cli@latest channel currentBundle📦 获取 Capgo Cloud 中与特定 channel 关联的当前 bundle，用于更新追踪。
示例：
npx @capgo/cli@latest channel currentBundle production com.example.app选项：
| 参数 | 类型 | 描述 |
|---|---|---|
| -c | string | 用于获取当前 bundle 的 Channel |
| -a | string | API 用于关联您的账户的密钥 |
| —quiet | boolean | 仅打印 bundle 版本 |
| —supa-host | string | 自定义 Supabase host URL（用于自托管或 Capgo 开发） |
| —supa-anon | string | 自定义 Supabase anon key（用于自托管） |
⚙️ 设置
“ ⚙️ 设置”章节别名： s
npx @capgo/cli@latest channel set⚙️ 配置 channel 的设置，例如绑定 bundle、设置更新策略（major, minor, metadata, patch, none）或设备目标（iOS, Android, dev, prod, emulator, device）。 必须指定一个默认 channel。
示例：
npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default选项：
| 参数 | 类型 | 描述 |
|---|---|---|
| -a | string | API 用于关联您的账户的密钥 |
| -b | string | 要设置的文件 Bundle 版本号 |
| -s | string | 设置 Channel 状态，默认为 default 或 normal |
| —latest-remote | boolean | 获取 capgo 云端最新上传的 bundle 并将其设置为该 channel |
| —latest | boolean | 获取 package.json 中的最新 version key 并将其设置为该 channel |
| —downgrade | boolean | 允许降级到低于 Native Build 的版本 |
| —no-downgrade | boolean | 禁用降级到低于 Native Build 的版本 |
| —ios | boolean | 允许向 iOS 设备推送更新 |
| —no-ios | boolean | 禁用向 iOS 设备推送更新 |
| —android | boolean | 允许向 Android 设备推送更新 |
| —no-android | boolean | 禁止向 Android 设备推送更新 |
| —self-assign | boolean | 允许设备自行分配到此 channel |
| —no-self-assign | boolean | 禁止设备自行分配到此 channel |
| —disable-auto-update | string | 按类型拦截更新：major、minor、metadata、patch 或 none（允许所有） |
| —update-package | string | 提供 zip、delta 或两者：all、zip、delta、zip_from_builtin 或 delta_from_builtin |
| —rollout-bundle | string | 在该频道上逐步发布的 Bundle 版本 |
| —rollout-percentage | string | 灰度发布百分比，范围 0 到 100 |
| —rollout-percentage-bps | string | 以基点为单位的灰度发布百分比，范围 0 到 10000 |
| —rollout-enable | boolean | 启用已配置的灰度发布 |
| —rollout-disable | boolean | 禁用已配置的灰度发布 |
| —rollout-pause | boolean | 暂停灰度发布，但不回滚已选设备 |
| —rollout-resume | boolean | 恢复暂停的 rollout |
| —rollout-rollback | boolean | 清除 rollout 状态并将设备恢复至 stable 版本 |
| —rollout-promote | boolean | 将 rollout 目标提升至 stable 并清除 rollout 状态 |
| —rollout-cache-ttl-seconds | string | Cloudflare rollout 决策缓存 TTL（秒） |
| —auto-pause-enabled | boolean | 启用 rollout 自动暂停策略 |
| —auto-pause-disabled | boolean | 禁用 rollout 自动暂停策略 |
| —auto-pause-window-minutes | string | 发布自动暂停统计窗口 |
| —auto-pause-failure-rate-bps | string | 以基点 (bps) 为单位的失败率阈值 |
| —auto-pause-confidence | string | 0 到 1 之间的置信度水平 |
| —auto-pause-min-attempts | string | 触发自动暂停前所需的最小安装加失败尝试次数 |
| —auto-pause-min-failures | string | 触发自动暂停前所需的最小失败次数 |
| —auto-pause-action | string | 自动暂停操作：pause、rollback 或 notify |
| —auto-pause-cooldown-minutes | string | 自动暂停再次触发前的冷却时间 |
| —dev | boolean | 允许向开发设备发送更新 |
| —no-dev | boolean | 禁止向开发设备发送更新 |
| —prod | boolean | 允许向生产设备发送更新 |
| —no-prod | boolean | 禁止向生产设备发送更新 |
| —emulator | boolean | 允许向模拟器发送更新 |
| —no-emulator | boolean | 禁止向模拟器设备发送更新 |
| —device | boolean | 允许向真机设备发送更新 |
| —no-device | boolean | 禁止向真机设备发送更新 |
| —qr-preview | boolean | 更新该 channel 后，在终端打印 QR code 用于预览该 channel |
| —send-update-notification | boolean | 更新关联的 channel bundle 后，向设备发送原生更新检查通知 |
| —package-json | string | Monorepo 中 package.json 文件的路径（以逗号分隔） |
| —ignore-metadata-check | boolean | 如果 bundle 中存在 node_modules，则忽略其兼容性检查 |
| —supa-host | string | 自定义 Supabase host URL（用于自托管或 Capgo 开发） |
| —supa-anon | string | 自定义 Supabase anon key（用于自托管） |
