vps-work 2.4.1 → 2.5.1

package/dist/packages/vps-work/src/commands/cli-install.js

@@ -0,0 +1,70 @@
+import { spawnSync } from 'node:child_process';
+import { Command } from 'commander';
+import { CLI_BIN, CLI_PACKAGE } from '../core/cli-bin.js';
+import { VertuError } from '../core/errors.js';
+import { copySkillTo, detectInstalledAgents, loadPublicSkills, resolveDestinations, } from '../core/skill-catalog.js';
+function assertNodeEngine() {
+    const major = Number.parseInt(process.versions.node.split('.')[0] ?? '0', 10);
+    if (major < 20) {
+        throw new VertuError(`Node.js 20+ is required (current: ${process.versions.node}). Upgrade Node, then re-run \`${CLI_BIN} install\`.`, { exitCode: 1 });
+    }
+}
+function runNpmInstallGlobal(spec) {
+    const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const result = spawnSync(npmCmd, ['install', '-g', spec], {
+        stdio: 'inherit',
+        env: process.env,
+    });
+    if (result.error) {
+        throw new VertuError(`Failed to run npm: ${result.error.message}`, { exitCode: 1 });
+    }
+    if (result.status !== 0) {
+        process.exit(result.status ?? 1);
+    }
+}
+/**
+ * 把随包分发的公开 skill 自动铺到本机已检测到的 Agent 目录（lark-cli 式开箱即用）。
+ * 无需登录、无远端依赖；未检测到任何 Agent 时静默跳过。
+ */
+async function autoInstallPublicSkills() {
+    const detected = await detectInstalledAgents();
+    if (detected.length === 0) {
+        process.stdout.write(`\n未检测到 Agent 目录（~/.cursor 等）。可稍后运行 \`${CLI_BIN} skill install --agent <id>\` 安装公开 skill。\n`);
+        return;
+    }
+    const skills = await loadPublicSkills();
+    const dests = resolveDestinations(detected, []);
+    for (const dest of dests) {
+        for (const s of skills) {
+            await copySkillTo(s, dest.skillsRoot);
+        }
+        process.stdout.write(`  ${dest.label} → ${dest.skillsRoot} (${skills.length} skills)\n`);
+    }
+    process.stdout.write(`公开 skill 已铺到 ${dests.length} 个 Agent 目录。\n`);
+}
+/**
+ * 全局安装 CLI（`npx vps-work@latest install` 的入口）。
+ */
+export function buildCliInstallCommand() {
+    return new Command('install')
+        .description(`Install ${CLI_PACKAGE} globally via npm (e.g. npx ${CLI_PACKAGE}@latest install)`)
+        .option('--tag <dist-tag>', 'npm dist-tag for the package', 'latest')
+        .option('--no-skills', '安装后不自动铺设公开 skill')
+        .action(async (opts) => {
+        assertNodeEngine();
+        const tag = opts.tag?.trim() || 'latest';
+        const spec = `${CLI_PACKAGE}@${tag}`;
+        process.stdout.write(`Installing ${spec} globally…\n`);
+        runNpmInstallGlobal(spec);
+        if (opts.skills !== false) {
+            process.stdout.write('\n铺设公开 skill…\n');
+            try {
+                await autoInstallPublicSkills();
+            }
+            catch (err) {
+                process.stdout.write(`公开 skill 铺设跳过：${err.message}\n`);
+            }
+        }
+        process.stdout.write(`\nDone. Next:\n  ${CLI_BIN} auth status\n\nHuman interactive login only: ${CLI_BIN} auth login\nAgent/Bot/Hermes must use host-injected app_key credentials.\n`);
+    });
+}

package/dist/packages/vps-work/src/commands/collab-invoke.js

