ai-world-sdk 1.5.13 → 1.5.16

package/dist/__tests__/config-dotenv.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/config-dotenv.test.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const TEST_DIR = path.join(__dirname, "__config_dotenv_test_tmp__");
+beforeEach(() => {
+    if (!fs.existsSync(TEST_DIR)) {
+        fs.mkdirSync(TEST_DIR, { recursive: true });
+    }
+    // 清除相关环境变量
+    delete process.env.AI_WORLD_TOKEN;
+    delete process.env.DEBUG_TOKEN;
+    delete process.env.DEBUG;
+    delete process.env.PLUGIN_ID;
+    delete process.env.AI_WORLD_BASE_URL;
+    delete process.env.AI_WORLD_ENV_FILE;
+});
+afterEach(() => {
+    if (fs.existsSync(TEST_DIR)) {
+        fs.rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+    delete process.env.AI_WORLD_TOKEN;
+    delete process.env.DEBUG_TOKEN;
+    delete process.env.DEBUG;
+    delete process.env.PLUGIN_ID;
+    delete process.env.AI_WORLD_BASE_URL;
+    delete process.env.AI_WORLD_ENV_FILE;
+    jest.resetModules();
+});
+describe("SDKConfig dotenv loading", () => {
+    it("loads AI_WORLD_TOKEN from .env file", () => {
+        const envPath = path.join(TEST_DIR, ".env");
+        fs.writeFileSync(envPath, "AI_WORLD_TOKEN=token-from-env\n");
+        const originalCwd = process.cwd();
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBe("token-from-env");
+        jest.spyOn(process, "cwd").mockReturnValue(originalCwd);
+    });
+    it(".env.local overrides .env", () => {
+        fs.writeFileSync(path.join(TEST_DIR, ".env"), "AI_WORLD_TOKEN=from-env\n");
+        fs.writeFileSync(path.join(TEST_DIR, ".env.local"), "AI_WORLD_TOKEN=from-env-local\n");
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBe("from-env-local");
+    });
+    it("process.env overrides .env.local", () => {
+        fs.writeFileSync(path.join(TEST_DIR, ".env.local"), "AI_WORLD_TOKEN=from-file\n");
+        process.env.AI_WORLD_TOKEN = "from-process-env";
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBe("from-process-env");
+    });
+    it("loads custom env file via AI_WORLD_ENV_FILE (lowest priority)", () => {
+        const customPath = path.join(TEST_DIR, ".env.custom");
+        fs.writeFileSync(customPath, "AI_WORLD_TOKEN=from-custom\nPLUGIN_ID=custom-plugin\n");
+        process.env.AI_WORLD_ENV_FILE = customPath;
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBe("from-custom");
+        expect(sdkConfig.getPluginId()).toBe("custom-plugin");
+    });
+    it("custom env file does not override .env.local", () => {
+        fs.writeFileSync(path.join(TEST_DIR, ".env.local"), "AI_WORLD_TOKEN=from-local\n");
+        const customPath = path.join(TEST_DIR, ".env.custom");
+        fs.writeFileSync(customPath, "AI_WORLD_TOKEN=from-custom\nPLUGIN_ID=custom-plugin\n");
+        process.env.AI_WORLD_ENV_FILE = customPath;
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBe("from-local");
+        expect(sdkConfig.getPluginId()).toBe("custom-plugin");
+    });
+    it("loads AI_WORLD_BASE_URL from .env", () => {
+        fs.writeFileSync(path.join(TEST_DIR, ".env"), "AI_WORLD_BASE_URL=https://my-server.com/\n");
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getServerUrl()).toBe("https://my-server.com");
+    });
+    it("loads DEBUG_TOKEN as fallback when AI_WORLD_TOKEN is not set", () => {
+        fs.writeFileSync(path.join(TEST_DIR, ".env.local"), "DEBUG_TOKEN=debug-fallback\n");
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBe("debug-fallback");
+    });
+    it("works when no .env files exist", () => {
+        jest.spyOn(process, "cwd").mockReturnValue(TEST_DIR);
+        jest.resetModules();
+        const { sdkConfig } = require("../config");
+        expect(sdkConfig.getToken()).toBeNull();
+    });
+});

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.13";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.16";
 /**
  * 版本兼容性错误
  */
