defineAPI() 一次。
四种协议。 think() remember() 已内建。

在同一个 handler 里混合业务逻辑与 AI 推理。HTTP、MCP、A2A、OpenAPI — 自动生成。

$ bunx create-capstan-app my-app

一个 defineAPI() 定义自动创建: HTTP JSON API (Hono), MCP 工具 (Claude Desktop), A2A 技能 (Google Agent-to-Agent), OpenAPI 3.1 规范.

app/routes/tickets/index.api.ts
import { defineAPI } from "@zauso-ai/capstan-core";
import { z } from "zod";

export const GET = defineAPI({
  input: z.object({
    status: z.enum(["open", "closed"]).optional(),
  }),
  output: z.object({
    tickets: z.array(z.object({
      id: z.string(),
      title: z.string(),
      status: z.string(),
    })),
  }),
  description: "List support tickets",
  capability: "read",
  resource: "ticket",
  async handler({ input }) {
    return { tickets: await db.tickets.list(input) };
  },
});

为什么选择 Capstan

多协议 API

一个 defineAPI() 同时暴露 HTTP、MCP、A2A 和 OpenAPI 端点。

AI 智能体工具包

think()、generate()、带工具调用的 agent loop。独立包 @zauso-ai/capstan-ai。

长期记忆

remember/recall/about 维度隔离。自动去重、混合检索、上下文组装。

流式 SSR

React 18 renderToReadableStream,选择性 hydration,Image/Font/Metadata。

安全与身份

JWT、OAuth、DPoP (RFC 9449)、SPIFFE/mTLS、限流、CSRF。

数据库与 RAG

Drizzle ORM、向量字段、嵌入、混合搜索、4 种数据库支持。

缓存与 ISR

cacheSet/cacheGet,TTL、标签、stale-while-revalidate。

EU AI Act 合规

defineCompliance 风险分级、审计日志、审批工作流。

框架对比

功能CapstanNext.jsFastAPI
Multi-protocol (HTTP + MCP + A2A)+
OpenAPI auto-generation++
File-based routing++
React SSR++
Built-in auth (JWT + API keys)+~
Policy engine + approval workflow+
AI TDD verifier+
Built-in database layer+
AI Agent Toolkit+
Long-term Memory+
LLM Integration+~~
Cache / ISR++

+ 内置 ~ 部分 不可用 | 完整对比

快速开始

  1. 创建
    bunx create-capstan-app my-app
  2. 开发
    cd my-app && bunx capstan dev
  3. 连接

    你的应用已上线,所有 agent 端点就绪:

    # Agent manifest
    curl http://localhost:3000/.well-known/capstan.json
    
    # OpenAPI spec
    curl http://localhost:3000/openapi.json
    
    # MCP server (for Claude Desktop / Cursor)
    bunx capstan mcp

独立 AI 工具包

@zauso-ai/capstan-ai 无需完整框架即可使用。可在任何 TypeScript 项目中用于结构化 LLM 交互和持久记忆。

import { createAI } from "@zauso-ai/capstan-ai";

const ai = createAI({ llm: openaiProvider({ apiKey: "..." }) });
await ai.think("Analyze this data");
await ai.remember("User prefers dark mode");
const context = await ai.memory.about("customer", "c-42").recall("preferences");

浏览文档

MIT 许可 · 基于 Capstan 构建 — 同时服务人类与机器的 API。