Skip to main content

输入

输入是按照设备能力生成的设备技能描述。

输入示例

评估器读取的不是设备动作请求,而是能力说明文本及其结构。它检查内容是否足以生成和验证函数调用,不接触物理设备。 评估器检查:

评估实现逻辑

质量评估器先把设备技能描述解析为结构化章节和字段,再按检查项逐一判定,不依赖设备名称猜测能力。核心过程如下:
  1. 检查元数据、技能名称、请求分类和来源修订号是否存在;
  2. 对每个参数检查名称、类型、必填性、单位、范围、枚举和嵌套字段是否完整且可解析;
  3. 检查每项技能的三个维度是否完整,对前置条件、约束、状态变化、返回值和结果验证建立对应关系;
  4. 将强制缺失或矛盾记录为失败项,将可改善但不阻断的问题记录为建议项;
  5. 汇总得分、通过状态和逐项修订要求,作为是否进入技能库的唯一依据。
评估器不执行设备动作,也不修改原始能力数据。它的输出是可复查的评估报告:失败时输出具体缺失字段和修订动作,修订后必须重新解析全文并重新评分。

检查项

通过输出示例

以下示例展示一个总分 95、达到阈值但缺少整体流程约束章节的评估结果:

输出字段

准入判断

设备技能描述只有同时满足以下条件才能准入:
默认样例阈值为 60。阈值来自质量评估配置,不作为所有部署不可修改的协议常量。

不通过与修订

评估不通过时,仍使用同一报告结构:
  • passed=false
  • 失败项保留在 required_checksoptional_checks
  • fix_instructions 给出修订要求;
  • suggestions 给出非阻断建议。
修订后必须重新生成完整报告,不能只修改总分。

对 FSP 数据的补充检查

从 FSP 生成能力说明时还应检查:
  • 来源设备和修订号是否存在;
  • 每项技能的对象、控制和系统三个维度是否可解析且相互一致;
  • 控制参数和状态字段是否能够无损映射;
  • 系统安全围栏和结果验证是否进入说明;
  • 派生说明是否遗漏 FSP 强制约束。
这些检查可以加入部署采用的评分配置,但输出仍必须使用本页定义的报告字段。