ai-world-sdk 1.5.1 → 1.5.5

package/dist/cli/commands/admin.js

@@ -88,7 +88,7 @@ function parseUserIdsList(raw) {
     });
 }
 function registerAdminCommands(program) {
-    const admin = program.command('admin');
+    const admin = program.command('admin').description('管理员功能（用户 / 角色 / 数据库）');
     const user = admin.command('user');
     user
         .command('list')

package/dist/cli/commands/chrome.js

@@ -61,7 +61,7 @@ function parsePositiveInt(raw, flag) {
     return n;
 }
 function registerChromeCommands(program) {
-    const chrome = program.command('chrome');
+    const chrome = program.command('chrome').description('Chrome 扩展管理');
     chrome
         .command('list')
         .option('--page <n>', '页码')

package/dist/cli/commands/config-cmd.js

@@ -19,6 +19,10 @@ function parseEntries(entries) {
 }
 function registerConfigCommands(program) {
     const cfg = program.command('config');
+    cfg.command('file').action(() => {
+        const path = config_1.CONFIG_FILE;
+        (0, output_1.output)({ path }, 'json');
+    });
     cfg
         .command('set')
         .argument('<entries...>', 'key=value pairs')
@@ -41,9 +45,17 @@ function registerConfigCommands(program) {
             if (!(0, config_1.isValidKey)(key)) {
                 throw new Error(`Invalid config key: ${key}. Valid keys: ${(0, config_1.getValidKeys)().join(', ')}`);
             }
-            const value = (0, config_1.getConfigValue)(key);
+            const saved = (0, config_1.getConfigValue)(key);
+            const effective = (0, config_1.getEffectiveValue)(key);
             const format = (0, utils_1.getFormat)(program);
-            (0, output_1.output)({ key, value: value ?? null }, format);
+            const result = { key, value: effective };
+            if (saved !== undefined && saved === effective) {
+                result.source = 'config';
+            }
+            else if (saved === undefined && effective !== null) {
+                result.source = 'default';
+            }
+            (0, output_1.output)(result, format);
         }
         catch (e) {
             (0, utils_1.handleError)(e, 'config get');
@@ -52,12 +64,28 @@ function registerConfigCommands(program) {
     cfg.command('list').action(() => {
         try {
             const format = (0, utils_1.getFormat)(program);
-            const data = (0, config_1.readConfig)();
+            const saved = (0, config_1.readConfig)();
+            const effective = (0, config_1.getEffectiveConfig)();
+            const merged = {};
+            for (const [key, val] of Object.entries(effective)) {
+                const hasSaved = saved[key] !== undefined;
+                merged[key] = {
+                    value: val,
+                    source: key === 'token'
+                        ? (saved.token ? 'config' : (process.env.DEBUG_TOKEN ? 'env' : 'none'))
+                        : (hasSaved ? 'config' : (val !== null ? 'default' : 'none')),
+                };
+            }
             if (format === 'table') {
-                (0, output_1.output)(data, 'table');
+                const rows = Object.entries(merged).map(([k, v]) => ({
+                    key: k,
+                    value: k === 'token' && v.value ? v.value.slice(0, 20) + '...' : (v.value ?? ''),
+                    source: v.source,
+                }));
+                (0, output_1.output)(rows, 'table');
             }
             else {
-                (0, output_1.outputJSON)(data);
+                (0, output_1.outputJSON)(merged);
             }
         }
         catch (e) {

package/dist/cli/commands/help.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerHelpCommand(program: Command): void;

package/dist/cli/commands/help.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHelpCommand = registerHelpCommand;
+const COMMAND_DETAILS = {
+    login: {
+        desc: '登录 AI World 平台（浏览器 OAuth 或直接设置 token）',
+        usage: 'ai-world login [--token <jwt>] [--timeout <ms>]',
+        examples: [
+            'ai-world login                    # 浏览器 OAuth 登录',
+            'ai-world login --token eyJhbG...  # 直接设置 token',
+        ],
+    },
+    logout: {
+        desc: '退出登录，清除本地缓存的 token',
+        usage: 'ai-world logout',
+    },
+    me: {
+        desc: '查看当前登录用户信息（ID、姓名、邮箱、角色等）',
+        usage: 'ai-world me [--format table]',
+    },
+    status: {
+        desc: '检查当前认证状态，显示 token 是否有效',
+        usage: 'ai-world status',
+    },
+    version: {
+        desc: '显示当前 CLI 版本号，并检查是否有新版本可用',
+        usage: 'ai-world version',
+        examples: [
+            'ai-world version',
+            '# 输出: {"current":"1.5.3","latest":"1.5.3","updateAvailable":false}',
+        ],
+    },
+    config: {
+        desc: '管理 CLI 默认配置（base-url / provider / endpoint / model 等）',
+        usage: 'ai-world config <set|get|list|reset>',
+        examples: [
+            'ai-world config set base-url=https://aiworld.local:8000',
+            'ai-world config set provider=volcengine endpoint=doubao model=doubao-1-5-pro-32k-250115',
+            'ai-world config get provider',
+            'ai-world config list',
+            'ai-world config reset          # 重置所有配置',
+            'ai-world config reset provider # 重置单个配置项',
+        ],
+    },
+    text: {
+        desc: '文本生成 —— 调用 LLM 进行对话或流式输出',
+        usage: 'ai-world text <generate|stream>',
+        examples: [
+            'ai-world text generate --prompt "介绍 AI World"',
+            'ai-world text stream --prompt "讲个故事" --provider volcengine --endpoint doubao --model doubao-1-5-pro-32k-250115',
+        ],
+    },
+    model: {
+        desc: '检查指定模型在给定 provider/endpoint 下是否可用',
+        usage: 'ai-world model check --model <id> --provider <name> --endpoint <type>',
+        examples: [
+            'ai-world model check --model doubao-1-5-pro-32k-250115 --provider volcengine --endpoint doubao',
+        ],
+    },
+    image: {
+        desc: '图像生成 —— 支持 doubao / gemini / openai 三种提供商',
+        usage: 'ai-world image generate --provider <name> --prompt <text> [--output <file>]',
+        examples: [
+            'ai-world image generate --provider doubao --prompt "一只可爱的猫" --output cat.png',
+            'ai-world image generate --provider gemini --prompt "sunset" --output sunset.png',
+            'ai-world image generate --provider openai --prompt "abstract art" --model dall-e-3',
+        ],
+    },
+    video: {
+        desc: '视频生成、状态查询、下载和视频理解',
+        usage: 'ai-world video <generate|status|download|understand>',
+        examples: [
+            'ai-world video generate --provider doubao --prompt "猫在走路"',
+            'ai-world video status <taskId> --provider doubao',
+            'ai-world video download <taskId> --output video.mp4',
+            'ai-world video understand --model <id> --video-url <url> --prompt "描述这个视频"',
+        ],
+    },
+    resource: {
+        desc: '资源管理（带 ACL 访问控制）—— 上传、下载、分享、权限设置',
+        usage: 'ai-world resource <upload|list|get|download|share|unshare|set-access|delete>',
+        examples: [
+            'ai-world resource upload ./file.pdf /docs/file.pdf --access public',
+            'ai-world resource list --scope my',
+            'ai-world resource download 42 --output ./local.pdf',
+            'ai-world resource share 42 --users 1,2,3',
+        ],
+    },
+    versioned: {
+        desc: '版本化资源管理 —— 带版本号的文件存储',
+        usage: 'ai-world versioned <upload|list|versions|get|download|delete>',
+        examples: [
+            'ai-world versioned upload ./model.bin --name my-model --version 1.0.0',
+            'ai-world versioned list',
+            'ai-world versioned versions my-model',
+            'ai-world versioned download my-model latest --output ./model.bin',
+        ],
+    },
+    skill: {
+        desc: 'Agent 技能管理 —— 上传、下载、查看技能包',
+        usage: 'ai-world skill <list|get|upload|download|delete|md>',
+        examples: [
+            'ai-world skill list',
+            'ai-world skill get my-skill',
+            'ai-world skill md my-skill                # 查看 SKILL.md 内容',
+            'ai-world skill upload my-skill ./skill.zip',
+            'ai-world skill download my-skill -o skill.zip',
+        ],
+    },
+    plugin: {
+        desc: '插件管理 —— 部署、启用/禁用、重启、查看日志',
+        usage: 'ai-world plugin <list|get|ids|create|enable|disable|reload|restart|logs|status|delete>',
+        examples: [
+            'ai-world plugin list',
+            'ai-world plugin ids --enabled-only',
+            'ai-world plugin get my-plugin',
+            'ai-world plugin enable my-plugin',
+            'ai-world plugin logs my-plugin --lines 50',
+            'ai-world plugin create ./dist.zip --plugin-id my-plugin --name "我的插件"',
+        ],
+    },
+    admin: {
+        desc: '管理员功能 —— 用户管理、角色权限、数据库操作',
+        usage: 'ai-world admin <user|role|db>',
+        examples: [
+            'ai-world admin user list',
+            'ai-world admin user set-role 2 --role-id 1',
+            'ai-world admin role list',
+            'ai-world admin db tables',
+            'ai-world admin db schema users',
+            'ai-world admin db exec-sql --sql "SELECT COUNT(*) FROM users"',
+        ],
+    },
+    stats: {
+        desc: '统计与数据看板 —— 调用量、趋势、插件访问',
+        usage: 'ai-world stats <dashboard|plugin-access|ai-calls|ai-trend|...>',
+        examples: [
+            'ai-world stats dashboard',
+            'ai-world stats ai-calls --provider volcengine',
+            'ai-world stats ai-trend --period weekly --days 30',
+            'ai-world stats plugin-access-summary',
+        ],
+    },
+    shared: {
+        desc: '共享资源 —— 全平台可见的公共文件',
+        usage: 'ai-world shared <upload|list|get|download|update|delete>',
+        examples: [
+            'ai-world shared upload ./data.csv --name "示例数据"',
+            'ai-world shared list --search "模型"',
+            'ai-world shared download 10 --output ./out.csv',
+        ],
+    },
+    chrome: {
+        desc: 'Chrome 扩展管理 —— 上传、下载、查看浏览器插件',
+        usage: 'ai-world chrome <list|get|create|download|delete>',
+        examples: [
+            'ai-world chrome list',
+            'ai-world chrome create --extension-id my-ext --name "扩展" --zip ./ext.zip',
+            'ai-world chrome download my-ext --output ext.zip',
+        ],
+    },
+};
+function printFullHelp(program) {
+    const ver = program.version();
+    console.log(`
+AI World CLI v${ver}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+用法: ai-world [全局选项] <命令> [子命令] [参数]
+
+全局选项:
+  --base-url <url>     后端地址（默认从配置读取）
+  --token <token>      JWT 认证 token
+  --plugin-id <id>     插件 ID（默认 user_{user_id}）
+  --format <fmt>       输出格式: json（默认）| table
+  --debug              启用调试输出
+  -V, --version        显示版本号
+  -h, --help           显示帮助
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+命令列表:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  认证:
+    login              登录 AI World（浏览器 OAuth / token）
+    logout             退出登录
+    me                 查看当前用户信息
+    status             检查认证状态
+
+  配置:
+    config             管理默认配置（set / get / list / reset）
+    version            显示版本号并检查更新
+
+  AI 能力:
+    text               文本生成（对话、流式输出）
+    model              模型可用性检查
+    image              图像生成（doubao / gemini / openai）
+    video              视频生成、查询、下载、理解
+
+  平台管理:
+    resource           资源管理（带 ACL 访问控制）
+    versioned          版本化资源管理
+    skill              Agent 技能管理
+    plugin             插件管理（部署 / 启停 / 日志）
+    shared             共享资源
+    chrome             Chrome 扩展管理
+
+  管理员:
+    admin              用户 / 角色 / 数据库管理
+    stats              统计与数据看板
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+提示: 使用 "ai-world help <命令>" 查看具体命令详情
+      使用 "ai-world <命令> --help" 查看子命令帮助
+`);
+}
+function printCommandHelp(cmdName, program) {
+    const detail = COMMAND_DETAILS[cmdName];
+    if (!detail) {
+        const sub = program.commands.find((c) => c.name() === cmdName);
+        if (sub) {
+            sub.outputHelp();
+        }
+        else {
+            console.error(`未知命令: ${cmdName}\n运行 "ai-world help" 查看所有可用命令`);
+            process.exitCode = 1;
+        }
+        return;
+    }
+    console.log(`
+命令: ${cmdName}
+描述: ${detail.desc}
+用法: ${detail.usage}
+`);
+    if (detail.examples && detail.examples.length > 0) {
+        console.log('示例:');
+        for (const ex of detail.examples) {
+            console.log(`  ${ex}`);
+        }
+        console.log('');
+    }
+    console.log(`运行 "ai-world ${cmdName} --help" 查看完整参数列表`);
+}
+function registerHelpCommand(program) {
+    program
+        .command('help')
+        .description('显示帮助信息')
+        .argument('[command]', '要查看的命令名称')
+        .action((cmdName) => {
+        if (!cmdName) {
+            printFullHelp(program);
+        }
+        else {
+            printCommandHelp(cmdName, program);
+        }
+    });
+}

package/dist/cli/commands/image.js

@@ -64,7 +64,7 @@ function stripB64ForLog(obj) {
     return copy;
 }
 function registerImageCommands(program) {
-    const image = program.command('image');
+    const image = program.command('image').description('图像生成（doubao / gemini / openai）');
     image
         .command('generate')
         .requiredOption('--provider <name>', 'doubao, gemini, or openai')
@@ -180,6 +180,7 @@ function registerImageCommands(program) {
             });
         }
         catch (err) {
+            console.log('----image generate error', err, new Error().stack);
             (0, utils_1.handleError)(err, commandName);
         }
     });

package/dist/cli/commands/model.js

@@ -17,7 +17,7 @@ function collectOpts(cmd) {
     return o;
 }
 function registerModelCommands(program) {
-    const modelCmd = program.command('model');
+    const modelCmd = program.command('model').description('模型可用性检查');
     modelCmd
         .command('check')
         .requiredOption('--model <id>', 'Model id')

package/dist/cli/commands/plugin.js

@@ -17,7 +17,7 @@ function collectOpts(cmd) {
     return o;
 }
 function registerPluginCommands(program) {
-    const plugin = program.command('plugin');
+    const plugin = program.command('plugin').description('插件管理（启用 / 禁用 / 部署 / 日志）');
     plugin
         .command('list')
         .option('--page <n>', '', (v) => parseInt(v, 10))
@@ -61,7 +61,7 @@ function registerPluginCommands(program) {
     plugin
         .command('get')
         .argument('<plugin-id>')
-        .action(async (pluginId, cmd) => {
+        .action(async (pluginId, _opts, cmd) => {
         const commandName = 'plugin get';
         try {
             const o = collectOpts(cmd);
@@ -109,7 +109,7 @@ function registerPluginCommands(program) {
         plugin
             .command(subName)
             .argument('<plugin-id>')
-            .action(async (pluginId, cmd) => {
+            .action(async (pluginId, _opts, cmd) => {
             const commandName = `plugin ${subName}`;
             try {
                 const o = collectOpts(cmd);
@@ -131,7 +131,7 @@ function registerPluginCommands(program) {
     plugin
         .command('restart')
         .argument('<plugin-id>')
-        .action(async (pluginId, cmd) => {
+        .action(async (pluginId, _opts, cmd) => {
         const commandName = 'plugin restart';
         try {
             const o = collectOpts(cmd);
@@ -216,7 +216,7 @@ function registerPluginCommands(program) {
     plugin
         .command('delete')
         .argument('<plugin-id>')
-        .action(async (pluginId, cmd) => {
+        .action(async (pluginId, _opts, cmd) => {
         const commandName = 'plugin delete';
         try {
             const o = collectOpts(cmd);
@@ -237,7 +237,7 @@ function registerPluginCommands(program) {
     plugin
         .command('status')
         .argument('<plugin-id>')
-        .action(async (pluginId, cmd) => {
+        .action(async (pluginId, _opts, cmd) => {
         const commandName = 'plugin status';
         try {
             const o = collectOpts(cmd);

package/dist/cli/commands/shared.js

@@ -81,7 +81,7 @@ function parsePositiveInt(raw, flag) {
     return n;
 }
 function registerSharedCommands(program) {
-    const shared = program.command('shared');
+    const shared = program.command('shared').description('共享资源（上传 / 下载 / 搜索）');
     shared
         .command('upload')
         .argument('<local-file>', '本地文件路径')

package/dist/cli/commands/skill.js

@@ -51,7 +51,7 @@ function collectOpts(cmd) {
     return o;
 }
 function registerSkillCommands(program) {
-    const skill = program.command('skill');
+    const skill = program.command('skill').description('Agent 技能管理（上传 / 下载 / 查看）');
     skill
         .command('list')
         .option('--page <n>', '', (v) => parseInt(v, 10))
@@ -88,7 +88,7 @@ function registerSkillCommands(program) {
     skill
         .command('get')
         .argument('<skill-name>')
-        .action(async (skillName, cmd) => {
+        .action(async (skillName, _opts, cmd) => {
         const commandName = 'skill get';
         try {
             const o = collectOpts(cmd);
@@ -165,7 +165,7 @@ function registerSkillCommands(program) {
     skill
         .command('delete')
         .argument('<skill-name>')
-        .action(async (skillName, cmd) => {
+        .action(async (skillName, _opts, cmd) => {
         const commandName = 'skill delete';
         try {
             const o = collectOpts(cmd);
@@ -186,7 +186,7 @@ function registerSkillCommands(program) {
     skill
         .command('md')
         .argument('<skill-name>')
-        .action(async (skillName, cmd) => {
+        .action(async (skillName, _opts, cmd) => {
         const commandName = 'skill md';
         try {
             const o = collectOpts(cmd);

package/dist/cli/commands/stats.js

@@ -37,7 +37,7 @@ function parsePeriod(raw) {
     throw err;
 }
 function registerStatsCommands(program) {
-    const stats = program.command('stats');
+    const stats = program.command('stats').description('统计与数据看板');
     stats
         .command('plugin-access')
         .option('--user-id <n>', '用户 ID', (v) => parseInt(v, 10))

package/dist/cli/commands/text.js

@@ -47,7 +47,7 @@ async function prepareContext(program, cmd) {
     };
 }
 function registerTextCommands(program) {
-    const text = program.command('text');
+    const text = program.command('text').description('文本生成（对话、流式输出）');
     text
         .command('generate')
         .requiredOption('--prompt <text>', 'Prompt text')

package/dist/cli/commands/version.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerVersionCommand(program: Command): void;

package/dist/cli/commands/version.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerVersionCommand = registerVersionCommand;
+const output_1 = require("../output");
+const utils_1 = require("../utils");
+const config_1 = require("../config");
+async function getLatestVersion(baseUrl) {
+    try {
+        const response = await fetch(`${baseUrl}/api/sdk/latest-version`);
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        return data.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareVersions(current, latest) {
+    const a = current.split('.').map(Number);
+    const b = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] || 0) < (b[i] || 0))
+            return -1;
+        if ((a[i] || 0) > (b[i] || 0))
+            return 1;
+    }
+    return 0;
+}
+function registerVersionCommand(program) {
+    program
+        .command('version')
+        .description('显示版本号并检查更新')
+        .action(async () => {
+        try {
+            const currentVersion = require('../../../package.json').version;
+            const auth = (0, config_1.resolveAuth)({});
+            const latest = await getLatestVersion(auth.baseUrl);
+            const result = {
+                current: currentVersion,
+            };
+            if (latest) {
+                result.latest = latest;
+                const cmp = compareVersions(currentVersion, latest);
+                if (cmp < 0) {
+                    result.updateAvailable = true;
+                    result.updateCommand = 'npm install -g ai-world-sdk';
+                }
+                else {
+                    result.updateAvailable = false;
+                }
+            }
+            else {
+                result.latest = null;
+                result.updateAvailable = null;
+            }
+            (0, output_1.outputJSON)(result);
+        }
+        catch (e) {
+            (0, utils_1.handleError)(e, 'version');
+        }
+    });
+}

package/dist/cli/commands/video.js

@@ -53,7 +53,7 @@ function collectOpts(cmd) {
     return o;
 }
 function registerVideoCommands(program) {
-    const video = program.command('video');
+    const video = program.command('video').description('视频生成、状态查询、下载、理解');
     video
         .command('generate')
         .requiredOption('--provider <name>', 'doubao or openai')

package/dist/cli/config.d.ts

@@ -1,3 +1,5 @@
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
 declare const VALID_KEYS: readonly ["base-url", "token", "plugin-id", "provider", "endpoint", "model", "format"];
 export type ConfigKey = (typeof VALID_KEYS)[number];
 export interface CLIConfig {
@@ -13,7 +15,9 @@ export declare function isValidKey(key: string): key is ConfigKey;
 export declare function getValidKeys(): readonly string[];
 export declare function readConfig(): CLIConfig;
 export declare function writeConfig(config: CLIConfig): void;
+export declare function getEffectiveConfig(): Record<string, string | null>;
 export declare function getConfigValue(key: ConfigKey): string | undefined;
+export declare function getEffectiveValue(key: ConfigKey): string | null;
 export declare function setConfigValues(entries: Record<string, string>): void;
 export declare function resetConfig(key?: string): void;
 export interface ResolvedAuth {

package/dist/cli/config.js

@@ -33,11 +33,14 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
 exports.isValidKey = isValidKey;
 exports.getValidKeys = getValidKeys;
 exports.readConfig = readConfig;
 exports.writeConfig = writeConfig;
+exports.getEffectiveConfig = getEffectiveConfig;
 exports.getConfigValue = getConfigValue;
+exports.getEffectiveValue = getEffectiveValue;
 exports.setConfigValues = setConfigValues;
 exports.resetConfig = resetConfig;
 exports.resolveAuth = resolveAuth;
@@ -45,8 +48,8 @@ exports.resolveDefaults = resolveDefaults;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const CONFIG_DIR = path.join(os.homedir(), '.ai-world');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+exports.CONFIG_DIR = path.join(os.homedir(), '.ai-world');
+exports.CONFIG_FILE = path.join(exports.CONFIG_DIR, 'config.json');
 const VALID_KEYS = [
     'base-url',
     'token',
@@ -64,8 +67,8 @@ function getValidKeys() {
 }
 function readConfig() {
     try {
-        if (fs.existsSync(CONFIG_FILE)) {
-            return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+        if (fs.existsSync(exports.CONFIG_FILE)) {
+            return JSON.parse(fs.readFileSync(exports.CONFIG_FILE, 'utf-8'));
         }
     }
     catch {
@@ -74,14 +77,42 @@ function readConfig() {
     return {};
 }
 function writeConfig(config) {
-    if (!fs.existsSync(CONFIG_DIR)) {
-        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    if (!fs.existsSync(exports.CONFIG_DIR)) {
+        fs.mkdirSync(exports.CONFIG_DIR, { recursive: true });
     }
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+    fs.writeFileSync(exports.CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+const DEFAULTS = {
+    'base-url': 'https://aiworld.local:8000',
+    'plugin-id': 'cli',
+    provider: 'kunpo',
+    endpoint: 'openai',
+    model: 'deepseek/deepseek-v4-pro',
+    format: 'json',
+};
+function getEffectiveConfig() {
+    const config = readConfig();
+    const result = {};
+    for (const key of VALID_KEYS) {
+        if (key === 'token') {
+            result[key] = config.token || process.env.DEBUG_TOKEN || null;
+        }
+        else {
+            result[key] = config[key] || DEFAULTS[key] || null;
+        }
+    }
+    return result;
 }
 function getConfigValue(key) {
     return readConfig()[key];
 }
+function getEffectiveValue(key) {
+    const config = readConfig();
+    if (key === 'token') {
+        return config.token || process.env.DEBUG_TOKEN || null;
+    }
+    return config[key] || DEFAULTS[key] || null;
+}
 function setConfigValues(entries) {
     const config = readConfig();
     for (const [key, value] of Object.entries(entries)) {
@@ -119,15 +150,15 @@ function resolveAuth(opts) {
         pluginId: opts.pluginId ||
             process.env.PLUGIN_ID ||
             config['plugin-id'] ||
-            null,
+            'cli',
     };
 }
 function resolveDefaults(opts) {
     const config = readConfig();
     return {
-        provider: opts.provider || config.provider,
-        endpoint: opts.endpoint || config.endpoint,
-        model: opts.model || config.model,
+        provider: opts.provider || config.provider || 'kunpo',
+        endpoint: opts.endpoint || config.endpoint || 'openai',
+        model: opts.model || config.model || 'deepseek/deepseek-v4-pro',
         format: opts.format || config.format || 'json',
     };
 }

package/dist/cli/index.js

@@ -1,7 +1,81 @@
 #!/usr/bin/env node
 "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 });
-process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
+process.env.__AI_WORLD_CLI__ = '1';
+const tls = __importStar(require("tls"));
+const undici_1 = require("undici");
+const localCA = `-----BEGIN CERTIFICATE-----
+MIIFBDCCA2ygAwIBAgIRAIQTUXqwRwvkfn2rfwg0tIgwDQYJKoZIhvcNAQELBQAw
+gZkxHjAcBgNVBAoTFW1rY2VydCBkZXZlbG9wbWVudCBDQTE3MDUGA1UECwwubGln
+aHRnYW1lMkBndWFuZ3NodTJkZU1hYy1taW5pLmxvY2FsICjlhYnmnZ8yKTE+MDwG
+A1UEAww1bWtjZXJ0IGxpZ2h0Z2FtZTJAZ3VhbmdzaHUyZGVNYWMtbWluaS5sb2Nh
+bCAo5YWJ5p2fMikwHhcNMjUxMjMxMDcwNDQwWhcNMzUxMjMxMDcwNDQwWjCBmTEe
+MBwGA1UEChMVbWtjZXJ0IGRldmVsb3BtZW50IENBMTcwNQYDVQQLDC5saWdodGdh
+bWUyQGd1YW5nc2h1MmRlTWFjLW1pbmkubG9jYWwgKOWFieadnzIpMT4wPAYDVQQD
+DDVta2NlcnQgbGlnaHRnYW1lMkBndWFuZ3NodTJkZU1hYy1taW5pLmxvY2FsICjl
+hYnmnZ8yKTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAK0ebf/92MLt
+Hm6DdzoeOZm60H9mbYbUm2qon/hWTA1MsIo1fiSTKUsPT4Ni/3Gag1PDtqRy4o7p
+IQL+Z0YplKWMWXpIR+kAp08+WmDgYeD6UXd05W9WEJg5lLDMhwHwGOxV2YGPkikW
+gAtDbLVmDvZlHmbLJQTNJFFrxdNgcHSTwmS8lia+yiN4gNVMunjaifLvf7bSBF+a
+yG5B4mibjKmVyvuw37KyUOdiELeTHR53ltYLOoDi6Sm5YX93B2JoXnAq/8cKscDl
+lsNEcf0o2ed3TkPYbnj0Kqgb7C8twkaeB6Lh7aZJwHT2+lfeJaPs9DHKCMZ1d2zm
+g4AamFS9GDMwm5G+h42iiV9Z7Y+iHRyRu+rCAWBQRaA5kfnjHGf4UnZyGl44TULt
+WD3DIeizQAq0KFBkWGZOx62jJqsmvpUrSPOWab+THEfzYvJ4crk9xOGPDFv83EKq
+bo6XX1vWR4VZE8UuBduUSKCN3RDi0Bt+CedU076P51L3fYo5wz48bQIDAQABo0Uw
+QzAOBgNVHQ8BAf8EBAMCAgQwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU
+f5hRENsTrcW0I1D1/EGb4IgSaDUwDQYJKoZIhvcNAQELBQADggGBAE8GD1vD5kdk
+T7a/f8Phzv1QpG7WrHKo5QWFApcjajGbsK/CriyPJ9Ym+xZJ1IGaZc/CotYOqIuX
+ClFzlL1jm4T8LeEwju5m06ZbKAS2i1qU9YlqWZ0lGWe+x8+lvZR628e8rvVb+zAp
+wRBtrJZLSV4bhLj9fjRrEWZd8sJHUHzkETsXd7SD+fe+oSorlQ7B4A2VRBPf0JUF
+5QfU8Fv2Mb4mXoFkZK//iR/J27EwR8F0waGfS7Sc+cJGS1uo00cIVNLQBszd4b5h
+KvE2EwOZIKldOaEp0Rl/kmKGYHIuAGfl0Dvd8VlUfnXP3/vgXJtJ3cX5hDBMQ1s9
+padi0/W8fnu3E3Z922ceUpPkslXEGHBMGUoVDylt8QbOuKgjdmnEYLbB3yL2L7v1
+ENtBjVDV0WKXXmrXYYc8sGuNGE7NUSrry/m1u6J/muhH4NmWSJ0PcDQAPOdXZ4l5
+juLQfci27z5waIj0SrBJ7abmmQE/D1y7k528dXH/whu0HlIDnM7zQQ==
+-----END CERTIFICATE-----
+`;
+const allCA = [...tls.rootCertificates, localCA];
+const customAgent = new undici_1.Agent({
+    connect: {
+        ca: allCA,
+    },
+});
+globalThis.fetch = function (input, init) {
+    return (0, undici_1.fetch)(input, { ...init, dispatcher: customAgent });
+};
 const commander_1 = require("commander");
 const utils_1 = require("./utils");
 const program = new commander_1.Command();
@@ -11,9 +85,10 @@ program
     .version(require('../../package.json').version)
     .option('--base-url <url>', '后端地址')
     .option('--token <token>', 'JWT token')
-    .option('--plugin-id <id>', '插件 ID')
-    .option('--format <fmt>', '输出格式: json | table', 'json')
+    .option('--format <fmt>', '输出格式: json | table')
     .option('--debug', '启用调试输出');
+const help_1 = require("./commands/help");
+const version_1 = require("./commands/version");
 const auth_1 = require("./commands/auth");
 const config_cmd_1 = require("./commands/config-cmd");
 const text_1 = require("./commands/text");
@@ -28,6 +103,8 @@ const admin_1 = require("./commands/admin");
 const stats_1 = require("./commands/stats");
 const shared_1 = require("./commands/shared");
 const chrome_1 = require("./commands/chrome");
+(0, help_1.registerHelpCommand)(program);
+(0, version_1.registerVersionCommand)(program);
 (0, auth_1.registerAuthCommands)(program);
 (0, config_cmd_1.registerConfigCommands)(program);
 (0, text_1.registerTextCommands)(program);

package/dist/cli/utils.d.ts

@@ -1,3 +1,4 @@
+import { Command } from 'commander';
 export interface CLIError {
     error: true;
     code: string;
@@ -20,4 +21,4 @@ export declare function resolvePluginIdDefault(auth: {
     token: string | null;
     pluginId: string | null;
 }): Promise<string | null>;
-export declare function getFormat(program: any): string;
+export declare function getFormat(program: Command): string;

package/dist/cli/utils.js

@@ -69,7 +69,7 @@ function handleError(err, command) {
             cliError.code = 'NOT_FOUND';
             process.exitCode = 1;
         }
-        else if (err.message.includes('ECONNREFUSED') || err.message.includes('ENOTFOUND') || err.message.includes('ETIMEDOUT')) {
+        else if (err.message.includes('ECONNREFUSED') || err.message.includes('ENOTFOUND') || err.message.includes('ETIMEDOUT') || err.message.includes('fetch failed')) {
             cliError.code = 'NETWORK_ERROR';
             cliError.details = { suggestion: '请检查 base-url 是否正确，后端服务是否运行中' };
             process.exitCode = 1;
@@ -115,6 +115,7 @@ function requireOption(value, name) {
 }
 function initSDK(auth) {
     const { sdkConfig } = require('../index');
+    sdkConfig.setCliMode(true);
     sdkConfig.setBaseUrl(auth.baseUrl);
     if (auth.token)
         sdkConfig.setToken(auth.token);
@@ -122,26 +123,7 @@ function initSDK(auth) {
         sdkConfig.setPluginId(auth.pluginId);
 }
 async function resolvePluginIdDefault(auth) {
-    if (auth.pluginId)
-        return auth.pluginId;
-    if (!auth.token)
-        return null;
-    try {
-        initSDK(auth);
-        const { AuthClient } = require('../index');
-        const client = new AuthClient();
-        const user = await client.getCurrentUserInfo();
-        if (user && user.id) {
-            const defaultId = `user_${user.id}`;
-            const { setConfigValues } = require('./config');
-            setConfigValues({ 'plugin-id': defaultId });
-            return defaultId;
-        }
-    }
-    catch {
-        // can't resolve, return null
-    }
-    return null;
+    return 'cli';
 }
 function getFormat(program) {
     const opts = program.opts();

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.1";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.5";
 /**
  * 版本兼容性错误
  */
@@ -34,8 +34,9 @@ declare class SDKConfig {
     private _authenticated;
     private _authCheckPromise;
     private _currentUser;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.1";
-    readonly sdkVersion = "1.5.1";
+    private _cliMode;
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.5";
+    readonly sdkVersion = "1.5.5";
     constructor();
     /**
      * Set global base URL
@@ -72,6 +73,7 @@ declare class SDKConfig {
      * 设置调试模式
      */
     setDebug(enabled: boolean): void;
+    setCliMode(enabled: boolean): void;
     /**
      * Get debug mode
      * 获取调试模式状态

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.1";
+const SDK_VERSION = "1.5.5";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.5.1";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.1";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.5";
 /**
  * 版本兼容性错误
  */
@@ -38,6 +38,7 @@ class SDKConfig {
         this._authenticated = null; // null = 未检查
         this._authCheckPromise = null;
         this._currentUser = null;
+        this._cliMode = false;
         this.sdkSignature = exports.SDK_SIGNATURE;
         this.sdkVersion = SDK_VERSION;
         // 在全局对象上注册 SDK 版本信息（用于后端扫描检测）
@@ -177,6 +178,9 @@ class SDKConfig {
     setDebug(enabled) {
         this._debug = enabled;
     }
+    setCliMode(enabled) {
+        this._cliMode = enabled;
+    }
     /**
      * Get debug mode
      * 获取调试模式状态
@@ -216,7 +220,9 @@ class SDKConfig {
     async _performAuthCheck() {
         if (!this._token) {
             this._authenticated = false;
-            console.warn('[ai-world-sdk] 未检测到登录 token，请先登录。Vite 项目请在 vite.config 中添加 aiWorldPlugin()');
+            if (!this._cliMode && typeof process !== 'undefined' && !process.env?.__AI_WORLD_CLI__) {
+                console.warn('[ai-world-sdk] 未检测到登录 token，请先登录。Vite 项目请在 vite.config 中添加 aiWorldPlugin()');
+            }
             return false;
         }
         const baseUrl = this._baseUrl || (typeof window !== 'undefined' ? window.location.origin : '');
@@ -257,7 +263,9 @@ class SDKConfig {
             }
             this._authenticated = false;
             this._token = null;
-            console.warn('[ai-world-sdk] Token 已过期或无效，请重新登录');
+            if (!this._cliMode && typeof process !== 'undefined' && !process.env?.__AI_WORLD_CLI__) {
+                console.warn('[ai-world-sdk] Token 已过期或无效，请重新登录');
+            }
             return false;
         }
         catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.5.1",
+  "version": "1.5.5",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -83,6 +83,7 @@
     "@ai-sdk/openai": "^3.0.28",
     "@openrouter/ai-sdk-provider": "^2.3.1",
     "ai": "^6.0.85",
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "undici": "^8.1.0"
   }
 }

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

@@ -257,8 +257,11 @@ for await (const chunk of stream.textStream) {
 
 - `ai-world` 命令行工具，所有 SDK 功能的命令行模式
 - 安装: `npm install -g ai-world-sdk` 或 `npx ai-world-sdk`
-- 认证: `ai-world auth login` 或环境变量 `DEBUG_TOKEN`
+- 认证: `ai-world login` 或环境变量 `DEBUG_TOKEN`
 - 输出: 默认 JSON（AI Agent 友好），支持 `--format table`
+- 默认值: plugin-id=`cli`，provider=`kunpo`，endpoint=`openai`，model=`deepseek/deepseek-v4-pro`
+- 版本检查: `ai-world version`（从后端读取最新版本）
+- 帮助: `ai-world help` / `ai-world help <command>`（中文详细说明）
 - 完整命令参考 → `docs/cli-commands.md`
 
 #### 快速开始
@@ -268,10 +271,10 @@ for await (const chunk of stream.textStream) {
 npm install -g ai-world-sdk
 
 # 登录
-ai-world auth login
+ai-world login
 
-# 配置默认值
-ai-world config set provider=api2img endpoint=openai model=gpt-4o-mini
+# 配置默认值（可选，默认 kunpo/openai/deepseek-v4-pro）
+ai-world config set provider=kunpo endpoint=openai model=deepseek/deepseek-v4-pro
 
 # 文本生成
 ai-world text generate --prompt "你好"
@@ -281,6 +284,9 @@ ai-world text stream --prompt "请介绍人工智能"
 
 # 查看插件列表
 ai-world plugin list --format table
+
+# 版本检查
+ai-world version
 ```
 
 ### 常见错误 → `docs/common-mistakes.md`

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

@@ -1,25 +1,40 @@
 # AI World CLI 命令参考
 
-## auth — 认证管理
+## 认证管理（顶层命令）
 
 ```bash
-ai-world auth login [--token <jwt>]     # 交互式登录或直接设置 token
-ai-world auth logout                    # 退出登录（清除缓存）
-ai-world auth me                        # 当前用户信息
-ai-world auth status                    # 认证状态检查
+ai-world login [--token <jwt>]          # 交互式登录或直接设置 token
+ai-world logout                         # 退出登录（清除缓存）
+ai-world me                             # 当前用户信息
+ai-world status                         # 认证状态检查
+```
+
+## version — 版本检查
+
+```bash
+ai-world version                        # 显示当前版本，从后端检查更新
+```
+
+## help — 帮助
+
+```bash
+ai-world help                           # 显示所有命令详细说明（中文）
+ai-world help <command>                 # 显示特定命令的使用方法和示例
 ```
 
 ## config — 配置管理
 
 ```bash
-ai-world config set <key=value...>      # 批量设置，如 provider=api2img endpoint=openai
-ai-world config get <key>               # 查看某个配置
-ai-world config list                    # 查看所有配置
+ai-world config set <key=value...>      # 批量设置，如 provider=kunpo endpoint=openai
+ai-world config get <key>               # 查看某个配置（含值和来源 source）
+ai-world config list                    # 查看所有配置（含 effective value 和 source）
 ai-world config reset [key]             # 重置配置（不指定则全部重置）
 ```
 
 可配置项：`base-url`、`token`、`plugin-id`、`provider`、`endpoint`、`model`、`format`
 
+默认值：`base-url`=`https://aiworld.local:8000`、`plugin-id`=`cli`、`provider`=`kunpo`、`endpoint`=`openai`、`model`=`deepseek/deepseek-v4-pro`、`format`=`json`
+
 ## text — 文本生成
 
 ```bash

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

@@ -18,7 +18,7 @@ npx ai-world <command>
 ### 方式一：交互式登录（人类用户）
 
 ```bash
-ai-world auth login
+ai-world login
 ```
 
 自动打开浏览器完成飞书 OAuth 登录，token 保存到 `~/.ai-world/config.json`。
@@ -26,7 +26,7 @@ ai-world auth login
 ### 方式二：直接设置 token（AI Agent）
 
 ```bash
-ai-world auth login --token <your-jwt-token>
+ai-world login --token <your-jwt-token>
 ```
 
 ### 方式三：环境变量（AI Agent 推荐）
@@ -42,11 +42,7 @@ export PLUGIN_ID=my-plugin
 1. 命令行参数：`--token`、`--base-url`、`--plugin-id`
 2. 环境变量：`DEBUG_TOKEN`、`AI_WORLD_BASE_URL`、`PLUGIN_ID`
 3. 本地配置文件：`~/.ai-world/config.json`
-4. 默认值：base-url 默认 `https://aiworld.local:8000`；plugin-id 默认 `user_{user_id}`
-
-### plugin-id 默认值
-
-当未指定 plugin-id 时，CLI 在认证后自动调用 `/api/auth/me` 获取用户 ID，使用 `user_{user_id}` 作为默认值（如用户 ID 为 1 则 `user_1`）。
+4. 默认值：base-url=`https://aiworld.local:8000`，plugin-id=`cli`，provider=`kunpo`，endpoint=`openai`，model=`deepseek/deepseek-v4-pro`
 
 ## 全局选项
 
@@ -66,12 +62,12 @@ export PLUGIN_ID=my-plugin
 
 ```bash
 # 批量设置默认值
-ai-world config set provider=api2img endpoint=openai model=gpt-4o-mini base-url=https://aiworld.local:8000
+ai-world config set provider=kunpo endpoint=openai model=deepseek/deepseek-v4-pro
 
-# 查看所有配置
+# 查看所有配置（显示 key、effective value、source）
 ai-world config list
 
-# 查看单个配置
+# 查看单个配置（显示值和来源）
 ai-world config get provider
 
 # 重置配置
@@ -81,6 +77,8 @@ ai-world config reset provider # 重置单项
 
 可配置项：`base-url`、`token`、`plugin-id`、`provider`、`endpoint`、`model`、`format`
 
+`config list` 输出包含 `source` 字段（`config`=用户设置值 / `default`=内置默认值 / `env`=环境变量）。
+
 ## 输出格式
 
 ### JSON（默认）— AI Agent 友好
@@ -126,14 +124,29 @@ $ ai-world plugin list --format table
 
 退出码：`0` 成功、`1` 一般错误、`2` 参数错误、`3` 认证错误、`4` 权限错误。
 
+## 版本检查
+
+```bash
+ai-world version
+```
+
+从后端 `/api/sdk/latest-version` 获取最新版本号并与当前版本比对，输出是否有更新。
+
+## 帮助
+
+```bash
+ai-world help           # 打印所有命令详情（中文描述）
+ai-world help text      # 查看特定命令帮助
+```
+
 ## AI Agent 典型使用流程
 
 ```bash
 # 1. 设置认证
-ai-world auth login --token $JWT_TOKEN
+ai-world login --token $JWT_TOKEN
 
-# 2. 配置默认值
-ai-world config set provider=api2img endpoint=openai model=gpt-4o-mini
+# 2. 配置默认值（可选，默认 kunpo/openai/deepseek-v4-pro）
+ai-world config set provider=kunpo endpoint=openai model=deepseek/deepseek-v4-pro
 
 # 3. 文本生成
 ai-world text generate --prompt "分析以下代码..."
@@ -151,4 +164,7 @@ ai-world skill download my-skill --output my-skill.zip
 
 # 7. 查看统计
 ai-world stats dashboard
+
+# 8. 查看版本
+ai-world version
 ```