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。