> ## 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 契约向量（Symphony API Contract Vector，SACV）在整个平台范围内治理带版本的 API 契约。其引擎是一个可独立安装的 C++ 进程，执行有界的 OpenAPI 3.2.0 JSON 验证、确定性的兼容性差异比较，并生成一次性清单。端点语义仍归拥有该领域的向量或模块所有；SACV 治理的是契约结构与兼容性。

## 操作

* **检查与校验（Inspect and check）**：验证 OpenAPI 3.2.0 JSON 文档是否符合有界配置。
* **差异比较（Diff）**：计算契约版本之间确定性的兼容性差异。
* **提议（Propose）**：接受调用方针对新增或变更契约声明的注册表提议。
* **投影（Project）**：为审查者和下游工具输出一次性清单。

## SACV 治理的内容

SACV 约束：

* 契约结构（采用 SACV 配置的 OpenAPI 3.2.0）
* 版本之间的兼容性分类
* 已接受契约的注册表成员资格

它不会：

* 拥有端点语义（由各向量或模块自行保留）
* 生成 SDK、发布工件或签发令牌
* 暗示存在实际的网络界面（提及未来的私有 API 并不会创建该 API）

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

## 相关界面

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

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

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

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


## Related topics

- [快速入门：探索 QuanuX Symphony](https://docs.quanux.org/symphony/cn/quickstart.md)
- [QuanuX Symphony 文档](https://docs.quanux.org/symphony/cn/index.md)
- [Symphony Vector 与交付阶段](https://docs.quanux.org/symphony/cn/concepts/vectors.md)
- [QuanuX Symphony 平台准则](https://docs.quanux.org/symphony/cn/doctrine.md)
- [SODV：官方文档与发行治理](https://docs.quanux.org/symphony/cn/skv/sodv.md)


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