SuperAPI AI 工具集

zion-baas

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能用于把 Zion.app 作为无头后端(BaaS)来构建前端应用。Zion 将数据库、actionflow、第三方 API 与 AI 智能体统一暴露为单一 GraphQL API。HTTP 端点:https://zion-app.functorz.com/zero/{projectExId}/api/graphql-v2;WebSocket 端点:wss://zion-app.functorz.com/zero/{projectExId}/api/graphql-subscription。

认证:访问受保护端点需先登录或注册获取 JWT,未认证请求按匿名角色处理。可用用户名+密码登录,或通过 Meta API 获取运行时后端 token(FETCH_DATA_VISUALIZER 返回的即运行时后端 token)。开发者 token 可通过 OAuth 流程或邮箱/密码获取,命令为 cd ~/.agents/skills/zion-baas-skill/scripts 后执行 npm run auth 或 npm run auth:email <email> <password>。

凭据管理:所有凭据与项目状态须以 YAML 持久化在项目根目录 .zion/credentials.yaml,包含 developer_token、project(exId、name、admin_token、other_users)及各 token 的 expiry。

CLI 调试:npm run gql -- <projectExId> <role> '<query_string>' '<optional_variables_json>' 执行查询或变更,role 可为 admin、anonymous 或具体 user_id;npm run subscribe -- <projectExId> <role> '<query_string>' '<optional_variables_json>' 监听订阅。另有 npm run fetch-token -- <projectExId>、npm run meta -- search-projects、npm run meta -- fetch-schema <projectExId>。

数据模型:GraphQL schema 由 PostgreSQL 数据模型自动生成,表会生成查询、变更与订阅字段,支持聚合、分组、关系过滤、order_by、窗口函数与公式函数(如 EXTRACT_TIMESTAMPTZ、CONCAT、REGEX_MATCH 等)。过滤采用 Operator-First 模式,操作数分 literal、column、function。媒体列以 [column]_id 或 [column]_ids 关联系统资产表;id、created_at、updated_at 为只读。

限制:不确定字段、枚举或参数时须先用 webfetch/curl 或 zion MCP 内省实时 schema;批量 update/delete 必须提供 where;不支持 Hasura 的 JSONB _append/_delete_key 等操作符。其余细节资料未提供。