@@ -0,0 +1,19 @@
+import { executeOdooAiTool } from './odoo-invoke.js';
+export function resolveInvokeOpts(opts, cmd, defaultEndpoint) {
+    const merged = cmd.optsWithGlobals();
+    const endpoint = opts.endpoint ?? merged.endpoint ?? defaultEndpoint;
+    // 域快捷命令上的 `--base-url` 留给 vps-service；Odoo 走 login 登记的 defaultBaseUrl。
+    return { endpoint };
+}
+export async function callOdooLeaf(leaf, args, opts, cmd) {
+    const invokeOpts = resolveInvokeOpts(opts, cmd, leaf.defaultEndpoint);
+    return executeOdooAiTool(leaf.invokeKey, leaf.argv, args, invokeOpts);
+}
+export function printShortcutJson(opts, out) {
+    if (opts.json !== false) {
+        console.log(JSON.stringify(out, null, 2));
+    }
+    else {
+        console.log(typeof out === 'string' ? out : JSON.stringify(out));
+    }
+}

package/dist/packages/vps-work/src/commands/corporate/index.js

@@ -0,0 +1,204 @@
+import { Command } from 'commander';
+import { downloadCorporateAttachment, runCorporateQuery } from '../../core/corporate-client.js';
+import { VertuError } from '../../core/errors.js';
+import { attachSharedShortcutOptions, parseOptionalInt, resolveShortcutVpsServiceUrl, } from '../shortcut-common.js';
+const SEAL_KINDS = {
+    contract: 'seal-contract',
+    creator: 'seal-creator',
+    procurement: 'seal-procurement',
+    'non-contract': 'seal-non-contract',
+    'certificate-loan': 'seal-certificate-loan',
+    hr: 'seal-hr',
+};
+const BUSINESS_KINDS = {
+    'mall-activity': 'business-mall-activity',
+    'mall-entry': 'business-mall-entry',
+    'agent-contract': 'business-agent-contract',
+    'online-store': 'business-online-store',
+    'subject-change': 'business-subject-change',
+    'air-transport': 'business-air-transport',
+    'business-policy': 'business-policy',
+};
+function print(opts, value) {
+    console.log(opts.json === false && typeof value === 'string' ? value : JSON.stringify(value, null, 2));
+}
+function positiveId(raw, flag) {
+    const value = parseOptionalInt(raw, flag);
+    if (!value || value <= 0)
+        throw new VertuError(`${flag} must be a positive integer.`);
+    return value;
+}
+function kind(map, raw, flag) {
+    const value = raw?.trim();
+    if (!value || !map[value]) {
+        throw new VertuError(`${flag} must be one of: ${Object.keys(map).join(', ')}`);
+    }
+    return map[value];
+}
+async function query(cmd, opts, payload) {
+    const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+    if (opts.validateOnly === true || opts.dryRun === true) {
+        print(opts, { validateOnly: true, endpoint: `${baseUrl}/v1/corporate/query`, payload });
+        return;
+    }
+    print(opts, await runCorporateQuery(baseUrl, payload));
+}
+function recordRows(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return [];
+    const result = value.result;
+    if (!result || typeof result !== 'object' || Array.isArray(result))
+        return [];
+    const rows = result.rows;
+    return Array.isArray(rows)
+        ? rows.filter((row) => Boolean(row && typeof row === 'object' && !Array.isArray(row)))
+        : [];
+}
+function appliedFilter(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    const result = value.result;
+    if (!result || typeof result !== 'object' || Array.isArray(result))
+        return {};
+    const filter = result.filter;
+    return filter && typeof filter === 'object' && !Array.isArray(filter)
+        ? filter : {};
+}
+function assertDateFilterApplied(value, payload) {
+    const filter = appliedFilter(value);
+    for (const key of ['end_date_from', 'end_date_to']) {
+        if (payload[key] !== undefined && filter[key] !== payload[key]) {
+            throw new VertuError('当前 vps-service 尚未确认应用合同结束日期筛选，已拒绝返回可能未过滤的结果；请先部署新版 vps-service。');
+        }
+    }
+}
+async function queryContractList(cmd, opts, payload) {
+    const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+    if (opts.validateOnly === true || opts.dryRun === true) {
+        print(opts, { validateOnly: true, endpoint: `${baseUrl}/v1/corporate/query`, payload, all: opts.all === true });
+        return;
+    }
+    const requestedLimit = Number(payload.limit) || 50;
+    const pageSize = opts.all ? 200 : requestedLimit;
+    let offset = Number(payload.offset) || 0;
+    const rows = [];
+    let first;
+    do {
+        const response = await runCorporateQuery(baseUrl, { ...payload, limit: pageSize, offset });
+        assertDateFilterApplied(response, payload);
+        first ??= response;
+        const pageRows = recordRows(response);
+        rows.push(...pageRows);
+        if (!opts.all || pageRows.length < pageSize)
+            break;
+        offset += pageSize;
+    } while (true);
+    if (!opts.all) {
+        print(opts, first);
+        return;
+    }
+    print(opts, {
+        ok: true,
+        result: { rows, limit: pageSize, offset: Number(payload.offset) || 0, all: true, filter: appliedFilter(first) },
+    });
+}
+function listPayload(recordType, opts) {
+    return {
+        operation: 'list', record_type: recordType,
+        ...(opts.search?.trim() ? { search: opts.search.trim() } : {}),
+        ...(opts.status?.trim() ? { status: opts.status.trim() } : {}),
+        ...(opts.endDateFrom?.trim() ? { end_date_from: opts.endDateFrom.trim() } : {}),
+        ...(opts.endDateTo?.trim() ? { end_date_to: opts.endDateTo.trim() } : {}),
+        ...(parseOptionalInt(opts.limit, '--limit') ? { limit: parseOptionalInt(opts.limit, '--limit') } : {}),
+        ...(parseOptionalInt(opts.offset, '--offset') !== undefined ? { offset: parseOptionalInt(opts.offset, '--offset') } : {}),
+    };
+}
+function attachListOptions(command, withKind = false) {
+    if (withKind)
+        command.option('--kind <kind>', '业务子类型');
+    return attachSharedShortcutOptions(command
+        .option('--search <text>', '按名称模糊查询')
+        .option('--status <status>', '按状态筛选')
+        .option('--limit <n>', '返回条数，最大 200', '50')
+        .option('--offset <n>', '分页偏移', '0'));
+}
+function attachDetailOptions(command, withKind = false) {
+    if (withKind)
+        command.option('--kind <kind>', '业务子类型');
+    return attachSharedShortcutOptions(command.option('--id <id>', '记录 ID'));
+}
+/** 企业综合管理 — 合作企业档案、用印、业务管理和规章制度。 */
+export function buildCorporateCommand() {
+    const corporate = new Command('corporate').description('企业综合管理只读查询：合作企业档案、文件用印、业务管理、规章制度及授权附件。');
+    attachListOptions(corporate.command('+partner-list').description('查询合作企业档案')).action(async (opts, cmd) => query(cmd, opts, listPayload('partner', opts)));
+    attachDetailOptions(corporate.command('+partner-detail').description('查看合作企业档案详情')).action(async (opts, cmd) => query(cmd, opts, {
+        operation: 'detail', record_type: 'partner', record_id: positiveId(opts.id, '--id'),
+    }));
+    attachListOptions(corporate.command('+seal-list').description('查询文件用印及印章记录'), true)
+        .option('--end-date-from <date>', '合同结束日期起始，YYYY-MM-DD；仅合同类 kind')
+        .option('--end-date-to <date>', '合同结束日期截止，YYYY-MM-DD；仅合同类 kind')
+        .option('--all', '自动翻页返回全部匹配记录', false)
+        .action(async (opts, cmd) => {
+        const recordType = kind(SEAL_KINDS, opts.kind, '--kind');
+        if ((opts.endDateFrom || opts.endDateTo) && !['seal-contract', 'seal-creator', 'seal-procurement'].includes(recordType)) {
+            throw new VertuError('--end-date-from/--end-date-to 仅适用于 contract、creator、procurement。');
+        }
+        const payload = listPayload(recordType, opts);
+        if (opts.endDateFrom || opts.endDateTo || opts.all) {
+            await queryContractList(cmd, opts, payload);
+            return;
+        }
+        await query(cmd, opts, payload);
+    });
+    attachDetailOptions(corporate.command('+seal-detail').description('查看文件用印及印章详情'), true).action(async (opts, cmd) => query(cmd, opts, {
+        operation: 'detail', record_type: kind(SEAL_KINDS, opts.kind, '--kind'), record_id: positiveId(opts.id, '--id'),
+    }));
+    attachListOptions(corporate.command('+business-list').description('查询业务管理审批'), true).action(async (opts, cmd) => query(cmd, opts, listPayload(kind(BUSINESS_KINDS, opts.kind, '--kind'), opts)));
+    attachDetailOptions(corporate.command('+business-detail').description('查看业务管理审批详情'), true).action(async (opts, cmd) => query(cmd, opts, {
+        operation: 'detail', record_type: kind(BUSINESS_KINDS, opts.kind, '--kind'), record_id: positiveId(opts.id, '--id'),
+    }));
+    attachListOptions(corporate.command('+regulation-list').description('查询适用的规章制度')).action(async (opts, cmd) => query(cmd, opts, listPayload('regulation', opts)));
+    attachDetailOptions(corporate.command('+regulation-detail').description('查看规章制度详情')).action(async (opts, cmd) => query(cmd, opts, {
+        operation: 'detail', record_type: 'regulation', record_id: positiveId(opts.id, '--id'),
+    }));
+    attachSharedShortcutOptions(corporate.command('+attachments')
+        .description('列出已授权记录的附件元数据和下载选择器')
+        .requiredOption('--record-type <type>', '服务返回的 record_type')
+        .requiredOption('--record-id <id>', '记录 ID'))
+        .action(async (opts, cmd) => query(cmd, opts, {
+        operation: 'attachments', record_type: opts.recordType,
+        record_id: positiveId(opts.recordId, '--record-id'),
+    }));
+    attachSharedShortcutOptions(corporate.command('+attachment-download')
+        .description('下载已授权的企业综合管理附件，不覆盖已有文件')
+        .requiredOption('--record-type <type>', '附件列表返回的 record_type')
+        .requiredOption('--record-id <id>', '记录 ID')
+        .requiredOption('--field <field>', '附件列表返回的 field')
+        .requiredOption('--index <index>', '附件列表返回的 index')
+        .requiredOption('--output <path>', '本地输出文件'))
+        .action(async (opts, cmd) => {
+        const selector = {
+            record_type: opts.recordType,
+            record_id: positiveId(opts.recordId, '--record-id'),
+            field: opts.field,
+            index: parseOptionalInt(opts.index, '--index'),
+        };
+        const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            print(opts, { validateOnly: true, endpoint: `${baseUrl}/v1/corporate/attachment`, selector, output: opts.output });
+            return;
+        }
+        if (selector.index === undefined || selector.index < 0)
+            throw new VertuError('--index must be zero or greater.');
+        if (!opts.output?.trim())
+            throw new VertuError('--output is required.');
+        print(opts, await downloadCorporateAttachment(baseUrl, selector, opts.output));
+    });
+    corporate.addHelpText('after', [
+        '',
+        `Seal kinds: ${Object.keys(SEAL_KINDS).join(', ')}`,
+        `Business kinds: ${Object.keys(BUSINESS_KINDS).join(', ')}`,
+        '附件下载前先运行 +attachments，严格使用返回的 record_type / field / index。',
+    ].join('\n'));
+    return corporate;
+}

