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, and this page is available as Markdown at /apps-plugin/docs/release/review-guidelines.md.

审核标准

提示

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

一、审核系统概述

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

审核在版本流程中的位置

应用插件版本会经历"开发中 → 审核中 → 审核完成 → 内测 → 上线"。审核系统介入其中的审核中(reviewing)与审核完成(reviewed)两个阶段:审核通过则进入准出,可提交内测;审核驳回则退回开发中状态,整改后重新提审。

完整审核链路

二、提审前准备:提审包清单

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

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

三、审核维度总览

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

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

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

4.1 提审包规范校验

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

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

4.2 质量审核

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

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

4.3 效果审核

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

提示

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

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

4.4 安全审核(权限安全 + 内容安全)

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

① 权限安全

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

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

② 内容安全

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

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

4.5 UI 与基础产品设计审核

审核标准:对卡片(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_iddeep_link 仅携带资源 id,所有跳转均带上 conversation_id。
卡片与全页状态不同步实现卡片与全页之间的双向状态同步,避免展示不一致。

五、如何解读审核报告

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

1. 总体结论

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

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

2. 整改清单(核心)

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

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

整改优先级建议:先处理所有必改项(决定能否准出),维度上优先安全 > 质量 > 效果 > UI,同维度内按高 → 中 → 低等级依次修复。

3. 四维审核视图

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

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

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

附录:提审自检清单

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

  • 四类必选产物(manifest / Skill / MCP Server / Widget)齐全,manifest 结构合法

  • MCP Server 使用 Remote(HTTP / SSE),未使用本地 stdio

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

  • 工具响应时长达标,入参/出参 schema 与实际一致

  • Skill description 与实际能力精准匹配(避免一票否决)

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

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

  • 强依赖权限授权链路完整(含登录态与兜底)

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

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