ai-world-sdk 1.3.2 → 1.3.5

package/dist/video_generation.js

@@ -1,10 +1,10 @@
 "use strict";
 /**
- * Video Generation Client
- * 视频生成客户端
+ * Video Generation & Understanding Client
+ * 视频生成 & 视频理解客户端
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VideoGenerationClient = void 0;
+exports.VideoUnderstandingClient = exports.VideoGenerationClient = void 0;
 const config_1 = require("./config");
 const log_1 = require("./log");
 class VideoGenerationClient {
@@ -92,3 +92,138 @@ class VideoGenerationClient {
     }
 }
 exports.VideoGenerationClient = VideoGenerationClient;
+class VideoUnderstandingClient {
+    constructor(config) {
+        // 合并全局 headers 和配置 headers
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        this.headers = {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${config_1.sdkConfig.getToken()}`,
+            "X-Base-Url": config?.baseUrl || "",
+            ...globalHeaders,
+            ...config?.headers,
+        };
+    }
+    /**
+     * Analyze a video (non-streaming)
+     * 视频理解（非流式）
+     */
+    async understand(request) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${config_1.sdkConfig.getServerUrl()}/api/video-proxy/understand`;
+        const body = { ...request, stream: false };
+        (0, log_1.logRequest)("POST", url, this.headers, body);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            (0, log_1.logResponse)(response.status, response.statusText, response.headers, errorText);
+            throw new Error(`Video understanding API error: ${response.status} ${errorText}`);
+        }
+        const data = (await response.json());
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, data);
+        return data;
+    }
+    /**
+     * Analyze a video with streaming response
+     * 视频理解（流式）
+     *
+     * @returns AsyncGenerator yielding content chunks
+     */
+    async *understandStream(request) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${config_1.sdkConfig.getServerUrl()}/api/video-proxy/understand`;
+        const body = { ...request, stream: true };
+        (0, log_1.logRequest)("POST", url, this.headers, body);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            (0, log_1.logResponse)(response.status, response.statusText, response.headers, errorText);
+            throw new Error(`Video understanding stream API error: ${response.status} ${errorText}`);
+        }
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new Error("Response body is not readable");
+        }
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() || "";
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || !trimmed.startsWith("data: "))
+                        continue;
+                    const data = trimmed.slice(6);
+                    if (data === "[DONE]")
+                        return;
+                    try {
+                        const chunk = JSON.parse(data);
+                        if (chunk.error) {
+                            throw new Error(chunk.error.message);
+                        }
+                        yield chunk;
+                    }
+                    catch (e) {
+                        if (e instanceof SyntaxError)
+                            continue;
+                        throw e;
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Convenience: analyze video and return full text content
+     * 便捷方法：分析视频并返回完整文本
+     */
+    async analyzeVideo(videoUrl, options) {
+        const response = await this.understand({
+            video_url: videoUrl,
+            prompt: options?.prompt || "请详细描述这个视频的内容",
+            fps: options?.fps,
+            model: options?.model,
+            max_tokens: options?.max_tokens,
+        });
+        return response.choices?.[0]?.message?.content || "";
+    }
+    /**
+     * Convenience: analyze video with streaming, collecting full text
+     * 便捷方法：流式分析视频，收集完整文本
+     *
+     * @param onChunk optional callback for each text chunk
+     */
+    async analyzeVideoStream(videoUrl, options) {
+        let fullText = "";
+        for await (const chunk of this.understandStream({
+            video_url: videoUrl,
+            prompt: options?.prompt || "请详细描述这个视频的内容",
+            fps: options?.fps,
+            model: options?.model,
+            max_tokens: options?.max_tokens,
+        })) {
+            const content = chunk.choices?.[0]?.delta?.content;
+            if (content) {
+                fullText += content;
+                options?.onChunk?.(content);
+            }
+        }
+        return fullText;
+    }
+}
+exports.VideoUnderstandingClient = VideoUnderstandingClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.3.2",
+  "version": "1.3.5",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/ai-world-sdk/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ai-world-sdk
-description: Use when initializing ai-world-sdk or calling AI models in ai-world projects. Covers sdkConfig initialization, createProvider with Vercel AI SDK (generateText, streamText, generateImage), Doubao image/video generation, MinIO object storage (MinioStorageClient), resource management with ACL (ResourceClient), database requests (DatabaseRequestClient), agent skills management (AgentSkillClient), and VSCode extension login (initAIWorld). Triggers on ai-world-sdk, createProvider, sdkConfig, generateText, streamText, generateImage, doubao, MinioStorageClient, minio, ResourceClient, resource management, access control, file sharing, DatabaseRequestClient, database request, table creation, AgentSkillClient, agent skill, vscode extension, initAIWorld, or any AI model integration.
+description: Use when initializing ai-world-sdk or calling AI models in ai-world projects. Covers sdkConfig initialization, createProvider with Vercel AI SDK (generateText, streamText, generateImage), Doubao image/video generation/understanding, MinIO object storage (MinioStorageClient), resource management with ACL (ResourceClient), versioned resource management (VersionedResourceClient), agent skills management (AgentSkillClient), and VSCode extension login (initAIWorld). Triggers on ai-world-sdk, createProvider, sdkConfig, generateText, streamText, generateImage, doubao, video understanding, VideoUnderstandingClient, MinioStorageClient, minio, ResourceClient, resource management, access control, file sharing, VersionedResourceClient, versioned resource, version management, AgentSkillClient, agent skill, vscode extension, initAIWorld, or any AI model integration.
 ---
 
 # AI World SDK
