HubPort 的能力规范是什么？设备接入的第一步为什么是定规范

HubPort 的能力规范是什么？设备接入的第一步为什么是"定规范"

设备接入 HubPort，第一步不是写驱动，而是定能力规范。

能力规范，就是统一描述设备"能做什么"的标准化语义层。它定义了一台设备对外提供哪些能力、每个能力怎么调用、数据是什么格式。

HubPort 把设备能力抽象为九类原子能力：属性、采集值、设定值、指令、任务、事件、数据流、图片、文件。任何设备接入，能力都被归入这九类，语义统一，接口一致。

为什么第一步是"定规范"？因为规范是驱动自动生成的基础。

协议文档上传后，AI 先分析接口、推导能力规范——这台设备有哪些能力、每个能力对应什么语义。规范定了，驱动代码照着规范生成，点位物模型照着规范配置。规范准，后面全对；规范错，后面全错。

这和传统物模型的区别在于：更贴近 AI 调用语义，不只是数据点定义。

传统物模型定义的是"有哪些数据点"，能力规范定义的是"能做什么事"。前者是数据视角，后者是能力视角。AI 调用的是能力，不是数据点，所以能力规范天然更适合 AI 调用。

接入工作流是这样的：协议文档 → 提取接口 → 推导能力规范 → 生成驱动。每一步都有标准，每一步都可验证。

接口文档，一丢就通。设备接入的第一步是定规范，规范定了，驱动自动生成，接入自动化。