ai-world-sdk 1.5.15 → 1.5.16

package/dist/config.d.ts

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

package/package.json

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

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`
 
 ## 功能模块