@@ -12,13 +12,13 @@ ai-world-sdk 是 AI World 平台的 TypeScript SDK，通过 `createProvider` 创
 
 ## When to Use
 
-- 在 ai-world 插件中调用 AI 模型（文本、图像、视频）
+- 在 ai-world 插件中调用 AI 模型（文本、图像、视频生成/理解）
 - 需要初始化 ai-world-sdk 配置
 - 使用 `createProvider` 调用 Vercel AI SDK
 - 使用 Doubao 豆包图像/视频生成
 - 使用 MinIO 对象存储（文件上传/下载/管理）
 - 使用资源管理系统（权限控制: private/specific_users/public）
-- 提交数据库建表/迁移请求
+- 使用版本化资源管理（资源名称+版本号管理）
 - 管理 Agent Skills（上传/下载/删除/列表）
 - **开发 VSCode 扩展**时集成 AI World 登录和 SDK 功能
 
@@ -117,7 +117,10 @@ sdkConfig.setToken('your-jwt-token');
 sdkConfig.setPluginId('my-plugin');
 ```
 
-也可通过环境变量 `DEBUG_TOKEN`、`PLUGIN_ID`、`AI_WORLD_BASE_URL` 自动初始化。
+也可通过环境变量自动初始化：
+- `AI_WORLD_BASE_URL` — 服务端地址，插件 JS 后端启动时由平台自动注入
+- `PLUGIN_ID` — 插件 ID
+- `DEBUG_TOKEN` — 调试用 JWT Token
 
 ## 功能模块
 
@@ -126,9 +129,61 @@ sdkConfig.setPluginId('my-plugin');
 ### Provider 与模型 → `docs/provider-and-models.md`
 
 - `createProvider(provider, endpointType, pluginId)` 创建 Vercel AI SDK Provider
-- Provider 对照表：`api2img`(推荐) / `gemini` / `aihubmix` / `shubiaobiao` / `aiping`
+- Provider 对照表：`api2img`(推荐) / `gemini` / `aihubmix` / `shubiaobiao` / `aiping` / `openrouter` / `kunpo`
+- **OpenRouter**：使用专用代理端点 `/api/llm/openrouter`，模型 ID 格式为 `provider/model`（如 `openai/gpt-4o-mini`、`anthropic/claude-sonnet-4-20250514`、`google/gemini-2.5-flash-preview`）
+- **KUNPO API**：统一 LLM 网关（https://llm.ziy.cc），兼容 OpenAI 接口，使用专用代理端点 `/api/llm/kunpo`，一个 Key 访问 150+ 模型
 - 常用模型列表和 AI SDK 函数速查
 
+#### OpenRouter 快速示例
+
+```typescript
+import { createProvider } from 'ai-world-sdk';
+import { generateText, streamText } from 'ai';
+
+// OpenRouter（endpointType 传 'openai'，SDK 内部自动使用 createOpenRouter）
+const provider = createProvider('openrouter', 'openai', 'my-plugin');
+
+// 非流式
+const result = await generateText({
+  model: provider.languageModel('openai/gpt-4o-mini'),
+  prompt: '你好',
+});
+
+// 流式
+const stream = streamText({
+  model: provider.languageModel('anthropic/claude-sonnet-4-20250514'),
+  prompt: '请介绍人工智能',
+});
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+#### KUNPO API 快速示例
+
+```typescript
+import { createProvider } from 'ai-world-sdk';
+import { generateText, streamText } from 'ai';
+
+// KUNPO API（endpointType 传 'openai'，兼容 OpenAI 接口）
+const provider = createProvider('kunpo', 'openai', 'my-plugin');
+
+// 非流式
+const result = await generateText({
+  model: provider.languageModel('google/gemini-3.1-pro-preview'),
+  prompt: '你好',
+});
+
+// 流式
+const stream = streamText({
+  model: provider.languageModel('anthropic/claude-haiku-4.5'),
+  prompt: '请介绍人工智能',
+});
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
 ### 文本生成 → `docs/text-generation.md`
 
 - `generateText` / `streamText` / `generateObject` / `streamObject`
@@ -139,9 +194,10 @@ sdkConfig.setPluginId('my-plugin');
 - `DoubaoImageGenerationClient`（豆包 Seedream）
 - `GeminiImageGenerationClient`
 
-### 视频生成 → `docs/video-generation.md`
+### 视频生成 & 视频理解 → `docs/video-generation.md`
 
 - `VideoGenerationClient`（豆包 Seedance）
+- `VideoUnderstandingClient`（豆包视频理解，基于 Chat Completions API）
 - `OpenAIVideoGenerationClient`（Sora）
 
 ### MinIO 对象存储 → `docs/minio-storage.md`
@@ -155,10 +211,11 @@ sdkConfig.setPluginId('my-plugin');
 - 三级权限: `private` / `specific_users` / `public`
 - 插件隔离与跨插件访问
 
-### 数据库请求 → `docs/database-requests.md`
+### 版本化资源 → `docs/versioned-resource.md`
 
-- `DatabaseRequestClient` — 建表/迁移请求提交、列表、审核
-- 表名规则: `{pluginId}_{tableName}`
+- `VersionedResourceClient` — 全局版本化资源管理
+- 资源名称为唯一 ID，支持语义化版本号
+- 支持 `latest` 别名获取/下载最新版本
 
 ### Agent Skills → `docs/agent-skills.md`
 

package/skills/ai-world-sdk/docs/provider-and-models.md

@@ -14,7 +14,8 @@
 | `aiping` | `gemini` | 平音 Gemini |
 | `aiping` | `anthropic` | 平音 Claude |
 | `gemini` | `gemini` | Google 原生，仅限 Gemini 系列模型 |
-| `openrouter` | `openrouter` | OpenRouter 兼容，模型兼容 OpenRouter 格式，可包括 GPT、以及经聚合的 Gemini/Claude 等（视 provider 能力），模型ID必须以gateway方式设置，如openai/gpt-4o-mini |
+| `openrouter` | `openai` | OpenRouter 聚合服务，SDK 内部自动使用 `createOpenRouter` 和专用代理端点 `/api/llm/openrouter`。模型 ID 格式为 `provider/model`（如 `openai/gpt-4o-mini`、`anthropic/claude-sonnet-4-20250514`） |
+| `kunpo` | `openai` | KUNPO API 统一 LLM 网关（https://llm.ziy.cc），兼容 OpenAI 接口，一个 Key 访问 150+ 模型。SDK 内部使用 `createOpenAI` 并路由到专用代理 `/api/llm/kunpo` |
 
 ## EndpointType 与模型对应关系
 
@@ -23,9 +24,9 @@
 | `gemini` | Google Gemini | 必须使用 Google 的 Gemini 模型（如 `gemini-2.5-flash`、`gemini-2.5-pro`） |
 | `anthropic` | Claude | 必须使用 Anthropic 的 Claude 模型（如 `claude-sonnet-4-5`、`claude-3-5-sonnet`）；**仅 api2img、shubiaobiao、aiping 支持此 endpoint** |
 | `openai` | OpenAI 兼容 | 模型兼容 OpenAI 格式，可包括 GPT、以及经聚合的 Gemini/Claude 等（视 provider 能力） |
-| `openrouter` | OpenRouter 兼容 | OpenRouter 兼容，模型兼容 OpenRouter 格式，可包括 GPT、以及经聚合的 Gemini/Claude 等（视 provider 能力），模型ID必须以gateway方式设置，如openai/gpt-4o-mini |
+| `openai` | OpenRouter 兼容 | 当 provider 为 `openrouter` 时，`endpointType` 传 `openai`，SDK 内部自动切换到 `createOpenRouter` 和专用代理端点 |
 
-规则：**anthropic 不是 provider**，仅 **api2img**、**shubiaobiao**、**aiping** 支持 EndpointType 为 `anthropic`（调用 Claude）；`gemini` provider 用 `gemini` endpoint，其余按上表组合。
+规则：**anthropic 不是 provider**，仅 **api2img**、**shubiaobiao**、**aiping** 支持 EndpointType 为 `anthropic`（调用 Claude）；`gemini` provider 用 `gemini` endpoint；`openrouter` provider 的 `endpointType` 传 `openai`，SDK 内部会自动使用 `@openrouter/ai-sdk-provider` 的 `createOpenRouter` 并路由到专用代理 `/api/llm/openrouter`；`kunpo` provider 的 `endpointType` 传 `openai`，SDK 内部使用 `createOpenAI` 并路由到专用代理 `/api/llm/kunpo`；其余按上表组合。
 
 > `doubao` 不通过 `createProvider` 使用，豆包有专用客户端（见 image-generation.md / video-generation.md）。
 
@@ -53,6 +54,20 @@ const p = createProvider('api2img', 'openai', 'my-plugin');
 p.languageModel('gpt-4o-mini');
 p.languageModel('gemini-2.5-flash');
 p.languageModel('claude-sonnet-4-5');
+
+// OpenRouter（endpointType 传 'openai'，SDK 内部自动切换到 createOpenRouter + 专用代理）
+// 模型 ID 必须使用 provider/model 格式
+const or = createProvider('openrouter', 'openai', 'my-plugin');
+or.languageModel('openai/gpt-4o-mini');
+or.languageModel('anthropic/claude-sonnet-4-20250514');
+or.languageModel('google/gemini-2.5-flash-preview');
+
+// KUNPO API（endpointType 传 'openai'，SDK 内部使用 createOpenAI + 专用代理 /api/llm/kunpo）
+// 兼容 OpenAI Chat Completions 格式，支持 150+ 模型
+const kp = createProvider('kunpo', 'openai', 'my-plugin');
+kp.languageModel('google/gemini-3.1-pro-preview');
+kp.languageModel('anthropic/claude-haiku-4.5');
+kp.languageModel('GLM-5.1');
 ```
 
 ### 检测模型可用性
