# 技術契約

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

查閱編排、執行、部署和整合的準確結構與協議。

具體欄位、範圍和協議行為，以連結中的原始碼契約為準。這些參考固定在文件案例所使用的產品版本。

## 編排

Control API 定義節點查詢、讀取、編輯、驗證、發布、執行、工作流程檔案和輸入來源。節點編排指南說明業務設定如何轉換為產品的執行定義。

AI 助手編輯前應查詢目前部署端的節點結構和目錄。[AI 助手編排指南](https://openflow.run/zh-tw/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)