ai-world-sdk 1.3.3 → 1.3.5

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.3";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.5";
 /**
  * 版本兼容性错误
  */
@@ -34,8 +34,8 @@ declare class SDKConfig {
     private _authenticated;
     private _authCheckPromise;
     private _currentUser;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.3.3";
-    readonly sdkVersion = "1.3.3";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.3.5";
+    readonly sdkVersion = "1.3.5";
     constructor();
     /**
      * Set global base URL

package/dist/config.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkConfig = exports.VersionCompatibilityError = exports.SDK_SIGNATURE = void 0;
 // SDK 版本号（构建时自动从 package.json 更新）
 // 此版本号会在运行 npm run build 时自动从 package.json 读取并更新
-const SDK_VERSION = "1.3.3";
+const SDK_VERSION = "1.3.5";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.3.3";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.3";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.5";
 /**
  * 版本兼容性错误
  */

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export { OpenAIVideoGenerationClient, type OpenAIVideoGenerationConfig, type Ope
 export { DownloadClient, type DownloadConfig, type DownloadOptions, type StreamDownloadOptions, };
 export { MinioStorageClient, type MinioStorageConfig, type UploadResponse, type ObjectInfo, type PresignedUrlResponse, type UploadOptions, type ListOptions, } from "./minio";
 export { ResourceClient, type ResourceClientConfig, type ResourceInfo, type AccessLevel, type UploadResourceOptions, type ListResourceOptions, } from "./resource";
-export { DatabaseRequestClient, type DatabaseRequestClientConfig, type DatabaseRequestInfo, type RequestType, type RequestStatus, type ColumnDefinition, type IndexDefinition, type ForeignKeyDefinition, type SchemaDefinition, type SubmitCreateRequestOptions, type SubmitMigrateRequestOptions, type ListRequestsOptions, } from "./database-requests";
+export { VersionedResourceClient, type VersionedResourceClientConfig, type VersionedResourceInfo, type VersionedResourceSummary, type VersionedResourceListResponse, type ListVersionedResourceOptions, } from "./versioned-resource";
 export { AgentSkillClient, type AgentSkillClientConfig, type AgentSkillInfo, type AgentSkillListResponse, type ListSkillsOptions, } from "./agent-skills";
 export { AuthClient, getCurrentUserInfo, type AuthConfig, type UserInfo, };
 export { sdkConfig, VersionCompatibilityError, SDK_SIGNATURE, type AuthenticatedUser } from "./config";

package/dist/index.js

@@ -20,7 +20,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.AgentSkillClient = exports.DatabaseRequestClient = exports.ResourceClient = exports.MinioStorageClient = exports.DownloadClient = exports.OpenAIVideoGenerationClient = exports.VideoUnderstandingClient = exports.VideoGenerationClient = exports.GeminiImageGenerationClient = exports.DoubaoImageGenerationClient = exports.ChatAnthropic = exports.ChatGoogleGenerativeAI = exports.ChatOpenAI = exports.BaseChatModel = exports.AIMessageChunk = exports.SystemMessage = exports.AIMessage = exports.HumanMessage = void 0;
+exports.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.AgentSkillClient = exports.VersionedResourceClient = exports.ResourceClient = exports.MinioStorageClient = exports.DownloadClient = exports.OpenAIVideoGenerationClient = exports.VideoUnderstandingClient = exports.VideoGenerationClient = exports.GeminiImageGenerationClient = exports.DoubaoImageGenerationClient = exports.ChatAnthropic = exports.ChatGoogleGenerativeAI = exports.ChatOpenAI = exports.BaseChatModel = exports.AIMessageChunk = exports.SystemMessage = exports.AIMessage = exports.HumanMessage = void 0;
 exports.createChatModel = createChatModel;
 const openai_1 = require("./chat_models/openai");
 const google_1 = require("./chat_models/google");
@@ -60,9 +60,9 @@ Object.defineProperty(exports, "MinioStorageClient", { enumerable: true, get: fu
 // Export resource management client
 var resource_1 = require("./resource");
 Object.defineProperty(exports, "ResourceClient", { enumerable: true, get: function () { return resource_1.ResourceClient; } });
-// Export database request client
-var database_requests_1 = require("./database-requests");
-Object.defineProperty(exports, "DatabaseRequestClient", { enumerable: true, get: function () { return database_requests_1.DatabaseRequestClient; } });
+// Export versioned resource client
+var versioned_resource_1 = require("./versioned-resource");
+Object.defineProperty(exports, "VersionedResourceClient", { enumerable: true, get: function () { return versioned_resource_1.VersionedResourceClient; } });
 // Export agent skill client
 var agent_skills_1 = require("./agent-skills");
 Object.defineProperty(exports, "AgentSkillClient", { enumerable: true, get: function () { return agent_skills_1.AgentSkillClient; } });

package/dist/llm.js

@@ -32,6 +32,10 @@ function createProvider(provider, endpointType, pluginId) {
         settings.baseURL = `${serverUrl}/api/llm/openrouter`;
         return (0, ai_sdk_provider_1.createOpenRouter)(settings);
     }
+    else if (provider === "kunpo") {
+        settings.baseURL = `${serverUrl}/api/llm/kunpo`;
+        return (0, ai_sdk_provider_1.createOpenRouter)(settings);
+    }
     switch (endpointType) {
         case "openai":
             return (0, openai_1.createOpenAI)(settings);

package/dist/provider_config.d.ts

@@ -1,7 +1,7 @@
 /**
  * 模型提供商
  */
-export type AIModelProvider = "api2img" | "aihubmix" | "doubao" | "gemini" | "shubiaobiao" | "anthropic" | "aiping" | "openrouter";
+export type AIModelProvider = "api2img" | "aihubmix" | "doubao" | "gemini" | "shubiaobiao" | "anthropic" | "aiping" | "openrouter" | "kunpo";
 /**
  * 模型端点类型
  * - openai: OpenAI 兼容 API（/v1/chat/completions 等）

package/dist/provider_config.js

@@ -11,6 +11,7 @@ exports.PROVIDER_CONFIGS = {
     gemini: { provider: "gemini", modelType: "gemini" },
     anthropic: { provider: "anthropic", modelType: "anthropic" },
     openrouter: { provider: "openrouter", modelType: "openai" },
+    kunpo: { provider: "kunpo", modelType: "openai" },
 };
 function getProviderConfig(provider) {
     return exports.PROVIDER_CONFIGS[provider];

package/dist/versioned-resource.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端
+ * 通过后端 /api/versioned-resources 操作版本化资源系统
+ * 资源名称为全局唯一标识，支持语义化版本号管理
+ */
+export interface VersionedResourceClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface VersionedResourceInfo {
+    id: number;
+    name: string;
+    version: string;
+    description?: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    uploader_id: number;
+    uploader_name?: string;
+    created_at: string;
+}
+export interface VersionedResourceSummary {
+    name: string;
+    latest_version: string;
+    description?: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    version_count: number;
+    latest_uploader_name?: string;
+    created_at: string;
+}
+export interface VersionedResourceListResponse {
+    items: VersionedResourceSummary[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface ListVersionedResourceOptions {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+}
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { VersionedResourceClient } from 'ai-world-sdk';
+ *
+ * const vr = new VersionedResourceClient();
+ *
+ * // 上传新版本
+ * const file = new File(['content'], 'config.json', { type: 'application/json' });
+ * const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+ *
+ * // 获取最新版本
+ * const latest = await vr.getLatest('my-config');
+ *
+ * // 列出所有版本
+ * const versions = await vr.listVersions('my-config');
+ *
+ * // 下载指定版本
+ * const blob = await vr.download('my-config', '1.0.0');
+ *
+ * // 下载最新版本
+ * const latestBlob = await vr.download('my-config', 'latest');
+ * ```
+ */
+export declare class VersionedResourceClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: VersionedResourceClientConfig);
+    private handleErrorResponse;
+    /**
+     * 上传新版本
+     * @param name 资源名称（全局唯一标识）
+     * @param version 语义化版本号（必须高于当前最新版本）
+     * @param file 文件
+     * @param description 可选的版本描述
+     */
+    upload(name: string, version: string, file: File | Blob, description?: string): Promise<VersionedResourceInfo>;
+    /**
+     * 分页列出所有版本化资源（聚合最新版本信息）
+     */
+    list(options?: ListVersionedResourceOptions): Promise<VersionedResourceListResponse>;
+    /**
+     * 列出指定资源的所有版本（按版本号降序）
+     */
+    listVersions(name: string): Promise<VersionedResourceInfo[]>;
+    /**
+     * 获取指定资源的最新版本信息
+     */
+    getLatest(name: string): Promise<VersionedResourceInfo>;
+    /**
+     * 获取指定版本信息
+     */
+    getVersion(name: string, version: string): Promise<VersionedResourceInfo>;
+    /**
+     * 下载指定版本文件（version 可传 "latest" 下载最新版本）
+     */
+    download(name: string, version: string): Promise<Blob>;
+    /**
+     * 删除指定版本
+     */
+    deleteVersion(name: string, version: string): Promise<{
+        name: string;
+        version: string;
+        deleted: boolean;
+    }>;
+}

package/dist/versioned-resource.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端
+ * 通过后端 /api/versioned-resources 操作版本化资源系统
+ * 资源名称为全局唯一标识，支持语义化版本号管理
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionedResourceClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+// ==================== VersionedResourceClient ====================
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { VersionedResourceClient } from 'ai-world-sdk';
+ *
+ * const vr = new VersionedResourceClient();
+ *
+ * // 上传新版本
+ * const file = new File(['content'], 'config.json', { type: 'application/json' });
+ * const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+ *
+ * // 获取最新版本
+ * const latest = await vr.getLatest('my-config');
+ *
+ * // 列出所有版本
+ * const versions = await vr.listVersions('my-config');
+ *
+ * // 下载指定版本
+ * const blob = await vr.download('my-config', '1.0.0');
+ *
+ * // 下载最新版本
+ * const latestBlob = await vr.download('my-config', 'latest');
+ * ```
+ */
+class VersionedResourceClient {
+    constructor(config = {}) {
+        this.baseUrl =
+            config.baseUrl ||
+                config_1.sdkConfig.getServerUrl() ||
+                (typeof window !== "undefined" ? window.location.origin : "");
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        const globalToken = config.token || config_1.sdkConfig.getToken();
+        this.headers = {
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    async handleErrorResponse(response) {
+        let errorMessage = `Request failed: ${response.status} ${response.statusText}`;
+        try {
+            const errorText = await response.text();
+            const errorJson = JSON.parse(errorText);
+            errorMessage = errorJson.detail || errorMessage;
+        }
+        catch {
+            // ignore parse error
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * 上传新版本
+     * @param name 资源名称（全局唯一标识）
+     * @param version 语义化版本号（必须高于当前最新版本）
+     * @param file 文件
+     * @param description 可选的版本描述
+     */
+    async upload(name, version, file, description) {
+        const params = new URLSearchParams();
+        params.append("name", name);
+        params.append("version", version);
+        if (description)
+            params.append("description", description);
+        const url = `${this.baseUrl}/api/versioned-resources/upload?${params.toString()}`;
+        const formData = new FormData();
+        formData.append("file", file);
+        (0, log_1.debugLog)("VersionedResource", `Uploading ${name}@${version}`);
+        (0, log_1.logRequest)("POST", url);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                ...this.headers,
+            },
+            body: formData,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 分页列出所有版本化资源（聚合最新版本信息）
+     */
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.page)
+            params.append("page", options.page.toString());
+        if (options.pageSize)
+            params.append("page_size", options.pageSize.toString());
+        if (options.search)
+            params.append("search", options.search);
+        const url = `${this.baseUrl}/api/versioned-resources/?${params.toString()}`;
+        (0, log_1.debugLog)("VersionedResource", `Listing resources`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 列出指定资源的所有版本（按版本号降序）
+     */
+    async listVersions(name) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/versions`;
+        (0, log_1.debugLog)("VersionedResource", `Listing versions of ${name}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 获取指定资源的最新版本信息
+     */
+    async getLatest(name) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/latest`;
+        (0, log_1.debugLog)("VersionedResource", `Getting latest version of ${name}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 获取指定版本信息
+     */
+    async getVersion(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}`;
+        (0, log_1.debugLog)("VersionedResource", `Getting ${name}@${version}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 下载指定版本文件（version 可传 "latest" 下载最新版本）
+     */
+    async download(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}/download`;
+        (0, log_1.debugLog)("VersionedResource", `Downloading ${name}@${version}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.blob();
+    }
+    /**
+     * 删除指定版本
+     */
+    async deleteVersion(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}`;
+        (0, log_1.debugLog)("VersionedResource", `Deleting ${name}@${version}`);
+        (0, log_1.logRequest)("DELETE", url);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+}
+exports.VersionedResourceClient = VersionedResourceClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.3.3",
+  "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/understanding, 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, video understanding, VideoUnderstandingClient, 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
@@ -18,7 +18,7 @@ ai-world-sdk 是 AI World 平台的 TypeScript SDK，通过 `createProvider` 创
 - 使用 Doubao 豆包图像/视频生成
 - 使用 MinIO 对象存储（文件上传/下载/管理）
 - 使用资源管理系统（权限控制: private/specific_users/public）
-- 提交数据库建表/迁移请求
+- 使用版本化资源管理（资源名称+版本号管理）
 - 管理 Agent Skills（上传/下载/删除/列表）
 - **开发 VSCode 扩展**时集成 AI World 登录和 SDK 功能
 
@@ -129,8 +129,9 @@ sdkConfig.setPluginId('my-plugin');
 ### Provider 与模型 → `docs/provider-and-models.md`
 
 - `createProvider(provider, endpointType, pluginId)` 创建 Vercel AI SDK Provider
-- Provider 对照表：`api2img`(推荐) / `gemini` / `aihubmix` / `shubiaobiao` / `aiping` / `openrouter`
+- 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 快速示例
@@ -158,6 +159,31 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
+#### 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`
@@ -185,10 +211,11 @@ for await (const chunk of stream.textStream) {
 - 三级权限: `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

@@ -15,6 +15,7 @@
 | `aiping` | `anthropic` | 平音 Claude |
 | `gemini` | `gemini` | Google 原生，仅限 Gemini 系列模型 |
 | `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 与模型对应关系
 
@@ -25,7 +26,7 @@
 | `openai` | OpenAI 兼容 | 模型兼容 OpenAI 格式，可包括 GPT、以及经聚合的 Gemini/Claude 等（视 provider 能力） |
 | `openai` | OpenRouter 兼容 | 当 provider 为 `openrouter` 时，`endpointType` 传 `openai`，SDK 内部自动切换到 `createOpenRouter` 和专用代理端点 |
 
-规则：**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`，其余按上表组合。
+规则：**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）。
 
@@ -60,6 +61,13 @@ 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');
 ```
 
 ### 检测模型可用性
@@ -80,6 +88,11 @@ const ok = await checkModel('api2img', 'openai', 'gpt-4o-mini', 'my-plugin');
 | `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/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>;
-}

package/dist/database-requests.js

@@ -1,242 +0,0 @@
-"use strict";
-/**
- * Database Request Client
- * 数据库请求客户端
- * 通过后端 /api/database 提交建表/迁移请求，查看请求列表和详情
- * 所有登录用户可提交请求，管理员可审核
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DatabaseRequestClient = void 0;
-const config_1 = require("./config");
-const log_1 = require("./log");
-// ==================== DatabaseRequestClient ====================
-/**
- * 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' });
- * ```
- */
-class DatabaseRequestClient {
-    constructor(config = {}) {
-        this.baseUrl =
-            config.baseUrl ||
-                config_1.sdkConfig.getServerUrl() ||
-                (typeof window !== "undefined" ? window.location.origin : "");
-        const globalHeaders = config_1.sdkConfig.getHeaders();
-        const globalToken = config.token || config_1.sdkConfig.getToken();
-        this.headers = {
-            "Content-Type": "application/json",
-            ...globalHeaders,
-            ...config.headers,
-        };
-        if (globalToken) {
-            this.headers["Authorization"] = `Bearer ${globalToken}`;
-        }
-    }
-    getPluginId() {
-        const pluginId = this.headers["X-Plugin-Id"] || config_1.sdkConfig.getPluginId();
-        if (!pluginId) {
-            throw new Error("Plugin ID is required. Set it via sdkConfig.setPluginId() or pass pluginId in headers.");
-        }
-        return pluginId;
-    }
-    async handleErrorResponse(response) {
-        let errorMessage = `Request failed: ${response.status} ${response.statusText}`;
-        try {
-            const errorText = await response.text();
-            const errorJson = JSON.parse(errorText);
-            errorMessage = errorJson.detail || errorMessage;
-        }
-        catch {
-            // ignore parse error
-        }
-        throw new Error(errorMessage);
-    }
-    /**
-     * Submit a table creation request
-     * 提交建表请求
-     */
-    async submitCreateRequest(options) {
-        config_1.sdkConfig.ensureVersionCompatible();
-        const pluginId = this.getPluginId();
-        const body = {
-            plugin_id: pluginId,
-            table_name: options.tableName,
-            request_type: "create",
-            schema_definition: options.schemaDefinition,
-            description: options.description,
-        };
-        const apiUrl = `${this.baseUrl}/api/database/table-requests`;
-        (0, log_1.debugLog)("Submit create request:", body);
-        (0, log_1.logRequest)("POST", apiUrl, this.headers, body);
-        const response = await fetch(apiUrl, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(body),
-        });
-        if (!response.ok) {
-            await this.handleErrorResponse(response);
-        }
-        const result = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
-        return result;
-    }
-    /**
-     * Submit a migration request
-     * 提交迁移请求
-     */
-    async submitMigrateRequest(options) {
-        config_1.sdkConfig.ensureVersionCompatible();
-        const pluginId = this.getPluginId();
-        const body = {
-            plugin_id: pluginId,
-            table_name: options.tableName,
-            request_type: "migrate",
-            migration_sql: options.migrationSql,
-            description: options.description,
-        };
-        const apiUrl = `${this.baseUrl}/api/database/table-requests`;
-        (0, log_1.debugLog)("Submit migrate request:", body);
-        (0, log_1.logRequest)("POST", apiUrl, this.headers, body);
-        const response = await fetch(apiUrl, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(body),
-        });
-        if (!response.ok) {
-            await this.handleErrorResponse(response);
-        }
-        const result = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
-        return result;
-    }
-    /**
-     * List requests (admin sees all, regular users see own)
-     * 列出请求列表（管理员看全部，普通用户看自己的）
-     */
-    async listRequests(options = {}) {
-        config_1.sdkConfig.ensureVersionCompatible();
-        const params = new URLSearchParams();
-        if (options.status)
-            params.append("status", options.status);
-        if (options.page)
-            params.append("page", String(options.page));
-        if (options.pageSize)
-            params.append("page_size", String(options.pageSize));
-        const apiUrl = `${this.baseUrl}/api/database/table-requests?${params.toString()}`;
-        (0, log_1.debugLog)("List requests:", options);
-        (0, log_1.logRequest)("GET", apiUrl, this.headers);
-        const response = await fetch(apiUrl, {
-            method: "GET",
-            headers: this.headers,
-        });
-        if (!response.ok) {
-            await this.handleErrorResponse(response);
-        }
-        const result = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
-        return result;
-    }
-    /**
-     * Get request count
-     * 获取请求总数
-     */
-    async getRequestCount(options = {}) {
-        config_1.sdkConfig.ensureVersionCompatible();
-        const params = new URLSearchParams();
-        if (options.status)
-            params.append("status", options.status);
-        const apiUrl = `${this.baseUrl}/api/database/table-requests/count?${params.toString()}`;
-        (0, log_1.debugLog)("Get request count:", options);
-        (0, log_1.logRequest)("GET", apiUrl, this.headers);
-        const response = await fetch(apiUrl, {
-            method: "GET",
-            headers: this.headers,
-        });
-        if (!response.ok) {
-            await this.handleErrorResponse(response);
-        }
-        const result = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
-        return result.total;
-    }
-    /**
-     * Get request detail by ID
-     * 获取请求详情
-     */
-    async getRequest(requestId) {
-        config_1.sdkConfig.ensureVersionCompatible();
-        const apiUrl = `${this.baseUrl}/api/database/table-requests/${requestId}`;
-        (0, log_1.debugLog)("Get request detail:", { requestId });
-        (0, log_1.logRequest)("GET", apiUrl, this.headers);
-        const response = await fetch(apiUrl, {
-            method: "GET",
-            headers: this.headers,
-        });
-        if (!response.ok) {
-            await this.handleErrorResponse(response);
-        }
-        const result = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
-        return result;
-    }
-    /**
-     * Review a request (approve/reject) - requires can_manage_database permission
-     * 审核请求（通过/拒绝）- 需要 can_manage_database 权限
-     */
-    async reviewRequest(requestId, action, comment) {
-        config_1.sdkConfig.ensureVersionCompatible();
-        const body = { action, comment };
-        const apiUrl = `${this.baseUrl}/api/database/table-requests/${requestId}`;
-        (0, log_1.debugLog)("Review request:", { requestId, ...body });
-        (0, log_1.logRequest)("PATCH", apiUrl, this.headers, body);
-        const response = await fetch(apiUrl, {
-            method: "PATCH",
-            headers: this.headers,
-            body: JSON.stringify(body),
-        });
-        if (!response.ok) {
-            await this.handleErrorResponse(response);
-        }
-        const result = (await response.json());
-        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
-        return result;
-    }
-}
-exports.DatabaseRequestClient = DatabaseRequestClient;

package/skills/ai-world-sdk/docs/database-requests.md

@@ -1,68 +0,0 @@
-# 数据库请求
-
-通过 `DatabaseRequestClient` 提交建表/迁移请求、查看请求列表和详情。所有登录用户可提交请求，管理员审核通过后自动执行。
-
-## 基本用法
-
-```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: '用户评分表',
-});
-
-// 提交迁移请求
-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', page: 1, pageSize: 20 });
-
-// 获取请求总数
-const total = await dbRequests.getRequestCount({ status: 'pending' });
-
-// 获取请求详情
-const detail = await dbRequests.getRequest(req.id);
-
-// 审核请求（需 can_manage_database 权限）
-await dbRequests.reviewRequest(req.id, 'approve', '审核通过');
-```
-
-## 表名规则
-
-- 实际表名 = `{pluginId}_{tableName}`
-- 只允许 `[a-z0-9_]`
-
-## 列类型白名单
-
-integer, bigint, varchar, text, boolean, float, decimal, date, datetime, timestamp, json, jsonb
-
-## 迁移 SQL 限制
-
-禁止: DROP DATABASE, TRUNCATE, DROP SCHEMA
-
-## API 端点
-
-| 方法 | 路径 | 说明 |
-|------|------|------|
-| POST | `/api/database/table-requests` | 提交建表/迁移请求 |
-| GET | `/api/database/table-requests` | 列出请求 |
-| GET | `/api/database/table-requests/count` | 请求总数 |
-| GET | `/api/database/table-requests/{id}` | 请求详情 |
-| PATCH | `/api/database/table-requests/{id}` | 审核请求 |