@@ -70,6 +85,14 @@ const ok = await checkModel('api2img', 'openai', 'gpt-4o-mini', 'my-plugin');
 | `gemini-2.5-flash` / `gemini-2.5-pro` | 文本 | `gemini` | `gemini`（仅 Google） |
 | `claude-sonnet-4-6` / `claude-opus-4-6` | 文本 | `api2img`、`shubiaobiao` 或 `aiping` | `anthropic`（仅 Claude） |
 | `dall-e-3` / `gpt-image-1` | 图像 | `api2img`、`shubiaobiao` 或 `aiping` | `openai` |
+| `openai/gpt-4o-mini` / `openai/gpt-4o` | 文本 | `openrouter` | `openai`（SDK 自动处理） |
+| `anthropic/claude-sonnet-4-20250514` | 文本 | `openrouter` | `openai`（SDK 自动处理） |
+| `google/gemini-2.5-flash-preview` | 文本 | `openrouter` | `openai`（SDK 自动处理） |
+| `google/gemini-3.1-pro-preview` | 文本 | `kunpo` | `openai`（KUNPO API） |
+| `anthropic/claude-haiku-4.5` | 文本 | `kunpo` | `openai`（KUNPO API） |
+| `GLM-5.1` / `z-ai/glm-5v-turbo` | 文本 | `kunpo` | `openai`（KUNPO API） |
+| `x-ai/grok-4.20` | 文本 | `kunpo` | `openai`（KUNPO API） |
+| `google/gemma-4-26b-a4b-it` | 文本 | `kunpo` | `openai`（KUNPO API） |
 | `doubao-seedream-4-5-251128` | 图像 | — | 专用客户端 |
 
 ## AI SDK 函数速查

