gaoding-cli 1.0.0-alpha.8 → 1.0.0-alpha.9

package/dist/src/program.js

@@ -1,4 +1,4 @@
-import { Command, Option } from "commander";
+import { Command, CommanderError } from "commander";
 import { CLI_VERSION } from "./utils/config.js";
 import { registerAuthCommand } from "./commands/auth.js";
 import { registerOrgCommand } from "./commands/org.js";
@@ -8,21 +8,16 @@ import { registerDamCommand } from "./commands/dam.js";
 import { registerUpdateCommand } from "./commands/update.js";
 import { registerSkillsCommand } from "./commands/skills.js";
 import { maybeNotifyUpdate } from "./update/notifier.js";
-import { setStaticHelp } from "./utils/static-help.js";
 import { installAuthPreflight } from "./middleware/auth.js";
+import { CliUsageError } from "./core/output/cli-error.js";
+import { emitJsonFailure } from "./middleware/error-handler.js";
 export async function createProgram() {
     const program = new Command();
     program
         .name("gd-cli")
         .usage("<command> [options]")
         .description("GD CLI — 让稿定成为 Agent 的创意生产引擎")
-        .version(CLI_VERSION)
-        .addOption(new Option("-f, --format <format>", "输出格式: human / table / json / text").choices(["json", "human", "table", "text"]))
-        .addOption(new Option("--json", "等同于 --format json，推荐 Agent 和脚本使用"))
-        .addOption(new Option("--no-input", "禁止交互，适合 CI / Agent"))
-        .addOption(new Option("--yes", "跳过确认"))
-        .addOption(new Option("--verbose", "输出详细日志").hideHelp().default(false));
-    setStaticHelp(program, TOP_LEVEL_HELP);
+        .version(CLI_VERSION);
     registerAuthCommand(program);
     registerOrgCommand(program);
     registerCreativeCommand(program);
@@ -36,35 +31,137 @@ export async function createProgram() {
     });
     return program;
 }
