@lingxiao-office/sdk

凌霄剑域可复用 Agent 引擎 SDK：编排内核、Agent 运行时、LLM 客户端、工具系统、记忆系统。不依赖 Web API，可直接嵌入任意产品线。

安装

npm install @lingxiao-office/sdk

快速开始

import {
  createAgentLoop,
  createLLMClientFromConfig,
  createToolRegistry,
} from '@lingxiao-office/sdk';

// ① 接上 LLM — 直接传 apiKey / baseUrl / model，无需配置文件
const llm = createLLMClientFromConfig({
  apiKey: 'sk-...',
  baseUrl: 'https://api.anthropic.com',
  model: 'claude-opus-4-8',
  provider: 'anthropic',  // OpenAI 兼容端点可不传，默认 'openai'
});

// ② 拿工具 — 50+ 内置工具
const registry = createToolRegistry();

// ③ 跑循环 — 自动处理 LLM 调用 + tool_calls + 结果回灌
const loop = createAgentLoop({
  llm,
  registry,
  model: 'claude-opus-4-8',
  messages: [
    { role: 'system', content: 'You are a helpful agent.' },
    { role: 'user', content: 'Inspect the workspace.' },
  ],
  toolContext: {
    workspace: process.cwd(),
    permissionContext: { mode: 'yolo' },
  },
  done: ({ text }) => text.includes('DONE'),
});

const result = await loop.run();

核心能力

| 能力 | 入口 | 说明 | |---|---|---| | LLM 客户端 | createLLMClientFromConfig({ apiKey, baseUrl, model }) | 一行接上任意 LLM，直接传配置，无需 settings.json | | LLM 客户端（高级） | createLLMClient(snapshotId) | 通过 ModelManager 创建 runtime snapshot，适合动态模型管理 | | 工具系统 | createToolRegistry() | 50+ 内置工具（shell/http/file/code_search/memory/...） | | Agent 循环 | createAgentLoop() | 封装 LLM 调用 + tool_calls 执行 + 结果回灌 + done 判断 | | 文本提取 | contentToPlainText() | 把 LLM 返回统一转成纯文本 | | 会话管理 | SessionManager | 会话级编排：多 agent、共享上下文 | | 任务图 | TaskBoard | 任务 DAG：建任务、设依赖、追踪状态 | | 消息总线 | MessageBus | 进程内异步通信 | | Team 协作 | team_manage / team_message / team_inbox | 多 agent 组团、P2P/广播消息 | | Blackboard | blackboard 工具 | 共享知识图：多 agent 往同一黑板写事实 | | 记忆系统 | memory / memory_read / memory_write | 持久化记忆 | | MCP | mcp 工具 | 接入任意 MCP server 的 tools/resources/prompts |

子路径导入

部分高级 runtime 能力通过子路径访问：

import { createContentGenerator } from '@lingxiao-office/sdk/llm/ContentGenerator.js';
import { AgentRoundExecutor } from '@lingxiao-office/sdk/agents/AgentRoundExecutor.js';
import { AgentCore } from '@lingxiao-office/sdk/agents/runtime/AgentCore.js';

文档

• 完整文档
• API Reference
• Team / Blackboard / DAG
• Pentest Agent 教学项目

License

MIT