Common Capability Contract 是让不同团队在最终硬件完成前共同工作的 shared boundary,描述的是 function,不是无限使用某 Resource 的 permission。
contract_id稳定 contract/Profile identifier。 ## C.Field - function
人类可读动作/结果,例如 locate_marks。 ## C.Field -
input_schema 版本化输入对象、单位、范围和必需文件。 ##
C.Field - output_schema 版本化结果、quality
fields、units、Evidence refs、error states。 ## C.Field -
resource_target HSIMC Resource 或 target class;真实
physical instance 单独绑定。 ## C.Field - execution_mode
simulation / physical_reference / physical_delivered / operational。
## C.Field - conditions
环境、tooling、calibration、material、prerequisites。 ## C.Field -
authority_required
discover/read/reserve/configure/execute/stop/accept/administer 所需最低
Authority。 ## C.Field - effect_identity 独立于短期
credential 的 intended physical effect digest/identifier。 ## C.Field -
operation_id 用于 retry/read-back 的稳定物理副作用请求
identity。 ## C.Field - freshness_requirement 用于
planning/authorization 的 observation 最大可接受年龄。 ## C.Field -
resource_locking reservation、lease、busy/conflict 和
release rule。 ## C.Field - safety_boundary
必须留在本地/deterministic、不委托远程模型的条件。 ## C.Field -
acceptance measurement、tolerance、Evidence 与
human/organization acceptance。 ## C.Field - recovery
stop、unknown-result、network interruption、restart behavior。 ##
C.Field - version
contract、adapter、algorithm、hardware/BOM、calibration、deployment
refs。 ## C.Field - cost_time
预期/实际时间、材料、能源、money cost。 ## C.Field - rights
contribution、reuse、attribution、confidentiality、withdrawal
constraints。
locate_marks{
"contract_id": "hsimc.locate_marks.v0",
"function": "locate_marks",
"input": {"image_ref": "sha256:...", "marker_profile": "marker-profile-v3", "calibration_ref": null},
"target": {"resource_id": null, "mode": "simulation"},
"authority": {"subject": "bound-at-runtime", "scope": ["read_input", "run_observation"]},
"output": {"coordinate_space": "pixels", "marks": [], "quality": {}, "evidence_refs": []},
"limits": ["No millimetre conversion without calibration evidence", "Observation only; no machine motion or laser action"]
}同一 contract 可以运行于 fixed image、cloud simulator、remote reference camera 或 delivered device,但每个 target 都需要自己的 adapter 和 Evidence。
请求相同 physical effect 时 retry 复用原
operation_id;结果未知时先 query 原 operation,再考虑新
effect。更新 credential/token 本身不会创建新的 physical Work。