> 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 提示

本指南面向**豆包开发者平台**的对接开发者，帮助你在提交应用插件审核前理解**审核标准**、提前规避**常见驳回原因**，并在收到审核报告后快速完成整改与复审。审核是应用插件上线前的"准出闸门"，只有通过审核的版本才能进入内测、灰测直至上线。

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

:::

## 一、审核系统概述

审核系统对你提交的产物做**自动化质检 + 准出判定**，并作为后续内测、灰测的准出标准。

### 审核在版本流程中的位置

应用插件版本会经历"开发中 → 审核中 → 审核完成 → 内测 → 上线"。审核系统介入其中的**审核中（reviewing）**&#x4E0E;**审核完成（reviewed）**&#x4E24;个阶段：审核通过则进入准出，可提交内测；审核驳回则退回开发中状态，整改后重新提审。

### 完整审核链路

```mermaid
flowchart TD
  A[提交提审包] --> B[提审包规范校验]
  B -->|缺件或结构错误| R1[直接驳回并提示补件]
  B -->|校验通过| C[四维并行审核]
  C --> D[质量审核]
  C --> E[效果审核]
  C --> F[安全审核]
  C --> G[UI 与基础产品设计审核]
  D --> H[综合审核结论]
  E --> H
  F --> H
  G --> H
  H -->|通过| P[准出 可提交内测]
  H -->|驳回| R2[整改清单回流开发者平台]
  R2 --> A
```

## 二、提审前准备：提审包清单

开发调试完成后，需通过打包工具生成提审包并提交以下产物。审核系统会**首先做完整性与结构校验**，必选项缺失或结构非法将**直接拒审**、不进入后续审核。提交前请对照下表逐项确认。

| 产物                | 是否必选 | 说明                                                               |
| ----------------- | ---- | ---------------------------------------------------------------- |
| **manifest**      | ✅ 必选 | 包含 meta（含隐私协议）、卡片固定字段绑定、鉴权/索权需求声明、服务通知/多任务需求声明等。                 |
| **Skill**         | ✅ 必选 | 描述模型应如何使用其背后能力的载体，是整个审核的一等公民输入。描述的准确性直接影响效果审核结论。                 |
| **MCP Server**    | ✅ 必选 | 提供原子工具能力。仅支持 Remote MCP Server，传输方式为 HTTP / SSE，**不支持本地 stdio**。 |
| **Widget（卡片）**    | ✅ 必选 | 将 MCP Server 返回的部分字段以更友好、可交互的形式呈现给用户。                            |
| **Full Page（全页）** | 可选   | 承载卡片难以承载的复杂信息与交互（如长列表、编辑修改等）。                                    |

## 三、审核维度总览

通过提审包规范校验后，系统会**并行触发四个维度**的审核，全部达标方可准出。下表为各维度的关注点与准出前提。

| 维度             | 审什么                      | 准出前提（概要）                |
| -------------- | ------------------------ | ----------------------- |
| **提审包规范**      | 产物完整性与结构合法性              | 必选项齐全、结构合法              |
| **质量审核**       | 工具协议、入参、错误处理的基础可用性       | 基础用例通过、无高危异常、响应时长达标     |
| **效果审核**       | 真实使用旅程下的体验与效果            | 综合体验达标、无一票否决项、关键场景无严重失败 |
| **安全审核**       | 权限合法合规 + 内容合规（唯一含人工最终判定） | 无高危权限、无权限差异、授权链路完整、内容合规 |
| **UI 与基础产品设计** | 卡片/全页的视觉、结构、交互规范         | 无硬性 FAIL、视觉不超限、三态齐全     |

## 四、各维度审核标准、常见驳回原因与规避建议

### 4.1 提审包规范校验

**审核标准：**&#x5BF9; MCP Server / Skill / Widget / Full Page / 服务通知 / 多任务等做完整性与结构合法性校验，必选项缺失或结构非法即直接拒绝。

| 常见驳回原因                               | 规避建议                                              |
| ------------------------------------ | ------------------------------------------------- |
| 必选产物缺失（如未提交 Skill、MCP Server、Widget） | 提交前对照第二章清单逐项确认，确保四类必选产物齐全。                        |
| manifest 结构非法、字段缺失或格式错误              | 使用官方打包工具生成 manifest，勿手工拼装；校验隐私协议、卡片字段绑定、索权声明均已填写。 |
| MCP Server 使用本地 stdio 传输             | 改用 Remote MCP Server，传输方式使用 HTTP 或 SSE。           |
| 产物结构与声明不一致（声明了但未打包进产物）               | 确保声明的能力与实际打包内容一一对应后再提审。                           |

### 4.2 质量审核

**审核标准：**&#x5BF9; MCP Server 的工具协议、入参约定、错误处理做自动化质检，覆盖基础功能用例与异常/边界用例（参数越权、边界值、错误格式等），保证基础可用。准出要求：基础用例通过率达标、无高危（阻断级）异常、工具响应时长达标。

