ai-world-sdk 1.5.6 → 1.5.7

package/dist/cli/commands/plugin.js

@@ -185,10 +185,16 @@ function registerPluginCommands(program) {
     });
     plugin
         .command('create')
-        .argument('<zip-file>')
-        .requiredOption('--plugin-id <id>')
-        .option('--name <name>')
-        .option('--description <text>')
+        .argument('[zip-file]', '静态文件 zip 包路径（可选）')
+        .requiredOption('--plugin-id <id>', '插件 ID')
+        .option('--name <name>', '插件名称')
+        .option('--description <text>', '插件描述')
+        .option('--author <author>', '插件作者')
+        .option('--version <ver>', '插件版本')
+        .option('--server-zip <path>', 'JS 后端 zip 包路径')
+        .option('--backend-entry <entry>', 'JS 后端入口文件（默认 index.js）')
+        .option('--backend-websocket', '启用 WebSocket 代理')
+        .option('--disable-sdk-update-notice', '禁用 SDK 更新提示')
         .action(async (zipFile, options, cmd) => {
         const commandName = 'plugin create';
         try {
@@ -200,12 +206,58 @@ function registerPluginCommands(program) {
             });
             (0, utils_1.initSDK)(auth);
             const client = new plugin_management_1.PluginManagementClient();
-            const staticZip = (0, utils_1.readFileAsFile)(zipFile);
             const res = await client.create({
                 pluginId: options.pluginId,
                 name: options.name,
                 description: options.description,
-                staticZip,
+                author: options.author,
+                version: options.version,
+                staticZip: zipFile ? (0, utils_1.readFileAsFile)(zipFile) : undefined,
+                serverZip: options.serverZip ? (0, utils_1.readFileAsFile)(options.serverZip) : undefined,
+                backendEntry: options.backendEntry,
+                backendWebsocket: options.backendWebsocket === true ? true : undefined,
+                disableSdkUpdateNotice: options.disableSdkUpdateNotice === true ? true : undefined,
+            });
+            (0, output_1.output)(res, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    plugin
+        .command('update')
+        .argument('[zip-file]', '静态文件 zip 包路径（可选）')
+        .requiredOption('--plugin-id <id>', '要更新的插件 ID')
+        .option('--name <name>', '插件名称')
+        .option('--description <text>', '插件描述')
+        .option('--author <author>', '插件作者')
+        .option('--version <ver>', '插件版本')
+        .option('--server-zip <path>', 'JS 后端 zip 包路径')
+        .option('--backend-entry <entry>', 'JS 后端入口文件（默认 index.js）')
+        .option('--backend-websocket', '启用 WebSocket 代理')
+        .option('--disable-sdk-update-notice', '禁用 SDK 更新提示')
+        .action(async (zipFile, options, cmd) => {
+        const commandName = 'plugin update';
+        try {
+            const o = collectOpts(cmd);
+            const auth = (0, config_1.resolveAuth)({
+                baseUrl: o.baseUrl,
+                token: o.token,
+                pluginId: o.pluginId,
+            });
+            (0, utils_1.initSDK)(auth);
+            const client = new plugin_management_1.PluginManagementClient();
+            const res = await client.update({
+                pluginId: options.pluginId,
+                name: options.name,
+                description: options.description,
+                author: options.author,
+                version: options.version,
+                staticZip: zipFile ? (0, utils_1.readFileAsFile)(zipFile) : undefined,
+                serverZip: options.serverZip ? (0, utils_1.readFileAsFile)(options.serverZip) : undefined,
+                backendEntry: options.backendEntry,
+                backendWebsocket: options.backendWebsocket === true ? true : undefined,
+                disableSdkUpdateNotice: options.disableSdkUpdateNotice === true ? true : undefined,
             });
             (0, output_1.output)(res, (0, utils_1.getFormat)(program));
         }

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.6";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.7";
 /**
  * 版本兼容性错误
  */
@@ -35,8 +35,8 @@ declare class SDKConfig {
     private _authCheckPromise;
     private _currentUser;
     private _cliMode;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.6";
-    readonly sdkVersion = "1.5.6";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.7";
+    readonly sdkVersion = "1.5.7";
     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.5.6";
+const SDK_VERSION = "1.5.7";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.5.6";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.6";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.7";
 /**
  * 版本兼容性错误
  */

package/dist/plugin-management.d.ts

@@ -49,6 +49,18 @@ export interface CreatePluginData {
     backendWebsocket?: boolean;
     disableSdkUpdateNotice?: boolean;
 }
+export interface UpdatePluginData {
+    pluginId: string;
+    name?: string;
+    description?: string;
+    author?: string;
+    version?: string;
+    staticZip?: File | Blob;
+    serverZip?: File | Blob;
+    backendEntry?: string;
+    backendWebsocket?: boolean;
+    disableSdkUpdateNotice?: boolean;
+}
 export interface PluginStatus {
     plugin_id: string;
     enabled: boolean;
@@ -110,6 +122,7 @@ export declare class PluginManagementClient {
     get(pluginId: string): Promise<PluginInfo>;
     getStatus(pluginId: string): Promise<PluginStatus>;
     create(data: CreatePluginData): Promise<PluginInfo>;
+    update(data: UpdatePluginData): Promise<PluginInfo>;
     delete(pluginId: string): Promise<{
         message: string;
     }>;

package/dist/plugin-management.js

@@ -136,6 +136,41 @@ class PluginManagementClient {
             await this.handleErrorResponse(response);
         return (await response.json());
     }
+    async update(data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/plugins/update`;
+        const formData = new FormData();
+        formData.append("plugin_id", data.pluginId);
+        if (data.name)
+            formData.append("name", data.name);
+        if (data.description)
+            formData.append("description", data.description);
+        if (data.author)
+            formData.append("author", data.author);
+        if (data.version)
+            formData.append("version", data.version);
+        if (data.staticZip)
+            formData.append("static_zip", data.staticZip);
+        if (data.serverZip)
+            formData.append("server_zip", data.serverZip);
+        if (data.backendEntry)
+            formData.append("backend_entry", data.backendEntry);
+        if (data.backendWebsocket !== undefined)
+            formData.append("backend_websocket", String(data.backendWebsocket));
+        if (data.disableSdkUpdateNotice !== undefined)
+            formData.append("disable_sdk_update_notice", String(data.disableSdkUpdateNotice));
+        const uploadHeaders = { ...this.headers };
+        delete uploadHeaders["Content-Type"];
+        (0, log_1.logRequest)("POST", url, uploadHeaders);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: uploadHeaders,
+            body: formData,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
     async delete(pluginId) {
         config_1.sdkConfig.ensureVersionCompatible();
         const url = `${this.baseUrl}/api/plugins/${pluginId}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "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

@@ -133,6 +133,7 @@ sdkConfig.setPluginId('my-plugin');
 - `createProvider(provider, endpointType, pluginId)` 创建 Vercel AI SDK Provider
 - 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`）
+- **OpenRouter Reasoning**：通过 `providerOptions.openrouter.reasoning` 启用模型思考，支持 `effort`（`xhigh`/`high`/`medium`/`low`/`minimal`）和 `max_tokens` 参数，适用于 Claude / DeepSeek-R1 / o1 / o3 / Gemini 等支持思考的模型
 - **KUNPO API**：统一 LLM 网关（https://llm.ziy.cc），兼容 OpenAI 接口，使用专用代理端点 `/api/llm/kunpo`，一个 Key 访问 150+ 模型
 - 常用模型列表和 AI SDK 函数速查
 
@@ -159,6 +160,22 @@ const stream = streamText({
 for await (const chunk of stream.textStream) {
   process.stdout.write(chunk);
 }
+
+// 启用思考/推理（OpenRouter / KUNPO 均支持）
+const thinkResult = await generateText({
+  model: provider.languageModel('anthropic/claude-sonnet-4-20250514'),
+  prompt: '证明根号2是无理数',
+  providerOptions: {
+    openrouter: {
+      reasoning: {
+        effort: 'high',         // 思考深度: xhigh / high / medium / low / minimal
+        // max_tokens: 10000,   // 可选：限制思考 token 数量
+      },
+    },
+  },
+});
+console.log('思考过程:', thinkResult.reasoning);
+console.log('最终回答:', thinkResult.text);
 ```
 
 #### KUNPO API 快速示例
@@ -247,7 +264,10 @@ for await (const chunk of stream.textStream) {
 
 ### 平台通用 API → `docs/platform-api.md`
 
-- `PluginManagementClient` — 插件 CRUD、启用/禁用/重载/重启、模板管理
+- `PluginManagementClient` — 插件 CRUD（`create` / `update` 分离）、启用/禁用/重载/重启、模板管理
+  - `create(data)` — 创建新插件（POST `/api/plugins/create`），插件不存在时使用
+  - `update(data)` — 更新已有插件（POST `/api/plugins/update`），插件必须已存在，未传入的字段保留原值
+  - 两者均支持: pluginId / name / description / author / version / staticZip / serverZip / backendEntry / backendWebsocket / disableSdkUpdateNotice
 - `StatsClient` — AI 接口调用统计/趋势、插件访问统计（管理员）
 - `DashboardClient` — 当前用户统计（无需管理员权限）
 - `SharedResourceClient` — 平台级文件共享（与 `ResourceClient` 的插件级 ACL 不同）
@@ -285,6 +305,12 @@ ai-world text stream --prompt "请介绍人工智能"
 # 查看插件列表
 ai-world plugin list --format table
 
+# 创建插件
+ai-world plugin create ./dist.zip --plugin-id my-plugin --name "My Plugin" --version 1.0.0
+
+# 更新插件（插件必须已存在，未传入的字段保留原值）
+ai-world plugin update ./dist.zip --plugin-id my-plugin --version 1.1.0
+
 # 版本检查
 ai-world version
 ```