开发者指南

API、SDK、CLI 与 MCP

为服务、脚本和 Agent 选择稳定且公开安全的调用入口。

API 与 SDK

Backend 的公共网关使用 :4320,承载普通 HTTP、tRPC 和 Agent SSE。SDK 只通过 HTTP 通信,不包含数据库或 Brain 凭证。

import { createDraPubSdk } from '@drapub/sdk'

const client = createDraPubSdk({
  baseUrl: process.env.DRAPUB_API_URL ?? 'http://localhost:4320',
  apiKey: process.env.DRAPUB_API_KEY,
})

client 提供工作区、知识库、任务、审核与发布等类型化方法。不要在浏览器代码中暴露长期 API Key。

CLI

CLI 输出保持稳定且适合脚本解析。自动化中优先使用 JSON 输出,检查非零退出码,并为会产生外部影响的命令保留人工审核。

MCP 与 Agent Skill

MCP 工具和本地 Skillpack 调用 Backend,不持有 GBrain 数据库凭证。云端 Agent 使用任务级 Token,只能访问当前任务授权的 MCP 与模型网关。