Deuz-SDK

环境要求

• Node ≥ 22，或任何提供 fetch 的边缘运行时
• npm 包管理器
• 调用 Claude 模型需准备 ANTHROPIC_API_KEY
• 可选：用到时再装的 peer 依赖（zod、@modelcontextprotocol/sdk、react、pg/redis、unpdf/mammoth/xls

安装与启动步骤

1. 1检查 Node 版本

   Deuz-SDK 要求 Node ≥ 22，或任何带 fetch 的边缘运行时。

   node -v

   复制

2. 2安装核心运行时

   安装 @deuz-sdk/core，它是零运行时依赖的智能体运行时包。

   npm install @deuz-sdk/core

   复制

3. 3按需装 React 包

   只有要用 useChat、useObject 等无头 UI 时才需要安装 @deuz-sdk/react。

   npm install @deuz-sdk/react

   复制

4. 4配置模型密钥

   示例通过 process.env.ANTHROPIC_API_KEY 读取密钥，先写入环境变量。

   export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

   复制

5. 5编写流式示例

   新建入口文件，用 streamChat 发起对话并逐块消费 textStream。

   import { streamChat } from '@deuz-sdk/core';
   import { createAnthropic } from '@deuz-sdk/core/anthropic';
   
   const anthropic = createAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
   
   // Returns synchronously and never throws. Failures arrive as typed stream parts.
   const res = streamChat({
     model: anthropic('claude-opus-4-8'),
     instructions: 'You are terse.',
     prompt: 'Hello!',
   });
   
   for await (const chunk of res.textStream) process.stdout.write(chunk);
   const usage = await res.usage;

   复制

6. 6运行入口文件

   用你项目现有的 TypeScript 运行方式执行该入口文件，观察流式输出。

关键配置

如何确认成功

控制台逐块打印出模型回复文本，并且能成功取到 res.usage，即说明安装与调用成功。

常见问题

注意事项

• 示例中的模型名与密钥请替换成你账号下实际可用的值。
• clock、randomness、fetch、keys、logging 均为注入式设计，同一份代码可跑在 Node、Bun、Deno 与边缘环境。
• zod、@modelcontextprotocol/sdk、react、pg/redis、unpdf/mammoth/xlsx、playwright、@opentelemetry/api 都是可选 peer 依赖，用到再装。
• README 未给出具体运行脚本，请使用你项目已有的 TypeScript 运行方式执行入口文件。