CodeBuddy Agentic SDK 集成解决方案

┌──────────────────────────────────┐
│         用户浏览器 (Memos UI)      │
│                                  │
│   ┌──────────────────────────┐   │
│   │     AIChatPanel 组件      │   │
│   │   (SSE 流式连接 Gateway)  │   │
│   └────────────┬─────────────┘   │
└────────────────┼─────────────────┘
                 │ SSE (text_delta / tool_use / done)
                 ▼
┌──────────────────────────────────┐
│    AI Gateway (Node.js :3333)    │
│                                  │
│  ┌────────┐ ┌────────┐ ┌──────┐ │
│  │认证代理 │ │并发控制 │ │会话  │ │
│  │        │ │(信号量) │ │管理  │ │
│  └────────┘ └────────┘ └──────┘ │
│           │                      │
│           │ query() API 调用     │
│           ▼                      │
│  ┌──────────────────────────┐   │
│  │  @tencent-ai/agent-sdk    │   │
│  │                          │   │
│  │  AsyncGenerator 流式输出  │   │
│  │  原生 Session 管理        │   │
│  │  精细权限控制              │   │
│  └────────────┬─────────────┘   │
└───────────────┼──────────────────┘
                │ curl (由 Agent 自主执行)
                ▼
┌──────────────────────────────────┐
│    Memos 后端 (Go :5230)         │
│    REST API /api/v1/memos        │
└──────────────────────────────────┘

.
├── README.md                        # 本文件 — 项目总览
├── memos/                           # Memos 原始项目（基准代码，用于对比演示）
├── integration-sdk/                 # SDK 嵌入式集成 (In-Process)
│   ├── ai-gateway/src/
│   │   ├── index.ts                 #   服务入口 & SSE 路由
│   │   ├── sdk-agent.ts             #   核心：query() API + 流式处理
│   │   ├── auth-proxy.ts            #   Memos Token 认证代理
│   │   ├── system-prompt.ts         #   Agent 系统提示词
│   │   ├── session-manager.ts       #   会话管理
│   │   ├── semaphore.ts             #   并发控制信号量
│   │   └── config.ts                #   配置项
│   ├── web/src/components/
│   │   └── AIChatPanel.tsx          #   [新增] AI 对话面板组件
│   ├── start.sh / stop.sh           #   一键启停
│   ├── SDK集成方案详细文档.md         #   详细技术文档
│   └── README.md                    #   方案说明

codebuddy login

export CODEBUDDY_API_KEY="your-api-key"
# 中国版必须同时设置
export CODEBUDDY_INTERNET_ENVIRONMENT=internal

cd integration-sdk
chmod +x start.sh stop.sh
./start.sh

curl http://localhost:3333/api/ai/status

{
  "status": "running",
  "mode": "sdk",
  "concurrent": 0,
  "maxConcurrency": 5,
  "queued": 0,
  "activeSessions": 0,
  "memosUrl": "http://localhost:5230"
}

# Token 可从浏览器开发者工具 (F12) → Network → 任意 API 请求的 Authorization 头中获取
curl -N -X POST http://localhost:3333/api/ai/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 memos_access_token>" \
  -d '{"message": "帮我记一条笔记：明天下午 3 点开会"}'

./stop.sh

import { query } from "@tencent-ai/agent-sdk";

const q = query({
  prompt: "查看我最近的笔记",
  options: {
    cwd: "/tmp/sandbox",
    permissionMode: "bypassPermissions",
    systemPrompt: "你是 Memos 智能助手...",
    persistSession: true,
    resume: "previous-session-id",   // 可选：恢复会话
    // 认证配置（API Key 方式，也可通过环境变量设置）
    env: {
      CODEBUDDY_API_KEY: process.env.CODEBUDDY_API_KEY,
      CODEBUDDY_INTERNET_ENVIRONMENT: "internal",  // 中国版必填
    },
  },
});

for await (const message of q) {
  switch (message.type) {
    case "assistant":
      // 处理完整消息（含 tool_use）
      break;
    case "partial_assistant":
      // 处理增量文本（逐字推送）
      break;
    case "result":
      // 对话完成
      break;
  }
}