> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# 内测与上线

:::info 提示

审核通过（`reviewed`）后，版本还不会直接对所有人开放，而是先进入**内测**：只让一批你指定的用户提前体验，用真实使用场景做最后一轮验证，确认没问题再上线。

<div hidden data-lark-callout-end></div>

:::

## 提交内测

### 提交内测名单

当版本处于"审核完成"，配置预览页右上角的按钮会变&#x6210;**"提交内测"**。点击后会弹出一个配置浮层，让你填写内测用户名单。名单以用户 UID 的形式提供，支持两种方式：

- **手动输入**：直接在浮层里逐个填入 UID，适合少量内测用户。
- **上传文件**：上传一个包含 UID 的 CSV 文件，适合批量导入。

填好后点击"确认提交"，版本进入 `testing`。此时只有名单内的用户能在豆包里看到并使用这个版本，名单之外的用户不受影响。

:::info 提示

提交内测时，如果 UID 格式不正确或名单为空，系统会拦截并报错。请确认名单内容无误后再提交。

<div hidden data-lark-callout-end></div>

:::

### 内测阶段做什么

内测的目的是在有限范围内暴露问题，而不是大范围推广。建议在这个阶段：

1. 覆盖典型使用场景，尤其是当初梳理的核心 Query，确认模型能正确调用工具、卡片渲染正常。
2. 关注真实环境下的表现，比如响应速度、异常情况的处理、登录与支付链路是否顺畅。
3. 收集内测用户反馈，如发现问题，回到开发阶段修复后重新提审，敏捷修复。

## 正式上线

内测验证通过后，由管理员确认将版本推向正式上线，版本进入 `production`。至此，所有符合条件的豆包用户都能正常使用你的应用插件。

上线后，你在开发者平台可以持续查看这个版本的运行情况和审核报告。当需要发布新功能或修复问题时，重新创建一个新版本，再走一遍"开发 → 提审 → 内测 → 上线"的完整流程即可——线上版本在新版本上线前保持稳定服务，不受影响。

## 版本管理

开发者平台的"版本管理"页是你管理所有版本的中枢。每个应用插件可以有多个版本并存，各自处于不同状态（例如同时有一个 `production` 的线上版本和一个 `staging` 的在研版本）。

在版本管理页，你可以：

<table><colgroup><col width="118"/><col width="694"/></colgroup><tbody><tr><td>能力</td><td>说明</td></tr><tr><td>版本列表</td><td>按时间线查看该应用插件的所有版本，以及每个版本当前所处的状态（开发中 / 审核中 / 已通过等）、更新时间、产物包大小等信息。</td></tr><tr><td>版本详情</td><td>进入某个版本查看其配置预览、审核报告与提审包元信息。</td></tr><tr><td>版本对比</td><td>对比不同版本之间的差异，便于确认改动内容。</td></tr><tr><td>撤回</td><td>在版本尚未推进到不可逆节点前，撤回本次提交。</td></tr><tr><td>回滚</td><td>当线上版本出现问题时，回退到此前的稳定版本。</td></tr></tbody></table>

:::info 提示

建议采用清晰、递增的版本号（如 `v1.1.0`、`v1.2.0`、`v1.3.0`），并在每次提交时简要记录本次改动，方便团队协作和后续排查。

<div hidden data-lark-callout-end></div>

:::

## 关于灰度发布

灰度发布，是指在正式全量上线之前，先让一小部分线上用户使用新版本，确认稳定后再逐步扩大范围。它比内测更进一步——面向的是真实线上流量，而不是预先指定的名单。

灰度能力（按比例逐步放量、依据线上表现动态调节放量速度等）会在后续版本中提供，Q3 内陆续开放。在此之前，请把内测阶段作为上线前的主要验证手段，尽量在内测中覆盖充分，以降低全量上线的风险。
