Headless · Zion BaaS

Headless 模式下，前端在 Zion 编辑器之外开发——自有代码库（React、Next.js、Vue、小程序等），或通过 Cursor、Claude Code、Codex 等 AI 编程工具构建。

Zion 提供基于 PostgreSQL 的全托管后端；AI 工具还可通过官方 Plugin或 MCP 直接连接项目，开发数据模型、行为流与前端对接。编辑器中的配置通过标准 GraphQL API 对外暴露。

后端提供的能力

以下每个板块都在 Zion 编辑器中可视化配置、由同一套后端提供，并自动暴露为 GraphQL API——无需自行开通或拼接多个服务。

板块	提供的能力	GraphQL 访问方式
数据库	可视化设计的 PostgreSQL 数据表，支持关联、约束、索引与计算字段	Query、Mutation 与 `[table]_aggregate` 聚合
行为流 (Actionflow)	服务端业务逻辑——支持同步与异步、条件分支、循环与事务	同步 `fz_invoke_action_flow`；异步任务 + 结果 Subscription
AI 智能体 (Agent)	原生大模型智能体，支持 RAG（知识库）、工具调用、结构化 / 流式输出，运行在你的数据上下文中	会话 Mutation + 流式 Subscription
第三方 API (TPA)	导入 OpenAPI 规范，通过后端作为带鉴权的中继调用外部服务	导入后可通过 GraphQL 调用
支付	内置微信支付、支付宝等支付渠道，支持一次性与订阅付费	支付相关 Mutation
账号体系与鉴权	内置用户体系，支持注册 / 登录与多种登录方式（含微信登录）	请求头携带 JWT 会话令牌
权限	数据库层的行级安全 (Row Level Security, RLS) 与角色权限控制 (RBAC)	每次操作自动强制校验
文件与资源存储	二进制与图片上传，自带 CDN 加速	直传 URL (presigned) + 文件 ID 写入业务表
实时数据	数据变更时实时推送	通过 WebSocket 的 GraphQL Subscription

Zion 是基于 PostgreSQL 的后端即服务 (BaaS)——一个可视化配置的真实托管后端，而不是简单的数据库控件。无论你在 Zion 内完成整个应用，还是仅将其作为 Headless 后端，以下优势都成立。

优势	说明
原生 PostgreSQL	真正的关系型数据库——索引查询、真实关联、外键与约束。不是 JSON blob / NoSQL 抽象，数据始终保持正确。
ACID 事务	复杂逻辑在失败时可干净回滚。行为流 (Actionflow) 支持事务——支付、金融、B2B 场景不可或缺。
可视化服务端逻辑	行为流以可视化方式实现业务规则（同步与异步），无需写代码，也没有 Edge 冷启动。逻辑可见、可追踪，而非黑盒。
自动生成 GraphQL API	每个项目都是一套类型安全的 API。前端按需取数，接口通过自省 (introspection) 自说明。
级联单请求加载	关联数据在服务端解析，相关联的多张表在一次请求中返回，避免 N 次往返。
原生 AI 智能体	AI 运行在你的数据上下文中，支持 RAG、工具调用与结构化输出——而非外挂模型拼接独立数据库。
数据库层安全	数据库层的行级安全 (RLS) 与角色权限 (RBAC)，实现真正的多租户隔离，并支持单点登录 (SSO) 等企业级合规能力。
无供应商锁定	可导出前端、直接访问数据，底层为标准 PostgreSQL。
全托管	自动索引与基础设施最佳实践由平台处理——无需自建和运维服务器。
可预测的定价	基于资源、可预估，而非不透明的按次计费。

由于后端与 Zion 自带前端解耦，Headless 让你可以：

外部前端通过统一的 GraphQL 端点与 Zion 通信。将 {projectExId} 替换为真实项目 ID。

HTTP 端点（Query 与 Mutation）：


https://zion-app.functorz.com/zero/{projectExId}/api/graphql-v2

WebSocket 端点（Subscription）：


wss://zion-app.functorz.com/zero/{projectExId}/api/graphql-subscription

在 Zion 编辑器顶部导航打开 「连接后端」 弹窗，即可复制端点与高权限的 Admin Token。弹窗内内置 GraphiQL 面板，可基于真实 schema 直接编写并测试 GraphQL 语句。

⚠️

Admin Token 具有最高权限，仅限本地开发或受信任的服务器环境（如 Node.js 服务端）使用。切勿泄露或硬编码在暴露给终端用户的纯前端代码中。

完整 API 结构请参阅 API 结构文档。

我们提供 Plugin、MCP、Skill，帮助 AI 编程工具更好地连接和开发 Zion 后端。

适用： Cursor 2.5+、Claude Code、Codex

能力： MCP + zion-platform Skill + Hook

安装： Zion 无代码 Plugin

Claude Code（终端）


claude plugin marketplace add functorz-tech/zion-nocode-plugin
claude plugin install zion-nocode@zion

Claude Code 内执行


/plugin marketplace add functorz-tech/zion-nocode-plugin
/plugin install zion-nocode@zion
/reload-plugins

Codex


codex plugin marketplace add functorz-tech/zion-nocode-plugin
codex plugin add zion-nocode@zion
codex plugin list | grep zion

Cursor
- 团队 / 企业：管理员将 Git 仓库添加为团队市场，成员安装 zion-nocode
- 本地 / 开发
```
ln -s "$PWD/plugin" ~/.cursor/plugins/local/zion-nocode
```

需要 Node.js 18+。认证：npx -y zion-mcp@latest login

适用： Windsurf、Cline、Claude Desktop、Qoder、Trae 等支持 MCP 的工具

能力： 连接项目，读取 schema、行为流、数据绑定与运行时日志

安装： 在工具的 MCP 配置中添加：


{
  "mcpServers": {
    "zion": {
      "command": "npx",
      "args": ["-y", "zion-mcp@latest", "mcp"]
    }
  }
}

需要 Node.js 18+。认证：npx -y zion-mcp@latest login

适用： 任意 AI 编程工具；可与 MCP 组合使用

能力： GraphQL 对接规范，不连接项目，需自行提供端点、Admin Token 与 schema

安装：


请仔细阅读并安装以下仓库的开发技能:
https://github.com/functorz-tech/zion-baas-skill


npx skills add https://github.com/functorz-tech/zion-baas-skill -g

💡

在编辑器中手动修改后端后，点击 同步变更，并告知 AI 重新读取后端结构。

若你希望在 Zion 编辑器内同时完成 UI 与后端——拖拽组件、数据绑定、Mirror 预览——那是平台原生开发，不是 Headless。请参阅认识编辑器与 Hello World 实战。