codexmate 0.0.23 → 0.0.24

package/cli.js

@@ -42,8 +42,9 @@ const {
     extractModelNames,
     hasModelsListPayload,
     buildModelsCacheKey,
+    buildApiProbeUrlCandidates,
     buildModelProbeSpec,
-    buildModelConversationSpecs,
+    buildModelProbeSpecs,
     extractModelResponseText,
     normalizeWireApi,
     getSupplementalModelsForBaseUrl,
@@ -74,6 +75,7 @@ const {
     executeTaskPlan
 } = require('./lib/task-orchestrator');
 const { buildConfigHealthReport: buildConfigHealthReportCore } = require('./cli/config-health');
+const { buildDoctorReport, buildDoctorLegacyPayload, renderDoctorMarkdown } = require('./cli/doctor-core');
 const {
     createAuthProfileController
 } = require('./cli/auth-profiles');
@@ -125,6 +127,7 @@ const {
     deleteSkills,
     deleteCodexSkills
 } = require('./cli/skills');
+const { cmdImportSkills: cmdImportSkillsFromUrl } = require('./cli/import-skills-url');
 const {
     getFileStatSafe,
     isBootstrapLikeText,
@@ -4155,12 +4158,14 @@ async function listAllSessions(params = {}) {
     const queryTokens = expandSessionQueryTokens(normalizeQueryTokens(params.query));
     const hasQuery = queryTokens.length > 0;
     const browseLightweight = params.browseLightweight === true && !hasQuery && !hasPathFilter;
-    const cacheKey = hasQuery ? '' : `${browseLightweight ? 'browse' : 'default'}:${source}:${limit}:${normalizedPathFilter}`;
-    if (!hasQuery) {
-        const cached = getSessionListCache(cacheKey, forceRefresh);
-        if (cached) {
-            return cached;
-        }
+    const queryKeyRaw = typeof params.query === 'string' ? params.query.trim() : '';
+    const queryKey = queryKeyRaw.length > 240 ? queryKeyRaw.slice(0, 240) : queryKeyRaw;
+    const cacheKey = hasQuery
+        ? `query:${source}:${limit}:${normalizedPathFilter}:${params.queryMode || ''}:${params.queryScope || ''}:${params.roleFilter || ''}:${Number(params.contentScanLimit) || ''}:${Number(params.contentScanBytes) || ''}:${queryKey}`
+        : `${browseLightweight ? 'browse' : 'default'}:${source}:${limit}:${normalizedPathFilter}`;
+    const cached = getSessionListCache(cacheKey, forceRefresh);
+    if (cached) {
+        return cached;
     }
 
     const scanOptions = hasPathFilter
@@ -4201,9 +4206,7 @@ async function listAllSessions(params = {}) {
         });
     }
     result = mergeAndLimitSessions(result, limit);
-    if (!hasQuery) {
-        setSessionListCache(cacheKey, result);
-    }
+    setSessionListCache(cacheKey, result);
     return result;
 }
 
@@ -6003,6 +6006,60 @@ function importConfigData(payload, options = {}) {
 function resolveSpeedTestTarget(params) {
     if (!params) return { error: 'Missing params' };
 
+    if (typeof params.kind === 'string' && params.kind.trim() === 'claude') {
+        const baseUrl = typeof params.url === 'string' ? params.url.trim() : '';
+        const apiKey = typeof params.apiKey === 'string' ? params.apiKey.trim() : '';
+        const model = typeof params.model === 'string' ? params.model.trim() : '';
+        if (!baseUrl) {
+            return { error: 'Missing url' };
+        }
+        if (!apiKey) {
+            return { error: 'Missing apiKey' };
+        }
+        if (!model) {
+            return { error: 'Missing model' };
+        }
+        const normalizedBase = baseUrl.replace(/\/+$/, '');
+        let parsed = null;
+        try {
+            parsed = new URL(normalizedBase);
+        } catch (_) {
+            return { error: 'Invalid URL' };
+        }
+        const pathname = typeof parsed.pathname === 'string' ? parsed.pathname : '';
+        const trimmedPath = pathname.replace(/\/+$/, '');
+        const isRootPath = !trimmedPath || trimmedPath === '/';
+        const endsWithV1 = trimmedPath.endsWith('/v1');
+        const makeCandidate = (url) => ({
+            method: 'POST',
+            url,
+            body: {
+                model,
+                max_tokens: 16,
+                messages: [{ role: 'user', content: 'ping' }]
+            }
+        });
+        const candidates = [];
+        if (endsWithV1) {
+            candidates.push(makeCandidate(`${normalizedBase}/messages`));
+        } else if (isRootPath) {
+            candidates.push(makeCandidate(`${normalizedBase}/v1/messages`));
+            candidates.push(makeCandidate(`${normalizedBase}/messages`));
+        } else {
+            candidates.push(makeCandidate(`${normalizedBase}/messages`));
+            candidates.push(makeCandidate(`${normalizedBase}/v1/messages`));
+        }
+        return {
+            kind: 'claude',
+            candidates,
+            apiKey,
+            apiKeyHeader: 'x-api-key',
+            headers: {
+                'anthropic-version': '2023-06-01'
+            }
+        };
+    }
+
     if (params.name) {
         const { config } = readConfigOrVirtualDefault();
         const providers = config.model_providers || {};
@@ -6013,20 +6070,32 @@ function resolveSpeedTestTarget(params) {
         if (!provider.base_url) {
             return { error: 'Provider missing URL' };
         }
-        const currentModel = typeof config.model === 'string' ? config.model.trim() : '';
-        const probeSpec = buildModelProbeSpec(provider, currentModel, provider.base_url);
-        if (probeSpec && probeSpec.url) {
-            return {
-                method: 'POST',
-                url: probeSpec.url,
-                body: probeSpec.body,
-                apiKey: provider.preferred_auth_method || ''
-            };
+        const providerName = String(params.name).trim();
+        const currentModels = readCurrentModels();
+        const selectedModel = typeof currentModels[providerName] === 'string' && currentModels[providerName].trim()
+            ? currentModels[providerName].trim()
+            : (typeof config.model === 'string' ? config.model.trim() : '');
+
+        const apiKey = typeof provider.preferred_auth_method === 'string'
+            ? provider.preferred_auth_method.trim()
+            : '';
+
+        const candidates = [];
+        for (const spec of buildModelProbeSpecs(provider, selectedModel, provider.base_url)) {
+            if (!spec || !spec.url) continue;
+            candidates.push({ method: 'POST', url: spec.url, body: spec.body });
+        }
+        for (const url of buildApiProbeUrlCandidates(provider.base_url, 'models')) {
+            candidates.push({ method: 'GET', url });
         }
+        if (candidates.length === 0) {
+            candidates.push({ method: 'GET', url: provider.base_url });
+        }
+
         return {
-            method: 'GET',
-            url: provider.base_url,
-            apiKey: provider.preferred_auth_method || ''
+            kind: 'provider',
+            candidates,
+            apiKey
         };
     }
 
@@ -6041,155 +6110,6 @@ function resolveSpeedTestTarget(params) {
     return { error: 'Missing name or url' };
 }
 
-function extractApiPayloadErrorMessage(payload) {
-    if (!payload || typeof payload !== 'object') {
-        return '';
-    }
-    if (typeof payload.error === 'string' && payload.error.trim()) {
-        return payload.error.trim();
-    }
-    if (!payload.error || typeof payload.error !== 'object') {
-        return '';
-    }
-    if (typeof payload.error.message === 'string' && payload.error.message.trim()) {
-        return payload.error.message.trim();
-    }
-    if (typeof payload.error.code === 'string' && payload.error.code.trim()) {
-        return payload.error.code.trim();
-    }
-    return '';
-}
-
-function resolveProviderChatTarget(params) {
-    const providerName = typeof (params && params.name) === 'string' ? params.name.trim() : '';
-    const prompt = typeof (params && params.prompt) === 'string' ? params.prompt.trim() : '';
-    if (!providerName) {
-        return { error: 'Provider name is required' };
-    }
-    if (!prompt) {
-        return { error: 'Prompt is required' };
-    }
-
-    const { config } = readConfigOrVirtualDefault();
-    const providers = config.model_providers || {};
-    const provider = providers[providerName];
-    if (!provider || typeof provider !== 'object') {
-        return { error: `Provider not found: ${providerName}` };
-    }
-
-    const baseUrl = typeof provider.base_url === 'string' ? provider.base_url.trim() : '';
-    if (!baseUrl) {
-        return { error: `Provider ${providerName} missing URL` };
-    }
-
-    const currentModels = readCurrentModels();
-    const savedModel = currentModels && typeof currentModels[providerName] === 'string'
-        ? currentModels[providerName].trim()
-        : '';
-    const activeProvider = typeof config.model_provider === 'string' ? config.model_provider.trim() : '';
-    const activeModel = typeof config.model === 'string' ? config.model.trim() : '';
-    const model = savedModel || (activeProvider === providerName ? activeModel : '');
-    if (!model) {
-        return { error: `Provider ${providerName} missing current model` };
-    }
-
-    const specs = buildModelConversationSpecs(provider, model, baseUrl, prompt, {
-        maxOutputTokens: 256
-    });
-    if (!specs.length) {
-        return { error: `Provider ${providerName} missing available conversation endpoint` };
-    }
-
-    return {
-        providerName,
-        provider,
-        model,
-        prompt,
-        specs,
-        apiKey: typeof provider.preferred_auth_method === 'string'
-            ? provider.preferred_auth_method.trim()
-            : ''
-    };
-}
-
-async function runProviderChatCheck(params = {}) {
-    const target = resolveProviderChatTarget(params);
-    if (target.error) {
-        return { ok: false, error: target.error };
-    }
-
-    const timeoutMs = Number.isFinite(params.timeoutMs)
-        ? Math.max(1000, Number(params.timeoutMs))
-        : 30000;
-    let finalSpec = target.specs[0];
-    let result = null;
-
-    for (let index = 0; index < target.specs.length; index += 1) {
-        const candidate = target.specs[index];
-        const probeResult = await probeJsonPost(candidate.url, candidate.body, {
-            apiKey: target.apiKey,
-            timeoutMs,
-            maxBytes: 512 * 1024
-        });
-        finalSpec = candidate;
-        result = probeResult;
-        const shouldTryNextCandidate = index < target.specs.length - 1
-            && (!probeResult.ok || probeResult.status === 404);
-        if (!shouldTryNextCandidate) {
-            break;
-        }
-    }
-
-    if (!result || !result.ok) {
-        return {
-            ok: false,
-            provider: target.providerName,
-            model: target.model,
-            url: finalSpec.url,
-            status: Number.isFinite(result && result.status) ? result.status : 0,
-            durationMs: Number.isFinite(result && result.durationMs) ? result.durationMs : 0,
-            reply: '',
-            rawPreview: '',
-            error: result && result.error ? result.error : 'request failed'
-        };
-    }
-
-    let payload = null;
-    try {
-        payload = result.body ? JSON.parse(result.body) : null;
-    } catch (e) {
-        payload = null;
-    }
-
-    const payloadError = extractApiPayloadErrorMessage(payload);
-    if (result.status >= 400 || payloadError) {
-        return {
-            ok: false,
-            provider: target.providerName,
-            model: target.model,
-            url: finalSpec.url,
-            status: Number.isFinite(result.status) ? result.status : 0,
-            durationMs: Number.isFinite(result.durationMs) ? result.durationMs : 0,
-            reply: '',
-            rawPreview: result.body ? truncateText(result.body, 600) : '',
-            error: payloadError || `HTTP ${result.status}`
-        };
-    }
-
-    const reply = extractModelResponseText(payload);
-    return {
-        ok: true,
-        provider: target.providerName,
-        model: target.model,
-        url: finalSpec.url,
-        status: Number.isFinite(result.status) ? result.status : 0,
-        durationMs: Number.isFinite(result.durationMs) ? result.durationMs : 0,
-        reply,
-        rawPreview: reply ? '' : (result.body ? truncateText(result.body, 600) : ''),
-        error: ''
-    };
-}
-
 function runSpeedTest(targetUrl, apiKey, options = {}) {
     const timeoutMs = Number.isFinite(options.timeoutMs)
         ? Math.max(1000, Number(options.timeoutMs))
@@ -6198,6 +6118,8 @@ function runSpeedTest(targetUrl, apiKey, options = {}) {
     if (method === 'POST') {
         return probeJsonPost(targetUrl, options.body || {}, {
             apiKey,
+            apiKeyHeader: typeof options.apiKeyHeader === 'string' ? options.apiKeyHeader : '',
+            headers: options.headers && typeof options.headers === 'object' ? options.headers : null,
             timeoutMs,
             maxBytes: 256 * 1024
         }).then((result) => ({
@@ -6209,6 +6131,8 @@ function runSpeedTest(targetUrl, apiKey, options = {}) {
     }
     return probeUrl(targetUrl, {
         apiKey,
+        apiKeyHeader: typeof options.apiKeyHeader === 'string' ? options.apiKeyHeader : '',
+        headers: options.headers && typeof options.headers === 'object' ? options.headers : null,
         timeoutMs,
         maxBytes: 256 * 1024
     }).then((result) => ({
@@ -6492,6 +6416,123 @@ function cmdStatus() {
     console.log();
 }
 
+function parseDoctorCommandArgs(argv = []) {
+    const options = {
+        format: 'json',
+        lang: '',
+        range: '7d',
+        targetApp: 'codex',
+        remote: true,
+        includeInstall: true,
+        includeUsage: true,
+        includeTasks: true,
+        includeSkills: true,
+        output: ''
+    };
+    let cursor = 0;
+    while (cursor < argv.length) {
+        const token = String(argv[cursor] || '');
+        if (token === '--json') {
+            options.format = 'json';
+            cursor += 1;
+            continue;
+        }
+        if (token === '--format') {
+            const value = String(argv[cursor + 1] || '').trim().toLowerCase();
+            if (!value || value.startsWith('--')) {
+                throw new Error('错误: --format 需要一个值（json/md）');
+            }
+            options.format = value === 'md' || value === 'markdown' ? 'md' : 'json';
+            cursor += 2;
+            continue;
+        }
+        if (token === '--output') {
+            const value = String(argv[cursor + 1] || '').trim();
+            if (!value || value.startsWith('--')) {
+                throw new Error('错误: --output 需要一个值（文件路径）');
+            }
+            options.output = value;
+            cursor += 2;
+            continue;
+        }
+        if (token === '--lang') {
+            const value = String(argv[cursor + 1] || '').trim().toLowerCase();
+            if (!value || value.startsWith('--')) {
+                throw new Error('错误: --lang 需要一个值（zh/en）');
+            }
+            options.lang = value === 'en' ? 'en' : 'zh';
+            cursor += 2;
+            continue;
+        }
+        if (token === '--range') {
+            const value = String(argv[cursor + 1] || '').trim().toLowerCase();
+            if (!value || value.startsWith('--')) {
+                throw new Error('错误: --range 需要一个值（7d/30d/all）');
+            }
+            options.range = value === 'all' ? 'all' : (value === '30d' ? '30d' : '7d');
+            cursor += 2;
+            continue;
+        }
+        if (token === '--target-app') {
+            const value = String(argv[cursor + 1] || '').trim().toLowerCase();
+            if (!value || value.startsWith('--')) {
+                throw new Error('错误: --target-app 需要一个值（codex/claude）');
+            }
+            options.targetApp = value === 'claude' ? 'claude' : 'codex';
+            cursor += 2;
+            continue;
+        }
+        if (token === '--no-remote') {
+            options.remote = false;
+            cursor += 1;
+            continue;
+        }
+        if (token === '--no-install') {
+            options.includeInstall = false;
+            cursor += 1;
+            continue;
+        }
+        cursor += 1;
+    }
+    return options;
+}
+
+async function cmdDoctor(argv = []) {
+    try {
+        const options = parseDoctorCommandArgs(argv);
+        const report = await buildDoctorReport(options, {
+            getStatusPayload: buildMcpStatusPayload,
+            buildInstallStatusReport,
+            buildConfigHealthReport,
+            listSessionUsage,
+            buildTaskOverviewPayload,
+            listSkills
+        });
+        const format = options.format === 'md' ? 'md' : 'json';
+        const text = format === 'md'
+            ? renderDoctorMarkdown(report)
+            : JSON.stringify(report, null, 2);
+        if (options.output) {
+            ensureDir(path.dirname(options.output));
+            fs.writeFileSync(options.output, text);
+        } else {
+            process.stdout.write(text + '\n');
+        }
+    } catch (e) {
+        console.error('错误:', e && e.message ? e.message : e);
+        process.exitCode = 1;
+    }
+}
+
+async function cmdImportSkills(argv = []) {
+    try {
+        await cmdImportSkillsFromUrl(argv);
+    } catch (e) {
+        console.error('错误:', e && e.message ? e.message : e);
+        process.exitCode = 1;
+    }
+}
+
 // 列出所有提供商
 function cmdList() {
     const configResult = readConfigOrVirtualDefault();
@@ -8339,6 +8380,21 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
                         case 'config-health-check':
                             result = await buildConfigHealthReport(params || {});
                             break;
+                        case 'doctor':
+                            {
+                                const doctorParams = isPlainObject(params) ? params : {};
+                                const report = await buildDoctorReport(doctorParams, {
+                                    getStatusPayload: buildMcpStatusPayload,
+                                    buildInstallStatusReport,
+                                    buildConfigHealthReport,
+                                    listSessionUsage,
+                                    buildTaskOverviewPayload,
+                                    listSkills
+                                });
+                                result = buildDoctorLegacyPayload(report);
+                                result.markdown = renderDoctorMarkdown(report);
+                            }
+                            break;
                         case 'get-agents-file':
                             result = readAgentsFile(params || {});
                             break;
@@ -8446,11 +8502,41 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
                                 result = { error: target.error };
                                 break;
                             }
-                            result = await runSpeedTest(target.url, target.apiKey, target);
-                            break;
-                        }
-                        case 'provider-chat-check': {
-                            result = await runProviderChatCheck(params || {});
+                            const timeoutMs = Number.isFinite(params && params.timeoutMs)
+                                ? Math.max(1000, Number(params.timeoutMs))
+                                : 0;
+                            if (Array.isArray(target.candidates) && target.candidates.length > 0) {
+                                let finalCandidate = target.candidates[0];
+                                let finalResult = null;
+                                for (let index = 0; index < target.candidates.length; index += 1) {
+                                    const candidate = target.candidates[index];
+                                    const probeResult = await runSpeedTest(candidate.url, target.apiKey, {
+                                        ...candidate,
+                                        apiKeyHeader: target.apiKeyHeader,
+                                        headers: target.headers,
+                                        timeoutMs: timeoutMs || undefined
+                                    });
+                                    finalCandidate = candidate;
+                                    finalResult = probeResult;
+                                    const status = Number.isFinite(probeResult && probeResult.status) ? probeResult.status : 0;
+                                    const shouldTryNext = index < target.candidates.length - 1 && status === 404;
+                                    if (!shouldTryNext) {
+                                        break;
+                                    }
+                                }
+                                result = {
+                                    ok: !!(finalResult && finalResult.ok),
+                                    status: Number.isFinite(finalResult && finalResult.status) ? finalResult.status : 0,
+                                    durationMs: Number.isFinite(finalResult && finalResult.durationMs) ? finalResult.durationMs : 0,
+                                    error: finalResult && finalResult.ok ? '' : (finalResult && finalResult.error ? finalResult.error : ''),
+                                    url: finalCandidate && finalCandidate.url ? finalCandidate.url : ''
+                                };
+                                break;
+                            }
+                            result = await runSpeedTest(target.url, target.apiKey, {
+                                ...target,
+                                timeoutMs: timeoutMs || undefined
+                            });
                             break;
                         }
                         case 'openai-bridge-get-provider': {
@@ -8913,7 +8999,8 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
     const openUrl = `http://${formatHostForUrl(openHost)}:${port}`;
     server.listen(port, host, () => {
         console.log('\n✓ Web UI 已启动');
-        console.log(`  待访问: ${openUrl}`);
+        const willOpenBrowser = !!openBrowser && !process.env.CODEXMATE_NO_BROWSER;
+        console.log(`  ${willOpenBrowser ? '已打开' : '待访问'}: ${openUrl}`);
         if (host && host !== openHost) {
             console.log('  监听地址:', host);
         }
@@ -8923,9 +9010,8 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
             console.warn('  建议仅在可信网络使用，或改用 --host 127.0.0.1。');
         }
 
-        if (!process.env.CODEXMATE_NO_BROWSER && openBrowser) {
-            const url = openUrl;
-            openBrowserAfterReady(url);
+        if (willOpenBrowser) {
+            openBrowserAfterReady(openUrl);
         }
     });
 
@@ -9036,14 +9122,15 @@ function cmdStart(options = {}) {
         || process.env.CODEXMATE_DEV === '1'
         || process.env.CODEXMATE_DEV === 'true';
 
-    // 禁止自动打开浏览器：仅输出 URL，交由用户自行点击/打开。
+    const shouldOpenBrowser = !options.noBrowser && !process.env.CODEXMATE_NO_BROWSER;
+
     let serverHandle = createWebServer({
         htmlPath,
         assetsDir,
         webDir,
         host,
         port,
-        openBrowser: false
+        openBrowser: shouldOpenBrowser
     });
 
     // 禁止前端变更侦测与自动重启：避免终端输出噪音与访问时短暂 Connection Refused。
@@ -13076,6 +13163,37 @@ async function cmdMcp(args = []) {
     });
 }
 
+function printMainHelp() {
+    console.log('\nCodex Mate - Codex 提供商管理工具');
+    console.log('\n用法:');
+    console.log('  codexmate status           显示当前状态');
+    console.log('  codexmate doctor [--format json|md] [--lang zh|en] [--output <PATH>]  输出诊断报告');
+    console.log('  codexmate import-skills <URL> [--target-app codex|claude] [--name <NAME>] [--timeout-ms <MS>]  从 URL 导入 skills');
+    console.log('  codexmate setup            交互式配置向导');
+    console.log('  codexmate list             列出所有提供商');
+    console.log('  codexmate models           列出所有模型');
+    console.log('  codexmate switch <名称>    切换提供商');
+    console.log('  codexmate use <模型>       切换模型');
+    console.log('  codexmate add <名称> <URL> [密钥] [--bridge <openai>]');
+    console.log('  codexmate delete <名称>    删除提供商');
+    console.log('  codexmate claude <BaseURL> <API密钥> [模型]  写入 Claude Code 配置');
+    console.log('  codexmate auth <list|import|switch|delete|status>  认证管理');
+    console.log('  codexmate add-model <模型> 添加模型');
+    console.log('  codexmate delete-model <模型> 删除模型');
+    console.log('  codexmate workflow <list|get|validate|run|runs>  MCP 工作流中心');
+    console.log('  codexmate task <plan|run|runs|queue|retry|cancel|logs>  本地任务编排');
+    console.log('  codexmate run [--host <HOST>] [--no-browser]    启动 Web 界面');
+    console.log('  codexmate codex [参数...] [--follow-up <文本>|--queued-follow-up <文本> 可重复]  等同于 codex --yolo');
+    console.log('    注: follow-up 自动排队仅支持 linux/android/netbsd/openbsd/darwin/freebsd 且 stdin 必须是 TTY，其他平台会报错');
+    console.log('  codexmate qwen [参数...]   等同于 qwen --yolo');
+    console.log('  codexmate mcp [serve] [--transport stdio] [--allow-write|--read-only]');
+    console.log('  codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]');
+    console.log('  codexmate zip <路径> [--max:级别]  压缩（系统 zip 优先，其次 zip-lib）');
+    console.log('  codexmate unzip <zip文件> [输出目录]  解压（zip-lib）');
+    console.log('  codexmate unzip-ext <zip目录> [输出目录] [--ext:后缀[,后缀...]] [--no-recursive]  批量提取 ZIP 指定后缀文件（默认递归）');
+    console.log('');
+}
+
 // ============================================================================
 // 主程序
 // ============================================================================
@@ -13091,32 +13209,8 @@ async function main() {
         }
     }
 
-    if (args.length === 0) {
-        console.log('\nCodex Mate - Codex 提供商管理工具');
-        console.log('\n用法:');
-        console.log('  codexmate status           显示当前状态');
-        console.log('  codexmate setup            交互式配置向导');
-        console.log('  codexmate list             列出所有提供商');
-        console.log('  codexmate models           列出所有模型');
-        console.log('  codexmate switch <名称>    切换提供商');
-        console.log('  codexmate use <模型>       切换模型');
-        console.log('  codexmate add <名称> <URL> [密钥] [--bridge <openai>]');
-        console.log('  codexmate delete <名称>    删除提供商');
-        console.log('  codexmate claude <BaseURL> <API密钥> [模型]  写入 Claude Code 配置');
-        console.log('  codexmate add-model <模型> 添加模型');
-        console.log('  codexmate delete-model <模型> 删除模型');
-        console.log('  codexmate workflow <list|get|validate|run|runs>  MCP 工作流中心');
-        console.log('  codexmate task <plan|run|runs|queue|retry|cancel|logs>  本地任务编排');
-        console.log('  codexmate run [--host <HOST>] [--no-browser]    启动 Web 界面');
-        console.log('  codexmate codex [参数...] [--follow-up <文本>|--queued-follow-up <文本> 可重复]  等同于 codex --yolo');
-        console.log('    注: follow-up 自动排队仅支持 linux/android/netbsd/openbsd/darwin/freebsd 且 stdin 必须是 TTY，其他平台会报错');
-        console.log('  codexmate qwen [参数...]   等同于 qwen --yolo');
-        console.log('  codexmate mcp [serve] [--transport stdio] [--allow-write|--read-only]');
-        console.log('  codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]');
-        console.log('  codexmate zip <路径> [--max:级别]  压缩（系统 zip 优先，其次 zip-lib）');
-        console.log('  codexmate unzip <zip文件> [输出目录]  解压（zip-lib）');
-        console.log('  codexmate unzip-ext <zip目录> [输出目录] [--ext:后缀[,后缀...]] [--no-recursive]  批量提取 ZIP 指定后缀文件（默认递归）');
-        console.log('');
+    if (args.length === 0 || command === '--help' || command === '-h' || command === 'help') {
+        printMainHelp();
         process.exit(0);
     }
 
@@ -13155,6 +13249,8 @@ async function main() {
     switch (command) {
         case '__task-worker': await cmdTaskWorker(args.slice(1)); break;
         case 'status': cmdStatus(); break;
+        case 'doctor': await cmdDoctor(args.slice(1)); break;
+        case 'import-skills': await cmdImportSkills(args.slice(1)); break;
         case 'setup': await cmdSetup(); break;
         case 'list': cmdList(); break;
         case 'models': await cmdModels(); break;