> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# SACV：QuanuX Symphony 的 API 契约治理

> SACV 通过有边界的 OpenAPI 3.2.0 检查、确定性的兼容性差异比较、调用方声明的提议以及清单，治理带版本的 API 契约。

Symphony API Contract Vector（SACV，Symphony API 契约向量）负责治理整个平台中带版本的 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 并不会创建它）

> [!NOTE]
>
> SACV 仅支持读取、查询、验证和提议。所有 SKV 引擎的程序化规范 apply 均处于禁用状态。

## 相关界面

> [card] [SKV 概览](https://docs.quanux.org/symphony/zh-Hans/skv/overview.md)
>
> 总体框架与 Contract Quad 模型。

> [card] [SODV](https://docs.quanux.org/symphony/zh-Hans/skv/sodv.md)
>
> 治理任何已在 SACV 注册的契约的官方发布。

> [card] [SAV](https://docs.quanux.org/symphony/zh-Hans/skv/sav.md)
>
> 评估所声明组件之间的组合与兼容性。

> [card] [qxctl 向量命令](https://docs.quanux.org/symphony/zh-Hans/qxctl/vector-commands.md)
>
> 运行 `qxctl sacv ...` 以执行 inspect、check、diff 和 propose。


## Related topics

- [快速入门：探索 QuanuX Symphony](https://docs.quanux.org/symphony/zh-Hans/quickstart.md)
- [QuanuX Symphony 文档](https://docs.quanux.org/symphony/zh-Hans/index.md)
- [QuanuX Symphony 平台准则](https://docs.quanux.org/symphony/zh-Hans/doctrine.md)
- [Symphony Vector 与交付阶段](https://docs.quanux.org/symphony/zh-Hans/concepts/vectors.md)
- [Symphony Quantitative Vector：框架契约](https://docs.quanux.org/symphony/zh-Hans/vectors/sqv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.