登录页已经完成，相关测试通过。
日常的工作对话…
支付回调还有一个失败用例，需要继续排查。
把发布文档列入下一步计划。
···更多 Agent
1flowbase保存对话 · 构建应用长出可持续使用的应用！
项目进展报表
基于 Agent 对话数据 · 构建示例
已完成12
需处理3
待开始5
| 事项 | 状态 | 数据来源 | 更新时间 |
|---|---|---|---|
| 登录页开发 | 已完成 | Claude Code | 11-06 10:24 |
| 支付回调异常 | 需处理 | Codex | 11-06 11:03 |
| 发布文档 | 待开始 | 你 | 11-06 11:20 |
| 用户反馈功能 | 进行中 | Claude Code | 11-06 09:12 |
| 性能优化 | 待开始 | 更多 Agent | 11-06 08:45 |
任务状态概览 · 示例数据
已完成12/20 12
需处理3/20 3
待开始5/20 5
接入与记录范围由你配置。以下为示例对话。
Claude Code登录页已经完成，相关测试通过。
Codex支付回调还有一个失败用例，需要继续排查。
你把发布文档列入下一步计划。
报表从对话中提取业务数据
知识库沉淀团队经验与知识
业务工具构建专属的工作应用
三种 AI 协议，一个 GATEWAY
Anthropic MessagesOpenAI Chat CompletionsOpenAI Responses
系统架构
分层看 1flowbase：业务怎么用，技术怎么搭。
- L1使用者谁在使用业务用户在权限范围内操作应用管理员配置模型、权限与工作空间Agent通过 MCP 调用已开放能力AI 应用 / SDK把 1flowbase 当作模型入口
- L2接入渠道从哪里进入GUI 控制台图形界面查看与管理MCP / WebMCPlist / get / call 渐进发现工具兼容模型 APIAnthropic Messages · OpenAI Chat / Responses
- L3业务应用你构建的应用（示例）知识库整理可复用知识业务管理基于自有数据的业务工具报表汇总并展示数据用量分析分析模型与 Token 使用
- L4平台能力1flowbase 提供AI Gateway协议翻译 · 模型调度 · 对话日志应用后端数据模型 · CRUD API · WorkflowReact Block原生 React / TSX 界面区块
- L5业务资源被使用的资源模型供应商OpenAI · Anthropic · Gemini · DeepSeek …业务数据你定义和管理的数据对话记录按配置保留与授权访问文件上传文件与附件
自上而下：使用者经接入渠道使用业务应用，业务应用建立在平台能力之上，平台能力调度底层资源；治理贯穿每一层。业务应用为场景示例，需按需配置与开发。
- L1前端层web 容器React 控制台React 19 · antd 6 · TanStack Router · Zustand · ViteNginx静态资源托管 · /api 反向代理到 api-server
- L2协议适配层api-server · AxumHTTP / SSEREST 与流式响应WebSocket长连接交互MCP / WebMCPAgent 工具协议模型兼容入口Anthropic · OpenAI 协议
- L3统一接口层interface-runtimeDefinition / Binding每个入口唯一绑定冻结执行计划Registry snapshot认证关联调用身份不可变终态收尾取消 · 超时 · 有界收尾
- L4应用服务层control-planeUse Case业务决策与状态写入口事务与审计命名 service commandaccess-control权限目录 · 角色 · 授权
- L5运行时层runtime-*runtime-coreRegistry · Slot 引擎 · 六个 Runtime Portorchestration-runtime编排编译执行 · provider-routingruntime-extension-hostWorker 与插件进程生命周期
- L6存储适配层storage/*Durablestorage-durable-postgres · SQL · migrationEphemeral会话 / 缓存 / Lease · 内存或 RedisObject业务文件对象存储 driver
- L7领域与契约最稳定的核心domain领域对象 · 不变量 · 作用域*-contracts端口 trait · wire type · 错误契约
- L8基础设施外部依赖PostgreSQL 18db 容器 · 持久化与工作流状态上游模型 API经网络出口访问文件卷上传文件持久化
依赖只能自上而下指向更稳定的层，不允许循环（见仓库 api/crates/AGENTS.md）；横切关注点由 api-server 组合根装配进各层。
01 / 从网关开始
AI 基础设施，可以更进一步。
从一次模型调用开始，在自己的能力和数据之上，继续构建业务。
01
AI Gateway统一入口，连接不同模型。
通过插件接入 OpenAI、Anthropic、Gemini、DeepSeek、阿里云百炼或任意 OpenAI 兼容接口，在三种主流 AI 协议之间转换。每个网关应用都有独立的 Key、日志、监控与统计。
02
Workflow一个模型，也可以是一条工作流。
按模型名分发请求、在多个分支间兜底，或组合模型与工具形成新能力。发布后，像调用普通模型一样调用整条工作流。
03
会话与成本让每次对话，成为自己的资产。
每次经过网关的对话，连同模型、推理强度、状态、Token 与费用一起保存到 PostgreSQL；报表按模型和用户拆分用量。
04
API-first 后端从模型调用，走向业务系统。
定义数据模型与数据源，提供 CRUD API，并可定时运行工作流。每个应用都会发布自己的 OpenAPI 3.1 文档。
05
MCP Gateway让 Agent 按需发现系统能力。
通过 list、get、call 渐进式发现并调用工具；在控制台统一管理 MCP 实例、Tool 配置与第三方 MCP。
06
React 页面你的界面，直接用 React 构建。
用原生 React 区块搭建页面，在 UI 模式下原地编辑，还能让内置 AI 助手和你一起操作页面。
02 / 组合智能
让合适的模型， 做合适的事。
高能力模型负责规划与审计，更快、更低成本的模型负责执行。把整个工作流发布为一个虚拟模型。
按业务需要权衡能力、成本与速度。实际效果取决于选用的模型和任务。
一次 API 请求
01
规划主模型
02
执行工作模型
03
审计主模型
一个模型接口
03 / 看见运行中的系统
从能力组合，到真实运行。
编排网关应用、发布 API、追踪用量与成本，再和 AI 助手一起搭建页面。以下均为 1flowbase v0.5.0 的实际界面。
工作流编排：按模型名把请求分发到 Claude、GPT、Gemini 或 DeepSeek，再按顺序返回第一个可用的分支结果。
公开 API：每个应用都会发布 OpenAI 兼容、Anthropic 兼容与原生 Agent 接口，并附带 OpenAPI 3.1 文档。
统计：任务数、Token 总量、已记录费用与耗时，可按模型和用户拆分。
页面与 AI 助手：在 UI 模式下编辑控制台页面，内置 AI 助手在一旁协作。
MCP 管理：MCP 实例、Tool 配置与第三方 MCP 集中管理。
BUILT FOR AGENTS
同一个系统， 两种构建方式。
人使用 GUI 和内置 AI 助手，Agent 通过 MCP 访问同一个 API-first 运行时。让整个应用系统都能被理解、构建与管理。
探索文档01
list()发现有哪些工具
02
get()获取所需工具的完整定义
03
call()调用真正需要的能力
开放构建，持续完善。
官方 1flowbase MCP 实例已按能力分组提供上百个工具，工具描述与默认配置仍在持续优化。复杂应用场景下，目前仍建议让 Coding Agent 在 1flowbase 项目上下文中工作。
从你的场景出发
一个起点，更多可能。
企业 AI 团队
为不同团队统一分发 AI 能力，掌握自己的会话数据，在自己的基础设施上构建内部应用。
AI 产品团队
从 Gateway 继续扩展数据、API、工作流和界面，让每一层能力相互连接。
高级个人用户
构建自己的模型组合策略，再通过熟悉的模型 API 使用它。
实践指南
带着一个问题，找到下一步。
从适用场景和验证清单开始，再决定要构建什么。
01
浏览全部文章评估 AI 网关
判断统一入口是否适合你的应用，再用一个真实客户端验证。02组合模型与工具
把模型行为组织成可复用工作流，查看背后的调用过程。03排查一次 AI 运行
把执行证据连接到复盘结论，找到下一步需要验证的改动。bash
curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | shpowershell
irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iexcmd
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"需要 Docker 及所选模型供应商的访问权限。运行前，请先审阅部署脚本。
常见问题
开始之前，你可能想知道。
1flowbase 是什么？
1flowbase 是开源、可自托管的 AI Gateway 与 AI 应用运行时。它把模型接入、Workflow、完整会话数据、API、业务数据、MCP 与 React 界面连接在同一个系统中。
支持哪些 AI 协议？
当前支持 Anthropic Messages、OpenAI Chat Completions 与 OpenAI Responses 之间的协议转换。每个应用都会发布 /v1/messages、/v1/chat/completions、/v1/responses 与 /v1/models，以及支持 WebSocket、取消与恢复的原生 Agent API。模型与工作流都可以这样对外发布。
数据存储在哪里？
目前使用 PostgreSQL 作为主数据源，保存经过 Gateway 的完整 AI 会话，也支持业务数据。用于生产环境前，请评估存储容量、保留周期、备份策略及合规要求。
Agent 现在能直接构建完整应用吗？
底层运行时采用 API-first 架构，能力已通过 MCP 暴露，控制台也内置了 AI 助手。官方工具定义和 Agent 使用体验仍在优化；复杂应用场景下，建议提供项目源码上下文，不应假设已经可以完全自主配置。
开箱即用的应用模板已经上线了吗？
网关应用已经可以通过 Agent 模板配置，扩展中心也提供了应用模板入口；现成的业务应用模板仍在建设中，本网站不将其描述为已经完成的一键应用。
使用 1flowbase 需要付费吗？
1flowbase 基于 Apache License 2.0 开源。自托管所需的服务器、数据库和模型供应商可能产生各自的费用。
用 AI 构建。为 Agent 构建。
从小处开始，让底座保持开放。