HSIMC · UN Six-Language White Paper · P6 / W0-017

Appendix C - Common Capability Contract

Common Capability Contract 是让不同团队在最终硬件完成前共同工作的 shared boundary,描述的是 function,不是无限使用某 Resource 的 permission。

C.Field - 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。

C.1 示例 - 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。

C.2 Retry/effect rule

请求相同 physical effect 时 retry 复用原 operation_id;结果未知时先 query 原 operation,再考虑新 effect。更新 credential/token 本身不会创建新的 physical Work。