ai-world-sdk 1.2.7 → 1.3.2

package/dist/vscode-login.js

@@ -0,0 +1,517 @@
+"use strict";
+/**
+ * AI World SDK - VSCode Extension Login
+ * 完整 VSCode 扩展登录集成，一步到位初始化
+ *
+ * 使用方式（最简）:
+ *   import { initAIWorld } from 'ai-world-sdk/vscode';
+ *   export async function activate(ctx: vscode.ExtensionContext) {
+ *     const ai = await initAIWorld(ctx);
+ *   }
+ *
+ * 导出路径: ai-world-sdk/vscode
+ *
+ * 存储：token 等信息通过 vscode.SecretStorage 持久化
+ * pluginId：默认取扩展 package.json 的 name 字段
+ */
+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 });
+exports.AIWorldExtension = void 0;
+exports.initAIWorld = initAIWorld;
+exports.getAIWorld = getAIWorld;
+const vscode = __importStar(require("vscode"));
+const http = __importStar(require("http"));
+const config_1 = require("./config");
+const login_1 = require("./login");
+// ── Constants ────────────────────────────────────────────────────────────────
+const CALLBACK_PORT = 18000;
+const DEFAULT_BASE_URL = "https://aiworld.local:8000";
+const LOGIN_TIMEOUT_MS = 120000;
+const SECRET_TOKEN = "ai-world:token";
+const SECRET_USER = "ai-world:user";
+const SECRET_BASE_URL = "ai-world:baseUrl";
+// ── Singleton ────────────────────────────────────────────────────────────────
+let _instance = null;
+// ── Main Class ───────────────────────────────────────────────────────────────
+class AIWorldExtension {
+    // ── Construction (use initAIWorld) ─────────────────────────────────────
+    /** @internal 使用 initAIWorld() 创建实例 */
+    constructor(context, options = {}) {
+        this._disposables = [];
+        this._onDidChangeAuth = new vscode.EventEmitter();
+        /** 认证状态变化事件 */
+        this.onDidChangeAuthentication = this._onDidChangeAuth.event;
+        this._context = context;
+        this._baseUrl = options.baseUrl || DEFAULT_BASE_URL;
+        this._timeout = options.timeout || LOGIN_TIMEOUT_MS;
+        this._callbackPort = options.callbackPort || CALLBACK_PORT;
+        this._debug = options.debug || false;
+        this._pluginId = options.pluginId || context.extension?.packageJSON?.name || "unknown";
+        this._statusBar = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Right, 100);
+        this._statusBar.command = "aiWorld.showLoginPanel";
+        this._disposables.push(this._statusBar);
+        this._registerCommands();
+        this._updateStatusBar();
+    }
+    // ── Public API ─────────────────────────────────────────────────────────
+    get token() { return this._token; }
+    get user() { return this._user; }
+    get pluginId() { return this._pluginId; }
+    get baseUrl() { return this._baseUrl; }
+    get isAuthenticated() { return !!this._token; }
+    /**
+     * 执行登录：有缓存 token 则验证复用，否则打开浏览器 OAuth
+     * 登录成功后自动配置 sdkConfig 并持久化到 SecretStorage
+     */
+    async login() {
+        if (this._token) {
+            const valid = await (0, login_1.validateToken)(this._baseUrl, this._token);
+            if (valid)
+                return this._token;
+        }
+        const { token } = await this._performBrowserLogin();
+        await this._onLoginSuccess(token);
+        return token;
+    }
+    /** 登出：清除 token、sdkConfig、SecretStorage */
+    async logout() {
+        this._token = undefined;
+        this._user = undefined;
+        config_1.sdkConfig.setToken("");
+        await this._clearSecrets();
+        this._updateStatusBar();
+        this._onDidChangeAuth.fire(false);
+        this._refreshPanel();
+        vscode.window.showInformationMessage("AI World: 已退出登录");
+    }
+    /** 显示 / 聚焦登录 Webview 面板 */
+    showLoginPanel() {
+        if (this._panel) {
+            this._panel.reveal(vscode.ViewColumn.One);
+            this._refreshPanel();
+            return;
+        }
+        this._panel = vscode.window.createWebviewPanel("aiWorldLogin", "AI World 登录", vscode.ViewColumn.One, { enableScripts: true, retainContextWhenHidden: true });
+        this._panel.onDidDispose(() => { this._panel = undefined; }, null, this._disposables);
+        this._panel.webview.onDidReceiveMessage(async (msg) => {
+            if (msg.command === "login") {
+                try {
+                    await this.login();
+                    this._refreshPanel();
+                    this._panel?.webview.postMessage({ command: "loginComplete" });
+                }
+                catch (err) {
+                    vscode.window.showErrorMessage(`AI World 登录失败: ${err.message}`);
+                    this._panel?.webview.postMessage({ command: "loginFailed" });
+                }
+            }
+            else if (msg.command === "logout") {
+                await this.logout();
+            }
+            else if (msg.command === "refresh") {
+                await this._validateAndRefresh();
+            }
+        }, null, this._disposables);
+        this._refreshPanel();
+    }
+    /** 释放所有资源 */
+    dispose() {
+        this._onDidChangeAuth.dispose();
+        this._disposables.forEach((d) => d.dispose());
+        this._panel?.dispose();
+        _instance = null;
+    }
+    // ── SecretStorage ──────────────────────────────────────────────────────
+    get _secrets() {
+        return this._context.secrets;
+    }
+    async _loadSecrets() {
+        const [token, userJson, baseUrl] = await Promise.all([
+            this._secrets.get(SECRET_TOKEN),
+            this._secrets.get(SECRET_USER),
+            this._secrets.get(SECRET_BASE_URL),
+        ]);
+        if (token)
+            this._token = token;
+        if (baseUrl)
+            this._baseUrl = baseUrl;
+        if (userJson) {
+            try {
+                this._user = JSON.parse(userJson);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    async _saveSecrets() {
+        const ops = [];
+        if (this._token) {
+            ops.push(this._secrets.store(SECRET_TOKEN, this._token));
+        }
+        if (this._user) {
+            ops.push(this._secrets.store(SECRET_USER, JSON.stringify(this._user)));
+        }
+        ops.push(this._secrets.store(SECRET_BASE_URL, this._baseUrl));
+        await Promise.all(ops);
+    }
+    async _clearSecrets() {
+        await Promise.all([
+            Promise.resolve(this._secrets.delete(SECRET_TOKEN)),
+            Promise.resolve(this._secrets.delete(SECRET_USER)),
+            Promise.resolve(this._secrets.delete(SECRET_BASE_URL)),
+        ]);
+    }
+    // ── SDK Config ─────────────────────────────────────────────────────────
+    _applySdkConfig() {
+        config_1.sdkConfig.setBaseUrl(this._baseUrl);
+        if (this._token)
+            config_1.sdkConfig.setToken(this._token);
+        config_1.sdkConfig.setPluginId(this._pluginId);
+        config_1.sdkConfig.setHeaders({ "X-Plugin-Id": this._pluginId });
+        if (this._debug)
+            config_1.sdkConfig.setDebug(true);
+    }
+    // ── Internal ───────────────────────────────────────────────────────────
+    /** 初始化流程：读 SecretStorage → 验证 → (可选)弹窗提示登录 → 配置 SDK */
+    async _bootstrap(autoLogin) {
+        await this._loadSecrets();
+        this._applySdkConfig();
+        if (this._token) {
+            const valid = await (0, login_1.validateToken)(this._baseUrl, this._token);
+            if (valid) {
+                await this._fetchUserInfo();
+                this._applySdkConfig();
+                await this._saveSecrets();
+                this._updateStatusBar();
+                this._onDidChangeAuth.fire(true);
+                if (this._debug)
+                    console.log("[ai-world] Token 有效，已自动登录");
+                return;
+            }
+            this._token = undefined;
+            this._user = undefined;
+            await this._clearSecrets();
+            if (this._debug)
+                console.log("[ai-world] 缓存 token 已过期");
+        }
+        this._updateStatusBar();
+        if (autoLogin) {
+            this._promptLogin();
+        }
+    }
+    /** 弹出小通知提示用户登录，用户点击"登录"按钮后才打开浏览器 */
+    _promptLogin() {
+        vscode.window
+            .showWarningMessage("AI World: 未登录，部分功能不可用", "登录", "稍后")
+            .then((choice) => {
+            if (choice === "登录") {
+                this.login().catch((err) => {
+                    vscode.window.showErrorMessage(`AI World 登录失败: ${err.message}`);
+                });
+            }
+        });
+    }
+    async _onLoginSuccess(token) {
+        this._token = token;
+        await this._fetchUserInfo();
+        this._applySdkConfig();
+        await this._saveSecrets();
+        this._updateStatusBar();
+        this._onDidChangeAuth.fire(true);
+        vscode.window.showInformationMessage(`AI World: 登录成功${this._user?.full_name ? ` (${this._user.full_name})` : ""}`);
+    }
+    async _fetchUserInfo() {
+        if (!this._token)
+            return;
+        try {
+            const url = new URL(`${this._baseUrl}/api/auth/me`);
+            const mod = url.protocol === "https:" ? require("https") : require("http");
+            const data = await new Promise((resolve) => {
+                const req = mod.get(url.href, {
+                    headers: { Authorization: `Bearer ${this._token}`, "Content-Type": "application/json" },
+                    rejectUnauthorized: false,
+                }, (res) => {
+                    let body = "";
+                    res.on("data", (c) => { body += c; });
+                    res.on("end", () => {
+                        if (res.statusCode >= 200 && res.statusCode < 300) {
+                            try {
+                                resolve(JSON.parse(body));
+                            }
+                            catch {
+                                resolve(null);
+                            }
+                        }
+                        else {
+                            resolve(null);
+                        }
+                    });
+                });
+                req.on("error", () => resolve(null));
+                req.end();
+            });
+            if (data) {
+                this._user = {
+                    id: data.id,
+                    full_name: data.full_name,
+                    email: data.email,
+                    avatar_url: data.avatar_url,
+                };
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    _registerCommands() {
+        this._disposables.push(vscode.commands.registerCommand("aiWorld.login", () => this.login().catch((e) => vscode.window.showErrorMessage(`AI World 登录失败: ${e.message}`))), vscode.commands.registerCommand("aiWorld.logout", () => this.logout()), vscode.commands.registerCommand("aiWorld.showLoginPanel", () => this.showLoginPanel()));
+    }
+    _updateStatusBar() {
+        if (this._token && this._user) {
+            this._statusBar.text = `$(pass-filled) AI World: ${this._user.full_name || "已登录"}`;
+            this._statusBar.tooltip = `已登录 · ${this._user.full_name || ""}\nPlugin: ${this._pluginId}\n点击管理`;
+            this._statusBar.backgroundColor = undefined;
+        }
+        else {
+            this._statusBar.text = "$(key) AI World: 未登录";
+            this._statusBar.tooltip = "点击登录 AI World";
+            this._statusBar.backgroundColor = new vscode.ThemeColor("statusBarItem.warningBackground");
+        }
+        this._statusBar.show();
+    }
+    async _validateAndRefresh() {
+        if (this._token) {
+            const valid = await (0, login_1.validateToken)(this._baseUrl, this._token);
+            if (valid) {
+                await this._fetchUserInfo();
+                await this._saveSecrets();
+                this._updateStatusBar();
+                this._refreshPanel();
+                vscode.window.showInformationMessage("AI World: Token 有效");
+                return;
+            }
+            this._token = undefined;
+            this._user = undefined;
+            await this._clearSecrets();
+        }
+        this._updateStatusBar();
+        this._refreshPanel();
+        vscode.window.showWarningMessage("AI World: Token 无效或已过期");
+    }
+    _refreshPanel() {
+        if (!this._panel)
+            return;
+        this._panel.webview.html = this._getLoginPanelHtml();
+    }
+    // ── Browser OAuth Login ────────────────────────────────────────────────
+    _performBrowserLogin() {
+        const port = this._callbackPort;
+        return new Promise((resolve, reject) => {
+            (0, login_1.ensurePort)(port);
+            let settled = false;
+            let timeoutId;
+            const server = http.createServer((req, res) => {
+                const url = new URL(req.url || "/", `http://localhost:${port}`);
+                if (url.pathname === "/callback") {
+                    const token = url.searchParams.get("token");
+                    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                    if (token) {
+                        res.end(CALLBACK_SUCCESS_HTML);
+                        if (!settled) {
+                            settled = true;
+                            clearTimeout(timeoutId);
+                            server.close();
+                            resolve({ token });
+                        }
+                    }
+                    else {
+                        res.end(CALLBACK_FAILURE_HTML);
+                    }
+                    return;
+                }
+                res.writeHead(404);
+                res.end("Not Found");
+            });
+            server.on("error", (err) => {
+                if (!settled) {
+                    settled = true;
+                    reject(new Error(`无法启动本地回调服务器: ${err.message}`));
+                }
+            });
+            server.listen(port, () => {
+                const callbackUrl = `http://localhost:${port}/callback`;
+                const loginUrl = `${this._baseUrl}/api/auth/login?redirect=${encodeURIComponent(callbackUrl)}`;
+                vscode.env.openExternal(vscode.Uri.parse(loginUrl)).then(undefined, () => {
+                    vscode.window.showWarningMessage(`请手动打开: ${loginUrl}`);
+                });
+                timeoutId = setTimeout(() => {
+                    if (!settled) {
+                        settled = true;
+                        server.close();
+                        reject(new Error(`登录超时（${this._timeout / 1000}s），请重试`));
+                    }
+                }, this._timeout);
+            });
+        });
+    }
+    // ── Webview HTML ───────────────────────────────────────────────────────
+    _getLoginPanelHtml() {
+        const auth = this.isAuthenticated;
+        const name = this._user?.full_name || "AI World User";
+        const avatar = this._user?.avatar_url;
+        const pid = this._pluginId;
+        return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>AI World</title>
+<style>
+:root{--bg:#1e1e1e;--card:#252526;--border:#3c3c3c;--txt:#ccc;--muted:#888;--accent:#0078d4;--ok:#4ec9b0;--err:#f14c4c}
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:var(--bg);color:var(--txt);min-height:100vh;display:flex;justify-content:center;align-items:center;padding:20px}
+.c{background:var(--card);border:1px solid var(--border);border-radius:12px;padding:40px;max-width:420px;width:100%;text-align:center}
+.logo{font-size:40px;margin-bottom:8px}
+h1{font-size:22px;font-weight:600;margin-bottom:4px}
+.sub{color:var(--muted);font-size:13px;margin-bottom:32px}
+.badge{display:inline-flex;align-items:center;gap:6px;padding:6px 14px;border-radius:20px;font-size:13px;font-weight:500;margin-bottom:24px}
+.badge.ok{background:rgba(78,201,176,.12);color:var(--ok);border:1px solid rgba(78,201,176,.25)}
+.badge.no{background:rgba(241,76,76,.12);color:var(--err);border:1px solid rgba(241,76,76,.25)}
+.dot{width:8px;height:8px;border-radius:50%}
+.ok .dot{background:var(--ok)}.no .dot{background:var(--err)}
+.user{margin-bottom:24px}
+.av{width:56px;height:56px;border-radius:50%;margin:0 auto 12px;background:var(--border);display:flex;align-items:center;justify-content:center;font-size:24px;overflow:hidden}
+.av img{width:100%;height:100%;object-fit:cover}
+.nm{font-size:16px;font-weight:600;margin-bottom:4px}
+.pid{color:var(--muted);font-size:12px;font-family:'SF Mono',Monaco,Menlo,monospace;background:rgba(255,255,255,.05);padding:2px 8px;border-radius:4px}
+.btn{display:inline-flex;align-items:center;justify-content:center;gap:8px;width:100%;padding:12px 24px;border:none;border-radius:8px;font-size:14px;font-weight:500;cursor:pointer;transition:background .15s,opacity .15s}
+.btn:hover{opacity:.9}.btn:active{opacity:.8}
+.btn-p{background:var(--accent);color:#fff}.btn-p:hover{background:#1a8ae8}
+.btn-d{background:transparent;color:var(--err);border:1px solid rgba(241,76,76,.3);margin-top:12px}.btn-d:hover{background:rgba(241,76,76,.1)}
+.btn-s{background:transparent;color:var(--muted);border:1px solid var(--border);margin-top:12px}.btn-s:hover{background:rgba(255,255,255,.05)}
+.sp{display:none;width:16px;height:16px;border:2px solid rgba(255,255,255,.3);border-top-color:#fff;border-radius:50%;animation:spin .6s linear infinite}
+.ld .sp{display:inline-block}.ld .lb{display:none}
+@keyframes spin{to{transform:rotate(360deg)}}
+.ft{margin-top:32px;color:var(--muted);font-size:11px}
+.info-row{display:flex;justify-content:space-between;padding:8px 0;border-bottom:1px solid var(--border);font-size:13px;text-align:left}
+.info-row:last-child{border-bottom:none}
+.info-key{color:var(--muted)}.info-val{color:var(--txt);font-family:'SF Mono',Monaco,Menlo,monospace;font-size:12px}
+</style>
+</head>
+<body>
+<div class="c">
+  <div class="logo">🌐</div>
+  <h1>AI World</h1>
+  <p class="sub">VSCode Extension · ${pid}</p>
+  <div class="badge ${auth ? "ok" : "no"}"><span class="dot"></span>${auth ? "已登录" : "未登录"}</div>
+${auth ? `
+  <div class="user">
+    <div class="av">${avatar ? `<img src="${avatar}" alt="">` : "👤"}</div>
+    <div class="nm">${this._escHtml(name)}</div>
+    <span class="pid">${this._escHtml(pid)}</span>
+  </div>
+  <div style="background:rgba(255,255,255,.03);border-radius:8px;padding:12px 16px;margin-bottom:20px">
+    <div class="info-row"><span class="info-key">BaseUrl</span><span class="info-val">${this._escHtml(this._baseUrl)}</span></div>
+    <div class="info-row"><span class="info-key">PluginId</span><span class="info-val">${this._escHtml(pid)}</span></div>
+    <div class="info-row"><span class="info-key">UserId</span><span class="info-val">${this._user?.id ?? "-"}</span></div>
+  </div>
+  <button class="btn btn-s" onclick="post('refresh')"><span class="lb">🔄 刷新状态</span></button>
+  <button class="btn btn-d" onclick="post('logout')"><span class="lb">退出登录</span></button>
+` : `
+  <button id="lb" class="btn btn-p" onclick="doLogin()"><span class="sp"></span><span class="lb">🔑 通过飞书登录</span></button>
+  <button class="btn btn-s" onclick="post('refresh')"><span class="lb">🔄 刷新状态</span></button>
+`}
+  <div class="ft">AI World SDK v${config_1.sdkConfig.sdkVersion}</div>
+</div>
+<script>
+const vsc=acquireVsCodeApi();
+function post(c){vsc.postMessage({command:c})}
+function doLogin(){const b=document.getElementById('lb');if(b)b.classList.add('ld');post('login')}
+window.addEventListener('message',e=>{const m=e.data;if(m.command==='loginComplete'||m.command==='loginFailed'){const b=document.getElementById('lb');if(b)b.classList.remove('ld')}});
+</script>
+</body></html>`;
+    }
+    _escHtml(s) {
+        return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+    }
+}
+exports.AIWorldExtension = AIWorldExtension;
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * 一步初始化 AI World VSCode 扩展
+ *
+ * 自动完成：读 SecretStorage → 验证 token → 配置 sdkConfig → 注册命令 → 显示状态栏
+ * pluginId 默认取扩展 package.json 的 name 字段
+ *
+ * @example
+ * import { initAIWorld } from 'ai-world-sdk/vscode';
+ * export async function activate(ctx: vscode.ExtensionContext) {
+ *   const ai = await initAIWorld(ctx);
+ *   // sdkConfig 已自动配置，可直接使用 createProvider 等 SDK 功能
+ * }
+ */
+async function initAIWorld(context, options = {}) {
+    if (_instance) {
+        _instance.dispose();
+    }
+    const ext = new AIWorldExtension(context, options);
+    _instance = ext;
+    context.subscriptions.push({ dispose: () => ext.dispose() });
+    await ext._bootstrap(options.autoLogin !== false);
+    return ext;
+}
+/**
+ * 获取已初始化的 AIWorldExtension 实例
+ * @throws 如果 initAIWorld 尚未调用
+ */
+function getAIWorld() {
+    if (!_instance)
+        throw new Error("请先调用 initAIWorld(context) 初始化");
+    return _instance;
+}
+// ── Static HTML for Browser Callback ─────────────────────────────────────────
+const CALLBACK_SUCCESS_HTML = `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>AI World</title></head>
+<body style="display:flex;justify-content:center;align-items:center;height:100vh;font-family:system-ui;background:#1e1e1e;color:#ccc">
+<div style="text-align:center;padding:40px;background:#252526;border-radius:12px;border:1px solid #3c3c3c">
+<h2 style="color:#4ec9b0">✓ 登录成功</h2>
+<p style="color:#888">Token 已保存，可以关闭此页面回到 VSCode</p>
+</div></body></html>`;
+const CALLBACK_FAILURE_HTML = `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>AI World</title></head>
+<body style="display:flex;justify-content:center;align-items:center;height:100vh;font-family:system-ui;background:#1e1e1e;color:#ccc">
+<div style="text-align:center;padding:40px;background:#252526;border-radius:12px;border:1px solid #3c3c3c">
+<h2 style="color:#f14c4c">✗ 登录失败</h2>
+<p style="color:#888">未收到 token，请重试</p>
+</div></body></html>`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.2.7",
+  "version": "1.3.2",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,6 +12,10 @@
     "./vite": {
       "types": "./dist/vite-plugin.d.ts",
       "default": "./dist/vite-plugin.js"
+    },
+    "./vscode": {
+      "types": "./dist/vscode-login.d.ts",
+      "default": "./dist/vscode-login.js"
     }
   },
   "scripts": {
@@ -59,6 +63,7 @@
     "@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",
@@ -73,6 +78,7 @@
     "@ai-sdk/anthropic": "^3.0.43",
     "@ai-sdk/google": "^3.0.29",
     "@ai-sdk/openai": "^3.0.28",
+    "@openrouter/ai-sdk-provider": "^2.3.1",
     "ai": "^6.0.85"
   }
 }

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, MinIO object storage (MinioStorageClient), and resource management with ACL (ResourceClient). Triggers on ai-world-sdk, createProvider, sdkConfig, generateText, streamText, generateImage, doubao, MinioStorageClient, minio, ResourceClient, resource management, access control, file sharing, 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, 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, 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.
 ---
 
 # AI World SDK
@@ -18,6 +18,9 @@ ai-world-sdk 是 AI World 平台的 TypeScript SDK，通过 `createProvider` 创
 - 使用 Doubao 豆包图像/视频生成
 - 使用 MinIO 对象存储（文件上传/下载/管理）
 - 使用资源管理系统（权限控制: private/specific_users/public）
+- 提交数据库建表/迁移请求
+- 管理 Agent Skills（上传/下载/删除/列表）
+- **开发 VSCode 扩展**时集成 AI World 登录和 SDK 功能
 
 ## 安装
 
@@ -62,6 +65,48 @@ export default defineConfig({
 aiWorldPlugin({ baseUrl: 'https://your-server:8000' })
 ```
 
+### VSCode 扩展（推荐：initAIWorld 一步到位）
+
+在 VSCode 扩展中使用 `ai-world-sdk/vscode`，一行代码完成所有配置：
+
+```typescript
+import * as vscode from 'vscode';
+import { initAIWorld } from 'ai-world-sdk/vscode';
+import { createProvider } from 'ai-world-sdk';
+import { generateText } from 'ai';
+
+export async function activate(context: vscode.ExtensionContext) {
+  const ai = await initAIWorld(context, {
+    pluginId: 'my-extension',  // 可选，默认从 package.json name 推断
+  });
+
+  // sdkConfig 已自动配置，直接使用 SDK 功能
+  if (ai.isAuthenticated) {
+    const provider = createProvider('api2img', 'openai', ai.pluginId);
+    const model = provider.languageModel('gpt-4o-mini');
+    const result = await generateText({ model, prompt: '你好' });
+  }
+}
+```
+
+`initAIWorld` 自动完成：登录认证、sdkConfig 配置、命令注册、状态栏、缓存持久化到 `vscode.SecretStorage`。pluginId 默认取 `package.json` 的 `name`。
+
+扩展 `package.json` 需声明 SDK 自动注册的命令：
+
+```json
+{
+  "contributes": {
+    "commands": [
+      { "command": "aiWorld.login", "title": "AI World: 登录" },
+      { "command": "aiWorld.logout", "title": "AI World: 退出登录" },
+      { "command": "aiWorld.showLoginPanel", "title": "AI World: 登录面板" }
+    ]
+  }
+}
+```
+
+详细用法见 → `docs/vscode-login.md`
+
 ### 非浏览器环境（测试、脚本）
 
 ```typescript
@@ -81,7 +126,7 @@ sdkConfig.setPluginId('my-plugin');
 ### Provider 与模型 → `docs/provider-and-models.md`
 
 - `createProvider(provider, endpointType, pluginId)` 创建 Vercel AI SDK Provider
-- Provider 对照表：`api2img`(推荐) / `gemini` / `aihubmix` / `shubiaobiao`
+- Provider 对照表：`api2img`(推荐) / `gemini` / `aihubmix` / `shubiaobiao` / `aiping`
 - 常用模型列表和 AI SDK 函数速查
 
 ### 文本生成 → `docs/text-generation.md`
@@ -110,6 +155,24 @@ sdkConfig.setPluginId('my-plugin');
 - 三级权限: `private` / `specific_users` / `public`
 - 插件隔离与跨插件访问
 
+### 数据库请求 → `docs/database-requests.md`
+
+- `DatabaseRequestClient` — 建表/迁移请求提交、列表、审核
+- 表名规则: `{pluginId}_{tableName}`
+
+### Agent Skills → `docs/agent-skills.md`
+
+- `AgentSkillClient` — Skills 上传/下载/删除/列表
+- Skill 名称全小写，zip 必须包含 SKILL.md
+
+### VSCode 扩展登录 → `docs/vscode-login.md`
+
+- `initAIWorld(context)` 一步初始化（登录 + sdkConfig + 状态栏 + 命令）
+- `getAIWorld()` 获取实例
+- 认证信息通过 `vscode.SecretStorage` 安全存储（token / user / baseUrl）
+- `pluginId` 默认取扩展 `package.json` 的 `name` 字段
+- 完整示例见 `examples/vscode-test-extension/`
+
 ### 常见错误 → `docs/common-mistakes.md`
 
 - endpointType 匹配规则、AI SDK v6 用法变更、MinIO 路径规范等