> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/architecture/flows-on-tinyflows.md).

# TinyFlows 上的流程

OpenHuman 如何组合 TinyFlows 模块：总线契约、作用域存储、运行回调、触发器以及宿主安全边界。

OpenHuman 的 flows 域负责已保存自动化的产品表面：RPC 和智能体工具、触发器订阅、主机策略，以及将工作流节点连接到 OpenHuman 服务的回调。TinyFlows 模块负责可移植的工作流引擎、Catalog 和 Runs 的行为、调度服务，以及 Copilot 提示词。OpenHuman 通过 `tinyflows-bus`；它不会在核心内运行一份工作流引擎副本。

本页描述组合边界。该 [智能体运行框架](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/architecture/agent-harness.md) 本页说明 OpenHuman 智能体轮次如何在工作流 `智能体` 节点调用主机的智能体能力。

## 组件与归属

| 组件                  | 职责                                         |
| ------------------- | ------------------------------------------ |
| `tinyflows-module`  | 工作流图验证与执行、Catalog 和 Runs 操作、调度，以及提示词编写。    |
| `tinyflows-bus`     | 同步方法名称、请求/响应 DTO、图 JSON，以及回调契约。            |
| `openhuman::flows`  | 工作流 RPC 和工具、事件到运行的分发、主机策略，以及类型化总线适配器。      |
| `CatalogStorage` 回调 | 在捕获的存储作用域下，为 Catalog 提供访问当前工作区后端的能力。       |
| `CapsHost` 回调       | 将工作流能力连接到 OpenHuman 的推理、智能体、工具、HTTP、代码和记忆。 |
| `openhuman::cron`   | 提交并移除调度作业；TinyFlows 调度服务通过主机触发器接收端触发它们。    |

```mermaid
flowchart LR
  rpc[流程 RPC、工具和事件订阅者] --> host[OpenHuman 流程适配器]
  host -->|编写 / Catalog / Runs / 调度| module[TinyFlows 模块]
  module -->|CatalogStorage| storage[主机存储后端]
  module -->|CapsHost| caps[OpenHuman 能力与策略]
  schedule[OpenHuman cron 适配器] -->|调度总线| module
  module -->|运行事件| host
```

总线契约描述线上数据和回调形状。模块实现和产品策略仍归各自所有者负责：图规则和执行属于 TinyFlows，而 OpenHuman 负责执行范围、审批、沙箱隔离、Composio 访问以及主机工具分发。

## 编写与安全保存

图以 JSON 形式跨越主机边界。OpenHuman 调用 TinyFlows 的 Authoring 成员执行迁移、验证、图兼容性、导入规范化以及构建器故障处理。模块将规范化后的图提供给有作用域的主机门控，以进行 OpenHuman 特有检查，例如智能体引用是否可解析、Composio 连接是否属于所选工具包、本地上传路径是否仍位于工作区内，以及所需的工具参数是否齐全。

Catalog 负责保存语义。其 `PutWorkflow` 操作决定自动工作流是否必须以禁用状态启动、具有副作用的工作流是否需要审批，以及将手动触发器更改为自动触发器的更新是否应停用工作流。把这些决定保留在模块中，并通过其回调传递主机特定的分类或标识。

flows 工具和画布都会调用这些相同的模块操作。草稿晋升也使用 Catalog 路径，因此会继承相同的检查和写入行为。每个被接受的更新都会映射到 OpenHuman 现有的 RPC 和事件契约。

## 运行生命周期

一次运行通过 Runs.StartRun 启动。OpenHuman 提供受信任的运行来源、执行存储作用域和回调地址；TinyFlows 模块负责运行状态、检查点、准入、执行、取消和恢复规则。OpenHuman 轮询模块的运行事件，并将其映射到既定的 RPC、进度、审批和 Langfuse 表面。

`runs_adapter::RunBindings` 在轮询报告终态结算之前，保留受作用域约束的 CatalogStorage 和每次运行的 CapsHost 注册。等待审批而暂停的运行会保持这些回调处于激活状态。恢复会创建一个新的 CapsHost 注册，同时保持相同且稳定的 CatalogStorage 地址。

当工作流包含智能体节点时，模块会调用 OpenHuman 的智能体能力。主机会解析已配置的智能体，并调用其他产品表面所使用的同一 Agent 运行时。该流程的受信任来源、自主级别、审批策略，以及智能体自身的工具作用域和沙箱，仍然由 OpenHuman 决定。

自动触发器使用相同的 Runs 路径。OpenHuman 绑定并移除 `JobType::Flow` 条目通过 Schedule 总线契约；cron 将触发载荷返回给流程订阅者。Composio 触发器沿用现有的集成事件路径。一个触发器只会选择一个运行请求；它不会创建第二个执行引擎。

## 存储迁移

Catalog 和 Schedule 拥有各自的存储模式。在启动时，OpenHuman 会在流程恢复、调度对账或 TTL 清理之前，对每个发现的存储作用域执行两个所有者的迁移操作。这些操作会在可选主机服务启动之前运行，因此 Catalog 迁移失败只会在流程域中报告，不会阻塞聊天、登录或无关的存储作用域。

旧版 TinyFlows 文件由其中的纯读取器读取 `tinyflows-import` 并通过 Catalog.ImportLegacyBatch 重放。这些文件不会被打开用于写入，也不会被删除。只有在每个读取器和所有者批次都顺利成功后，OpenHuman 才会记录导入标记。失败或不完整的本地导入会暂停该作用域的工作流访问，并在下次启动时重试；其他核心域继续运行。未启动的本地存储回退会在首次使用时迁移 Catalog 的模式，并且刻意不导入旧版文件。

## 安全边界

`flows_run` 和 `flows_resume` 在调用 Runs 之前建立受信任的自动化来源。Capsule 回调会在节点可以使用本地工具、Composio、HTTP、代码或记忆之前应用 OpenHuman 的自主策略。本地流程工具使用与其他 OpenHuman 界面相同的本地工具注册表，并由 CapsHost 附加流程特定的审批上下文。智能体节点也在流程来源下运行，然后应用所选智能体的 ToolScope、沙箱和迭代上限。

这使引擎执行保持通用，同时保留主机保证。模块节点不能通过更改图数据来选择不同的工作区、存储作用域或安全策略。

## 查看位置

* `crates/openhuman-core/src/flows/ops/` 包含主机操作及其组合出的总线调用。
* `crates/openhuman-core/src/flows/host_gates/` 包含对规范化图 JSON 的 OpenHuman 编写门控。
* `crates/openhuman-core/src/flows/catalog_storage.rs` 提供受作用域约束的 CatalogStorage 回调。
* `crates/openhuman-core/src/flows/caps_host/` 提供每次运行的能力和工具分发。
* `crates/openhuman-core/src/flows/runs_adapter/` 负责运行回调生命周期、轮询和 RPC 投影。
* `crates/openhuman-core/src/storage/import/tinyflows.rs` 按顺序执行所有者迁移和有边界的旧版读取器。
* `vendor/tinyflows/crates/tinyflows-bus/` 定义契约；引擎和模块实现位于 TinyFlows 仓库中。

请参阅 [Flows 域 README](https://github.com/tinyhumansai/openhuman/tree/main/crates/openhuman-core/src/flows/README.md) 以获取 RPC 名称、编写门控和模块集成测试。
