DISCLAIMER

FLUJO 是一个开源、本地优先的 AI 工作区。只需保存一次模型和应用连接，即可通过自然语言步骤或可视化流程构建可复用的 Agent，并检查它们运行时发生了什么。组合模型、工具和其他 Agent；分支、循环并移交任务；在聊天、后台自动化和外部应用中使用同一套配置。

你的工作区存储在自己的电脑上。云端模型和连接的服务会收到你发送给它们的请求。隐私和工作区控制。

连接 AI，创建 Agent，然后开始使用。演示截图展示的是 FLUJO 3.46.2 的真实界面；选择图片可查看大图。

觉得 FLUJO 太复杂、缺少某项功能，或遇到问题？加入 Discord 或提交 GitHub issue。只有了解问题所在，我们才能改进。

AI 设置 · 已连接的应用 · Agent 构建器 · 对话与调试 · 自动化 · 会议 · 角色与职责 · 集成 · 项目愿景

快速安装

安装程序会安装 FLUJO 以及 Git、Node.js、Python、uv 和 ripgrep 等常用工具运行时。它们会下载依赖项，因此需要连接互联网。

Windows 安装程序：下载最新版 flujo-setup.exe。

Windows PowerShell：

irm https://raw.githubusercontent.com/mario-andreschak/FLUJO/main/scripts/install.ps1 | iex

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/mario-andreschak/FLUJO/main/scripts/install.sh | bash

已经安装了 Node.js 22.x 系列中的 22.23.4+，或 24.x 系列中的 24.22.1+？ 运行已发布的软件包：

npx flujo-ai@latest

打开 localhost:4200，并保持 FLUJO 服务运行。某些已连接的工具需要额外的运行时或凭据。Shell 安装程序默认跟随开发分支；Windows 安装程序的版本和渠道请参阅发行说明。

所有安装选项 · Windows · Linux/macOS · npm · Docker · 从源代码构建

核心功能

AI 设置

• 选择提供商： OpenAI、Azure OpenAI、Anthropic、Google Gemini、X.ai、OpenRouter、受支持的订阅连接，或通过 Ollama 使用本地模型。
• 引导式或专家模式设置： 使用轻松易懂的引导流程、更快速的引导路径，或完整配置表单。使用前先测试已保存的连接。
• 订阅和 CLI 选项： Claude Subscription 使用 Claude Agent SDK；Codex 和捆绑的 Antigravity CLI 有各自的登录和主机要求。仍需遵守提供商的访问权限和用量限制。
• 重复使用和整理： 将连接放入文件夹、标记为收藏，并为不同的 AI 步骤选择不同的模型。
• 回退策略： 在开始生成输出或执行工具操作前，针对选定的限制或故障，按顺序尝试备用连接。

模型连接和支持的登录方式 · 模型设置 · 回退行为

已连接的应用（MCP）

通过 Model Context Protocol，让 Agent 访问文件、浏览器、API 和其他服务。

• 按需选择连接方式： 精选应用、MCP Registry、远程 URL、GitHub 仓库或本地命令。AI 辅助设置可帮助配置连接。
• 不止于工具： 浏览工具、资源和可重复使用的提示词；配置根目录，并在支持时选择启用模型采样。
• 连接前先检查： 在已连接服务的详情视图中调用工具并检查资源。保存连接和成功执行操作是两项独立检查。
• 交互式 MCP Apps： 兼容的工具可在聊天中返回界面。为连接启用 Apps；是否支持取决于服务声明的功能。
• 在 FLUJO 外重复使用： 通过 FLUJO 的本地 MCP 代理显式公开已配置的服务，供其他兼容客户端使用。

GitHub 设置和工具检查器

导入仓库，安装并构建其服务，配置运行命令，然后测试并保存连接。

工具检查器可让你直接浏览和调用已连接服务的功能：

已连接的应用指南 · GitHub 设置 · 交互式 Apps 和限制

Agent 构建器

从简单开始，再添加任务所需的结构。

• **简单模式：**像写食谱一样构建 Agent，每次用一个简单的自然语言步骤。
• **专家可视化模式：**在图中连接 Start、AI、已连接应用、Static、Subflow 和 Finish 节点。
• **分支与交接：**让模型根据对话选择下一个专长 Agent 或路径。
• **循环：**返回较早的步骤，再执行一轮。
• **子流程：**将另一个流程作为一个步骤重复使用，并可配置输入上下文和输出处理方式。
• **逐步设置范围：**为每个 AI 步骤选择模型、指令、工具和资源。运行前请检查 AI 生成的流程。

