ai-world-sdk 1.0.0

package/README.md

@@ -0,0 +1,1006 @@
+# ai-world-sdk
+
+TypeScript SDK for AI World Platform - 一个功能完整的 AI 应用开发 SDK
+
+[![npm version](https://img.shields.io/npm/v/ai-world-sdk)](https://www.npmjs.com/package/ai-world-sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 简介
+
+`ai-world-sdk` 是一个功能完整的 TypeScript SDK，用于与 AI World 平台交互。它提供了：
+
+- **聊天模型**: 兼容 LangChain.js 接口的聊天模型（OpenAI、Google Gemini、Anthropic Claude、Doubao）
+- **图像生成**: 支持豆包 Seedream 模型的图像生成 API
+- **视频生成**: 支持豆包 Seedance 模型的视频生成 API
+- **全局配置**: 支持全局 baseUrl 和 token 配置，简化客户端初始化
+
+设计灵感来自 [LangChain.js](https://github.com/langchain-ai/langchainjs) 的接口风格。
+
+## 安装
+
+```bash
+npm install ai-world-sdk
+# 或
+yarn add ai-world-sdk
+# 或
+pnpm add ai-world-sdk
+```
+
+## 快速开始
+
+### 1. 全局配置（推荐）
+
+```typescript
+import { sdkConfig, ChatGoogleGenerativeAI, ImageGenerationClient, VideoGenerationClient } from 'ai-world-sdk';
+
+// 设置全局配置（只需设置一次）
+sdkConfig.setBaseUrl('http://localhost:8000');
+sdkConfig.setToken('your-jwt-token');
+
+// 现在可以创建客户端而不需要提供 baseUrl 和 token
+const chatModel = new ChatGoogleGenerativeAI({
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+  temperature: 0.7,
+});
+
+const imageClient = new ImageGenerationClient({});
+const videoClient = new VideoGenerationClient({});
+```
+
+### 2. 基础聊天模型使用
+
+```typescript
+import {
+  ChatGoogleGenerativeAI,
+  HumanMessage,
+  SystemMessage,
+  AIMessageChunk,
+} from 'ai-world-sdk';
+
+// 初始化聊天模型
+const model = new ChatGoogleGenerativeAI({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-jwt-token',
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+  temperature: 0.7,
+});
+
+// 非流式调用
+const response = await model.invoke([
+  new SystemMessage('You are a helpful assistant.'),
+  new HumanMessage('Hello! What is AI?'),
+]);
+
+console.log(response.content); // 输出: AI 是...
+
+// 流式调用
+for await (const chunk of model.stream([
+  new HumanMessage('Tell me a story about AI'),
+])) {
+  // chunk 是 AIMessageChunk 对象
+  if (typeof chunk.content === 'string') {
+    process.stdout.write(chunk.content);
+  }
+}
+```
+
+## 完整 API 文档
+
+### 全局配置 API
+
+#### `sdkConfig.setBaseUrl(baseUrl: string): void`
+
+设置全局 baseUrl。所有客户端实例如果没有提供 baseUrl，将使用此全局值。
+
+```typescript
+import { sdkConfig } from 'ai-world-sdk';
+
+sdkConfig.setBaseUrl('http://localhost:8000');
+```
+
+#### `sdkConfig.setToken(token: string): void`
+
+设置全局 token。所有客户端实例如果没有提供 token，将使用此全局值。
+
+```typescript
+sdkConfig.setToken('your-jwt-token');
+```
+
+#### `sdkConfig.setHeaders(headers: Record<string, string>): void`
+
+设置全局 headers。这些 headers 会与每个客户端实例的 headers 合并。
+
+```typescript
+sdkConfig.setHeaders({
+  'X-Custom-Header': 'value',
+});
+```
+
+#### `sdkConfig.getBaseUrl(): string | null`
+
+获取全局 baseUrl。
+
+#### `sdkConfig.getToken(): string | null`
+
+获取全局 token。
+
+#### `sdkConfig.getHeaders(): Record<string, string>`
+
+获取全局 headers。
+
+#### `sdkConfig.reset(): void`
+
+重置所有全局配置。
+
+### 聊天模型 API
+
+#### 支持的模型类
+
+- `ChatOpenAI` - OpenAI 兼容模型（GPT、O1、Doubao）
+- `ChatGoogleGenerativeAI` - Google Gemini 模型
+- `ChatAnthropic` - Anthropic Claude 模型
+
+#### `BaseChatModel` 接口
+
+所有聊天模型都继承自 `BaseChatModel`，提供以下方法：
+
+##### `invoke(messages: BaseMessage[]): Promise<AIMessage>`
+
+发送非流式请求。
+
+**参数:**
+- `messages`: 消息数组，可以是 `HumanMessage`、`SystemMessage`、`AIMessage`
+
+**返回:** `AIMessage` 对象，包含 `content` 字段
+
+**示例:**
+```typescript
+const response = await model.invoke([
+  new HumanMessage('What is the capital of France?'),
+]);
+console.log(response.content); // "The capital of France is Paris."
+```
+
+##### `stream(messages: BaseMessage[]): AsyncGenerator<AIMessageChunk, void, unknown>`
+
+发送流式请求。
+
+**参数:**
+- `messages`: 消息数组
+
+**返回:** 异步生成器，每次 yield 一个 `AIMessageChunk` 对象
+
+**示例:**
+```typescript
+for await (const chunk of model.stream([
+  new HumanMessage('Tell me a story'),
+])) {
+  if (typeof chunk.content === 'string') {
+    process.stdout.write(chunk.content);
+  }
+}
+```
+
+##### `batch(messagesList: BaseMessage[][]): Promise<AIMessage[]>`
+
+批量处理多个消息集。
+
+**参数:**
+- `messagesList`: 消息数组的数组
+
+**返回:** `AIMessage` 数组
+
+**示例:**
+```typescript
+const responses = await model.batch([
+  [new HumanMessage('What is AI?')],
+  [new HumanMessage('What is ML?')],
+  [new HumanMessage('What is DL?')],
+]);
+
+responses.forEach((response, index) => {
+  console.log(`Response ${index + 1}:`, response.content);
+});
+```
+
+##### `bind(options: BindOptions): BaseChatModel`
+
+绑定参数到模型实例，返回新的模型实例。
+
+**参数:**
+- `options.temperature`: 温度参数
+- `options.maxTokens`: 最大 token 数
+- `options.topP`: Top-p 采样参数
+- `options.tools`: 工具定义数组
+- `options.toolChoice`: 工具选择策略
+
+**示例:**
+```typescript
+const boundModel = model.bind({
+  temperature: 0.9,
+  maxTokens: 1000,
+});
+
+const response = await boundModel.invoke([
+  new HumanMessage('Hello!'),
+]);
+```
+
+##### `bindTools(tools: ToolDefinition[]): BaseChatModel`
+
+绑定工具到模型实例。
+
+**参数:**
+- `tools`: 工具定义数组
+
+**示例:**
+```typescript
+import { ToolDefinition } from 'ai-world-sdk';
+
+const tools: ToolDefinition[] = [
+  {
+    type: 'function',
+    function: {
+      name: 'get_weather',
+      description: 'Get the current weather in a location',
+      parameters: {
+        type: 'object',
+        properties: {
+          location: { type: 'string' },
+        },
+        required: ['location'],
+      },
+    },
+  },
+];
+
+const modelWithTools = model.bindTools(tools);
+const response = await modelWithTools.invoke([
+  new HumanMessage('What is the weather in Paris?'),
+]);
+```
+
+##### `getModelName(): string`
+
+获取当前模型名称。
+
+#### 消息类型
+
+##### `HumanMessage`
+
+用户消息。
+
+```typescript
+import { HumanMessage } from 'ai-world-sdk';
+
+const message = new HumanMessage('Hello!');
+```
+
+##### `SystemMessage`
+
+系统消息，用于设置助手的行为。
+
+```typescript
+import { SystemMessage } from 'ai-world-sdk';
+
+const message = new SystemMessage('You are a helpful assistant.');
+```
+
+##### `AIMessage`
+
+助手消息。
+
+```typescript
+import { AIMessage } from 'ai-world-sdk';
+
+const message = new AIMessage('Hello! How can I help you?');
+```
+
+##### `AIMessageChunk`
+
+流式响应中的消息块。
+
+```typescript
+import { AIMessageChunk } from 'ai-world-sdk';
+
+// 在流式调用中使用
+for await (const chunk of model.stream([...])) {
+  // chunk 是 AIMessageChunk 实例
+  console.log(chunk.content);
+  console.log(chunk.id);
+  console.log(chunk.response_metadata);
+}
+```
+
+#### 多模态输入
+
+支持文本和图像混合输入：
+
+```typescript
+const response = await model.invoke([
+  {
+    role: 'user',
+    content: [
+      { type: 'text', text: 'Describe this image' },
+      {
+        type: 'image_url',
+        image_url: 'data:image/jpeg;base64,/9j/4AAQSkZJRg...',
+      },
+    ],
+  },
+]);
+```
+
+#### 工厂函数
+
+使用 `createChatModel` 根据模型名称自动选择正确的模型类：
+
+```typescript
+import { createChatModel } from 'ai-world-sdk';
+
+// 自动选择 ChatGoogleGenerativeAI
+const gemini = createChatModel('gemini-1.5-pro', {
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+  temperature: 0.7,
+});
+
+// 自动选择 ChatOpenAI
+const gpt = createChatModel('gpt-4', {
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+});
+
+// 自动选择 ChatAnthropic
+const claude = createChatModel('claude-3-sonnet-20240229', {
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+});
+```
+
+**支持的模型前缀:**
+- `gpt-*`, `o1-*` → `ChatOpenAI`
+- `doubao-*` → `ChatOpenAI` (Doubao 与 OpenAI 兼容)
+- `gemini-*` → `ChatGoogleGenerativeAI`
+- `claude-*` → `ChatAnthropic`
+
+### 图像生成 API
+
+#### `ImageGenerationClient`
+
+图像生成客户端，支持 OpenAI 标准格式的图像生成。
+
+##### 初始化
+
+```typescript
+import { ImageGenerationClient } from 'ai-world-sdk';
+
+const imageClient = new ImageGenerationClient({
+  baseUrl: 'http://localhost:8000', // 可选，如果设置了全局配置
+  token: 'your-jwt-token', // 可选，如果设置了全局配置
+  headers: { // 可选
+    'X-Custom-Header': 'value',
+  },
+});
+```
+
+##### `generate(request: ImageGenerationRequest): Promise<ImageGenerationResponse>`
+
+生成图像（同步）。
+
+**请求参数 (`ImageGenerationRequest`):**
+- `prompt` (必需): 图像生成提示词
+- `model` (可选): 模型名称，默认: `doubao-seedream-4-5-251128`
+- `n` (可选): 生成图像数量，1-10，默认: 1
+- `size` (可选): 图像尺寸，支持: `256x256`, `512x512`, `1024x1024`, `1792x1024`, `1024x1792`, `1K`, `2K`, `4K`，默认: `1024x1024`
+- `quality` (可选): 图像质量，`standard` 或 `hd`，默认: `standard`
+- `response_format` (可选): 响应格式，`url` 或 `b64_json`，默认: `url`
+- `style` (可选): 图像风格，`vivid` 或 `natural`（仅部分模型支持）
+- `user` (可选): 用户标识（用于追踪和审计）
+
+**返回 (`ImageGenerationResponse`):**
+- `created`: 创建时间戳（Unix 时间戳）
+- `data`: 图像数据数组，每个元素包含:
+  - `url`: 图像 URL（如果 `response_format` 为 `url`）
+  - `b64_json`: Base64 编码的图像数据（如果 `response_format` 为 `b64_json`）
+
+**示例:**
+```typescript
+const result = await imageClient.generate({
+  prompt: '充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子',
+  model: 'doubao-seedream-4-5-251128',
+  size: '2K',
+  n: 1,
+  quality: 'hd',
+  response_format: 'url',
+});
+
+console.log('生成的图像:', result.data);
+console.log('第一张图像 URL:', result.data[0]?.url);
+```
+
+### 视频生成 API
+
+#### `VideoGenerationClient`
+
+视频生成客户端，支持豆包 Seedance 模型的视频生成。
+
+##### 初始化
+
+```typescript
+import { VideoGenerationClient } from 'ai-world-sdk';
+
+const videoClient = new VideoGenerationClient({
+  baseUrl: 'http://localhost:8000', // 可选，如果设置了全局配置
+  token: 'your-jwt-token', // 可选，如果设置了全局配置
+  headers: { // 可选
+    'X-Custom-Header': 'value',
+  },
+});
+```
+
+##### `create(request: VideoGenerationRequest): Promise<ContentGenerationTaskID>`
+
+创建视频生成任务。
+
+**请求参数 (`VideoGenerationRequest`):**
+- `prompt` (可选): 文本提示词（文本生成视频）
+- `image_url` (可选): 图像 URL（图像生成视频）
+- `model` (可选): 模型名称，默认: `doubao-seedance-1-0-pro-fast-251015`
+- `content` (可选): 内容列表（如果提供，将直接使用，忽略 prompt 和 image_url）
+- `callback_url` (可选): 回调 URL（任务完成时通知）
+- `return_last_frame` (可选): 是否返回最后一帧图像
+- `service_tier` (可选): 服务层级
+- `execution_expires_after` (可选): 执行过期时间（秒）
+- `duration` (可选): 视频时长（秒），1-10，默认: 5（将添加到 prompt）
+- `aspect_ratio` (可选): 视频宽高比，`16:9`, `9:16`, `1:1`，默认: `16:9`（将添加到 prompt）
+- `resolution` (可选): 视频分辨率，例如: `720p`, `1080p`（将添加到 prompt）
+- `user` (可选): 用户标识（用于追踪和审计）
+
+**注意:** `prompt` 和 `image_url` 必须提供其中之一，或者直接提供 `content`。
+
+**返回 (`ContentGenerationTaskID`):**
+- `id`: 任务 ID
+
+**示例（文本生成视频）:**
+```typescript
+const task = await videoClient.create({
+  prompt: 'A beautiful sunset over the ocean with waves crashing on the shore',
+  model: 'doubao-seedance-1-0-pro-fast-251015',
+  duration: 5,
+  aspect_ratio: '16:9',
+  resolution: '720p',
+});
+
+console.log('任务 ID:', task.id);
+```
+
+**示例（图像生成视频）:**
+```typescript
+const task = await videoClient.create({
+  image_url: 'https://example.com/image.jpg',
+  model: 'doubao-seedance-1-0-pro-fast-251015',
+  duration: 5,
+});
+
+console.log('任务 ID:', task.id);
+```
+
+**示例（直接提供 content）:**
+```typescript
+const task = await videoClient.create({
+  model: 'doubao-seedance-1-0-pro-fast-251015',
+  content: [
+    {
+      type: 'text',
+      text: 'A beautiful sunset --ratio 16:9 --duration 5',
+    },
+  ],
+  return_last_frame: true,
+  callback_url: 'https://example.com/callback',
+});
+```
+
+##### `get(taskId: string): Promise<ContentGenerationTask>`
+
+查询视频生成任务状态。
+
+**参数:**
+- `taskId`: 任务 ID
+
+**返回 (`ContentGenerationTask`):**
+- `id`: 任务 ID
+- `model`: 使用的模型
+- `status`: 任务状态，`queued` | `running` | `succeeded` | `failed` | `cancelled`
+- `error`: 错误信息（如果失败），包含 `message` 和 `code`
+- `content`: 生成的内容，包含:
+  - `video_url`: 视频 URL（任务完成时）
+  - `last_frame_url`: 最后一帧图像 URL（如果 `return_last_frame` 为 true）
+  - `file_url`: 文件 URL
+- `usage`: 使用情况，包含 `completion_tokens`
+- `created_at`: 创建时间戳（Unix 时间戳）
+- `updated_at`: 更新时间戳
+- 其他字段: `subdivisionlevel`, `fileformat`, `frames`, `framespersecond`, `seed`, `revised_prompt`, `service_tier`, `execution_expires_after`
+
+**示例:**
+```typescript
+const task = await videoClient.get(taskId);
+
+console.log('任务状态:', task.status);
+console.log('使用的模型:', task.model);
+
+if (task.status === 'succeeded' && task.content?.video_url) {
+  console.log('视频 URL:', task.content.video_url);
+} else if (task.error) {
+  console.error('错误:', task.error.message);
+}
+```
+
+##### `poll(taskId: string, options?: PollOptions): Promise<ContentGenerationTask>`
+
+轮询视频生成任务直到完成。
+
+**参数:**
+- `taskId`: 任务 ID
+- `options.interval` (可选): 轮询间隔（毫秒），默认: 5000
+- `options.timeout` (可选): 超时时间（毫秒），默认: 300000 (5分钟)
+
+**返回:** 完成后的 `ContentGenerationTask`
+
+**示例:**
+```typescript
+// 创建任务
+const createTask = await videoClient.create({
+  prompt: 'A short video of a cat playing',
+  model: 'doubao-seedance-1-0-pro-fast-251015',
+  duration: 3,
+});
+
+// 轮询直到完成
+const result = await videoClient.poll(createTask.id, {
+  interval: 2000, // 每 2 秒轮询一次
+  timeout: 60000, // 60 秒超时
+});
+
+if (result.status === 'succeeded' && result.content?.video_url) {
+  console.log('视频生成成功:', result.content.video_url);
+} else if (result.error) {
+  console.error('生成失败:', result.error.message);
+}
+```
+
+## 支持的模型
+
+### 聊天模型
+
+#### OpenAI 兼容模型
+- `gpt-3.5-turbo`
+- `gpt-4`
+- `gpt-4-turbo`
+- `o1-preview`
+- `o1-mini`
+- `doubao-*` (豆包模型，与 OpenAI 兼容)
+
+#### Google Gemini
+- `gemini-pro`
+- `gemini-1.5-pro`
+- `gemini-1.5-flash`
+- `gemini-2.0-flash-exp-image-generation`
+
+#### Anthropic Claude
+- `claude-3-opus-20240229`
+- `claude-3-sonnet-20240229`
+- `claude-3-haiku-20240307`
+
+### 图像生成模型
+
+- `doubao-seedream-4-5-251128` (默认)
+- 其他 Seedream 模型版本
+
+### 视频生成模型
+
+- `doubao-seedance-1-0-pro-fast-251015` (默认，推荐)
+- `doubao-seedance-1-0-pro-250528`
+- `doubao-seedance-1-0-lite-t2v-250428` (文本生成视频)
+- `doubao-seedance-1-0-lite-i2v-250428` (图像生成视频)
+
+## 完整示例
+
+### 示例 1: 使用全局配置
+
+```typescript
+import {
+  sdkConfig,
+  ChatGoogleGenerativeAI,
+  ImageGenerationClient,
+  VideoGenerationClient,
+  HumanMessage,
+} from 'ai-world-sdk';
+
+// 设置全局配置
+sdkConfig.setBaseUrl('http://localhost:8000');
+sdkConfig.setToken('your-jwt-token');
+
+// 创建客户端（不需要提供 baseUrl 和 token）
+const chatModel = new ChatGoogleGenerativeAI({
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+  temperature: 0.7,
+});
+
+const imageClient = new ImageGenerationClient({});
+const videoClient = new VideoGenerationClient({});
+
+// 使用
+const response = await chatModel.invoke([
+  new HumanMessage('Hello!'),
+]);
+
+const imageResult = await imageClient.generate({
+  prompt: 'A beautiful sunset',
+});
+```
+
+### 示例 2: 流式聊天
+
+```typescript
+import { ChatGoogleGenerativeAI, HumanMessage, AIMessageChunk } from 'ai-world-sdk';
+
+const model = new ChatGoogleGenerativeAI({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+});
+
+let fullText = '';
+for await (const chunk of model.stream([
+  new HumanMessage('Tell me a story about AI'),
+])) {
+  // chunk 是 AIMessageChunk 对象
+  if (typeof chunk.content === 'string') {
+    fullText += chunk.content;
+    process.stdout.write(chunk.content);
+  }
+}
+
+console.log('\n完整回复:', fullText);
+```
+
+### 示例 3: 图像生成工作流
+
+```typescript
+import { ImageGenerationClient } from 'ai-world-sdk';
+
+const imageClient = new ImageGenerationClient({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+});
+
+// 生成单张图像
+const result = await imageClient.generate({
+  prompt: 'A futuristic city skyline at sunset',
+  model: 'doubao-seedream-4-5-251128',
+  size: '2K',
+  quality: 'hd',
+  n: 1,
+});
+
+console.log('图像 URL:', result.data[0]?.url);
+
+// 生成多张图像
+const multiResult = await imageClient.generate({
+  prompt: 'A beautiful landscape',
+  n: 3,
+  size: '2K',
+});
+
+multiResult.data.forEach((image, index) => {
+  console.log(`图像 ${index + 1}:`, image.url);
+});
+```
+
+### 示例 4: 视频生成工作流
+
+```typescript
+import { VideoGenerationClient } from 'ai-world-sdk';
+
+const videoClient = new VideoGenerationClient({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+});
+
+// 1. 创建视频生成任务
+const createTask = await videoClient.create({
+  prompt: 'A beautiful sunset over the ocean with waves',
+  model: 'doubao-seedance-1-0-pro-fast-251015',
+  duration: 5,
+  aspect_ratio: '16:9',
+  resolution: '720p',
+});
+
+console.log('任务已创建，ID:', createTask.id);
+
+// 2. 查询任务状态
+const task = await videoClient.get(createTask.id);
+console.log('当前状态:', task.status);
+
+// 3. 轮询直到完成
+const result = await videoClient.poll(createTask.id, {
+  interval: 3000, // 每 3 秒查询一次
+  timeout: 300000, // 5 分钟超时
+});
+
+if (result.status === 'succeeded') {
+  console.log('视频生成成功!');
+  console.log('视频 URL:', result.content?.video_url);
+  if (result.content?.last_frame_url) {
+    console.log('最后一帧:', result.content.last_frame_url);
+  }
+} else {
+  console.error('生成失败:', result.error?.message);
+}
+```
+
+### 示例 5: 批量处理
+
+```typescript
+import { ChatGoogleGenerativeAI, HumanMessage } from 'ai-world-sdk';
+
+const model = new ChatGoogleGenerativeAI({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+});
+
+// 批量处理多个问题
+const questions = [
+  'What is artificial intelligence?',
+  'What is machine learning?',
+  'What is deep learning?',
+];
+
+const responses = await model.batch(
+  questions.map(q => [new HumanMessage(q)])
+);
+
+responses.forEach((response, index) => {
+  console.log(`问题 ${index + 1}:`, questions[index]);
+  console.log(`回答:`, response.content);
+  console.log('---');
+});
+```
+
+### 示例 6: 工具调用
+
+```typescript
+import {
+  ChatGoogleGenerativeAI,
+  HumanMessage,
+  ToolDefinition,
+} from 'ai-world-sdk';
+
+const model = new ChatGoogleGenerativeAI({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+});
+
+const tools: ToolDefinition[] = [
+  {
+    type: 'function',
+    function: {
+      name: 'get_weather',
+      description: 'Get the current weather in a location',
+      parameters: {
+        type: 'object',
+        properties: {
+          location: {
+            type: 'string',
+            description: 'The city and state, e.g. San Francisco, CA',
+          },
+          unit: {
+            type: 'string',
+            enum: ['celsius', 'fahrenheit'],
+            description: 'The unit of temperature',
+          },
+        },
+        required: ['location'],
+      },
+    },
+  },
+];
+
+const modelWithTools = model.bindTools(tools);
+
+const response = await modelWithTools.invoke([
+  new HumanMessage('What is the weather in Paris?'),
+]);
+
+console.log('响应:', response.content);
+// 检查是否有工具调用
+if (response.tool_calls && response.tool_calls.length > 0) {
+  console.log('工具调用:', response.tool_calls);
+}
+```
+
+## 类型定义
+
+### 核心类型
+
+```typescript
+// 消息类型
+export class HumanMessage extends BaseMessage { ... }
+export class SystemMessage extends BaseMessage { ... }
+export class AIMessage extends BaseMessage { ... }
+export class AIMessageChunk extends BaseMessage { ... }
+
+// 配置类型
+export interface BaseChatModelParams {
+  temperature?: number;
+  maxTokens?: number;
+  topP?: number;
+  modelName?: string;
+  provider?: string;
+  apiKey?: string;
+}
+
+export interface LangchainClientConfig {
+  baseUrl?: string;
+  token?: string;
+  headers?: Record<string, string>;
+}
+
+// 工具类型
+export interface ToolDefinition {
+  type: 'function';
+  function: {
+    name: string;
+    description: string;
+    parameters?: Record<string, any>;
+  };
+}
+
+export interface BindOptions {
+  temperature?: number;
+  maxTokens?: number;
+  topP?: number;
+  tools?: ToolDefinition[];
+  toolChoice?: 'auto' | 'none' | 'required' | { type: 'function'; function: { name: string } };
+}
+```
+
+## 错误处理
+
+所有 API 调用都可能抛出错误。建议使用 try-catch 进行错误处理：
+
+```typescript
+import { ChatGoogleGenerativeAI, HumanMessage } from 'ai-world-sdk';
+
+const model = new ChatGoogleGenerativeAI({
+  baseUrl: 'http://localhost:8000',
+  token: 'your-token',
+  modelName: 'gemini-2.0-flash-exp-image-generation',
+});
+
+try {
+  const response = await model.invoke([
+    new HumanMessage('Hello!'),
+  ]);
+  console.log(response.content);
+} catch (error) {
+  console.error('API 调用失败:', error);
+  if (error instanceof Error) {
+    console.error('错误消息:', error.message);
+  }
+}
+```
+
+## 参考地址
+
+### 官方文档
+
+- **AI World 平台**: [项目仓库](https://github.com/your-org/ai-world)
+- **LangChain.js**: [https://github.com/langchain-ai/langchainjs](https://github.com/langchain-ai/langchainjs)
+- **火山引擎方舟平台**: [https://www.volcengine.com/docs/82379](https://www.volcengine.com/docs/82379)
+
+### API 文档
+
+- **图像生成 API**: [https://www.volcengine.com/docs/82379/1824121](https://www.volcengine.com/docs/82379/1824121)
+- **视频生成 API**: [https://www.volcengine.com/docs/82379/1366799](https://www.volcengine.com/docs/82379/1366799)
+- **对话 API**: [https://www.volcengine.com/docs/82379/1541595](https://www.volcengine.com/docs/82379/1541595)
+
+### 模型文档
+
+- **Seedream 4.0-4.5 教程**: [https://www.volcengine.com/docs/82379/1824121?lang=zh](https://www.volcengine.com/docs/82379/1824121?lang=zh)
+- **Seedance 提示词指南**: [https://www.volcengine.com/docs/82379/1901652](https://www.volcengine.com/docs/82379/1901652)
+
+## 开发
+
+### 构建
+
+```bash
+npm run build
+```
+
+### 测试
+
+```bash
+# 运行所有测试
+npm test
+
+# 运行特定测试
+npm run test:stream
+npm run test:image-generation
+npm run test:video-generation
+```
+
+### 项目结构
+
+```
+ai-world-sdk/
+├── src/
+│   ├── base.ts              # 基础聊天模型类
+│   ├── config.ts            # 全局配置管理
+│   ├── messages.ts          # 消息类型定义
+│   ├── image_generation.ts  # 图像生成客户端
+│   ├── video_generation.ts  # 视频生成客户端
+│   ├── chat_models/         # 具体模型实现
+│   │   ├── openai.ts
+│   │   ├── google.ts
+│   │   └── anthropic.ts
+│   └── index.ts             # 主入口文件
+├── __tests__/               # 测试文件
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 发布
+
+### 安装
+
+```bash
+npm install ai-world-sdk
+```
+
+### 发布到 npm
+
+详细的发布指南请参考 [PUBLISH.md](./PUBLISH.md)。
+
+**快速发布步骤:**
+
+```bash
+# 1. 构建项目
+npm run build
+
+# 2. 运行测试
+npm test
+
+# 3. 更新版本号（如果需要）
+npm version patch  # 或 minor, major
+
+# 4. 登录 npm
+npm login
+
+# 5. 发布（scope 包需要 --access public）
+npm publish --access public
+```
+
+## 许可证
+
+MIT
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 更新日志
+
+### 1.0.0
+
+- ✨ 初始版本发布
+- ✨ 支持聊天模型（OpenAI、Gemini、Claude、Doubao）
+- ✨ 支持图像生成（Seedream）
+- ✨ 支持视频生成（Seedance）
+- ✨ 支持全局配置（baseUrl、token）
+- ✨ 兼容 LangChain.js 接口风格
+- ✨ 完整的 TypeScript 类型定义