ai-world-sdk 1.5.12 → 1.5.15

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/cli/commands/config-cmd.js

@@ -72,7 +72,7 @@ function registerConfigCommands(program) {
                 merged[key] = {
                     value: val,
                     source: key === 'token'
-                        ? (saved.token ? 'config' : (process.env.DEBUG_TOKEN ? 'env' : 'none'))
+                        ? (saved.token ? 'config' : (process.env.AI_WORLD_TOKEN || process.env.DEBUG_TOKEN ? 'env' : 'none'))
                         : (hasSaved ? 'config' : (val !== null ? 'default' : 'none')),
                 };
             }

package/dist/cli/config.js

@@ -95,7 +95,7 @@ function getEffectiveConfig() {
     const result = {};
     for (const key of VALID_KEYS) {
         if (key === 'token') {
-            result[key] = config.token || process.env.DEBUG_TOKEN || null;
+            result[key] = config.token || process.env.AI_WORLD_TOKEN || process.env.DEBUG_TOKEN || null;
         }
         else {
             result[key] = config[key] || DEFAULTS[key] || null;
@@ -109,7 +109,7 @@ function getConfigValue(key) {
 function getEffectiveValue(key) {
     const config = readConfig();
     if (key === 'token') {
-        return config.token || process.env.DEBUG_TOKEN || null;
+        return config.token || process.env.AI_WORLD_TOKEN || process.env.DEBUG_TOKEN || null;
     }
     return config[key] || DEFAULTS[key] || null;
 }
@@ -144,6 +144,7 @@ function resolveAuth(opts) {
             config['base-url'] ||
             'https://aiworld.local:8000',
         token: opts.token ||
+            process.env.AI_WORLD_TOKEN ||
             process.env.DEBUG_TOKEN ||
             config.token ||
             null,

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.12";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.15";
 /**
  * 版本兼容性错误
  */
@@ -35,8 +35,8 @@ declare class SDKConfig {
     private _authCheckPromise;
     private _currentUser;
     private _cliMode;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.12";
-    readonly sdkVersion = "1.5.12";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.15";
+    readonly sdkVersion = "1.5.15";
     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.12";
+const SDK_VERSION = "1.5.15";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.5.12";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.12";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.15";
 /**
  * 版本兼容性错误
  */
@@ -95,11 +95,18 @@ class SDKConfig {
             }
         }
         else {
-            // 非浏览器环境（Node.js / Vite dev）：从 process.env 读取
+            // 非浏览器环境（Node.js / Vite dev）：先加载 .env 文件，再从 process.env 读取
             try {
-                const debugToken = typeof process !== 'undefined' && process.env?.DEBUG_TOKEN;
-                if (debugToken) {
-                    this._token = debugToken;
+                this._loadDotenv();
+                const token = typeof process !== 'undefined' && process.env?.AI_WORLD_TOKEN;
+                if (token) {
+                    this._token = token;
+                }
+                else {
+                    const debugToken = typeof process !== 'undefined' && process.env?.DEBUG_TOKEN;
+                    if (debugToken) {
+                        this._token = debugToken;
+                    }
                 }
                 const debugFlag = typeof process !== 'undefined' && process.env?.DEBUG;
                 if (debugFlag === 'true') {
@@ -273,6 +280,40 @@ 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();
+            // .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/llm.js

@@ -7,7 +7,7 @@ const google_1 = require("@ai-sdk/google");
 const openai_1 = require("@ai-sdk/openai");
 const config_1 = require("./config");
 const ai_1 = require("ai");
-const ai_sdk_provider_1 = require("@openrouter/ai-sdk-provider");
+const dist_1 = require("../pacakges/ai-sdk-provider/dist");
 /**
  * 根据端点类型创建 ai-sdk ProviderV3
  * 所有请求会通过后端代理（/api/llm/{endpointType}）转发到实际 API
@@ -30,11 +30,11 @@ function createProvider(provider, endpointType, pluginId) {
     };
     if (provider === "openrouter") {
         settings.baseURL = `${serverUrl}/api/llm/openrouter`;
-        return (0, ai_sdk_provider_1.createOpenRouter)(settings);
+        return (0, dist_1.createOpenRouter)(settings);
     }
     else if (provider === "kunpo") {
         settings.baseURL = `${serverUrl}/api/llm/kunpo`;
-        return (0, ai_sdk_provider_1.createOpenRouter)(settings);
+        return (0, dist_1.createOpenRouter)(settings);
     }
     switch (endpointType) {
         case "openai":

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/dist/vite-plugin.js

@@ -26,6 +26,8 @@ function aiWorldPlugin(options = {}) {
             const config = { baseUrl };
             if (env["DEBUG_TOKEN"])
                 config.token = env["DEBUG_TOKEN"];
+            if (env["AI_WORLD_TOKEN"])
+                config.token = env["AI_WORLD_TOKEN"];
             if (env["PLUGIN_ID"])
                 config.pluginId = env["PLUGIN_ID"];
             if (env["DEBUG"] === "true")
@@ -43,7 +45,7 @@ function aiWorldPlugin(options = {}) {
                 if (hasLoggedIn)
                     return;
                 const env = (0, login_1.readEnvLocal)(projectRoot);
-                const existingToken = env["DEBUG_TOKEN"] || process.env.DEBUG_TOKEN;
+                const existingToken = env["DEBUG_TOKEN"] || process.env.DEBUG_TOKEN || env["AI_WORLD_TOKEN"] || process.env.AI_WORLD_TOKEN;
                 // 确保 PLUGIN_ID 存在，不存在则从 plugin.json 或目录名推断
                 if (!env["PLUGIN_ID"] && !process.env.PLUGIN_ID) {
                     const pluginId = (0, login_1.resolvePluginId)(projectRoot);

package/package.json

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

@@ -123,6 +123,7 @@ sdkConfig.setPluginId('my-plugin');
 - `AI_WORLD_BASE_URL` — 服务端地址，插件 JS 后端启动时由平台自动注入
 - `PLUGIN_ID` — 插件 ID
 - `DEBUG_TOKEN` — 调试用 JWT Token
+- `AI_WORLD_TOKEN` — 用户登录后获取的 JWT Token
 
 ## 功能模块
 

package/skills/ai-world-sdk/docs/cli-usage.md

@@ -5,12 +5,15 @@
 ## 安装
 
 ```bash
-# 全局安装
+# 全局安装（CLI 工具）
 npm install -g ai-world-sdk
 
 # 或临时使用（无需安装）
 npx ai-world-sdk <command>
 npx ai-world <command>
+
+# 项目中作为依赖安装（用于打包/开发）
+npm install ai-world-sdk ai
 ```
 
 ## 认证
@@ -33,14 +36,14 @@ ai-world login --token <your-jwt-token>
 
 ```bash
 export AI_WORLD_BASE_URL=https://aiworld.local:8000
-export DEBUG_TOKEN=your-jwt-token
+export AI_WORLD_TOKEN=your-jwt-token
 export PLUGIN_ID=my-plugin
 ```
 
 ### 认证优先级（从高到低）
 
 1. 命令行参数：`--token`、`--base-url`、`--plugin-id`
-2. 环境变量：`DEBUG_TOKEN`、`AI_WORLD_BASE_URL`、`PLUGIN_ID`
+2. 环境变量：`AI_WORLD_TOKEN`、`AI_WORLD_BASE_URL`、`PLUGIN_ID`
 3. 本地配置文件：`~/.ai-world/config.json`
 4. 默认值：base-url=`https://aiworld.local:8000`，plugin-id=`cli`，provider=`kunpo`，endpoint=`openai`，model=`deepseek/deepseek-v4-pro`
 
@@ -114,7 +117,7 @@ $ ai-world plugin list --format table
   "code": "AUTH_REQUIRED",
   "message": "未认证",
   "details": {
-    "checked_sources": ["--token flag", "DEBUG_TOKEN env", "~/.ai-world/config.json"],
+    "checked_sources": ["--token flag", "AI_WORLD_TOKEN env", "~/.ai-world/config.json"],
     "suggestion": "运行 `ai-world auth login`"
   },
   "command": "ai-world resource list",