跳轉到主要內容
Symphony API 合約向量(Symphony API Contract Vector,SACV)治理整個平台中具版本的 API 合約。其引擎是一個可獨立安裝的 C++ 程序,負責執行有界的 OpenAPI 3.2.0 JSON 驗證、確定性的相容性差異比對,以及可拋棄的清單。端點語意仍歸屬於擁有該領域的向量或模組;SACV 治理的是合約結構與相容性。

操作

  • Inspect 與 check:驗證 OpenAPI 3.2.0 JSON 文件是否符合有界設定檔。
  • Diff:計算合約版本之間確定性的相容性差異。
  • Propose:接受由呼叫者宣告、針對新增或變更合約的登錄檔提議。
  • Project:為審查者與下游工具輸出可拋棄的清單。

SACV 治理的範圍

SACV 約束:
  • 合約結構(採用 SACV 設定檔的 OpenAPI 3.2.0)
  • 版本之間的相容性分類
  • 已接受合約的登錄檔成員資格
它不會:
  • 擁有端點語意(由各向量或模組自行保有)
  • 產生 SDK、發布產出物或核發權杖
  • 暗示存在即時的網路介面(提及未來的私有 API 並不會因此建立該 API)
SACV 僅支援讀取、查詢、驗證與提議。所有 SKV 引擎皆已停用程式化的標準套用。

相關介面

SKV 概覽

總體框架與 Contract Quad 模型。

SODV

治理任何在 SACV 註冊之合約的官方發布。

SAV

評估已宣告元件之間的組合與相容性。

qxctl 向量命令

執行 qxctl sacv ... 進行 inspect、check、diff 與 propose。
最後修改於 2026年10月10日