@aswless_854771076/ai_short_studio_cli 0.1.64 → 0.1.66

package/dist/commands/config/ai-provider/set.d.ts

@@ -0,0 +1,40 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * vvicat config ai-provider set <providerId> [...flags]
+ *
+ * 写入 provider 配置。两类使用方式：
+ *
+ *   1. 命令行 flag（最常见）：
+ *      vvicat config ai-provider set comfyui \
+ *        --base-url http://127.0.0.1:8188 \
+ *        --enabled true \
+ *        --protocol comfyui-official
+ *
+ *   2. JSON 文件（复杂场景，如 openai-compat 协议全套字段）：
+ *      vvicat config ai-provider set openai --file openai-config.json
+ *      cat openai-config.json | vvicat config ai-provider set openai --file -
+ *
+ * `--file` 模式时：JSON 内容会作为完整 body 提交，要求含 `type` + `name`；CLI 不再叠加 flag。
+ */
+export default class ConfigAiProviderSet extends BaseCommand {
+    static description: string;
+    static args: {
+        providerId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-mode': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        protocol: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        enabled: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'sort-order': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        create: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/ai-provider/set.js

@@ -0,0 +1,65 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, readJsonInput } from '../../../command-helpers.js';
+import { composeBodyFromFlags } from '../../../domain/ai-provider-command-helpers.js';
+/**
+ * vvicat config ai-provider set <providerId> [...flags]
+ *
+ * 写入 provider 配置。两类使用方式：
+ *
+ *   1. 命令行 flag（最常见）：
+ *      vvicat config ai-provider set comfyui \
+ *        --base-url http://127.0.0.1:8188 \
+ *        --enabled true \
+ *        --protocol comfyui-official
+ *
+ *   2. JSON 文件（复杂场景，如 openai-compat 协议全套字段）：
+ *      vvicat config ai-provider set openai --file openai-config.json
+ *      cat openai-config.json | vvicat config ai-provider set openai --file -
+ *
+ * `--file` 模式时：JSON 内容会作为完整 body 提交，要求含 `type` + `name`；CLI 不再叠加 flag。
+ */
+export default class ConfigAiProviderSet extends BaseCommand {
+    static description = '配置 AI provider 的 baseUrl / apiKey / 协议 / enabled 等字段';
+    static args = {
+        providerId: Args.string({ required: true, description: 'provider ID' }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'base-url': Flags.string({ description: 'provider 服务地址（如 http://127.0.0.1:8188）' }),
+        'api-key': Flags.string({ description: 'provider API key（仅写入；不会回显）' }),
+        'api-mode': Flags.string({ description: 'apiMode（gateway 协议族字段，如 openai / comfyui-official）' }),
+        name: Flags.string({ description: 'provider 展示名（默认沿用 providerId）' }),
+        protocol: Flags.string({ description: 'protocolMode（openai / comfyui-official / runninghub）' }),
+        enabled: Flags.boolean({ description: 'true 启用；false 禁用', allowNo: true }),
+        'sort-order': Flags.integer({ description: '排序权重（数字越小越靠前）' }),
+        file: Flags.string({ description: '完整 JSON body；省略时从 stdin 读取' }),
+        create: Flags.boolean({ description: '强制走 POST 创建（默认 PATCH 404 时自动回退到 create）', default: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigAiProviderSet);
+        const { api } = await commandApi(flags);
+        const body = flags.file !== undefined
+            ? await readJsonInput(flags.file === '-' ? undefined : flags.file)
+            : composeBodyFromFlags(args.providerId, flags);
+        if (typeof body.type !== 'string' || !body.type.trim()) {
+            this.error('set 请求 body 必须包含 type 字段（provider 类型，如 comfyui / openai）');
+        }
+        if (flags.create) {
+            this.print(await api.createAiProvider(body));
+            return;
+        }
+        try {
+            this.print(await api.updateAiProvider(args.providerId, body));
+        }
+        catch (error) {
+            // PATCH 404 → 不存在，自动回退到 create（更友好的 UX）
+            const status = error.status;
+            if (status === 404) {
+                this.print(await api.createAiProvider(body));
+                return;
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/config/ai-provider/test.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * vvicat config ai-provider test <providerId>
+ *
+ * 触发服务端连通性探测：
+ *   - comfyui: GET baseUrl/system_stats
+ *   - 其他 OpenAI 兼容: GET baseUrl/models 带 Bearer token
+ *
+ * 返回 { success, steps, durationMs }。CLI 原样转发。
+ */
+export default class ConfigAiProviderTest extends BaseCommand {
+    static description: string;
+    static args: {
+        providerId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/ai-provider/test.js

@@ -0,0 +1,24 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi } from '../../../command-helpers.js';
+/**
+ * vvicat config ai-provider test <providerId>
+ *
+ * 触发服务端连通性探测：
+ *   - comfyui: GET baseUrl/system_stats
+ *   - 其他 OpenAI 兼容: GET baseUrl/models 带 Bearer token
+ *
+ * 返回 { success, steps, durationMs }。CLI 原样转发。
+ */
+export default class ConfigAiProviderTest extends BaseCommand {
+    static description = '触发服务端连通性探测（GET /models 或 /system_stats）';
+    static args = {
+        providerId: Args.string({ required: true, description: 'provider ID' }),
+    };
+    static flags = BaseCommand.baseFlags;
+    async run() {
+        const { args, flags } = await this.parse(ConfigAiProviderTest);
+        const { api } = await commandApi(flags);
+        this.print(await api.testAiProvider(args.providerId));
+    }
+}

package/dist/commands/config/set.d.ts

@@ -2,6 +2,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class ConfigSet extends BaseCommand {
     static flags: {
         file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verify: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/config/set.js

@@ -1,7 +1,60 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import { commandApi, readJsonInput } from '../../command-helpers.js';
+// 服务端 GET /api/user/api-config 会自动"修复"无效的 defaultModels；客户端拿到
+// success=true 但实际配置可能被覆盖。--verify 在 set 成功后立刻 GET 一次，
+// 输出"用户请求值 vs 服务端实际值" diff，让 agent 能看到真相。
+// 不影响默认行为；只是给 agent 一个验证工具。
 export default class ConfigSet extends BaseCommand {
-    static flags = { ...BaseCommand.baseFlags, file: Flags.string({ description: '配置 JSON；省略时读取 stdin' }) };
-    async run() { const { flags } = await this.parse(ConfigSet); const { api } = await commandApi(flags); this.print(await api.updateConfig(await readJsonInput(flags.file))); }
+    static flags = {
+        ...BaseCommand.baseFlags,
+        file: Flags.string({ description: '配置 JSON；省略时读取 stdin' }),
+        verify: Flags.boolean({
+            description: 'set 成功后立刻 GET 一次，diff 用户请求值 vs 服务端实际值。默认 false。',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ConfigSet);
+        const { api } = await commandApi(flags);
+        const requested = await readJsonInput(flags.file);
+        const result = await api.updateConfig(requested);
+        if (!flags.verify) {
+            this.print(result);
+            return;
+        }
+        // --verify：再 GET 一次，把 effective vs requested diff 出来。
+        // 服务端会修复 invalid defaultModels / capabilityDefaults，所以 effective
+        // 可能 ≠ requested。这里**只递归遍历 requested 的 keys**，避免 effective
+        // 中多出的 models / providers / capabilityDefaults 等造成噪声。
+        const effective = (await api.config());
+        const diff = diffJsonRequested(requested, effective, '');
+        this.print({ requested, effective, diff });
+    }
+}
+// 只递归遍历 requested 的 keys；effective 中多余 keys 不输出。
+// 这样客户端能直接看到"用户请求的字段"与"服务端实际值"的差异，不会被服务端
+// 补充的默认值 / 自动修复字段污染 diff。
+function diffJsonRequested(requested, effective, prefix) {
+    const out = [];
+    for (const key of Object.keys(requested ?? {})) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        const r = (requested ?? {})[key];
+        const e = (effective ?? {})[key];
+        if (r === undefined)
+            continue;
+        if (e === undefined) {
+            out.push(`${path}: requested=${JSON.stringify(r)}, effective=<missing>`);
+        }
+        else if (isPlainObject(r) && isPlainObject(e)) {
+            out.push(...diffJsonRequested(r, e, path));
+        }
+        else if (JSON.stringify(r) !== JSON.stringify(e)) {
+            out.push(`${path}: requested=${JSON.stringify(r)}, effective=${JSON.stringify(e)}`);
+        }
+    }
+    return out;
+}
+function isPlainObject(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
 }

package/dist/commands/task/wait.d.ts

@@ -7,6 +7,7 @@ export default class TaskWait extends BaseCommand {
         task: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         concurrency: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'max-wait-ms': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/task/wait.js

@@ -8,6 +8,10 @@ export default class TaskWait extends BaseCommand {
         task: Flags.string({ description: '任务 ID，可重复指定以批量等待', multiple: true }),
         concurrency: Flags.integer({ description: '批量轮询并发数', default: 4, min: 1, max: 16 }),
         interval: Flags.integer({ default: 1000 }),
+        'max-wait-ms': Flags.integer({
+            description: '单次 waitTask 最大等待毫秒数；0 表示不超时（保留旧行为）。',
+            default: 0,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(TaskWait);
@@ -15,7 +19,8 @@ export default class TaskWait extends BaseCommand {
         if (!taskIds.length)
             throw new Error('请提供 taskId 或至少一个 --task');
         const { api } = await commandApi(flags);
-        const tasks = await mapConcurrent(taskIds, flags.concurrency, async (taskId) => await api.waitTask(taskId, flags.interval));
+        const maxWaitMs = flags['max-wait-ms'] > 0 ? flags['max-wait-ms'] : Number.POSITIVE_INFINITY;
+        const tasks = await mapConcurrent(taskIds, flags.concurrency, async (taskId) => await api.waitTask(taskId, flags.interval, { maxWaitMs }));
         this.print(tasks.length === 1 ? tasks[0] : { tasks });
         if (tasks.some((task) => task.status !== 'completed'))
             this.error('部分任务未成功完成', { exit: 8 });

package/dist/domain/ai-provider-capabilities.d.ts

@@ -0,0 +1,109 @@
+/**
+ * vvicat config ai-provider capabilities 命令的聚合视图：
+ * 把服务端返回的 providers / catalog / user-config / reachability
+ * 合并成一张 agent 可读的"我能跑什么 / 缺什么"结构。
+ *
+ * 设计目标：
+ * - 单一入口；agent 一次拿到所有决策所需信息。
+ * - 畸形输入不抛错（catalogModels / defaultModels 可能因为网络/服务端 bug 缺数据）。
+ * - 字段命名稳定（生产数据契约）；JSON 字段不要随意改名。
+ */
+export type ReachabilityState = 'ok' | 'failed' | 'skipped' | 'unknown';
+export interface ProviderCapabilityRow {
+    id: string;
+    name: string;
+    type: string;
+    enabled: boolean;
+    baseUrl: string | null;
+    apiKeyMask: string | null;
+    hasApiKey: boolean;
+    protocolMode: string | null;
+    lastTestResult: 'pass' | 'fail' | null;
+    lastResponseMs: number | null;
+    upstreamModels?: unknown[];
+    upstreamModelsCount: number;
+    upstreamModelsSyncedAt: string | null;
+    reachability: ReachabilityState;
+    reachabilityDetail?: string;
+}
+export interface ModelCapabilityRow {
+    modelKey: string;
+    provider: string;
+    type: 'image' | 'video' | 'audio' | 'llm' | 'tts';
+    enabled: boolean;
+    capabilityOptions: Record<string, unknown>;
+}
+export interface MissingPiece {
+    capability: string;
+    modelKey?: string;
+    reason: string;
+    fixHint?: string;
+}
+export interface CapabilitiesReport {
+    generatedAt: string;
+    baseUrl: string;
+    summary: {
+        totalProviders: number;
+        enabledProviders: number;
+        reachableProviders: number;
+        catalogModelCount: number;
+        capabilityCount: number;
+    };
+    providers: ProviderCapabilityRow[];
+    capabilities: {
+        imageModel: ModelCapabilityRow[];
+        videoModel: ModelCapabilityRow[];
+        audioModel: ModelCapabilityRow[];
+        analysisModel: ModelCapabilityRow[];
+        characterModel: ModelCapabilityRow[];
+        locationModel: ModelCapabilityRow[];
+        storyboardModel: ModelCapabilityRow[];
+    };
+    userDefaults: {
+        imageModel: string | null;
+        videoModel: string | null;
+        audioModel: string | null;
+        analysisModel: string | null;
+        characterModel: string | null;
+        locationModel: string | null;
+        storyboardModel: string | null;
+    };
+    reachability: Record<string, {
+        ok: boolean;
+        detail?: string;
+        durationMs?: number;
+    }>;
+    missingPieces: MissingPiece[];
+}
+export interface ProviderCapabilitiesInput {
+    baseUrl: string;
+    providers: Array<{
+        id: string;
+        name: string;
+        type: string;
+        enabled: boolean;
+        baseUrl: string | null;
+        apiKeyMask: string | null;
+        hasApiKey: boolean;
+        protocolMode: string | null;
+        lastTestResult: 'pass' | 'fail' | null;
+        lastResponseMs: number | null;
+        upstreamModels?: unknown[];
+        upstreamModelsSyncedAt: string | null;
+    }>;
+    catalogModels: Array<{
+        modelKey: string;
+        provider: string;
+        type: 'image' | 'video' | 'audio' | 'llm' | 'tts';
+        enabled?: boolean;
+        capabilities?: Record<string, Record<string, unknown>>;
+    }> | null;
+    defaultModels: Record<string, string> | null;
+    capabilityDefaults: Record<string, Record<string, unknown>> | null;
+    reachability: Record<string, {
+        ok: boolean;
+        detail?: string;
+        durationMs?: number;
+    }>;
+}
+export declare function buildCapabilitiesReport(input: ProviderCapabilitiesInput): CapabilitiesReport;

package/dist/domain/ai-provider-capabilities.js

@@ -0,0 +1,180 @@
+/**
+ * vvicat config ai-provider capabilities 命令的聚合视图：
+ * 把服务端返回的 providers / catalog / user-config / reachability
+ * 合并成一张 agent 可读的"我能跑什么 / 缺什么"结构。
+ *
+ * 设计目标：
+ * - 单一入口；agent 一次拿到所有决策所需信息。
+ * - 畸形输入不抛错（catalogModels / defaultModels 可能因为网络/服务端 bug 缺数据）。
+ * - 字段命名稳定（生产数据契约）；JSON 字段不要随意改名。
+ */
+function isPlainObject(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function mapCapabilityBucket(type) {
+    if (type === 'llm')
+        return 'analysisModel';
+    if (type === 'image')
+        return 'imageModel';
+    if (type === 'video')
+        return 'videoModel';
+    if (type === 'tts')
+        return 'audioModel';
+    return 'audioModel';
+}
+function resolveReachability(provider, sample) {
+    if (!provider.enabled)
+        return 'skipped';
+    if (!sample)
+        return 'unknown';
+    return sample.ok ? 'ok' : 'failed';
+}
+export function buildCapabilitiesReport(input) {
+    const catalogModels = Array.isArray(input.catalogModels) ? input.catalogModels : [];
+    const defaultModels = isPlainObject(input.defaultModels) ? input.defaultModels : {};
+    const capabilityDefaults = isPlainObject(input.capabilityDefaults) ? input.capabilityDefaults : {};
+    // 1) providers 表（含 reachability 状态）
+    const providerIds = new Set(input.providers.map((p) => p.id));
+    const providers = input.providers.map((p) => {
+        const sample = input.reachability[p.id];
+        return {
+            id: p.id,
+            name: p.name,
+            type: p.type,
+            enabled: p.enabled,
+            baseUrl: p.baseUrl,
+            apiKeyMask: p.apiKeyMask,
+            hasApiKey: p.hasApiKey,
+            protocolMode: p.protocolMode,
+            lastTestResult: p.lastTestResult,
+            lastResponseMs: p.lastResponseMs,
+            upstreamModelsCount: Array.isArray(p.upstreamModels) ? p.upstreamModels.length : 0,
+            upstreamModelsSyncedAt: p.upstreamModelsSyncedAt,
+            reachability: resolveReachability(p, sample),
+            reachabilityDetail: sample?.detail,
+        };
+    });
+    // 2) capability buckets
+    const buckets = {
+        imageModel: [],
+        videoModel: [],
+        audioModel: [],
+        analysisModel: [],
+        characterModel: [],
+        locationModel: [],
+        storyboardModel: [],
+    };
+    for (const model of catalogModels) {
+        if (!model || typeof model.modelKey !== 'string' || typeof model.provider !== 'string')
+            continue;
+        if (model.enabled === false)
+            continue;
+        const bucket = mapCapabilityBucket(model.type);
+        const row = {
+            modelKey: model.modelKey,
+            provider: model.provider,
+            type: model.type,
+            enabled: model.enabled !== false,
+            capabilityOptions: extractCapabilityOptions(model.capabilities, model.type),
+        };
+        buckets[bucket].push(row);
+    }
+    // character/location/storyboard 都是 image 类，复用 imageModel 列表
+    buckets.characterModel = buckets.imageModel;
+    buckets.locationModel = buckets.imageModel;
+    buckets.storyboardModel = buckets.imageModel;
+    // 3) userDefaults + missingPieces
+    const missingPieces = [];
+    const userDefaults = {
+        imageModel: typeof defaultModels.imageModel === 'string' ? defaultModels.imageModel : null,
+        videoModel: typeof defaultModels.videoModel === 'string' ? defaultModels.videoModel : null,
+        audioModel: typeof defaultModels.audioModel === 'string' ? defaultModels.audioModel : null,
+        analysisModel: typeof defaultModels.analysisModel === 'string' ? defaultModels.analysisModel : null,
+        characterModel: typeof defaultModels.characterModel === 'string' ? defaultModels.characterModel : null,
+        locationModel: typeof defaultModels.locationModel === 'string' ? defaultModels.locationModel : null,
+        storyboardModel: typeof defaultModels.storyboardModel === 'string' ? defaultModels.storyboardModel : null,
+    };
+    for (const field of ['analysisModel', 'characterModel', 'locationModel', 'storyboardModel', 'videoModel']) {
+        const key = userDefaults[field];
+        if (!key) {
+            missingPieces.push({ capability: field, reason: `defaultModels.${field} 未配置`, fixHint: `运行 vvicat config set 设置 defaultModels.${field}` });
+            continue;
+        }
+        const providerKey = key.split('::')[0];
+        if (providerKey && !providerIds.has(providerKey)) {
+            missingPieces.push({
+                capability: field,
+                modelKey: key,
+                reason: `defaultModels.${field}=${key} 引用了未注册的 provider '${providerKey}'`,
+                fixHint: `运行 vvicat config ai-provider list 查看可用 provider，或 vvicat config ai-provider set ${providerKey} ...`,
+            });
+        }
+    }
+    // 检查每个 defaultModelKey 在 catalog 中是否 enabled
+    for (const [capability, modelKey] of Object.entries(userDefaults)) {
+        if (!modelKey)
+            continue;
+        const catalogEntry = catalogModels.find((m) => m.modelKey === modelKey);
+        if (catalogEntry && catalogEntry.enabled === false) {
+            missingPieces.push({
+                capability,
+                modelKey,
+                reason: `catalog 中 ${modelKey} 已禁用`,
+                fixHint: '在服务端启用该模型或换一个 defaultModel',
+            });
+        }
+    }
+    // capabilityDefaults 关键字段检查：videoModel 缺 duration 时给 agent 提示
+    for (const [capability, modelKey] of Object.entries(userDefaults)) {
+        if (!modelKey)
+            continue;
+        const catalogEntry = catalogModels.find((m) => m.modelKey === modelKey);
+        if (!catalogEntry)
+            continue;
+        if (catalogEntry.type !== 'video')
+            continue;
+        const defaults = capabilityDefaults[modelKey];
+        if (!defaults || !('duration' in defaults)) {
+            missingPieces.push({
+                capability,
+                modelKey,
+                reason: `capabilityDefaults.${modelKey} 缺 duration 字段`,
+                fixHint: `运行 vvicat config set 设置 capabilityDefaults.${modelKey}.duration（如 10）`,
+            });
+        }
+    }
+    const enabledProviders = providers.filter((p) => p.enabled).length;
+    const reachableProviders = providers.filter((p) => p.reachability === 'ok').length;
+    const capabilityCount = Object.values({
+        imageModel: buckets.imageModel,
+        videoModel: buckets.videoModel,
+        audioModel: buckets.audioModel,
+        analysisModel: buckets.analysisModel,
+    }).filter((bucket) => bucket.length > 0).length;
+    return {
+        generatedAt: new Date().toISOString(),
+        baseUrl: input.baseUrl,
+        summary: {
+            totalProviders: providers.length,
+            enabledProviders,
+            reachableProviders,
+            catalogModelCount: catalogModels.length,
+            capabilityCount,
+        },
+        providers,
+        capabilities: buckets,
+        userDefaults,
+        reachability: input.reachability,
+        missingPieces,
+    };
+}
+function extractCapabilityOptions(caps, type) {
+    if (!isPlainObject(caps))
+        return {};
+    const namespace = isPlainObject(caps[type]) ? caps[type] : {};
+    const out = {};
+    for (const [key, value] of Object.entries(namespace)) {
+        out[key] = value;
+    }
+    return out;
+}

package/dist/domain/ai-provider-command-helpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * vvicat config ai-provider ... 命令的纯逻辑 helper。
+ *
+ * 单测入口在这里（_ 开头让 oclif 不把它当作命令加载）。
+ * 真实命令文件 import 这里的 helper 即可。
+ */
+export interface SetFlags {
+    'base-url'?: string;
+    'api-key'?: string;
+    'api-mode'?: string;
+    name?: string;
+    protocol?: string;
+    enabled?: boolean;
+    'sort-order'?: number;
+}
+export declare function composeBodyFromFlags(providerId: string, flags: SetFlags): Record<string, unknown>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export interface CatalogModelRow {
+    modelKey: string;
+    provider: string;
+    type: 'image' | 'video' | 'audio' | 'llm' | 'tts';
+    enabled?: boolean;
+    capabilities?: Record<string, Record<string, unknown>>;
+}
+export declare function extractCatalogModels(config: unknown): CatalogModelRow[];
+export declare function extractDefaultModels(config: unknown): Record<string, string>;
+export declare function extractCapabilityDefaults(config: unknown): Record<string, Record<string, unknown>>;

package/dist/domain/ai-provider-command-helpers.js

@@ -0,0 +1,55 @@
+/**
+ * vvicat config ai-provider ... 命令的纯逻辑 helper。
+ *
+ * 单测入口在这里（_ 开头让 oclif 不把它当作命令加载）。
+ * 真实命令文件 import 这里的 helper 即可。
+ */
+export function composeBodyFromFlags(providerId, flags) {
+    const body = {
+        type: providerId,
+        name: flags.name?.trim() || providerId,
+        enabled: flags.enabled === true,
+    };
+    if (typeof flags['base-url'] === 'string' && flags['base-url'].trim())
+        body.baseUrl = flags['base-url'].trim();
+    if (typeof flags['api-key'] === 'string' && flags['api-key'])
+        body.apiKey = flags['api-key'];
+    if (typeof flags['api-mode'] === 'string' && flags['api-mode'])
+        body.apiMode = flags['api-mode'];
+    if (typeof flags.protocol === 'string' && flags.protocol)
+        body.protocolMode = flags.protocol;
+    if (typeof flags['sort-order'] === 'number')
+        body.sortOrder = flags['sort-order'];
+    return body;
+}
+export function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+export function extractCatalogModels(config) {
+    if (!isRecord(config))
+        return [];
+    const models = config.models;
+    if (!Array.isArray(models))
+        return [];
+    return models.filter((m) => isRecord(m) && typeof m.modelKey === 'string' && typeof m.provider === 'string' && typeof m.type === 'string');
+}
+export function extractDefaultModels(config) {
+    if (!isRecord(config))
+        return {};
+    const value = isRecord(config.defaultModels) ? config.defaultModels : {};
+    const out = {};
+    for (const [k, v] of Object.entries(value))
+        if (typeof v === 'string')
+            out[k] = v;
+    return out;
+}
+export function extractCapabilityDefaults(config) {
+    if (!isRecord(config))
+        return {};
+    const value = isRecord(config.capabilityDefaults) ? config.capabilityDefaults : {};
+    const out = {};
+    for (const [k, v] of Object.entries(value))
+        if (isRecord(v))
+            out[k] = v;
+    return out;
+}