-const TOP_LEVEL_HELP = `
-Usage: gd-cli <command> [options]
-
-GD CLI — 让稿定成为 Agent 的创意生产引擎
-
-核心命令:
-  auth      登录、退出、查看登录状态
-  org       查看和切换当前组织
-  creative  通过统一创作入口生成图片、视频和文本
-  workflows 运行完整创意场景任务，例如商品上新、批量海报、内容矩阵
-  skills    安装和管理 gd-cli Agent Skill
-  dam       素材管理，上传、查询、删除素材
-  update    检查并升级 gd-cli
-
-常用流程:
-  gd-cli auth login                         登录稿定账号
-  gd-cli org list                           查看可用组织
-  gd-cli org switch                         切换当前组织
-  gd-cli creative schema --format json      查看 Creative 输入输出结构
-  gd-cli creative examples --format json    查看 Creative 调用示例
-  gd-cli workflows list                     查看完整创意场景
-  gd-cli dam upload ./image.png             上传素材到 DAM
-
-常用选项:
-  -V, --version          output the version number
-  -f, --format <format>  输出格式: human / table / json / text
-  --json                 等同于 --format json，推荐 Agent 和脚本使用
-  --no-input             禁止交互，适合 CI / Agent
-  --yes                  跳过确认
-  -h, --help             display help for command
-
-`;
+export async function parseProgram(program, argv = process.argv) {
+    const userArgs = argv.slice(2);
+    const jsonLeaf = resolveExplicitJsonLeaf(program, userArgs);
+    const capturedErrors = [];
+    const configuredCommands = allCommands(program).map((command) => {
+        const output = command.configureOutput();
+        const writeErr = output.writeErr ?? ((text) => process.stderr.write(text));
+        command.configureOutput({
+            writeErr: (text) => capturedErrors.push({ text, write: writeErr }),
+        });
+        command.exitOverride();
+        return { command, writeErr };
+    });
+    let actionStarted = false;
+    program.hook("preAction", () => {
+        actionStarted = true;
+    });
+    try {
+        await program.parseAsync([...argv]);
+    }
+    catch (error) {
+        if (error instanceof CommanderError && error.exitCode === 0)
+            return;
+        if (!actionStarted && jsonLeaf) {
+            emitJsonFailure(jsonLeaf, parseFailure(error, jsonLeaf));
+            process.exitCode = error instanceof CommanderError
+                ? Math.max(1, error.exitCode)
+                : 1;
+            return;
+        }
+        for (const captured of capturedErrors)
+            captured.write(captured.text);
+        if (error instanceof CommanderError) {
+            process.exitCode = error.exitCode;
+            return;
+        }
+        throw error;
+    }
+    finally {
+        for (const { command, writeErr } of configuredCommands) {
+            command.configureOutput({ writeErr });
+        }
+    }
+}
+function resolveExplicitJsonLeaf(program, args) {
+    let current = program;
+    let index = 0;
+    let commandIndex = -1;
+    while (current.commands.length > 0) {
+        let nextCommand;
+        while (index < args.length) {
+            const token = args[index];
+            if (token === "--")
+                return undefined;
+            if (token.startsWith("-")) {
+                index += optionWidth(current, args, index);
+                continue;
+            }
+            nextCommand = current.commands.find((candidate) => candidate.name() === token || candidate.aliases().includes(token));
+            if (!nextCommand)
+                return undefined;
+            commandIndex = index;
+            index += 1;
+            break;
+        }
+        if (!nextCommand)
+            return undefined;
+        current = nextCommand;
+    }
+    if (commandIndex < 0 ||
+        !current.options.some((option) => option.long === "--json")) {
+        return undefined;
+    }
+    return hasExplicitJsonOption(current, args.slice(commandIndex + 1))
+        ? current
+        : undefined;
+}
+function hasExplicitJsonOption(command, args) {
+    for (let index = 0; index < args.length;) {
+        const token = args[index];
+        if (token === "--")
+            return false;
+        if (token === "--json")
+            return true;
+        index += optionWidth(command, args, index);
+    }
+    return false;
+}
+function optionWidth(command, args, index) {
+    const token = args[index];
+    const flag = token.includes("=") ? token.slice(0, token.indexOf("=")) : token;
+    const option = command.options.find((candidate) => candidate.long === flag || candidate.short === flag);
+    if (!option || token.includes("="))
+        return 1;
+    if (option.required)
+        return index + 1 < args.length ? 2 : 1;
+    if (option.optional &&
+        index + 1 < args.length &&
+        !args[index + 1].startsWith("-")) {
+        return 2;
+    }
+    return 1;
+}
+function parseFailure(error, command) {
+    const missingCodes = new Set([
+        "commander.missingArgument",
+        "commander.optionMissingArgument",
+        "commander.missingMandatoryOptionValue",
+    ]);
+    const code = error instanceof CommanderError && missingCodes.has(error.code)
+        ? "PARAM_MISSING"
+        : "PARAM_INVALID";
+    const rawMessage = error instanceof Error ? error.message : String(error);
+    const message = rawMessage.replace(/^error:\s*/i, "").trim() || "参数不合法";
+    return new CliUsageError({
+        code,
+        type: "validation",
+        message,
+        hint: `运行 gd-cli ${publicCommandName(command)} --help 查看参数说明。`,
+        retryable: false,
+    });
+}
+function publicCommandName(command) {
+    const names = [];
+    let current = command;
+    while (current.parent) {
+        names.unshift(current.name());
+        current = current.parent;
+    }
+    return names.join(" ");
+}
+function allCommands(root) {
+    return [root, ...root.commands.flatMap(allCommands)];
+}

package/dist/src/registry/agent-contracts.d.ts

@@ -1,35 +1,23 @@
-import type { OutputSpec, ParamSpec } from "./types.js";
-import { type CapabilityPolicy, type CapabilitySource, type CapabilityStatus } from "../utils/capability-metadata.js";
+import type { ParamSpec } from "./types.js";
+export declare const PUBLIC_WORKFLOW_MEDIA_PATTERN = "^kv_\\d+_\\d+$";
+export interface PublicWorkflowOutputDefinition {
+    textFields: readonly string[];
+    mediaFields: readonly string[];
+    overlayFields: readonly string[];
+    ratioFields: readonly string[];
+    ratios: "record" | "array";
+    sellingPoints?: boolean;
+    mediaPattern?: string;
+}
 export interface JsonSchemaObject {
     type: "object";
     properties: Record<string, Record<string, unknown>>;
     required: string[];
     additionalProperties?: boolean;
-}
-export interface CapabilityManifestCommand {
-    id: string;
-    type: "workflow";
-    category: string;
-    title: string;
-    description: string;
-    canonical_command: string;
-    input_schema_command?: string;
-    examples_command?: string;
-    output: "json";
-    safe_for_agent: boolean;
-    source: CapabilitySource;
-    status: CapabilityStatus;
-    policy: CapabilityPolicy;
-}
-export interface CapabilityManifest {
-    name: "gd-cli";
-    version: string;
-    description: string;
-    commands: CapabilityManifestCommand[];
+    patternProperties?: Record<string, Record<string, unknown>>;
 }
 export declare function buildInputJsonSchema(params: ParamSpec[], extraProperties?: Record<string, Record<string, unknown>>): JsonSchemaObject;