| 常见驳回原因               | 规避建议                                            |
| -------------------- | ----------------------------------------------- |
| 基础功能用例失败，核心工具调用不通    | 提审前自行跑通所有工具的基础调用，确保正常入参下能稳定返回预期结果。              |
| 异常/边界输入未处理，出现崩溃或错误返回 | 对越权参数、空值、超长/超范围值、错误格式等做健壮性处理，返回规范错误码而非直接失败。     |
| 错误码不规范、错误信息缺失或无法定位   | 为每类错误定义清晰的错误码与可读的错误信息，避免笼统的通用报错。                |
| 工具响应时长超标             | 优化耗时接口，控制单次工具调用时延；对慢操作考虑异步或分步返回。                |
| 入参/出参 schema 与实际不符   | 保证 Skill/工具声明的入参与出参 schema 和真实行为一致，避免字段缺失或类型错配。 |

### 4.3 效果审核

**审核标准：**&#x57FA;于你的 Skill 模拟真实用户旅程生成评测集，抓取端到端结果并从多维度评分与归因。准出以"综合体验达标"为基准，并设有**一票否决项**；关键维度出现严重失败会直接影响结论。评分更贴近真实用户的主观体验，而非仅看最终结果快照。

:::info 提示

**一票否决项**（命中任一即不通过）：① Skill description 与实际能力不匹配；② 拟真用户在使用旅程中产生明确投诉。请务必重视 Skill 描述的准确性。

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

:::

| 常见驳回原因                              | 规避建议                                              |
| ----------------------------------- | ------------------------------------------------- |
| Skill description 与工具实际能力不符（触发一票否决） | 如实、精准地撰写 Skill 描述，覆盖能力边界与适用场景，不夸大、不遗漏、不写与实际不符的功能。 |
| 关键场景体验差，用户旅程中出现明显卡点或投诉              | 以真实用户视角走查高频场景，确保结果准确、响应连贯、无重复下发或答非所问。             |
| 重复/冗余响应，交互体验随对话推进而下滑                | 避免重复返回相同内容；对"换一批""继续"等操作保证结果有实质变化。                |
| 结果准确性不足，与用户预期存在明显差距                 | 提升工具返回内容的准确性与相关性，覆盖主要用户群的典型诉求。                    |

### 4.4 安全审核（权限安全 + 内容安全）

**审核标准：**&#x5B89;全审核是**唯一保留人工最终判定**的环节，分为权限安全与内容安全两条线。准出要求：权限无高危项、权限声明与实际调用无差异、强依赖授权链路完整、内容合规无高危。外部报告呈现的是**人审后的最终结论**。

#### ① 权限安全

审查权限清单合法性（jsb 接口必须命中已开放权限列表）、敏感字段静态扫描（是否携带 phone / id\_card / token / location / 通讯录等高敏字段）、声明与实际调用的一致性、强依赖权限的授权链路完整性。

| 常见驳回原因                 | 规避建议                                                                   |
| ---------------------- | ---------------------------------------------------------------------- |
| 申请了未开放的 jsb 接口（直接拒）    | 仅申请平台已开放的权限接口，提审前核对权限清单是否都在开放范围内。                                      |
| 入参中携带高敏字段但未匹配相应权限分级    | 最小化采集敏感信息；确需使用 phone/id\_card/token/location/通讯录等字段时，按分级申请对应权限并说明使用场景。 |
| 权限声明与代码实际调用不一致（存在权限差异） | 保证权限清单声明的权限与实际调用严格一致，不多申请、不少声明。                                        |
| 强依赖权限的授权链路不完整、缺登录态或无兜底 | 为强依赖权限补齐登录态覆盖与失败兜底逻辑，确保授权链路闭环。                                         |

#### ② 内容安全

对暴露给用户的文案、卡片素材、服务通知做合规扫描（涉黄涉政、违禁、虚假宣传、诱导等），校验隐私协议与索权声明的一致性，并核验行业资质（金融/医疗/新闻等）与所声明能力的匹配性。

| 常见驳回原因                            | 规避建议                               |
| --------------------------------- | ---------------------------------- |
| 文案/素材/服务通知含违规内容（涉黄涉政、违禁、虚假宣传、诱导等） | 提审前自查所有对外文案与素材合规，杜绝夸大宣传、诱导点击、违禁表述。 |
| 隐私协议与实际索权声明不一致                    | 确保隐私政策中列明的信息收集范围与实际索权声明完全对应。       |
| 行业资质与声明能力不匹配（如金融/医疗/新闻类无相应资质）     | 涉及特殊行业能力时，提前准备并提交对应主体资质与合规材料。      |

### 4.5 UI 与基础产品设计审核

**审核标准：**&#x5BF9;卡片（Widget）、全页（Full Page）及其与模型的交互约定做静态扫描与视觉规范校验。存在硬性 **FAIL** 项必须修复后复审；WARN 项会计入质量分、影响后续灰度速度。

#### 视觉规范硬指标

| 规范项        | 要求               |
| ---------- | ---------------- |
| 卡片高度（含标题行） | ≤ 500dp          |
| 主标题字数      | ≤ 16 字           |
| CTA 按钮数量   | ≤ 3 个            |
| KV 字段行数    | ≤ 6 行（超出需折叠）     |
| 主色数量       | ≤ 3 种            |
| 圆角         | 卡片 12dp / 按钮 8dp |
| 暗色模式       | 必须适配             |