package/skills/ai-world-sdk/docs/versioned-resource.md

@@ -0,0 +1,64 @@
+# 版本化资源管理
+
+独立于 SharedResource 的版本化资源系统。资源名称为全局唯一标识（不区分用户），支持语义化版本号管理。
+存储在 MinIO `ai-world-res` bucket 的 `resources/{name}/{version}/{filename}` 路径下。
+
+## 基本用法
+
+```typescript
+import { VersionedResourceClient } from 'ai-world-sdk';
+
+const vr = new VersionedResourceClient();
+
+// 上传新版本（版本号必须高于当前最新版本）
+const file = new File(['{"key": "value"}'], 'config.json', { type: 'application/json' });
+const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+
+// 上传更高版本
+const file2 = new File(['{"key": "new"}'], 'config.json', { type: 'application/json' });
+await vr.upload('my-config', '1.1.0', file2, '更新配置');
+
+// 获取最新版本信息
+const latest = await vr.getLatest('my-config');
+console.log(latest.version); // "1.1.0"
+
+// 获取指定版本信息
+const v1 = await vr.getVersion('my-config', '1.0.0');
+
+// 列出所有版本（按版本号降序）
+const versions = await vr.listVersions('my-config');
+
+// 下载指定版本
+const blob = await vr.download('my-config', '1.0.0');
+
+// 下载最新版本（使用 "latest" 别名）
+const latestBlob = await vr.download('my-config', 'latest');
+
+// 列出所有资源（分页，聚合最新版本信息）
+const list = await vr.list({ page: 1, pageSize: 20, search: 'config' });
+
+// 删除指定版本
+await vr.deleteVersion('my-config', '1.0.0');
+```
+
+## 版本号规则
+
+| 规则 | 说明 |
+|------|------|
+| 格式 | 语义化版本号（semver），如 `1.0.0`、`2.1.3` |
+| 唯一性 | 同一资源名称下版本号唯一 |
+| 递增约束 | 上传新版本时，版本号必须高于当前最新版本 |
+| latest 别名 | 获取/下载时可使用 `latest` 代替具体版本号 |
+
+## 权限模型
+
+| 操作 | 权限要求 |
+|------|----------|
+| 上传/删除 | `can_upload_shared_resources` 权限 |
+| 查看/下载 | 所有已登录用户 |
+
+## 与 SharedResource / ResourceClient 的区别
+
+- `SharedResource` — 平台级文件共享，按用户上传，无版本概念
+- `ResourceClient` — 插件级资源管理，按 plugin_id 隔离，三级 ACL
+- `VersionedResourceClient` — 全局版本化资源，资源名称为唯一 ID，支持多版本管理