-export declare function buildOutputJsonSchema(output: OutputSpec): JsonSchemaObject;
+export declare function resolvePublicWorkflowOutputDefinition(appId: string): PublicWorkflowOutputDefinition;
+export declare function buildOutputJsonSchema(appId: string): JsonSchemaObject;
 export declare function buildWorkflowSchema(appId: string): Record<string, unknown>;
 export declare function buildWorkflowExamples(appId: string): Record<string, unknown>;
-export declare function buildWorkflowManifest(): CapabilityManifest;
-export declare function rowsForWorkflowManifest(manifest: CapabilityManifest): Record<string, string>[];

package/dist/src/registry/agent-contracts.js

@@ -1,6 +1,75 @@
-import { CLI_VERSION } from "../utils/config.js";
-import { DIRECT_APPS, resolveAppSpec, } from "./direct-registry.js";
-import { capabilityMetadata, } from "../utils/capability-metadata.js";
+import { resolveAppSpec } from "./direct-registry.js";
+export const PUBLIC_WORKFLOW_MEDIA_PATTERN = "^kv_\\d+_\\d+$";
+const PUBLIC_WORKFLOW_OUTPUT_DEFINITIONS = {
+    "listing-gallery": {
+        textFields: ["text", "title_text", "delivery_copy", "prompt_plan"],
+        mediaFields: [
+            "main_image",
+            "selling_point_image",
+            "detail_image",
+            "lifestyle_image",
+        ],
+        overlayFields: [
+            "selling_point_image",
+            "detail_image",
+            "lifestyle_image",
+        ],
+        ratioFields: [
+            "main_image",
+            "selling_point_image",
+            "detail_image",
+            "lifestyle_image",
+        ],
+        ratios: "record",
+    },
+    "pdp-a-plus": {
+        textFields: ["text", "title_text", "delivery_copy", "prompt_plan"],
+        mediaFields: [
+            "hero_module",
+            "pain_point_module",
+            "structure_module",
+            "usage_module",
+            "comparison_module",
+        ],
+        overlayFields: [
+            "hero_module",
+            "pain_point_module",
+            "structure_module",
+            "usage_module",
+            "comparison_module",
+        ],
+        ratioFields: [
+            "hero_module",
+            "pain_point_module",
+            "structure_module",
+            "usage_module",
+            "comparison_module",
+        ],
+        ratios: "record",
+        sellingPoints: true,
+    },
+    "social-seeding-pack": {
+        textFields: [
+            "text",
+            "title_text",
+            "xhs_caption",
+            "cover_prompt",
+            "scene_prompt",
+        ],
+        mediaFields: ["cover_image", "scene_image"],
+        overlayFields: ["cover_image", "scene_image"],
+        ratioFields: ["cover_image", "scene_image"],
+        ratios: "record",
+    },
+    "campaign-kv-pack": {
+        textFields: ["text", "title_text", "delivery_copy", "prompt_plan"],
+        mediaFields: [],
+        overlayFields: [],
+        ratioFields: [],
+        ratios: "array",
+        mediaPattern: PUBLIC_WORKFLOW_MEDIA_PATTERN,
+    },
+};
 export function buildInputJsonSchema(params, extraProperties = {}) {
     const properties = { ...extraProperties };
     const required = [];
@@ -24,28 +93,52 @@ export function buildInputJsonSchema(params, extraProperties = {}) {
         type: "object",
         properties,
         required,
-        additionalProperties: true,
+        additionalProperties: false,
     };
 }