#### 结构与跳转规则

- 全页须为 **5 区固定结构**；
- 卡片 ↔ 全页状态需**双向同步**；
- 跳转必须携带 `conversation_id`；
- deep\_link **只传资源 id**；
- 卡片/全页须完整设计**正常态、空态、错误态**三态。

| 常见驳回原因                                          | 规避建议                                          |
| ----------------------------------------------- | --------------------------------------------- |
| 视觉指标超限（卡片过高、标题过长、按钮/字段/主色过多、圆角不符、未适配暗色）         | 按上方硬指标表逐项对照设计稿，超限内容做折叠或精简。                    |
| 缺少空态或错误态设计（三态不全）                                | 为每个卡片/全页补齐正常态、空态、错误态的展示与文案。                   |
| 全页结构不符 5 区规范，或存在全页跳全页                           | 严格采用 5 区固定结构，全页入口统一从卡片进入。                     |
| deep\_link 传了资源 id 以外的内容，或跳转缺少 conversation\_id | deep\_link 仅携带资源 id，所有跳转均带上 conversation\_id。 |
| 卡片与全页状态不同步                                      | 实现卡片与全页之间的双向状态同步，避免展示不一致。                     |

## 五、如何解读审核报告

审核完成后，你会在开发者平台收到一份**审核报告**。报告采用"结论先行"结构，请按以下顺序阅读。

### 1. 总体结论

| 结论                     | 含义与下一步                                |
| ---------------------- | ------------------------------------- |
| **通过（passed）**         | 四个维度全部通过，已准出，可提交内测。                   |
| **有条件通过（conditional）** | 存在建议改项（WARN），不阻断准出，但会影响后续灰度速度，建议尽快优化。 |
| **驳回（rejected）**       | 存在任一不准出项，需按整改清单修复后重新提审。               |

报告头部会给出**必改项数量**与**建议改项数量**，以及四个维度各自的状态（通过 / 不通过 / 警告），帮助你快速判断整改工作量。

### 2. 整改清单（核心）

整改清单是驳回时最重要的部分，为跨四个维度聚合的扁平问题列表，每条对应一个可执行的修复动作。字段含义：

| 字段      | 说明                                                     |
| ------- | ------------------------------------------------------ |
| 所属维度    | 质量 / 效果 / 安全 / UI                                      |
| 严重程度    | **必改（must\_fix）**：阻断准出，必须修复；**建议（suggest）**：不阻断，但影响灰度。 |
| 等级      | 高 / 中 / 低（风险或严重等级）。                                    |
| 问题摘要与说明 | 问题的对外描述。                                               |
| 定位信息    | 目标对象、字段、文件、行号（脱敏后），便于快速定位。                             |
| 建议动作    | 推荐的修复方式。                                               |
| 证据      | 脱敏后的样例或截图引用。                                           |
| 状态      | 待处理 / 已修复 / 已豁免（供复审追踪）。                                |

:::info 提示

**整改优先级建议：**&#x5148;处理所有**必改项**（决定能否准出），维度上优先**安全 > 质量 > 效果 > UI**，同维度内按**高 → 中 → 低**等级依次修复。

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

:::

### 3. 四维审核视图

报告还会分别给出质量、效果、安全、UI 四个维度的对外视图（是否达标、差距方向、失败项对外描述）。注意：报告仅呈现"是否达标 / 差距方向"，不展示内部阈值数值、评分明细与内部实现细节。

## 六、驳回后的整改、复审与申诉

1. **按整改清单修复**：优先完成全部必改项，建议改项一并优化以提升灰度速度。
2. **重新提审**：修复完成后通过复审入口重新提交，流程将**回到提审包规范校验**重新走完整审核。
3. **申诉**：若对结论有异议，可通过申诉通道提出（当前为飞书/邮件人工受理，后续将逐步自动化）。
4. **准出后**：总体结论为通过后，即可由管理员提交内测，继续后续上线流程。

## 附录：提审自检清单

提交审核前，建议逐项确认以下事项，可显著降低驳回概率。

- [ ] 四类必选产物（manifest / Skill / MCP Server / Widget）齐全，manifest 结构合法

- [ ] MCP Server 使用 Remote（HTTP / SSE），未使用本地 stdio

- [ ] 所有工具在正常入参下可稳定返回，异常/边界输入有健壮处理与规范错误码

- [ ] 工具响应时长达标，入参/出参 schema 与实际一致

- [ ] Skill description 与实际能力精准匹配（避免一票否决）

- [ ] 高频场景以真实用户视角走查通过，无重复下发或答非所问

- [ ] 仅申请已开放权限，敏感字段最小化并匹配分级，声明与实际调用一致

- [ ] 强依赖权限授权链路完整（含登录态与兜底）

- [ ] 对外文案/素材/服务通知合规，隐私协议与索权一致，行业资质齐备

- [ ] 卡片/全页视觉指标不超限、三态齐全、5 区结构、跳转规则合规