Easy 和 Expert 是同一 Agent 的两种视图。此录制以 Website Builder 为例。

分支、循环与编排

将一个节点连接到多个后续节点，然后说明其交接工具应在何种情况下选择各条路径。将一个节点连接回较早的步骤即可创建循环。组合使用这些模式，协调多个专长 Agent。

交接工具、循环和编排示例

可复用子流程

添加一个 Subflow 节点来调用另一个流程。选择它接收的上下文，以及其输出在父流程运行中的呈现方式。

节点参考 · 上下文和输出模式

对话与调试

• **集中管理所有 Agent：**在 Talk 中选择已保存的 Agent，然后开始或继续对话。
• **实时执行视图：**跟踪步骤和工具结果，并查看模型用量和上下文窗口计量器。
• **可视化调试器：**设置断点、逐步执行节点，并检查执行前后的状态。
• **可选的工具审批：**在工具调用运行前进行检查。审批用于控制操作；它们不会对本地程序进行沙箱隔离。
• **文件、音频和修订：**附加支持的文件或音频、编辑消息，或分支对话以尝试不同方向。

运行和调试 Agent · 聊天命令和动态引用

自动化

按计划运行已保存的 Agent，或在发生特定事件时运行。FLUJO 服务必须保持运行；可以关闭浏览器标签页。

触发条件	示例
计划	准备每日报告，或按自定义 cron 计划运行
Webhook	通过其他服务发出的经过身份验证的调用启动工作
文件更改	在受监视的文件夹中出现或更改文件时处理该文件
监视工具	轮询 MCP 工具，并对结果更改或新项目做出响应
网站更改	在获取的页面内容发生更改时做出响应
其他工作流完成	在工作流完成或失败后接续执行

选择启动工作的条件。每个已保存的触发器都有自己的运行历史记录和结果。

运行历史记录和 WhatsApp 示例

将 监视工具 触发器与 WhatsApp MCP 服务结合，即可构建自动回复程序。其运行取决于已连接的服务、账户访问权限和 Agent 配置。

工具故障、提供商限制和审批可能需要处理。计划补跑最多补上一次错过的触发；它不会重放所有错过的运行。刷新出错时，“触发器”页面会保留已保存的计划，并提供 重试。暂停操作的更改需等待确认；删除失败后仍可重试；请求卡住 30 秒后，控件会恢复可用。

自动化设置与恢复 · 计划触发次数的计算

会议 — 实验性功能

让多个 Agent 围绕一个主题展开共享对话。在 更多 → 会议 中选择参与者和主持方式。

此操作演示会预览设置，不会创建或运行会议。

较早的多 Agent 会议示例

Personas 和角色 — 实验性功能

Persona 是一位持续提供帮助的助手，拥有姓名、角色、记忆、对话和目标。查看其工作和记忆，调整设置，并暂停或停止持续执行的目标。在 设置 中启用实验性功能以探索 Personas。

跟随 Maya 的工作坊示例。其中三个“日”是压缩后的演示环节，包含操作人员的审核和更正；这并不能证明系统在经过数日后仍可无人值守地可靠运行。

Waves — 实验性功能

在同一处查看工作流及其关系，或在“日”视图中探索计划时间。概览为只读；预测与执行结果彼此独立。

外部工具集成

可在 Cline、Roo Code、Cursor、OpenAI SDK 客户端或其他兼容的 MCP 客户端中复用 FLUJO。

界面	用途
http://localhost:4200/v1	选择 flow-<your-flow-name> 模型，通过兼容 OpenAI 的 API 运行 Agent
http://localhost:4200/mcp-flows	通过 FLUJO 的 MCP 传输访问工作流
http://localhost:4200/mcp-proxy/<server-name>	复用已明确公开的 MCP 服务的工具和资源；代理目前仅支持 localhost

默认本地配置文件接受兼容性 API 密钥值；该值不用于身份验证。显式启用的所有者策略需要已签发的、有作用域限制的 bearer。这些接口受访问暴露和工作区访问规则约束；请参阅 API 参考。

FLUJO 将 Ollama 连接为模型提供方。它不会提供兼容 Ollama 的服务端点。

内置 API 文档

在运行中的应用内打开 /docs，查看可搜索的 HTTP 文档，其中包含聊天、对话、模型、工作流、MCP、自动化和管理功能的示例。该参考文档经过整理；路由清单涵盖源代码处理程序。

开发者和集成指南

入门和示例