package/dist/packages/vps-work/src/commands/creative/index.js

@@ -0,0 +1,369 @@
+import { Command } from 'commander';
+import { VertuError } from '../../core/errors.js';
+import { vpsServiceGet, vpsServicePost } from '../../core/sales-query-client.js';
+import { creativeDownloadPath, downloadCreativeAttachment } from '../../core/creative-attachment-download.js';
+import { attachSharedShortcutOptions, parseOptionalFloat, parseOptionalInt, resolveShortcutVpsServiceUrl, } from '../shortcut-common.js';
+/** Features · 内容创作 — `vps-work creative +…`（AI 生图 / 生视频 / 生音频）。 */
+export function buildCreativeCommand() {
+    const creative = new Command('creative')
+        .description('内容创作：AI 生图、生视频、生音频（TTS/音乐）与模型列表，返回可下载附件链接。');
+    attachCreativeShortcuts(creative);
+    return creative;
+}
+function printResult(opts, result) {
+    if (opts.json !== false) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(typeof result === 'string' ? result : JSON.stringify(result));
+}
+/** 从站内受控 OSS 路径提取 key（`/api/oss/object?key=...`）。 */
+function ossKeyFromUrl(url) {
+    try {
+        return new URL(url, 'http://creative-studio.invalid').searchParams.get('key');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 把创意工坊返回的站内受控附件路径 `/api/oss/object?key=...` 重写为
+ * vps-service 的可下载地址 `/v1/creative/oss?key=...`（复用 CLI 会话鉴权）。
+ * 递归处理对象/数组，覆盖 image_url / url / video_url / original_video_url 等字段。
+ */
+function rewriteOssUrls(value, baseUrl) {
+    if (typeof value === 'string' && value.startsWith('/api/oss/object')) {
+        const key = ossKeyFromUrl(value);
+        return key ? `${baseUrl}/v1/creative/oss?key=${encodeURIComponent(key)}` : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => rewriteOssUrls(item, baseUrl));
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = rewriteOssUrls(v, baseUrl);
+        }
+        return out;
+    }
+    return value;
+}
+async function printCreativeResult(opts, result, baseUrl) {
+    const publicBaseUrl = new URL(baseUrl).hostname === 'tenant-api' ? 'https://vps-service.vertu.cn' : baseUrl;
+    const rewritten = rewriteOssUrls(result, publicBaseUrl);
+    const keys = new Set();
+    const collect = (value) => {
+        if (typeof value === 'string' && value.startsWith(`${publicBaseUrl}/v1/creative/oss?`)) {
+            const key = ossKeyFromUrl(value);
+            if (key)
+                keys.add(key);
+        }
+        else if (Array.isArray(value))
+            value.forEach(collect);
+        else if (value && typeof value === 'object')
+            Object.values(value).forEach(collect);
+    };
+    collect(rewritten);
+    const attachments = [];
+    for (const key of keys) {
+        try {
+            const file = await vpsServiceGet('/v1/creative/oss', { key, mode: 'sign' }, baseUrl, '获取素材临时下载链接');
+            const name = key.split('/').pop() || 'attachment';
+            const ext = name.split('.').pop()?.toLowerCase() || '';
+            const mime = { png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif', mp4: 'video/mp4', mp3: 'audio/mpeg' }[ext];
+            attachments.push({ ...file, name, mime_type: mime, attachment_type: mime?.split('/')[0] || 'file', url: `${publicBaseUrl}/v1/creative/oss?key=${encodeURIComponent(key)}`, download_command: ['vps-work', 'creative', '+download', '--storage-key', key, '--output', name] });
+        }
+        catch {
+            // Preserve successful generation even if the signing service is unavailable.
+            attachments.push({ storage_key: key, url: `${publicBaseUrl}/v1/creative/oss?key=${encodeURIComponent(key)}`, download_command: ['vps-work', 'creative', '+download', '--storage-key', key, '--output', key.split('/').pop() || 'attachment'], error: '临时链接获取失败，可通过 download_command 使用当前登录身份下载' });
+        }
+    }
+    printResult(opts, attachments.length ? { ...(rewritten && typeof rewritten === 'object' && !Array.isArray(rewritten) ? rewritten : { result: rewritten }), attachments } : rewritten);
+}
+function splitCsv(raw) {
+    if (raw === undefined || raw.trim() === '') {
+        return undefined;
+    }
+    const parts = raw.split(',').map((s) => s.trim()).filter(Boolean);
+    return parts.length ? parts : undefined;
+}
+function splitCsvNumbers(raw) {
+    const parts = splitCsv(raw);
+    if (!parts) {
+        return undefined;
+    }
+    return parts.map((p, i) => {
+        const n = Number(p);
+        if (!Number.isFinite(n)) {
+            throw new VertuError(`Invalid numeric list at index ${i}: "${p}"`);
+        }
+        return n;
+    });
+}
+function num(raw, flag) {
+    return parseOptionalFloat(raw, flag);
+}
+function int(raw, flag) {
+    return parseOptionalInt(raw, flag);
+}
+async function postCreative(opts, cmd, path, body, label) {
+    const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+    if (opts.validateOnly === true || opts.dryRun === true) {
+        printResult(opts, {
+            validateOnly: true,
+            endpoint: `${baseUrl}${path}`,
+            payload: body,
+        });
+        return;
+    }
+    await printCreativeResult(opts, await vpsServicePost(path, body, baseUrl, label), baseUrl);
+}
+async function pollVideoTask(opts, baseUrl, model, taskId) {
+    const timeoutSec = parseOptionalInt(opts.waitTimeout, '--wait-timeout') ?? 600;
+    const intervalSec = parseOptionalInt(opts.pollInterval, '--poll-interval') ?? 5;
+    const deadline = Date.now() + timeoutSec * 1000;
+    let last = '';
+    for (;;) {
+        const status = await vpsServiceGet('/v1/creative/video', { model, task_id: taskId }, baseUrl, '创意工坊生视频状态');
+        const s = String(status.status ?? 'pending');
+        if (s !== last) {
+            process.stderr.write(`[creative] video ${taskId}: ${s}\n`);
+            last = s;
+        }
+        if (s === 'succeeded' || s === 'failed' || s === 'error') {
+            return status;
+        }
+        if (Date.now() >= deadline) {
+            throw new VertuError(`生视频任务 ${taskId} 在 ${timeoutSec}s 内未完成，可用 creative +video-status --model ${model} --task-id ${taskId} 继续查询`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalSec * 1000));
+    }
+}
+function attachCreativeShortcuts(parent) {
+    attachSharedShortcutOptions(parent.command('+download')
+        .description('通过当前账号下载创意素材到工作区，云电脑无需公网 DNS')
+        .option('--url <url>', 'VPS 创意素材地址')
+        .option('--storage-key <key>', '生成结果中的 storage_key')
+        .requiredOption('--output <path>', '保存路径，不覆盖已有文件'))
+        .action(async (opts, cmd) => {
+        const base = resolveShortcutVpsServiceUrl(opts, cmd);
+        const path = creativeDownloadPath(base, opts);
+        if (opts.validateOnly || opts.dryRun) {
+            printResult(opts, { validateOnly: true, endpoint: new URL(path, base).href, output: opts.output });
+            return;
+        }
+        printResult(opts, await downloadCreativeAttachment(base, opts));
+    });
+    attachSharedShortcutOptions(parent
+        .command('+models')
+        .description('模型列表：按能力类型筛选（image / video / audio / tts）')
+        .option('--type <type>', '能力类型：image|video|audio|tts|text')).action(async (opts, cmd) => {
+        const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+        const query = opts.type ? { type: opts.type } : {};
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            printResult(opts, { validateOnly: true, endpoint: `${baseUrl}/v1/creative/models`, query });
+            return;
+        }
+        printResult(opts, await vpsServiceGet('/v1/creative/models', query, baseUrl, '创意工坊模型'));
+    });
+    attachSharedShortcutOptions(parent
+        .command('+image')
+        .description('AI 生图 / 改图，返回 image_url 与计费（POST /api/aigc/image-edit）')
+        .option('--model <id>', '模型 id 或 model_id（必填）')
+        .option('--prompt <text>', '画面提示词（必填）')
+        .option('--source-image-url <url>', '参考/底图 URL')
+        .option('--reference-images <urls>', '参考图 URL 列表（逗号分隔）')
+        .option('--size <size>', '输出尺寸，如 1024x1024 / auto')
+        .option('--quality <q>', '质量：auto|low|medium|high|xhigh|max（后两档仅 gpt-image-2.5-sunburst）')
+        .option('--resolution <r>', '分辨率档：512|1K|2K|4K')
+        .option('--aspect-ratio <ratio>', '宽高比，如 1:1 / 16:9')
+        .option('--background <text>', '背景：auto|opaque|transparent（transparent 仅 gpt-image-2.5-sunburst）')
+        .option('--output-compression <n>', '输出压缩级别（整数）')
+        .option('--n <n>', '生成张数（当前接口固定单图）')).action(async (opts, cmd) => {
+        if (!opts.model || !opts.prompt) {
+            throw new VertuError('生图需要 --model 与 --prompt');
+        }
+        const body = { model: opts.model, prompt: opts.prompt };
+        if (opts.sourceImageUrl)
+            body.source_image_url = opts.sourceImageUrl;
+        const refs = splitCsv(opts.referenceImages);
+        if (refs)
+            body.reference_images = refs;
+        if (opts.size)
+            body.size = opts.size;
+        if (opts.quality)
+            body.quality = opts.quality;
+        if (opts.resolution)
+            body.resolution = opts.resolution;
+        if (opts.aspectRatio)
+            body.aspect_ratio = opts.aspectRatio;
+        if (opts.background)
+            body.background = opts.background;
+        const compression = int(opts.outputCompression, '--output-compression');
+        if (compression !== undefined)
+            body.output_compression = compression;
+        const count = int(opts.n, '--n');
+        if (count !== undefined)
+            body.n = count;
+        await postCreative(opts, cmd, '/v1/creative/image', body, '创意工坊生图');
+    });
+    attachSharedShortcutOptions(parent
+        .command('+video')
+        .description('AI 生视频（异步）：提交后返回 task_id；加 --wait 轮询到完成')
+        .option('--model <id>', '模型 id 或 model_id（必填）')
+        .option('--prompt <text>', '文本描述')
+        .option('--reference-images <urls>', '参考图 URL 列表（逗号分隔）')
+        .option('--reference-videos <urls>', '参考视频 URL 列表（逗号分隔）')
+        .option('--reference-audios <urls>', '参考音频 URL 列表（逗号分隔）')
+        .option('--reference-audio-durations-sec <secs>', '各参考音频时长秒数（逗号分隔）')
+        .option('--first-frame-image <url>', '首帧图片 URL（Seedance 首尾帧）')
+        .option('--last-frame-image <url>', '尾帧图片 URL（Seedance 首尾帧）')
+        .option('--ratio <ratio>', '画幅比：16:9 / 9:16 / 1:1 等')
+        .option('--resolution <r>', '分辨率档')
+        .option('--duration <sec>', '视频时长（秒）')
+        .option('--generate-audio', '是否同时生成音频', false)
+        .option('--watermark', '是否加水印', false)
+        .option('--wait', '轮询到任务成功/失败后返回', false)
+        .option('--wait-timeout <sec>', '--wait 最长等待秒数，默认 600')
+        .option('--poll-interval <sec>', '--wait 轮询间隔秒数，默认 5')).action(async (opts, cmd) => {
+        if (!opts.model) {
+            throw new VertuError('生视频需要 --model');
+        }
+        const body = { model: opts.model };
+        if (opts.prompt)
+            body.prompt = opts.prompt;
+        const imgs = splitCsv(opts.referenceImages);
+        if (imgs)
+            body.reference_images = imgs;
+        const vids = splitCsv(opts.referenceVideos);
+        if (vids)
+            body.reference_videos = vids;
+        const auds = splitCsv(opts.referenceAudios);
+        if (auds)
+            body.reference_audios = auds;
+        const durs = splitCsvNumbers(opts.referenceAudioDurationsSec);
+        if (durs)
+            body.reference_audio_durations_sec = durs;
+        if (opts.firstFrameImage)
+            body.first_frame_image = opts.firstFrameImage;
+        if (opts.lastFrameImage)
+            body.last_frame_image = opts.lastFrameImage;
+        if (opts.ratio)
+            body.ratio = opts.ratio;
+        if (opts.resolution)
+            body.resolution = opts.resolution;
+        const duration = num(opts.duration, '--duration');
+        if (duration !== undefined)
+            body.duration = duration;
+        if (opts.generateAudio === true)
+            body.generate_audio = true;
+        if (opts.watermark === true)
+            body.watermark = true;
+        const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            printResult(opts, { validateOnly: true, endpoint: `${baseUrl}/v1/creative/video`, payload: body });
+            return;
+        }
+        const result = await vpsServicePost('/v1/creative/video', body, baseUrl, '创意工坊生视频');
+        const taskId = typeof result.task_id === 'string'
+            ? result.task_id
+            : '';
+        if (!taskId) {
+            await printCreativeResult(opts, result, baseUrl);
+            return;
+        }
+        if (opts.wait === true) {
+            await printCreativeResult(opts, await pollVideoTask(opts, baseUrl, opts.model, taskId), baseUrl);
+        }
+        else {
+            await printCreativeResult(opts, result, baseUrl);
+        }
+    });
+    attachSharedShortcutOptions(parent
+        .command('+video-status')
+        .description('查询视频生成任务状态，返回 status 与 video_url')
+        .option('--model <id>', '模型 id（必填）')
+        .option('--task-id <id>', '任务 id（必填）')).action(async (opts, cmd) => {
+        if (!opts.model || !opts.taskId) {
+            throw new VertuError('需要 --model 与 --task-id');
+        }
+        const baseUrl = resolveShortcutVpsServiceUrl(opts, cmd);
+        const query = { model: opts.model, task_id: opts.taskId };
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            printResult(opts, { validateOnly: true, endpoint: `${baseUrl}/v1/creative/video`, query });
+            return;
+        }
+        await printCreativeResult(opts, await vpsServiceGet('/v1/creative/video', query, baseUrl, '创意工坊生视频状态'), baseUrl);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tts')
+        .description('文字转语音，返回音频 url（POST /api/aigc/audio-tts）')
+        .option('--model <id>', '模型 id 或 model_id（必填）')
+        .option('--text <text>', '待合成文本（必填）')
+        .option('--voice-id <id>', '音色 id')
+        .option('--speed <n>', '语速')
+        .option('--vol <n>', '音量')
+        .option('--pitch <n>', '音调')
+        .option('--emotion <e>', '情感')
+        .option('--format <fmt>', 'mp3|wav|flac|pcm')
+        .option('--sample-rate <hz>', '采样率')
+        .option('--bitrate <kbps>', '码率')).action(async (opts, cmd) => {
+        if (!opts.model || !opts.text) {
+            throw new VertuError('语音合成需要 --model 与 --text');
+        }
+        const body = { model: opts.model, text: opts.text };
+        if (opts.voiceId)
+            body.voice_id = opts.voiceId;
+        const speed = num(opts.speed, '--speed');
+        if (speed !== undefined)
+            body.speed = speed;
+        const vol = num(opts.vol, '--vol');
+        if (vol !== undefined)
+            body.vol = vol;
+        const pitch = num(opts.pitch, '--pitch');
+        if (pitch !== undefined)
+            body.pitch = pitch;
+        if (opts.emotion)
+            body.emotion = opts.emotion;
+        if (opts.format)
+            body.format = opts.format;
+        const sampleRate = int(opts.sampleRate, '--sample-rate');
+        if (sampleRate !== undefined)
+            body.sample_rate = sampleRate;
+        const bitrate = int(opts.bitrate, '--bitrate');
+        if (bitrate !== undefined)
+            body.bitrate = bitrate;
+        await postCreative(opts, cmd, '/v1/creative/audio/tts', body, '创意工坊语音合成');
+    });
+    attachSharedShortcutOptions(parent
+        .command('+music')
+        .description('AI 音乐生成，返回音频 url（POST /api/aigc/audio-music）')
+        .option('--model <id>', '模型 id 或 model_id（必填）')
+        .option('--prompt <text>', '风格/情绪/场景描述（必填）')
+        .option('--lyrics <text>', '歌词；不传走纯音乐')
+        .option('--instrumental', '纯音乐（无歌词）', false)
+        .option('--lyrics-optimizer', '开启歌词优化', false)
+        .option('--format <fmt>', 'mp3|wav|pcm')
+        .option('--sample-rate <hz>', '采样率')
+        .option('--bitrate <kbps>', '码率')).action(async (opts, cmd) => {
+        if (!opts.model || !opts.prompt) {
+            throw new VertuError('音乐生成需要 --model 与 --prompt');
+        }
+        const body = { model: opts.model, prompt: opts.prompt };
+        if (opts.lyrics)
+            body.lyrics = opts.lyrics;
+        if (opts.instrumental === true)
+            body.is_instrumental = true;
+        if (opts.lyricsOptimizer === true)
+            body.lyrics_optimizer = true;
+        if (opts.format)
+            body.format = opts.format;
+        const sampleRate = int(opts.sampleRate, '--sample-rate');
+        if (sampleRate !== undefined)
+            body.sample_rate = sampleRate;
+        const bitrate = int(opts.bitrate, '--bitrate');
+        if (bitrate !== undefined)
+            body.bitrate = bitrate;
+        await postCreative(opts, cmd, '/v1/creative/audio/music', body, '创意工坊音乐生成');
+    });
+}