package/skills/ai-world-sdk/docs/video-generation.md

@@ -1,4 +1,4 @@
-# 视频生成
+# 视频生成 & 视频理解
 
 ## 豆包视频生成（Seedance）
 
@@ -26,6 +26,109 @@ if (result.status === 'succeeded') {
 }
 ```
 
+## 豆包视频理解
+
+使用 `VideoUnderstandingClient` 分析视频内容。基于 Chat Completions API，支持传入视频 URL 进行理解分析。
+
+参考文档: https://www.volcengine.com/docs/82379/1895586
+
+### 支持的模型
+
+| 模型 | 说明 |
+|------|------|
+| `doubao-seed-2-0-pro-260215` | 专业级视频理解 |
+| `doubao-seed-2-0-lite-260215` | 轻量级视频理解 |
+| `doubao-seed-2-0-mini-260215` | mini级视频理解 |
+| `doubao-seed-2-0-code-preview-260215` | 代码预览视频理解 |
+
+### 简化用法（推荐）
+
+```typescript
+import { VideoUnderstandingClient } from 'ai-world-sdk';
+
+const client = new VideoUnderstandingClient({});
+
+// 一行代码分析视频
+const description = await client.analyzeVideo(
+  'https://example.com/video.mp4',
+  { prompt: '请详细描述这个视频的内容' }
+);
+console.log(description);
+```
+
+### 非流式请求
+
+```typescript
+const response = await client.understand({
+  video_url: 'https://example.com/video.mp4',
+  prompt: '这个视频讲了什么？',
+  model: 'doubao-seed-2-0-pro-260215',
+  fps: 1,         // 可选，视频采样帧率，默认为1秒，即每秒从视频中抽取一帧图像
+});
+
+console.log(response.choices[0].message.content);
+console.log(response.usage); // { prompt_tokens, completion_tokens, total_tokens }
+```
+
+### 流式请求
+
+```typescript
+// 方式1: 使用便捷方法
+const text = await client.analyzeVideoStream(
+  'https://example.com/video.mp4',
+  {
+    prompt: '描述视频内容',
+    onChunk: (chunk) => process.stdout.write(chunk),
+  }
+);
+
+// 方式2: 使用 AsyncGenerator
+for await (const chunk of client.understandStream({
+  video_url: 'https://example.com/video.mp4',
+  prompt: '描述视频内容',
+})) {
+  const content = chunk.choices?.[0]?.delta?.content;
+  if (content) process.stdout.write(content);
+}
+```
+
+### 高级用法（完整 messages）
+
+```typescript
+const response = await client.understand({
+  model: 'doubao-seed-2-0-pro-260215',
+  messages: [
+    { role: 'system', content: '你是一个专业的视频分析助手' },
+    {
+      role: 'user',
+      content: [
+        { type: 'text', text: '请分析这个视频中的关键事件' },
+        {
+          type: 'video_url',
+          video_url: {
+            url: 'https://example.com/video.mp4',
+          },
+        },
+      ],
+    },
+  ],
+});
+```
+
+### 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `video_url` | `string` | 与 messages 二选一 | 视频 URL |
+| `prompt` | `string` | 否 | 提示词（默认: "请详细描述这个视频的内容"） |
+| `fps` | `number` | 否 | 视频采样帧率，较高值提取更多帧但消耗更多 token |
+| `model` | `string` | 否 | 模型名称（默认: doubao-seed-2-0-pro-260215） |
+| `messages` | `VideoUnderstandingMessage[]` | 与 video_url 二选一 | 完整消息列表（高级用法） |
+| `stream` | `boolean` | 否 | 是否流式输出（默认: false） |
+| `max_tokens` | `number` | 否 | 最大输出 token 数（默认: 4096） |
+| `temperature` | `number` | 否 | 采样温度 0.0-2.0 |
+| `top_p` | `number` | 否 | 核采样参数 0.0-1.0 |
+
 ## OpenAI 视频生成（Sora）
 
 ```typescript