-export function buildOutputJsonSchema(output) {
-    const properties = {};
-    for (const [key, prop] of Object.entries(output.properties ?? {})) {
-        properties[key] = {
-            type: prop.type,
-            description: prop.description,
-        };
+export function resolvePublicWorkflowOutputDefinition(appId) {
+    const definition = PUBLIC_WORKFLOW_OUTPUT_DEFINITIONS[appId];
+    if (!definition)
+        throw new Error(`未找到 Workflow 输出契约: ${appId}`);
+    return definition;
+}
+export function buildOutputJsonSchema(appId) {
+    const definition = resolvePublicWorkflowOutputDefinition(appId);
+    const properties = Object.fromEntries(definition.textFields.map((field) => [
+        field,
+        stringSchema(workflowTextDescription(field)),
+    ]));
+    properties.copy_plan = copyPlanSchema();
+    properties.overlay_copy = namedStringRecordSchema(definition.overlayFields, definition.mediaPattern);
+    properties.category_profile = categoryProfileSchema();
+    properties.ratios = definition.ratios === "array"
+        ? stringArraySchema("本次生成的画面比例列表", "^\\d+:\\d+$")
+        : namedStringRecordSchema(definition.ratioFields);
+    properties.assets = workflowAssetsSchema();
+    if (definition.sellingPoints) {
+        properties.selling_points = stringArraySchema("从 brief 提取的公开卖点列表");
+    }
+    for (const field of definition.mediaFields) {
+        properties[field] = workflowMediaSchema(`${field} 生成结果`);
     }
     return {
         type: "object",
         properties,
         required: [],
-        additionalProperties: true,
+        additionalProperties: false,
+        ...(definition.mediaPattern
+            ? {
+                patternProperties: {
+                    [definition.mediaPattern]: workflowMediaSchema("Campaign KV 生成结果"),
+                },
+            }
+            : {}),
     };
 }
 export function buildWorkflowSchema(appId) {
     const spec = resolveAppSpec(appId);
     if (!spec)
-        throw new Error(`未找到应用: ${appId}`);
+        throw new Error(`未找到 Workflow: ${appId}`);
     const input = sampleInput(spec.input ?? []);
     return {
         id: spec.id,
@@ -54,23 +147,119 @@ export function buildWorkflowSchema(appId) {
         title: spec.name,
         description: spec.description,
         canonical_command: `gd-cli workflows run ${spec.id}`,
-        schema_command: `gd-cli workflows schema ${spec.id} --format json`,
-        examples_command: `gd-cli workflows examples ${spec.id} --format json`,
+        schema_command: `gd-cli workflows schema ${spec.id} --json`,
+        examples_command: `gd-cli workflows examples ${spec.id}`,
         input_schema: buildInputJsonSchema(spec.input ?? []),
-        output_schema: buildOutputJsonSchema(spec.output),
+        output_schema: buildOutputJsonSchema(spec.id),
         sample_input: input,
         deliverables: spec.outputs ?? ["manifest.json", "README.md", "assets/"],
         stdin: {
             supported: true,
-            command: `cat brief.json | gd-cli workflows run ${spec.id} - --format json`,
+            command: `cat brief.json | gd-cli workflows run ${spec.id} --input - --json`,
             content_type: "application/json",
         },
     };
 }
+function workflowMediaSchema(description) {
+    return {
+        type: "object",
+        description,
+        properties: {
+            url: stringSchema("主结果 URL"),
+            mime_type: stringSchema("主结果 MIME 类型"),
+            urls: stringArraySchema("全部结果 URL"),
+        },
+        required: [],
+        additionalProperties: false,
+    };
+}
+function workflowAssetsSchema() {
+    return {
+        type: "array",
+        description: "按语义角色汇总的公开图片清单",
+        items: {
+            type: "object",
+            properties: {
+                label: stringSchema("交付物显示名称"),
+                role: stringSchema("交付物语义角色"),
+                type: { type: "string", enum: ["image"], description: "媒体类型" },
+                url: stringSchema("交付物 URL"),
+            },
+            required: ["label", "role", "type", "url"],
+            additionalProperties: false,
+        },
+    };
+}
+function copyPlanSchema() {
+    return {
+        type: "object",
+        description: "本次 Workflow 使用的画内文案策略",
+        properties: {
+            mode: {
+                type: "string",
+                enum: ["layout-copy", "render-text", "no-text"],
+                description: "最终文案模式",
+            },
+            render_text: { type: "boolean", description: "是否生成画内文字" },
+            image_model: stringSchema("显式选择的生图模型"),
+        },
+        required: ["mode", "render_text"],
+        additionalProperties: false,
+    };
+}
+function categoryProfileSchema() {
+    return {
+        type: "object",
+        description: "根据 brief 推断的公开品类策略",
+        properties: {
+            id: stringSchema("品类策略 ID"),
+            label: stringSchema("品类显示名称"),
+            guidance: stringSchema("品类创作指导"),
+        },
+        required: ["id", "label", "guidance"],
+        additionalProperties: false,
+    };
+}
+function namedStringRecordSchema(fields, pattern) {
+    return {
+        type: "object",
+        properties: Object.fromEntries(fields.map((field) => [field, stringSchema(`${field} 对应值`)])),
+        required: [],
+        additionalProperties: false,
+        ...(pattern
+            ? { patternProperties: { [pattern]: stringSchema("比例对应值") } }
+            : {}),
+    };
+}
+function stringArraySchema(description, pattern) {
+    return {
+        type: "array",
+        description,
+        items: {
+            type: "string",
+            ...(pattern ? { pattern } : {}),
+        },
+    };
+}
+function stringSchema(description) {
+    return { type: "string", description };
+}
+function workflowTextDescription(field) {
+    const descriptions = {
+        text: "面向用户的 Workflow 总说明",
+        title_text: "生成标题",
+        delivery_copy: "交付说明或渠道文案",
+        prompt_plan: "公开素材或主视觉规划",
+        xhs_caption: "小红书正文与标签",
+        cover_prompt: "封面图提示词",
+        scene_prompt: "场景图提示词",
+    };
+    return descriptions[field] ?? field;
+}
 export function buildWorkflowExamples(appId) {
     const spec = resolveAppSpec(appId);
     if (!spec)
-        throw new Error(`未找到应用: ${appId}`);
+        throw new Error(`未找到 Workflow: ${appId}`);
     const input = sampleInput(spec.input ?? []);
     const curatedExamples = curatedAppExamples(spec.id);
     const agentInput = firstExampleInput(curatedExamples) ?? input;
@@ -82,21 +271,15 @@ export function buildWorkflowExamples(appId) {
             ]),
         {
             description: "Agent / 脚本推荐：stdin JSON",
-            command: `cat brief.json | gd-cli workflows run ${spec.id} - --format json`,
+            command: `cat brief.json | gd-cli workflows run ${spec.id} --input - --json`,
             input_json: agentInput,
         },
         {
             description: "Agent / 脚本推荐：JSON 文件",
-            command: `gd-cli workflows run ${spec.id} --input brief.json --format json`,
+            command: `gd-cli workflows run ${spec.id} --input brief.json --json`,
             input_json: agentInput,
         },
     ];
-    if (spec.supports_batch) {
-        examples.push({
-            description: "批量任务 dry-run 预检",
-            command: `gd-cli workflows run ${spec.id} --input ./products.csv --assets-dir ./images --dry-run --format json`,
-        });
-    }
     return {
         id: spec.id,
         type: "workflow",
@@ -106,39 +289,6 @@ export function buildWorkflowExamples(appId) {
         examples,
     };
 }
-export function buildWorkflowManifest() {
-    const commands = DIRECT_APPS.map(workflowManifestCommand);
-    return {
-        name: "gd-cli",
-        version: CLI_VERSION,
-        description: "Gaoding Workflow capabilities for agents",
-        commands,
-    };
-}
-export function rowsForWorkflowManifest(manifest) {
-    return manifest.commands.map((command) => ({
-        id: command.id,
-        type: command.type,
-        分类: command.category,
-        名称: command.title,
-        command: command.canonical_command,
-    }));
-}
-function workflowManifestCommand(spec) {
-    return {
-        id: spec.id,
-        type: "workflow",
-        category: spec.category,
-        title: spec.name,
-        description: spec.description,
-        canonical_command: `gd-cli workflows run ${spec.id}`,
-        input_schema_command: `gd-cli workflows schema ${spec.id}`,
-        examples_command: `gd-cli workflows examples ${spec.id}`,
-        output: "json",
-        safe_for_agent: true,
-        ...capabilityMetadata("app", spec.id),
-    };
-}
 function buildFlagCommand(prefix, id, params) {
     const pieces = [prefix, id];
     for (const param of params) {
@@ -146,7 +296,7 @@ function buildFlagCommand(prefix, id, params) {
             continue;
         pieces.push(param.cli_flag, quoteShell(String(sampleValue(param))));
     }
-    pieces.push("--format", "json");
+    pieces.push("--json");
     return pieces.join(" ");
 }
 function sampleInput(params) {
@@ -187,7 +337,7 @@ function sampleValue(param) {
 function curatedAppExamples(appId) {
     if (appId === "listing-gallery") {
         return [
-            scenarioExample("生成一套可上架的商品图库素材，包含白底主图、卖点图、细节图和生活方式图。", "gd-cli workflows run listing-gallery --image ./sku_001.jpg --brief \"夏季轻薄防晒衣，透气面料，适合户外通勤；卖点图短文案：轻薄防晒 通勤无负担\" --copy-mode render-text --ratio 1:1 -f json", {
+            scenarioExample("生成一套可上架的商品图库素材，包含白底主图、卖点图、细节图和生活方式图。", "gd-cli workflows run listing-gallery --image ./sku_001.jpg --brief \"夏季轻薄防晒衣，透气面料，适合户外通勤；卖点图短文案：轻薄防晒 通勤无负担\" --copy-mode render-text --ratio 1:1 --json", {
                 image: "./sku_001.jpg",
                 brief: "夏季轻薄防晒衣，透气面料，适合户外通勤；卖点图短文案：轻薄防晒 通勤无负担",
                 copy_mode: "render-text",
@@ -197,7 +347,7 @@ function curatedAppExamples(appId) {
     }
     if (appId === "pdp-a-plus") {
         return [
-            scenarioExample("生成详情页/A+模块素材，按购买疑虑组织首屏、痛点、结构、使用和规格模块。", "gd-cli workflows run pdp-a-plus --image ./air-purifier.jpg --brief \"桌面空气净化器，静音，滤芯可更换，适合卧室；首屏短文案：静音净化 安心入睡\" --copy-mode render-text --ratio 4:5 -f json", {
+            scenarioExample("生成详情页/A+模块素材，按购买疑虑组织首屏、痛点、结构、使用和规格模块。", "gd-cli workflows run pdp-a-plus --image ./air-purifier.jpg --brief \"桌面空气净化器，静音，滤芯可更换，适合卧室；首屏短文案：静音净化 安心入睡\" --copy-mode render-text --ratio 4:5 --json", {
                 image: "./air-purifier.jpg",
                 brief: "桌面空气净化器，静音，滤芯可更换，适合卧室；首屏短文案：静音净化 安心入睡",
                 copy_mode: "render-text",
@@ -207,7 +357,7 @@ function curatedAppExamples(appId) {
     }
     if (appId === "social-seeding-pack") {
         return [
-            scenarioExample("生成小红书种草图文素材，包含封面图、场景图、标题、正文和标签。", "gd-cli workflows run social-seeding-pack --image ./serum.jpg --brief \"屏障修护精华，清爽不黏，适合通勤包分享；封面短文案：通勤包里的清爽修护\" --copy-mode render-text --ratio 3:4 -f json", {
+            scenarioExample("生成小红书种草图文素材，包含封面图、场景图、标题、正文和标签。", "gd-cli workflows run social-seeding-pack --image ./serum.jpg --brief \"屏障修护精华，清爽不黏，适合通勤包分享；封面短文案：通勤包里的清爽修护\" --copy-mode render-text --ratio 3:4 --json", {
                 image: "./serum.jpg",
                 brief: "屏障修护精华，清爽不黏，适合通勤包分享；封面短文案：通勤包里的清爽修护",
                 copy_mode: "render-text",
@@ -217,7 +367,7 @@ function curatedAppExamples(appId) {
     }
     if (appId === "campaign-kv-pack") {
         return [
-            scenarioExample("生成 Campaign KV 多渠道素材，包含横版、方图、竖图和渠道裁切建议。", "gd-cli workflows run campaign-kv-pack --image ./running-shoes.jpg --brief \"城市跑鞋新品 Campaign，轻量缓震，面向通勤跑者；主标题：轻跑进城\" --copy-mode render-text --ratios 16:9,1:1,4:5 -f json", {
+            scenarioExample("生成 Campaign KV 多渠道素材，包含横版、方图、竖图和渠道裁切建议。", "gd-cli workflows run campaign-kv-pack --image ./running-shoes.jpg --brief \"城市跑鞋新品 Campaign，轻量缓震，面向通勤跑者；主标题：轻跑进城\" --copy-mode render-text --ratios 16:9,1:1,4:5 --json", {
                 image: "./running-shoes.jpg",
                 brief: "城市跑鞋新品 Campaign，轻量缓震，面向通勤跑者；主标题：轻跑进城",
                 copy_mode: "render-text",