#527·weekly

【开源自荐】Blade Agent SDK:面向 Node.js 的 Session-first AI Agent 开发框架

Author: echoVicCreated Mar 29, 2026Updated Mar 29, 2026

项目地址: https://github.com/echoVic/blade-agent-sdk npm: https://www.npmjs.com/package/@blade-ai/agent-sdk 协议: MIT

Blade Agent SDK 是一个面向 Node.js 与 TypeScript 的 Session-first Agent SDK。它把多轮会话、工具执行、MCP、子 Agent、Skills、权限控制、Hooks、沙箱和结构化输出统一到一套 API 中,适合构建 CLI 助手、IDE 插件、自动化工作流和对话式开发工具。

核心能力:

  • Session-firstcreateSession() / resumeSession() / forkSession(),会话可持久化、可恢复、可分叉
  • 流式 Agent 交互send() + stream(),支持 content、thinking、tool use、tool result 等事件
  • 多模型支持:OpenAI、Anthropic、Azure OpenAI、Gemini、DeepSeek、OpenAI-Compatible
  • 工具系统:内置 17 个标准工具 + 自定义工具 + MCP 协议工具
  • MCP 集成:支持 stdio、SSE、HTTP 传输,也支持进程内 MCP Server
  • 协作能力:子 Agent、Task 工具、用户级/项目级 Skills
  • 安全与治理:权限模式、Hooks 生命周期钩子、沙箱配置

快速开始:

bash
npm install @blade-ai/agent-sdk
typescript
import { createSession } from '@blade-ai/agent-sdk';

const session = await createSession({
  provider: { type: 'openai', apiKey: process.env.OPENAI_API_KEY! },
  model: 'gpt-4o-mini',
});

await session.send('分析当前项目的目录结构');

for await (const event of session.stream()) {
  if (event.type === 'content') {
    process.stdout.write(event.delta);
  }
}

session.close();