package/dist/database-requests.d.ts

@@ -1,151 +0,0 @@
-/**
- * Database Request Client
- * 数据库请求客户端
- * 通过后端 /api/database 提交建表/迁移请求，查看请求列表和详情
- * 所有登录用户可提交请求，管理员可审核
- */
-export interface DatabaseRequestClientConfig {
-    baseUrl?: string;
-    token?: string;
-    headers?: Record<string, string>;
-}
-export type RequestType = "create" | "migrate";
-export type RequestStatus = "pending" | "approved" | "rejected";
-export interface ColumnDefinition {
-    name: string;
-    type: string;
-    primary_key?: boolean;
-    auto_increment?: boolean;
-    nullable?: boolean;
-    default?: unknown;
-    length?: number;
-    precision?: number;
-    scale?: number;
-}
-export interface IndexDefinition {
-    name: string;
-    columns: string[];
-    unique?: boolean;
-}
-export interface ForeignKeyDefinition {
-    column: string;
-    references_table: string;
-    references_column: string;
-    on_delete?: string;
-}
-export interface SchemaDefinition {
-    columns: ColumnDefinition[];
-    indexes?: IndexDefinition[];
-    foreign_keys?: ForeignKeyDefinition[];
-}
-export interface SubmitCreateRequestOptions {
-    tableName: string;
-    schemaDefinition: SchemaDefinition;
-    description?: string;
-}
-export interface SubmitMigrateRequestOptions {
-    tableName: string;
-    migrationSql: string;
-    description?: string;
-}
-export interface DatabaseRequestInfo {
-    id: number;
-    requester_id: number;
-    plugin_id: string;
-    table_name: string;
-    request_type: RequestType;
-    schema_definition: SchemaDefinition | null;
-    migration_sql: string | null;
-    description: string | null;
-    status: RequestStatus;
-    reviewer_id: number | null;
-    review_comment: string | null;
-    created_at: string;
-    reviewed_at: string | null;
-}
-export interface ListRequestsOptions {
-    status?: RequestStatus;
-    page?: number;
-    pageSize?: number;
-}
-/**
- * Database Request Client
- * 数据库请求客户端类
- *
- * @example
- * ```typescript
- * import { DatabaseRequestClient, sdkConfig } from 'ai-world-sdk';
- *
- * sdkConfig.setPluginId('my-plugin');
- * const dbRequests = new DatabaseRequestClient();
- *
- * // 提交建表请求
- * const req = await dbRequests.submitCreateRequest({
- *   tableName: 'user_scores',
- *   schemaDefinition: {
- *     columns: [
- *       { name: 'id', type: 'integer', primary_key: true, auto_increment: true, nullable: false },
- *       { name: 'user_id', type: 'integer', nullable: false },
- *       { name: 'score', type: 'float', nullable: false },
- *     ],
- *     indexes: [{ name: 'idx_user_id', columns: ['user_id'] }],
- *   },
- *   description: '用户评分表',
- * });
- *
- * // 提交迁移请求
- * const migrateReq = await dbRequests.submitMigrateRequest({
- *   tableName: 'user_scores',
- *   migrationSql: 'ALTER TABLE my_plugin_user_scores ADD COLUMN level INTEGER DEFAULT 0;',
- *   description: '添加 level 字段',
- * });
- *
- * // 列出我的请求
- * const list = await dbRequests.listRequests({ status: 'pending' });
- *
- * // 获取请求详情
- * const detail = await dbRequests.getRequest(req.id);
- *
- * // 获取请求总数
- * const total = await dbRequests.getRequestCount({ status: 'pending' });
- * ```
- */
-export declare class DatabaseRequestClient {
-    private baseUrl;
-    private headers;
-    constructor(config?: DatabaseRequestClientConfig);
-    private getPluginId;
-    private handleErrorResponse;
-    /**
-     * Submit a table creation request
-     * 提交建表请求
-     */
-    submitCreateRequest(options: SubmitCreateRequestOptions): Promise<DatabaseRequestInfo>;
-    /**
-     * Submit a migration request
-     * 提交迁移请求
-     */
-    submitMigrateRequest(options: SubmitMigrateRequestOptions): Promise<DatabaseRequestInfo>;
-    /**
-     * List requests (admin sees all, regular users see own)
-     * 列出请求列表（管理员看全部，普通用户看自己的）
-     */
-    listRequests(options?: ListRequestsOptions): Promise<DatabaseRequestInfo[]>;
-    /**
-     * Get request count
-     * 获取请求总数
-     */
-    getRequestCount(options?: {
-        status?: RequestStatus;
-    }): Promise<number>;
-    /**
-     * Get request detail by ID
-     * 获取请求详情
-     */
-    getRequest(requestId: number): Promise<DatabaseRequestInfo>;
-    /**
-     * Review a request (approve/reject) - requires can_manage_database permission
-     * 审核请求（通过/拒绝）- 需要 can_manage_database 权限
-     */
-    reviewRequest(requestId: number, action: "approve" | "reject", comment?: string): Promise<DatabaseRequestInfo>;
-}