审核标准
本指南面向豆包开发者平台的对接开发者,帮助你在提交应用插件审核前理解审核标准、提前规避常见驳回原因,并在收到审核报告后快速完成整改与复审。审核是应用插件上线前的"准出闸门",只有通过审核的版本才能进入内测、灰测直至上线。
一、审核系统概述
审核系统对你提交的产物做自动化质检 + 准出判定,并作为后续内测、灰测的准出标准。
审核在版本流程中的位置
应用插件版本会经历"开发中 → 审核中 → 审核完成 → 内测 → 上线"。审核系统介入其中的审核中(reviewing)与审核完成(reviewed)两个阶段:审核通过则进入准出,可提交内测;审核驳回则退回开发中状态,整改后重新提审。
完整审核链路
二、提审前准备:提审包清单
开发调试完成后,需通过打包工具生成提审包并提交以下产物。审核系统会首先做完整性与结构校验,必选项缺失或结构非法将直接拒审、不进入后续审核。提交前请对照下表逐项确认。
三、审核维度总览
通过提审包规范校验后,系统会并行触发四个维度的审核,全部达标方可准出。下表为各维度的关注点与准出前提。
四、各维度审核标准、常见驳回原因与规避建议
4.1 提审包规范校验
审核标准:对 MCP Server / Skill / Widget / Full Page / 服务通知 / 多任务等做完整性与结构合法性校验,必选项缺失或结构非法即直接拒绝。
4.2 质量审核
审核标准:对 MCP Server 的工具协议、入参约定、错误处理做自动化质检,覆盖基础功能用例与异常/边界用例(参数越权、边界值、错误格式等),保证基础可用。准出要求:基础用例通过率达标、无高危(阻断级)异常、工具响应时长达标。
4.3 效果审核
审核标准:基于你的 Skill 模拟真实用户旅程生成评测集,抓取端到端结果并从多维度评分与归因。准出以"综合体验达标"为基准,并设有一票否决项;关键维度出现严重失败会直接影响结论。评分更贴近真实用户的主观体验,而非仅看最终结果快照。
一票否决项(命中任一即不通过):① Skill description 与实际能力不匹配;② 拟真用户在使用旅程中产生明确投诉。请务必重视 Skill 描述的准确性。
4.4 安全审核(权限安全 + 内容安全)
审核标准:安全审核是唯一保留人工最终判定的环节,分为权限安全与内容安全两条线。准出要求:权限无高危项、权限声明与实际调用无差异、强依赖授权链路完整、内容合规无高危。外部报告呈现的是人审后的最终结论。
① 权限安全
审查权限清单合法性(jsb 接口必须命中已开放权限列表)、敏感字段静态扫描(是否携带 phone / id_card / token / location / 通讯录等高敏字段)、声明与实际调用的一致性、强依赖权限的授权链路完整性。
② 内容安全
对暴露给用户的文案、卡片素材、服务通知做合规扫描(涉黄涉政、违禁、虚假宣传、诱导等),校验隐私协议与索权声明的一致性,并核验行业资质(金融/医疗/新闻等)与所声明能力的匹配性。
4.5 UI 与基础产品设计审核
审核标准:对卡片(Widget)、全页(Full Page)及其与模型的交互约定做静态扫描与视觉规范校验。存在硬性 FAIL 项必须修复后复审;WARN 项会计入质量分、影响后续灰度速度。
视觉规范硬指标
结构与跳转规则
- 全页须为 5 区固定结构;
- 卡片 ↔ 全页状态需双向同步;
- 跳转必须携带
conversation_id; - deep_link 只传资源 id;
- 卡片/全页须完整设计正常态、空态、错误态三态。
五、如何解读审核报告
审核完成后,你会在开发者平台收到一份审核报告。报告采用"结论先行"结构,请按以下顺序阅读。
1. 总体结论
报告头部会给出必改项数量与建议改项数量,以及四个维度各自的状态(通过 / 不通过 / 警告),帮助你快速判断整改工作量。
2. 整改清单(核心)
整改清单是驳回时最重要的部分,为跨四个维度聚合的扁平问题列表,每条对应一个可执行的修复动作。字段含义:
整改优先级建议:先处理所有必改项(决定能否准出),维度上优先安全 > 质量 > 效果 > UI,同维度内按高 → 中 → 低等级依次修复。
3. 四维审核视图
报告还会分别给出质量、效果、安全、UI 四个维度的对外视图(是否达标、差距方向、失败项对外描述)。注意:报告仅呈现"是否达标 / 差距方向",不展示内部阈值数值、评分明细与内部实现细节。
六、驳回后的整改、复审与申诉
- 按整改清单修复:优先完成全部必改项,建议改项一并优化以提升灰度速度。
- 重新提审:修复完成后通过复审入口重新提交,流程将回到提审包规范校验重新走完整审核。
- 申诉:若对结论有异议,可通过申诉通道提出(当前为飞书/邮件人工受理,后续将逐步自动化)。
- 准出后:总体结论为通过后,即可由管理员提交内测,继续后续上线流程。
附录:提审自检清单
提交审核前,建议逐项确认以下事项,可显著降低驳回概率。
-
四类必选产物(manifest / Skill / MCP Server / Widget)齐全,manifest 结构合法
-
MCP Server 使用 Remote(HTTP / SSE),未使用本地 stdio
-
所有工具在正常入参下可稳定返回,异常/边界输入有健壮处理与规范错误码
-
工具响应时长达标,入参/出参 schema 与实际一致
-
Skill description 与实际能力精准匹配(避免一票否决)
-
高频场景以真实用户视角走查通过,无重复下发或答非所问
-
仅申请已开放权限,敏感字段最小化并匹配分级,声明与实际调用一致
-
强依赖权限授权链路完整(含登录态与兜底)
-
对外文案/素材/服务通知合规,隐私协议与索权一致,行业资质齐备
-
卡片/全页视觉指标不超限、三态齐全、5 区结构、跳转规则合规