# 技术契约

Source: https://openflow.run/zh-cn/docs/reference/contracts/
Language: zh-CN
Product version: 0.1.0-beta.77

查阅编排、执行、部署和集成的准确结构与协议。

具体字段、范围和协议行为，以链接中的源码契约为准。这些参考固定在文档案例所使用的产品版本。

## 编排

Control API 定义节点查询、读取、编辑、校验、发布、运行、工作流文件和输入来源。节点编排指南说明业务配置如何转换为产品的执行定义。

AI 助手编辑前应查询当前部署端的节点结构和目录。[AI 助手编排指南](https://openflow.run/zh-cn/docs/guides/agent-authoring/index.md)给出了请求模型和修订版本处理方式。

## 运行时

运行时契约规定受支持的 Node 兼容子集、代码能力、HTTP 访问、工作流调用、Artifact、工作流状态和失败分类，不授予任意安装 npm 包或访问宿主机资源的能力。

## 授权与事件

授权参考分别说明账号连接的使用声明、共享授权、执行快照和应用事件权限。集成 Connector 后端或托管事件回调时，应查阅这些契约。

## CLI 与 MCP

命令分发和 MCP 参考介绍传输与配置。两者与工作台调用同一套部署端服务，不单独提供持久化存储或执行权限。

## 版本兼容

兼容性契约记录已发布的模型和引擎边界。历史修订版本保留原有身份。新契约有要求时，需要同时升级部署端和使用方。

## 以 Markdown 阅读

每篇文档都提供 `index.md`，包含正文、产品版本、来源和案例文件链接。各语言的 `llms.txt` 索引列出可用页面。Markdown 不包含交互控件，仍保留案例输入、预期结果和运行前提。

## 资料来源

*   [docs/control/contracts/control-api.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/contracts/control-api.md)
*   [docs/authoring/node-authoring.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/authoring/node-authoring.md)
*   [docs/control/contracts/nodejs-runtime.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/contracts/nodejs-runtime.md)
*   [docs/control/flow-authorization.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/flow-authorization.md)
*   [docs/control/trigger-permissions.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/trigger-permissions.md)
*   [docs/distribution/command.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/distribution/command.md)
*   [docs/server/mcp.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/server/mcp.md)
*   [docs/control/contracts/compatibility.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/contracts/compatibility.md)