1. 安装 FLUJO，然后打开 AI Setup → Connect AI。保存并测试模型连接。
2. 在 Connected Apps 下添加任务所需的工具；在连接工具前先测试一项操作。
3. 打开 Agents → Start simple，描述步骤，绑定模型和工具，为 Agent 命名，然后点击 Save。
4. 选择 Try it 与 Agent 对话。返回其编辑器更改指令，或使用 Expert 图表。
5. 手动运行成功后，如果任务需要，可添加自动化或连接外部客户端。

选择一个示例：

指南	演示内容
首次纯 AI 对话	从连接模型到获得回复的最短路径
咖啡占卜助手	从 GitHub 安装网页阅读工具，在聊天中使用它，并对照来源核验答案
网站构建器	复用通用 Agent 处理网站需求，然后审阅并修改其本地输出
与 Maya 一起规划	在恢复的演示会话中延续上下文、记忆和目标

日常使用和恢复 · 比较 Claude、Goose、Dify、n8n、OpenClaw 和 Hermes 的工作方式 · 完整文档

安装、更新和维护

各类设置的详细说明仍可查阅：

• Windows 安装程序、PowerShell 选项和更新
• Linux/macOS 安装和更新
• 运行已发布的 npm 包，包括数据路径和嵌入式启动器设置
• 从源代码构建，包括支持的 Node 版本和手动设置
• Docker，包括持久化卷、重建、工具运行时和 Apps 端口
• 企业代理、自定义证书和浏览器下载恢复
• Windows 卸载和备份指南

## 隐私和工作区控制

• **本地工作区存储：**模型、Agent、聊天记录和设置均保存在你的计算机上。云服务商和远程工具会收到其请求所需的数据，并可能另行收费。
• **凭据保护：**设置你自己的加密密码。公开的默认方式是混淆，而非私人保险库；历史明文记录需要显式修复。加密和迁移。
• **共享值：**在 Settings → Global variables 中存储一次凭据或值，然后将其绑定到模型和应用配置中。
• **工作区和备份：**分别整理项目，并进行备份和恢复。备份和便携式工作器快照可能包含凭据。工作区 · 迁移规则。
• **使用情况共享：**匿名的每日活跃信号默认开启。它包含版本、平台、安装元数据和每日变化的标识符，不包含提示词、密钥或对话内容。可在 Settings → Privacy & Usage 中控制共享和相关说明。

网络暴露

默认安装面向一位在 localhost 上操作的可信用户，不提供登录界面或单独的用户账户。Settings → Network access 控制的是网络暴露，而非身份验证。若要主动向局域网或公网开放，需要采取适当的身份验证控制措施；关于接受公共／共享托管的讨论仍未结束。选择工作区并不能实现用户隔离。

网络部署指南 · 隐私和费用 · 安全策略

路线图和成熟度

能力	当前范围
模型连接、聊天和可视化 Agent	已提供，包括分支、循环、子流程、调试和工具审批
AI 辅助流程生成	已提供；请检查生成的步骤和工具访问权限
MCP 连接和交互式 Apps	在服务能力和已记录的协议限制范围内提供
自动化触发器	服务运行时可用；请检查结果并恢复故障
工作区和便携式工作器	在其数据、身份验证和凭据迁移边界范围内提供
Meetings、Personas、Roles、持久化目标和 Waves	实验性功能；可能需要监督和故障恢复
MCP Skills、可恢复的子流程会话和部分生成器	可选实验功能；请参阅其功能标志和指南

项目状态 · 版本历史 · Persona 验收标准

项目愿景 — Soon(tm)

**世界：一个化身，一种声音，以及在后台进行的工作。**一个虚拟家园，将一切汇聚一处。

**集群：将 FLUJO 带入云端。**一台机器、十台机器、一百台机器——长期目标是让数千个 Agent 协同工作，使用受支持的 Claude/Codex 订阅访问权限和本地 MCP 配置副本。

这些是长期目标。相关方向包括实时语音、更完善的根目录／检查点支持，以及适用于小型设备的构建版本。请参阅当前项目状态，或提交功能请求。

贡献与社区

欢迎提交贡献、报告 Bug 和分享想法。阅读贡献者指南、挑选一个入门任务，或提交拉取请求。维护者另有一份发布流程。

• GitHub 问题 · Discord
• 项目作者：mario-andreschak · LinkedIn
• 产品原片和工作室 · 引导式演示
• 开发者须知、响应格式和调试选项

FLUJO 基于 MIT 许可证授权，由 PocketFlow 提供支持，并由 Cline、Claude Code 和满满的热爱打造。

额外内容：“一首关于 MCP 的悲伤歌曲”

Star 历史

生态系统