一份契约要说清什么
契约怎样对应到设备
在同一命名范围内,operation_id 和 contract_version 共同确定动作含义。不同设备使用同名同版契约时,参数含义、单位和完成要求必须一致。
契约对应到具体设备实现时,绑定键至少包含:
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
说清一项动作的名称、参数、前置条件、结果和完成证据。
| 内容 | 需要说明 |
|---|---|
| 标识和版本 | 动作名称、契约版本和命名范围 |
| 输入 | 参数类型、必填项、单位、范围、枚举和跨字段限制 |
| 对象条件 | 需要哪些容器或样品,各自承担什么角色,动作前必须是什么状态 |
| 系统条件 | 设备状态、安全限制、资源占用和超时规则 |
| 结果 | 实际参数、对象变化、设备状态和诊断的返回格式 |
| 完成条件 | 哪些可观测结果都满足时才能返回 succeeded |
| 证据 | 使用哪个传感器、设备读数或人工检查,以及时间、单位、误差和有效期 |
operation_id 和 contract_version 共同确定动作含义。不同设备使用同名同版契约时,参数含义、单位和完成要求必须一致。
契约对应到具体设备实现时,绑定键至少包含:
设备编号 + 动作名称 + 契约版本 → 指定适配器实现