@@ -35,8 +35,8 @@ declare class SDKConfig {
     private _authCheckPromise;
     private _currentUser;
     private _cliMode;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.13";
-    readonly sdkVersion = "1.5.13";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.16";
+    readonly sdkVersion = "1.5.16";
     constructor();
     /**
      * Set global base URL
@@ -94,6 +94,12 @@ declare class SDKConfig {
      */
     checkAuthentication(): Promise<boolean>;
     private _performAuthCheck;
+    /**
+     * 加载 .env 文件到 process.env
+     * 优先级（高 → 低）：已有 process.env > .env.local > .env > AI_WORLD_ENV_FILE 指定文件
+     * dotenv 默认不覆盖已存在的环境变量，按优先级从高到低加载即可
+     */
+    private _loadDotenv;
     private _nodeAuthCheck;
     /**
      * 获取当前登录状态

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.13";
+const SDK_VERSION = "1.5.16";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.5.13";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.13";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.16";
 /**
  * 版本兼容性错误
  */
@@ -95,8 +95,9 @@ class SDKConfig {
             }
         }
         else {
-            // 非浏览器环境（Node.js / Vite dev）：从 process.env 读取
+            // 非浏览器环境（Node.js / Vite dev）：先加载 .env 文件，再从 process.env 读取
             try {
+                this._loadDotenv();
                 const token = typeof process !== 'undefined' && process.env?.AI_WORLD_TOKEN;
                 if (token) {
                     this._token = token;
@@ -279,6 +280,41 @@ class SDKConfig {
             return false;
         }
     }
+    /**
+     * 加载 .env 文件到 process.env
+     * 优先级（高 → 低）：已有 process.env > .env.local > .env > AI_WORLD_ENV_FILE 指定文件
+     * dotenv 默认不覆盖已存在的环境变量，按优先级从高到低加载即可
+     */
+    _loadDotenv() {
+        try {
+            const dotenv = require('dotenv');
+            const path = require('path');
+            const fs = require('fs');
+            const cwd = process.cwd();
+            console.log('server cwd:', cwd);
+            // .env.local 优先级最高（仅次于已有 process.env）
+            const envLocalPath = path.resolve(cwd, '.env.local');
+            if (fs.existsSync(envLocalPath)) {
+                dotenv.config({ path: envLocalPath });
+            }
+            // .env 次之
+            const envPath = path.resolve(cwd, '.env');
+            if (fs.existsSync(envPath)) {
+                dotenv.config({ path: envPath });
+            }
+            // 用户通过 AI_WORLD_ENV_FILE 指定自定义 .env 文件（最低优先级）
+            const customEnvFile = process.env.AI_WORLD_ENV_FILE;
+            if (customEnvFile) {
+                const customPath = path.isAbsolute(customEnvFile) ? customEnvFile : path.resolve(cwd, customEnvFile);
+                if (fs.existsSync(customPath)) {
+                    dotenv.config({ path: customPath });
+                }
+            }
+        }
+        catch {
+            // dotenv 不可用或文件加载失败时静默忽略
+        }
+    }
     _nodeAuthCheck(baseUrl, token) {
         return new Promise((resolve) => {
             try {

package/dist/login.js

@@ -98,9 +98,13 @@ function validateToken(baseUrl, token) {
                 res.resume();
                 resolve(res.statusCode !== undefined && res.statusCode >= 200 && res.statusCode < 300);
             });
-            req.on("error", () => resolve(false));
+            req.on("error", (e) => {
+                console.error(`[ai-world] 验证 token 失败: `, e);
+                resolve(false);
+            });
         }
-        catch {
+        catch (e) {
+            console.error(`[ai-world] 验证 token 失败: `, e);
             resolve(false);
         }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.5.13",
+  "version": "1.5.16",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -63,11 +63,9 @@
   "author": "ai-world",
   "license": "MIT",
   "devDependencies": {
-    "@types/dotenv": "^8.2.0",
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
     "@types/vscode": "^1.110.0",
-    "dotenv": "^16.0.0",
     "jest": "^29.5.0",
     "ts-jest": "^29.1.0",
     "ts-node": "^10.9.2",
@@ -86,6 +84,7 @@
     "@openrouter/ai-sdk-provider": "./pacakges/ai-sdk-provider",
     "ai": "^6.0.162",
     "commander": "^14.0.3",
+    "dotenv": "^16.0.0",
     "undici": "^8.1.0"
   }
 }

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

@@ -119,11 +119,70 @@ sdkConfig.setToken('your-jwt-token');
 sdkConfig.setPluginId('my-plugin');
 ```
 
-也可通过环境变量自动初始化：
+也可通过环境变量自动初始化（SDK 自动读取 `.env.local` > `.env` > `AI_WORLD_ENV_FILE` 指定文件）：
 - `AI_WORLD_BASE_URL` — 服务端地址，插件 JS 后端启动时由平台自动注入
 - `PLUGIN_ID` — 插件 ID
 - `DEBUG_TOKEN` — 调试用 JWT Token
 - `AI_WORLD_TOKEN` — 用户登录后获取的 JWT Token
+- `AI_WORLD_ENV_FILE` — 指定自定义 `.env` 文件路径（绝对或相对路径均可）
+
+### 插件 JS 后端环境（平台自动注入）
+
+当插件配置了 Node.js 后端（`plugin.json` 的 `backend` 字段），平台启动子进程时会自动注入以下环境变量：
+
+| 环境变量 | 说明 |
+|----------|------|
+| `PORT` | **插件后端必须监听的端口**（平台自动分配，范围 19000~19999） |
+| `SERVER_PORT` | 同 `PORT`，兼容别名 |
+| `PLUGIN_ID` | 当前插件 ID |
+| `AI_WORLD_BASE_URL` | 平台后端地址（默认 `http://127.0.0.1:8000`） |
+| `AI_WORLD_ENV_FILE` | 平台写入的 `.env` 文件路径（`server/.env`），SDK 自动加载 |
+| `NODE_ENV` | 固定为 `production` |
+
+**重要**：插件后端 **必须** 监听 `PORT` 环境变量指定的端口，否则平台无法正确代理请求。
+
+```javascript
+// server/index.js 示例
+const express = require('express');
+const app = express();
+const port = process.env.PORT || 3000;
+
+app.get('/health', (req, res) => res.json({ status: 'ok' }));
+app.get('/api/hello', (req, res) => res.json({ message: 'Hello from plugin backend!' }));
+
+app.listen(port, () => {
+  console.log(`Plugin backend listening on port ${port}`);
+});
+```
+
+### 插件前端请求插件后端（HTTP 代理）
+
+平台为每个 JS 后端插件注册了 HTTP 反向代理路由，**插件前端不需要知道后端实际端口**，统一通过以下地址访问：
+
+```
+{AI_WORLD_BASE_URL}/api/{plugin-id}/server/{path}
+```
+
+例如插件 ID 为 `my-plugin`，后端有 `/api/hello` 接口，前端请求地址为：
+
+```
+https://aiworld.local:8000/api/my-plugin/server/api/hello
+```
+
+在插件前端代码中使用 `sdkConfig` 获取 baseUrl：
+
+```typescript
+import { sdkConfig } from 'ai-world-sdk';
+
+// 插件前端请求插件后端
+const baseUrl = sdkConfig.getServerUrl();
+const pluginId = sdkConfig.getPluginId();
+const response = await fetch(`${baseUrl}/api/${pluginId}/server/api/hello`, {
+  headers: { 'Authorization': `Bearer ${sdkConfig.getToken()}` }
+});
+```
+
+WebSocket 同理：`ws(s)://{host}/api/{plugin-id}/server/ws`
 
 ## 功能模块