gaoding-cli 1.0.0-alpha.5

package/dist/src/api/app-runner.js

@@ -0,0 +1,1177 @@
+import { DirectToolInvoker } from "./direct-tools.js";
+import { DirectApiError } from "./direct-client.js";
+/** 多步 App 含多次生图/对话，默认至少等待 10 分钟 */
+const APP_RUN_MIN_WAIT_SEC = 600;
+function resolveAppWaitTimeout(explicit, estimatedSeconds) {
+    if (explicit !== undefined && Number.isFinite(explicit) && explicit > 0) {
+        return Math.floor(explicit);
+    }
+    const est = Number(estimatedSeconds);
+    if (Number.isFinite(est) && est > APP_RUN_MIN_WAIT_SEC) {
+        return Math.ceil(est);
+    }
+    return APP_RUN_MIN_WAIT_SEC;
+}
+function resolveConcurrency(value) {
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric) || numeric <= 0)
+        return 2;
+    return Math.max(1, Math.min(4, Math.floor(numeric)));
+}
+async function mapWithConcurrency(items, concurrency, worker) {
+    let next = 0;
+    const runners = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+        while (next < items.length) {
+            const index = next;
+            next += 1;
+            await worker(items[index], index);
+        }
+    });
+    await Promise.all(runners);
+}
+class AppWorkflowFailure extends Error {
+    result;
+    constructor(result) {
+        const error = result.error;
+        super(typeof error?.message === "string" ? error.message : "App workflow 执行失败");
+        this.result = result;
+        this.name = "AppWorkflowFailure";
+    }
+}
+class AppWorkflowContext {
+    appId;
+    options;
+    outputs = {};
+    steps = [];
+    order = 0;
+    constructor(appId, options = {}) {
+        this.appId = appId;
+        this.options = options;
+    }
+    async invoke(stepId, stepName, tool, fn) {
+        const base = this.newStep(stepId, stepName, tool);
+        this.emitStepStart(base);
+        try {
+            const invocation = await fn();
+            if (invocation.status === "failed") {
+                throw taskResultFailure(invocation);
+            }
+            const completedStep = { ...base, status: "completed", invocation };
+            this.steps.push(completedStep);
+            this.emitStepComplete(completedStep, invocation);
+            return invocation;
+        }
+        catch (error) {
+            const normalized = normalizeAppStepError(error, base);
+            const failed = { ...base, status: "failed", error: normalized };
+            this.steps.push(failed);
+            this.emitStepComplete(failed);
+            throw new AppWorkflowFailure(this.failed(normalized, failed));
+        }
+    }
+    async invokeOptional(stepId, stepName, tool, fn, fallback) {
+        const base = this.newStep(stepId, stepName, tool);
+        this.emitStepStart(base);
+        try {
+            const invocation = await fn();
+            if (invocation.status === "failed") {
+                throw taskResultFailure(invocation);
+            }
+            const completedStep = { ...base, status: "completed", invocation, optional: true };
+            this.steps.push(completedStep);
+            this.emitStepComplete(completedStep, invocation);
+            return invocation;
+        }
+        catch (error) {
+            const normalized = normalizeAppStepError(error, base);
+            const failed = { ...base, status: "failed", error: normalized, optional: true };
+            this.steps.push(failed);
+            this.emitStepComplete(failed);
+            return fallback();
+        }
+    }
+    addAsset(label, role, result) {
+        const url = outputString(result, "url", false);
+        if (!url)
+            return;
+        const assets = Array.isArray(this.outputs.assets)
+            ? this.outputs.assets
+            : [];
+        this.outputs.assets = [
+            ...assets.filter((item) => item.url !== url),
+            { label, role, type: "image", url },
+        ];
+    }
+    completed(extraOutputs = {}) {
+        return completedApp(this.appId, {
+            ...this.outputs,
+            ...extraOutputs,
+            step_outputs: this.orderedSteps(),
+            completed_steps: this.completedSteps(),
+        });
+    }
+    failed(error, failedStep) {
+        return {
+            task_id: `app-${this.appId}-${Date.now()}`,
+            status: "failed",
+            error: {
+                ...error,
+                app_id: this.appId,
+                step: publicStep(failedStep),
+            },
+            outputs: {
+                ...this.outputs,
+                partial: true,
+                step_outputs: this.orderedSteps(),
+                completed_steps: this.completedSteps(),
+                failed_step: publicStep(failedStep),
+            },
+        };
+    }
+    newStep(stepId, stepName, tool) {
+        this.order += 1;
+        return {
+            step_order: this.order,
+            step_id: stepId,
+            step_name: stepName,
+            tool,
+        };
+    }
+    completedSteps() {
+        return this.orderedSteps()
+            .filter((step) => step.status === "completed")
+            .map(publicStep);
+    }
+    orderedSteps() {
+        return [...this.steps].sort((a, b) => a.step_order - b.step_order);
+    }
+    emitStepStart(step) {
+        this.options.onStepStart?.({
+            step_order: step.step_order,
+            step_id: step.step_id,
+            step_name: step.step_name,
+            tool: step.tool,
+            status: "running",
+        });
+    }
+    emitStepComplete(step, result) {
+        this.options.onStepComplete?.({
+            step_order: step.step_order,
+            step_id: step.step_id,
+            step_name: step.step_name,
+            tool: step.tool,
+            status: step.status,
+        }, result);
+    }
+}
+export class AppRunner {
+    invoker = new DirectToolInvoker();
+    constructor(client) {
+        void client;
+    }
+    async run(appId, params, options = {}) {
+        if (options.async) {
+            return {
+                task_id: `app-${appId}-${Date.now()}`,
+                status: "failed",
+                message: "本地 App workflow 暂不支持 --async，请去掉 --async 直接运行。",
+            };
+        }
+        void resolveAppWaitTimeout(options.timeout, undefined);
+        void options.outputDir;
+        try {
+            if (appId === "listing-gallery")
+                return await this.runListingGallery(params, options);
+            if (appId === "pdp-a-plus")
+                return await this.runPdpAPlus(params, options);
+            if (appId === "social-seeding-pack")
+                return await this.runSocialSeedingPack(params, options);
+            if (appId === "campaign-kv-pack")
+                return await this.runCampaignKvPack(params, options);
+        }
+        catch (error) {
+            if (error instanceof AppWorkflowFailure)
+                return error.result;
+            throw error;
+        }
+        throw new Error("暂不支持的本地 App workflow: " + appId);
+    }
+    async runListingGallery(params, options) {
+        const ctx = new AppWorkflowContext("listing-gallery", options);
+        const image = requireString(params.image ?? params.images, "listing-gallery 需要 --image");
+        const brief = requireString(params.brief ?? params.prompt, "listing-gallery 需要 --brief");
+        const profile = inferProductCategoryProfile(brief);
+        const copyPlan = resolveCopyPlan(params, brief);
+        const ratios = resolveRoleRatios(params.ratio, {
+            main_image: "1:1",
+            selling_point_image: "4:5",
+            detail_image: "4:5",
+            lifestyle_image: "4:5",
+        });
+        const prepared = await this.prepareProduct(ctx, image, allowSensitivePath(params));
+        const title = await this.generateTitle(ctx, brief);
+        const titleText = outputString(title, "text", false) || brief;
+        const promptPlan = await this.optimizePrompt(ctx, "prompt_plan", "生成图库素材规划", `为电商 Listing 图库生成素材规划：${brief}。品类判断：${profile.label}。需要覆盖白底主图、单卖点证明图、材质/结构细节图、生活方式图；${copyPlanningGuidance(copyPlan)}每张图只回答一个购买问题，不生成假认证和不可验证参数。`, prepared.cutoutUrl, `Listing 图库素材规划：主图、卖点图、细节图、生活方式图。品类：${profile.label}。商品卖点：${brief}`);
+        const galleryCopy = buildListingGalleryCopy(titleText, brief);
+        const overlayCopy = {
+            selling_point_image: buildOverlayCopy("卖点图", titleText, brief),
+            detail_image: buildOverlayCopy("细节图", titleText, brief),
+            lifestyle_image: buildOverlayCopy("生活方式图", titleText, brief),
+        };
+        Object.assign(ctx.outputs, {
+            text: buildSummary([
+                ["标题", titleText],
+                ["图库交付说明", galleryCopy],
+                ["素材规划", promptPlan.text],
+            ]),
+            title_text: titleText,
+            delivery_copy: galleryCopy,
+            prompt_plan: promptPlan.text,
+            copy_plan: copyPlanOutput(copyPlan),
+            overlay_copy: overlayCopy,
+            category_profile: publicCategoryProfile(profile),
+            ratios,
+            title: title.outputs,
+            prompt: promptPlan.result.outputs,
+        });
+        await this.generateImageJobs(ctx, [
+            {
+                key: "main_image",
+                label: "白底主图",
+                stepName: "生成白底主图",
+                image: prepared.cutoutUrl,
+                ratio: ratios.main_image,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "白底商品主图",
+                    brief,
+                    profile,
+                    commercialRole: "Listing 第一张主图，用于平台审核和缩略图识别，让用户看清商品主体、颜色、形态、包装和配件边界。",
+                    visibleEvidence: "商品完整居中，轮廓清晰，标签或关键识别面可读，主体占画面 75%-80%。",
+                    composition: "暖白或纯白背景，真实柔和投影，干净棚拍光，画面没有道具、文字、促销元素和装饰。",
+                    platformFit: "适合 Amazon / 天猫 / 京东基础上架主图；优先保证过审和主体保真。",
+                    copyMode: "no-text",
+                }),
+            },
+            {
+                key: "selling_point_image",
+                label: "卖点图",
+                stepName: "生成卖点图",
+                image: prepared.cutoutUrl,
+                ratio: ratios.selling_point_image,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "核心卖点证明图",
+                    brief,
+                    profile,
+                    commercialRole: "Listing 第二张图，只解释一个核心购买利益点，不把多个卖点塞进同一张图。",
+                    visibleEvidence: `围绕“${primaryBriefPoint(brief)}”设计可见证据，效果只出现在相关产品部位附近，不编造数字、不生成假认证。`,
+                    composition: "商品在前景占主导，背景用克制的场景或视觉隐喻辅助说明，左上或右侧保留后期短标题空间。",
+                    platformFit: "适合电商图库卖点图，默认交付可排版成品所需视觉证据和短文案，不交付空白占位图。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.selling_point_image,
+                }),
+            },
+            {
+                key: "detail_image",
+                label: "细节图",
+                stepName: "生成细节图",
+                image: prepared.cutoutUrl,
+                ratio: ratios.detail_image,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "材质结构细节图",
+                    brief,
+                    profile,
+                    commercialRole: "Listing 第三张图，用近景或微距证明材质、结构、接口、按钮、织物纹理、包装或关键部件真实存在。",
+                    visibleEvidence: profile.detailEvidence,
+                    composition: "微距商业摄影，侧光突出触感和层次，浅景深但保留足够产品上下文，局部细节和整体识别不冲突。",
+                    platformFit: "适合详情页和图库细节说明；不生成伪文字、错误标签、额外配件或不存在的内部结构。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.detail_image,
+                }),
+            },
+            {
+                key: "lifestyle_image",
+                label: "生活方式图",
+                stepName: "生成生活方式图",
+                image: prepared.cutoutUrl,
+                ratio: ratios.lifestyle_image,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "生活方式使用图",
+                    brief,
+                    profile,
+                    commercialRole: "Listing 第四张图，让用户知道商品适合谁、在什么场景使用、使用时的状态是什么。",
+                    visibleEvidence: profile.usageEvidence,
+                    composition: "真实生活环境，商品自然融入但仍是视觉主角；可出现手部或背影动作，不出现名人脸和复杂人群。",
+                    platformFit: "适合小红书、电商图库和独立站补充场景；手机端缩略图仍能一眼看清商品。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.lifestyle_image,
+                }),
+            },
+        ], options);
+        return ctx.completed();
+    }
+    async runPdpAPlus(params, options) {
+        const ctx = new AppWorkflowContext("pdp-a-plus", options);
+        const image = requireString(params.image ?? params.images, "pdp-a-plus 需要 --image");
+        const brief = requireString(params.brief ?? params.prompt, "pdp-a-plus 需要 --brief");
+        const profile = inferProductCategoryProfile(brief);
+        const copyPlan = resolveCopyPlan(params, brief);
+        const ratios = resolveRoleRatios(params.ratio, {
+            hero_module: "16:9",
+            pain_point_module: "4:5",
+            structure_module: "4:5",
+            usage_module: "4:5",
+            comparison_module: "1:1",
+        });
+        const prepared = await this.prepareProduct(ctx, image, allowSensitivePath(params));
+        const title = await this.generateTitle(ctx, brief);
+        const titleText = outputString(title, "text", false) || brief;
+        const promptPlan = await this.optimizePrompt(ctx, "prompt_plan", "生成详情页模块规划", `为电商详情页/A+模块生成购买说服顺序：${brief}。品类判断：${profile.label}。模块包含首屏、痛点解决、结构/细节证明、真实使用场景、对比规格；${copyPlanningGuidance(copyPlan)}不编造参数和认证。`, prepared.cutoutUrl, `详情页模块规划：首屏、痛点、结构细节、使用场景、对比规格。品类：${profile.label}。商品信息：${brief}`);
+        const moduleCopy = buildPdpModuleCopy(titleText, brief);
+        const overlayCopy = {
+            hero_module: buildOverlayCopy("首屏模块", titleText, brief),
+            pain_point_module: buildOverlayCopy("痛点模块", titleText, brief),
+            structure_module: buildOverlayCopy("结构细节模块", titleText, brief),
+            usage_module: buildOverlayCopy("使用场景模块", titleText, brief),
+            comparison_module: buildOverlayCopy("对比规格模块", titleText, brief),
+        };
+        Object.assign(ctx.outputs, {
+            text: buildSummary([
+                ["标题", titleText],
+                ["详情页模块文案", moduleCopy],
+                ["模块规划", promptPlan.text],
+            ]),
+            title_text: titleText,
+            delivery_copy: moduleCopy,
+            prompt_plan: promptPlan.text,
+            copy_plan: copyPlanOutput(copyPlan),
+            overlay_copy: overlayCopy,
+            selling_points: splitBriefPoints(brief),
+            category_profile: publicCategoryProfile(profile),
+            ratios,
+            title: title.outputs,
+            prompt: promptPlan.result.outputs,
+        });
+        await this.generateImageJobs(ctx, [
+            {
+                key: "hero_module",
+                label: "首屏模块",
+                stepName: "生成首屏模块",
+                image: prepared.cutoutUrl,
+                ratio: ratios.hero_module,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "详情页首屏 Hero 模块",
+                    brief,
+                    profile,
+                    commercialRole: "PDP/A+ 首屏模块，用商品全貌和一个核心利益点建立第一购买理由。",
+                    visibleEvidence: `围绕“${primaryBriefPoint(brief)}”建立视觉锚点，商品清晰、比例准确、品牌识别面可读。`,
+                    composition: "横版详情页头图构图，商品占据视觉中心或黄金分割位，背景高级克制，留出后期标题和利益点排版区。",
+                    platformFit: "适合详情页首屏、独立站首屏和 A+ 头图；不交付空白背景，画面必须承载第一购买理由。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.hero_module,
+                }),
+            },
+            {
+                key: "pain_point_module",
+                label: "痛点模块",
+                stepName: "生成痛点模块",
+                image: prepared.cutoutUrl,
+                ratio: ratios.pain_point_module,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "痛点解决模块",
+                    brief,
+                    profile,
+                    commercialRole: "解释用户为什么需要这件商品，用克制的真实场景表达问题和解决前后关系。",
+                    visibleEvidence: "一侧呈现用户痛点或使用前困扰，另一侧通过商品出现表达解决方向；不做夸大疗效或不可验证对比。",
+                    composition: "可使用分区式或前后景关系，画面干净，商品和问题场景关联清晰，保留后期短文案空间。",
+                    platformFit: "适合详情页说服模块；不生成虚假数字、医疗化表述、认证徽章和过度戏剧化效果。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.pain_point_module,
+                }),
+            },
+            {
+                key: "structure_module",
+                label: "结构细节模块",
+                stepName: "生成结构细节模块",
+                image: prepared.cutoutUrl,
+                ratio: ratios.structure_module,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "结构细节证明模块",
+                    brief,
+                    profile,
+                    commercialRole: "用材质、结构、接口、配件、织物或关键部件证明卖点，不靠抽象口号。",
+                    visibleEvidence: profile.detailEvidence,
+                    composition: "局部放大、轻拆解或微距构图，技术感克制，callout 区可以留白但必须有真实可见细节，不发明内部结构。",
+                    platformFit: "适合详情页结构/材质说明；参数和箭头由后期设计添加。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.structure_module,
+                }),
+            },
+            {
+                key: "usage_module",
+                label: "使用场景模块",
+                stepName: "生成使用场景模块",
+                image: prepared.cutoutUrl,
+                ratio: ratios.usage_module,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "真实使用场景模块",
+                    brief,
+                    profile,
+                    commercialRole: "展示商品在目标用户真实环境中的使用动作、空间关系和体验结果。",
+                    visibleEvidence: profile.usageEvidence,
+                    composition: "自然光或真实室内光，手部/桌面/空间动作可信，商品始终清晰可见，背景不杂乱。",
+                    platformFit: "适合 PDP 使用方式说明；不出现名人脸、复杂人物、无关道具和隐藏商品的生活照。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.usage_module,
+                }),
+            },
+            {
+                key: "comparison_module",
+                label: "对比规格模块",
+                stepName: "生成对比规格模块",
+                image: prepared.cutoutUrl,
+                ratio: ratios.comparison_module,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "对比规格模块",
+                    brief,
+                    profile,
+                    commercialRole: "为尺寸、规格、适配、SKU 或参数对比预留视觉框架，只表达确定的信息。",
+                    visibleEvidence: "商品以准确透视和比例陈列，可放入真实尺度参照物；没有明确参数时只展示规格对比场景和信息框架，不生成具体数字。",
+                    composition: "理性网格或干净桌面陈列，留出后期规格表和短标签空间，商品不变形。",
+                    platformFit: "适合详情页参数模块；不生成假规格、假认证、假价格和错误 SKU。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.comparison_module,
+                }),
+            },
+        ], options);
+        return ctx.completed();
+    }
+    async runSocialSeedingPack(params, options) {
+        const ctx = new AppWorkflowContext("social-seeding-pack", options);
+        const image = requireString(params.image ?? params.images, "social-seeding-pack 需要 --image");
+        const brief = requireString(params.brief ?? params.prompt, "social-seeding-pack 需要 --brief");
+        const profile = inferProductCategoryProfile(brief);
+        const copyPlan = resolveCopyPlan(params, brief);
+        const ratios = resolveRoleRatios(params.ratio, {
+            cover_image: "3:4",
+            scene_image: "9:16",
+        });
+        const prepared = await this.prepareProduct(ctx, image, allowSensitivePath(params));
+        const title = await this.generateTitle(ctx, brief);
+        const titleText = outputString(title, "text", false) || brief;
+        const xhsCaption = buildXhsCaption(titleText, brief);
+        const [coverPrompt, scenePrompt] = await Promise.all([
+            this.optimizePrompt(ctx, "cover_prompt", "生成小红书封面提示词", `请生成适合小红书封面图的提示词：${brief}。品类判断：${profile.label}。要求真实创作者视角、移动端缩略图第一眼可读、商品清楚；${copyPlanningGuidance(copyPlan)}无假功效。`, prepared.cutoutUrl, `小红书封面图，真实创作者视角，移动端第一眼可读，保留标题空间。品类：${profile.label}。需求：${brief}`),
+            this.optimizePrompt(ctx, "scene_prompt", "生成小红书场景图提示词", `请生成适合小红书种草内容图的提示词：${brief}。品类判断：${profile.label}。要求真实生活台面、通勤、开箱或使用动作，有分享感，商品主体一致且不被场景吞掉。`, prepared.cutoutUrl, `小红书种草场景图，真实生活方式，自然动作，分享感，商品主体一致。品类：${profile.label}。需求：${brief}`),
+        ]);
+        ctx.outputs.prompt = coverPrompt.result.outputs;
+        const overlayCopy = {
+            cover_image: buildOverlayCopy("小红书封面图", titleText, brief),
+            scene_image: buildOverlayCopy("小红书场景图", titleText, brief),
+        };
+        Object.assign(ctx.outputs, {
+            text: buildSummary([
+                ["标题", titleText],
+                ["小红书种草文案", xhsCaption],
+                ["封面图提示词", coverPrompt.text],
+                ["场景图提示词", scenePrompt.text],
+            ]),
+            title_text: titleText,
+            xhs_caption: xhsCaption,
+            cover_prompt: coverPrompt.text,
+            scene_prompt: scenePrompt.text,
+            copy_plan: copyPlanOutput(copyPlan),
+            overlay_copy: overlayCopy,
+            category_profile: publicCategoryProfile(profile),
+            ratios,
+            title: title.outputs,
+            scene_prompt_outputs: scenePrompt.result.outputs,
+        });
+        await this.generateImageJobs(ctx, [
+            {
+                key: "cover_image",
+                label: "小红书封面图",
+                stepName: "生成小红书封面图",
+                image: prepared.cutoutUrl,
+                ratio: ratios.cover_image,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "小红书种草封面图",
+                    brief,
+                    profile,
+                    commercialRole: "小红书笔记封面，负责在移动端缩略图中让用户看清商品和内容角度。",
+                    visibleEvidence: `围绕“${primaryBriefPoint(brief)}”建立一个真实分享切入点，商品占据明确视觉焦点。`,
+                    composition: `真实创作者视角，构图有标题区但画面必须有商品证据。优化后的封面方向：${coverPrompt.text}`,
+                    platformFit: "适合小红书封面和信息流首屏；不出现夸张营销海报感、假标签、假口播字幕和不可验证功效。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.cover_image,
+                }),
+            },
+            {
+                key: "scene_image",
+                label: "小红书场景图",
+                stepName: "生成小红书场景图",
+                image: prepared.cutoutUrl,
+                ratio: ratios.scene_image,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: "小红书真实场景图",
+                    brief,
+                    profile,
+                    commercialRole: "小红书内容图，负责补充真实使用、开箱、通勤、桌面或生活方式证据。",
+                    visibleEvidence: profile.usageEvidence,
+                    composition: `竖版手机构图，自然光，手部或桌面动作可信，商品主体不被遮挡。优化后的场景方向：${scenePrompt.text}`,
+                    platformFit: "适合小红书种草正文配图；不出现名人脸、过度精修硬广感、复杂字幕和隐藏商品。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: overlayCopy.scene_image,
+                }),
+            },
+        ], options);
+        return ctx.completed();
+    }
+    async runCampaignKvPack(params, options) {
+        const ctx = new AppWorkflowContext("campaign-kv-pack", options);
+        const image = requireString(params.image ?? params.images, "campaign-kv-pack 需要 --image");
+        const brief = requireString(params.brief ?? params.prompt, "campaign-kv-pack 需要 --brief");
+        const ratios = parseRatioList(params.ratios ?? params.ratio, ["16:9", "1:1", "4:5"]);
+        const profile = inferProductCategoryProfile(brief);
+        const copyPlan = resolveCopyPlan(params, brief);
+        const prepared = await this.prepareProduct(ctx, image, allowSensitivePath(params));
+        const title = await this.generateTitle(ctx, brief);
+        const titleText = outputString(title, "text", false) || brief;
+        const promptPlan = await this.optimizePrompt(ctx, "prompt_plan", "生成 Campaign KV 主视觉提示词", `为新品 Campaign KV 生成${copyPlan.mode === "no-text" ? "无字主视觉" : "可直接投放主视觉"}提示词：${brief}。品类判断：${profile.label}。要求一个清晰记忆符号，可裁切到官网、社媒、电商活动和投放；${copyPlanningGuidance(copyPlan)}不改 logo、不生成假促销标。`, prepared.cutoutUrl, copyPlan.mode === "no-text"
+            ? `Campaign KV 无字主视觉，一个清晰记忆符号，多渠道可裁切，商品是视觉锚点。品类：${profile.label}。需求：${brief}`
+            : `Campaign KV 可直接投放主视觉，包含指定 Campaign 标题和核心利益点，一个清晰记忆符号，多渠道可裁切，商品是视觉锚点。品类：${profile.label}。需求：${brief}`);
+        const campaignCopy = buildCampaignCopy(titleText, brief, ratios);
+        const overlayCopy = Object.fromEntries(ratios.map((ratio) => [`kv_${slugKey(ratio)}`, buildOverlayCopy(`Campaign KV ${ratio}`, titleText, brief)]));
+        Object.assign(ctx.outputs, {
+            text: buildSummary([
+                ["Campaign 标题", titleText],
+                ["渠道文案与裁切建议", campaignCopy],
+                ["主视觉提示词", promptPlan.text],
+            ]),
+            title_text: titleText,
+            delivery_copy: campaignCopy,
+            prompt_plan: promptPlan.text,
+            copy_plan: copyPlanOutput(copyPlan),
+            overlay_copy: overlayCopy,
+            ratios,
+            category_profile: publicCategoryProfile(profile),
+            title: title.outputs,
+            prompt: promptPlan.result.outputs,
+        });
+        await this.generateImageJobs(ctx, ratios.map((ratio) => {
+            const key = `kv_${slugKey(ratio)}`;
+            return {
+                key,
+                label: `Campaign KV ${ratio}`,
+                stepName: `生成 Campaign KV ${ratio}`,
+                image: prepared.cutoutUrl,
+                ratio,
+                model: copyPlan.imageModel,
+                prompt: buildEcommerceImagePrompt({
+                    role: `Campaign KV 主视觉 ${ratio}`,
+                    brief,
+                    profile,
+                    commercialRole: "活动主视觉，负责建立一个可跨官网、活动页、社媒和电商投放延展的品牌记忆符号。",
+                    visibleEvidence: copyPlan.mode === "render-text"
+                        ? `商品是视觉锚点，围绕“${primaryBriefPoint(brief)}”建立可感知的场景、光影或材质符号，画内短文案只点明核心利益点，不能替代商品证据。`
+                        : `商品是视觉锚点，围绕“${primaryBriefPoint(brief)}”建立可感知的场景、光影或材质符号，不依赖画内文字表达卖点。`,
+                    composition: copyPlan.mode === "render-text"
+                        ? `画面比例 ${ratio}，高端商业广告光影，主体和背景层次明确，给指定 Campaign 标题和利益点留出清晰版式位置。优化后的 KV 方向：${promptPlan.text}`
+                        : `画面比例 ${ratio}，高端商业广告光影，主体和背景层次明确，保留后期标题、价格或利益点排版空间。优化后的 KV 方向：${promptPlan.text}`,
+                    platformFit: copyPlan.mode === "render-text"
+                        ? "适合多渠道裁切，横版、方图、竖图都能看清商品和指定短文案；不生成额外活动标、假价格或假认证。"
+                        : "适合多渠道裁切，横版、方图、竖图都能看清商品；可作为后期排版底图。",
+                    copyMode: copyPlan.mode,
+                    overlayCopy: String(overlayCopy[key] ?? ""),
+                }),
+            };
+        }), options);
+        return ctx.completed();
+    }
+    async generateImageJobs(ctx, jobs, options) {
+        await mapWithConcurrency(jobs, resolveConcurrency(options.concurrency), async (job) => {
+            const result = await this.generateImage(ctx, job.key, job.stepName, job.prompt, job.image, job.ratio, job.model);
+            ctx.outputs[job.key] = result.outputs;
+            ctx.addAsset(job.label, job.key, result);
+        });
+    }
+    async prepareProduct(ctx, image, allowSensitive) {
+        const product = await ctx.invoke("product_upload", "临时上传商品图", "asset.upload", () => this.invoker.invoke("upload", { file: image, allow_sensitive_path: allowSensitive }));
+        const productUrl = outputString(product, "url");
+        ctx.outputs.product = product.outputs;
+        const cutout = await ctx.invoke("product_cutout", "商品图抠图", "image.cutout", () => this.invoker.invoke("cutout", { image: productUrl, mode: "product" }));
+        const cutoutUrl = outputString(cutout, "url");
+        ctx.outputs.cutout = cutout.outputs;
+        return { product, cutout, productUrl, cutoutUrl };
+    }
+    async optimizePrompt(ctx, stepId, stepName, prompt, image, fallback) {
+        const result = await ctx.invoke(stepId, stepName, "text.prompt", () => this.invoker.invoke("prompt", { prompt, image }));
+        return {
+            result,
+            text: outputString(result, "text", false) || fallback,
+        };
+    }
+    async generateImage(ctx, stepId, stepName, prompt, image, ratio, model) {
+        return ctx.invoke(stepId, stepName, "image.generate", async () => {
+            try {
+                return await this.invokeGenerateImage(prompt, image, ratio, model);
+            }
+            catch (error) {
+                const message = extractErrorMessage(error);
+                if (!isToolIntentRoutingError(message) &&
+                    !isThirdPartyUnsupportedError(message) &&
+                    !isContentSafetyError(message)) {
+                    throw error;
+                }
+                return this.invokeGenerateImage(isContentSafetyError(message)
+                    ? safeGeneratePrompt(stepName, prompt)
+                    : fallbackGeneratePrompt(stepName, prompt), image, ratio, model);
+            }
+        });
+    }
+    async invokeGenerateImage(prompt, image, ratio, model) {
+        return this.invoker.invoke("generate", {
+            prompt,
+            image,
+            ratio,
+            ...(model ? { model } : {}),
+        }, {
+            timeout: 600,
+        });
+    }
+    async generateTitle(ctx, brief) {
+        return ctx.invokeOptional("title", "生成标题", "text.title", () => this.invoker.invoke("title", { prompt: brief }), () => ({
+            task_id: `title-fallback-${Date.now()}`,
+            status: "completed",
+            outputs: {
+                text: brief,
+                warning: "标题生成失败，已使用 brief 作为标题 fallback。",
+            },
+        }));
+    }
+}
+function completedApp(appId, outputs) {
+    return {
+        task_id: `app-${appId}-${Date.now()}`,
+        status: "completed",
+        outputs,
+    };
+}
+function taskResultFailure(result) {
+    const message = typeof result.error === "string"
+        ? result.error
+        : result.error && typeof result.error === "object" && "message" in result.error
+            ? String(result.error.message)
+            : result.message ?? "工具调用失败";
+    return new Error(message);
+}
+function normalizeAppStepError(error, step) {
+    const rawMessage = extractErrorMessage(error);
+    const code = extractErrorCode(error);
+    if (isContentSafetyError(rawMessage)) {
+        return {
+            code: "CONTENT_SAFETY_REJECTED",
+            type: "business",
+            reason: "reference-image-sensitive",
+            message: `${step.step_name} 未通过平台内容安全审核。`,
+            raw_message: rawMessage,
+            hint: "平台判断参考图或当前生成上下文可能包含敏感内容。请换一张主体更清晰、少文字少 logo 的商品图，或先单独运行 image.cutout / image.generate 验证该图片。",
+            next_steps: [
+                "检查商品图中是否有敏感文字、人物、商标水印、医疗/政治/暴露等容易误判的元素。",
+                "更换或裁剪商品图后重试原 workflows run 命令。",
+                "如确认是误判，请把失败步骤和原图提供给平台排查。",
+            ],
+        };
+    }
+    if (isThirdPartyUnsupportedError(rawMessage)) {
+        return {
+            code: "THIRD_PARTY_UNSUPPORTED",
+            type: "business",
+            reason: "provider-unsupported",
+            message: `${step.step_name} 当前暂不支持这次生成请求。`,
+            raw_message: rawMessage,
+            hint: "平台服务当前调用到暂未开通的生成通道。如果持续复现，请联系平台确认能力配置。",
+            next_steps: [
+                "停止重试，不要切换模型、环境、团队或调用内部工具。",
+                "请提供任务编号、失败步骤和输入图片给平台排查。",
+            ],
+        };
+    }
+    if (isRateLimitErrorText(rawMessage)) {
+        return {
+            code: "RATE_LIMITED",
+            type: "business",
+            reason: "rate-limited",
+            message: `${step.step_name} 请求过于频繁，已被平台限流。`,
+            raw_message: rawMessage,
+            hint: "请稍后重试，或减少并发和连续生成次数。多图 App 建议等上一轮完成后再启动下一轮。",
+            next_steps: [
+                "等待 1-3 分钟后重试原 workflows run 命令。",
+                "如正在批量测试，请降低并发或拆分执行。",
+            ],
+        };
+    }
+    if (isMediaResourceDownloadErrorText(rawMessage)) {
+        return {
+            code: "MEDIA_RESOURCE_UNREACHABLE",
+            type: "business",
+            reason: "reference-image-unreachable",
+            message: `${step.step_name} 的参考图无法被生成服务下载。`,
+            raw_message: rawMessage,
+            hint: "请换用公网可访问的 HTTPS 图片 URL，例如上一轮生成结果 URL；如果是视频任务，也可以先去掉参考图改用文生视频。",
+            next_steps: [
+                "确认参考图 URL 在无登录、无内网环境下可直接下载。",
+                "避免把本地上传后的 DAM 签名链接直接作为视频首帧。",
+            ],
+        };
+    }
+    if (isTransientNetworkErrorText(rawMessage)) {
+        return {
+            code: "NETWORK_TRANSIENT",
+            type: "network",
+            message: `${step.step_name} 请求暂时失败。`,
+            raw_message: rawMessage,
+            hint: "网络或服务短暂不可用，可稍后重试原命令。",
+            next_steps: ["稍后重试原 workflows run 命令。"],
+        };
+    }
+    return {
+        code,
+        type: code.startsWith("HTTP_401") || /未登录|鉴权|认证|authorization/i.test(rawMessage)
+            ? "auth"
+            : "business",
+        message: `${step.step_name} 执行失败：${friendlyErrorMessage(rawMessage)}`,
+        raw_message: rawMessage,
+        hint: "可根据失败步骤单独调用对应 Tool 验证输入，也可以调整图片或 brief 后重试 App。",
+        next_steps: [
+            `单独验证该步骤：gd-cli tools call ${step.tool}`,
+            "调整输入后重试原 workflows run 命令。",
+        ],
+    };
+}
+function publicStep(step) {
+    return {
+        step_order: step.step_order,
+        step_id: step.step_id,
+        step_name: step.step_name,
+        tool: step.tool,
+        status: step.status,
+    };
+}
+function extractErrorMessage(error) {
+    if (error instanceof DirectApiError) {
+        return extractDirectApiMessage(error.body) ?? error.message;
+    }
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function extractErrorCode(error) {
+    if (error instanceof DirectApiError) {
+        const parsed = extractDirectApiCode(error.body);
+        return parsed ?? `HTTP_${error.statusCode}`;
+    }
+    return "APP_STEP_FAILED";
+}
+function extractDirectApiMessage(body) {
+    const value = objectRecord(body);
+    if (!value)
+        return typeof body === "string" && body ? body : undefined;
+    const nested = objectRecord(value.error);
+    return stringField(nested, "message") ??
+        stringField(value, "message") ??
+        stringField(value, "msg") ??
+        stringField(value, "error");
+}
+function extractDirectApiCode(body) {
+    const value = objectRecord(body);
+    if (!value)
+        return undefined;
+    const nested = objectRecord(value.error);
+    return stringField(nested, "error_code") ??
+        stringField(nested, "code") ??
+        stringField(value, "error_code") ??
+        stringField(value, "code");
+}
+function objectRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringField(value, key) {
+    const field = value?.[key];
+    return typeof field === "string" && field.trim() ? field.trim() : undefined;
+}
+function isContentSafetyError(message) {
+    return /参考图.*敏感|内容敏感|敏感内容|安全审核|审核未通过|sensitive|safety/i.test(message);
+}
+function isThirdPartyUnsupportedError(message) {
+    return /该第三方暂未支持|第三方.*暂未支持|180000011|third[- ]?party.*unsupported|provider.*unsupported/i
+        .test(message);
+}
+function isRateLimitErrorText(message) {
+    return /429|Too Many Requests|rate.?limit|请求过于频繁|限流|频率/i.test(message);
+}
+function isMediaResourceDownloadErrorText(message) {
+    return /resource download failed|image_url.*not valid|content\[\d+\]\.image_url|参考图.*下载|媒体.*下载失败|图片.*下载失败/i
+        .test(message);
+}
+function isTransientNetworkErrorText(message) {
+    return /ECONNRESET|ETIMEDOUT|ENOTFOUND|network|fetch failed|timeout|超时|HTTP status code 503|grpc-status=14|UNAVAILABLE|Service Unavailable/i
+        .test(message);
+}
+function isToolIntentRoutingError(message) {
+    return /tool-intent 没有返回 scene_code|tool-intent.*scene_code/i.test(message);
+}
+function friendlyErrorMessage(message) {
+    return extractEmbeddedBackendMessage(message) ?? message
+        .replace(/^业务 API 请求失败\s*\[[^\]]+\]\s+\S+:\s*/i, "")
+        .replace(/, /g, "，")
+        .trim();
+}
+const CATEGORY_PROFILES = [
+    {
+        id: "gift-set",
+        label: "礼盒/套装",
+        guidance: "重点表达套装层级、开箱秩序、包装质感和送礼价值。",
+        detailEvidence: "展示礼盒结构、包装材质、配件层级、内托细节和主商品识别面，所有套装物件数量准确。",
+        usageEvidence: "使用开箱、送礼、桌面陈列或节日场景证明套装价值，主商品和包装都要清晰可见。",
+    },
+    {
+        id: "digital",
+        label: "3C 数码",
+        guidance: "重点表达科技感、结构精密度、材质高光和功能可信度。",
+        detailEvidence: "展示接口、按键、镜头、声学结构、金属/塑胶材质、接缝或核心部件，避免发明不存在的内部结构。",
+        usageEvidence: "使用通勤桌面、影音娱乐、移动办公或科技舞台场景证明使用状态，产品不能变成背景小物。",
+    },
+    {
+        id: "apparel-outdoor",
+        label: "服饰/户外",
+        guidance: "重点表达面料触感、版型适配、通勤/户外使用感和穿搭氛围。",
+        detailEvidence: "展示面料纹理、缝线、拉链、扣具、透气结构、鞋底或背负系统等可见细节。",
+        usageEvidence: "使用通勤、户外、运动、旅行或衣橱穿搭场景；可用手部、背影或局部穿着动作，不使用名人正脸。",
+    },
+    {
+        id: "beauty-personal-care",
+        label: "美妆个护",
+        guidance: "重点表达质地、清爽度、仪式感和瓶身包装质感，避免医疗化和绝对功效。",
+        detailEvidence: "展示瓶身、泵头、盖子、膏体/液体质地、材质反光和包装细节，不生成假成分表。",
+        usageEvidence: "使用梳妆台、随身包、手部试用或浴室台面场景表达日常感，不生成夸张肤效和医疗承诺。",
+    },
+    {
+        id: "food-beverage",
+        label: "食品/饮品",
+        guidance: "重点表达食欲感、原料真实感、口味氛围和包装可信度。",
+        detailEvidence: "展示包装密封、原料纹理、液体质感、杯壁水珠或食材切面，避免漂浮堆满的随机原料。",
+        usageEvidence: "使用早餐、下午茶、办公桌、露营或聚会场景表达饮用/食用时刻，不暗示未经证明的健康疗效。",
+    },
+    {
+        id: "home-living",
+        label: "家居/家电",
+        guidance: "重点表达空间适配、材质、尺寸关系、真实居家光线和使用便利性。",
+        detailEvidence: "展示开关、连接件、收纳结构、灯光效果、滤芯/配件、材质表面或空间尺度。",
+        usageEvidence: "使用客厅、卧室、厨房、办公桌或玄关场景证明尺寸与用途，环境干净但不要像空素材库。",
+    },
+    {
+        id: "general",
+        label: "通用商品",
+        guidance: "优先保证产品保真、主体清楚、卖点可见和平台友好。",
+        detailEvidence: "展示材质纹理、结构边界、包装、配件或关键功能部位，证据必须来自参考商品可推断的真实信息。",
+        usageEvidence: "使用真实桌面、通勤、家居或轻生活方式场景证明商品用途，商品仍是画面主角。",
+    },
+];
+function inferProductCategoryProfile(brief) {
+    const text = brief.toLowerCase();
+    if (/礼盒|套装|组合|礼包|礼物|送礼|节日|开箱/.test(text))
+        return CATEGORY_PROFILES[0];
+    if (/耳机|手机|相机|键盘|鼠标|充电|电脑|数码|3c|智能|音箱|手表|路由|摄像|镜头/.test(text))
+        return CATEGORY_PROFILES[1];
+    if (/防晒衣|衣|服|鞋|背包|包袋|帽|户外|通勤|跑步|穿搭|面料|夹克|裤|裙/.test(text))
+        return CATEGORY_PROFILES[2];
+    if (/精华|面霜|护肤|美妆|口红|香水|洗护|个护|防晒霜|乳液|洁面|面膜/.test(text))
+        return CATEGORY_PROFILES[3];
+    if (/茶|咖啡|饮|食品|零食|酒|果汁|牛奶|奶|味|香|糕|饼|糖/.test(text))
+        return CATEGORY_PROFILES[4];
+    if (/家居|收纳|灯|空气|净化|桌面|厨房|床|椅|沙发|柜|电器|卧室|客厅/.test(text))
+        return CATEGORY_PROFILES[5];
+    return CATEGORY_PROFILES[6];
+}
+function publicCategoryProfile(profile) {
+    return {
+        id: profile.id,
+        label: profile.label,
+        guidance: profile.guidance,
+    };
+}
+function resolveCopyPlan(params, brief = "") {
+    const raw = optionalString(params.copy_mode ?? params.copyMode ?? params["copy-mode"]) ?? "auto";
+    const normalized = raw.toLowerCase().replace(/_/g, "-");
+    if (normalized === "ask") {
+        throw new Error("COPY_REQUIREMENTS_REQUIRED: 当前选择 copy-mode=ask，需要先明确每张图是否生成画内文字、主卖点和目标平台后再执行。");
+    }
+    const mode = normalized === "render-text"
+        ? "render-text"
+        : normalized === "no-text"
+            ? "no-text"
+            : normalized === "layout-copy"
+                ? "layout-copy"
+                : resolveAutoCopyMode(brief);
+    const explicitModel = optionalString(params.image_model ?? params.imageModel ?? params["image-model"] ?? params.model);
+    return {
+        mode,
+        renderText: mode === "render-text",
+        imageModel: explicitModel,
+    };
+}
+function resolveAutoCopyMode(brief) {
+    return hasNoTextIntent(brief) ? "no-text" : "render-text";
+}
+function hasNoTextIntent(brief) {
+    return /无字|无文字|不带字|不要文字|不生成文字|无字幕|不要字幕|无文案|纯视觉|后期排版|no[-\s]?text|without\s+text/i
+        .test(brief);
+}
+function copyPlanOutput(plan) {
+    return {
+        mode: plan.mode,
+        render_text: plan.renderText,
+        image_model: plan.imageModel,
+    };
+}
+function copyPlanningGuidance(plan) {
+    if (plan.mode === "render-text") {
+        return "生成可直接交付的画内短文案版本，短文案必须来自商品信息、卖点和场景，不编造价格、参数、认证或促销；";
+    }
+    if (plan.mode === "layout-copy") {
+        return "图片不直接生成文字，但必须提供后期排版所需的视觉证据、商品场景和标题/卖点空间；";
+    }
+    return "图片不生成文字，但必须用商品主体、材质、结构、动作或场景表达卖点，不能是空白底图；";
+}
+function buildOverlayCopy(role, title, brief) {
+    const point = primaryBriefPoint(brief);
+    const baseTitle = title.trim() || point;
+    if (/白底|主图/.test(role))
+        return "";
+    if (/卖点/.test(role))
+        return `${point}｜一眼看懂核心卖点`;
+    if (/细节|结构/.test(role))
+        return `细节实拍｜${point}`;
+    if (/生活|使用|场景/.test(role))
+        return `${baseTitle}｜真实使用场景`;
+    if (/痛点/.test(role))
+        return `解决痛点｜${point}`;
+    if (/对比|规格/.test(role))
+        return `规格对比｜${point}`;
+    if (/封面/.test(role))
+        return baseTitle;
+    if (/Campaign|KV/i.test(role))
+        return `${baseTitle}｜${point}`;
+    return `${baseTitle}｜${point}`;
+}
+function buildEcommerceImagePrompt(input) {
+    const copyMode = input.copyMode ?? "layout-copy";
+    const copyInstruction = buildCopyInstruction(copyMode, input.overlayCopy);
+    return [
+        `电商图片生成任务：${input.role}。`,
+        "严格参考上传图片中的商品主体，把参考图作为唯一商品真值；完整保留主体轮廓、比例、颜色、材质、Logo/标签位置、包装和配件关系，不修改、不重绘主体，只围绕主体渲染场景与氛围。",
+        `商品需求：${input.brief}`,
+        `品类策略：${input.profile.label}。${input.profile.guidance}`,
+        `商业角色：${input.commercialRole}`,
+        `可见证据：${input.visibleEvidence}`,
+        copyInstruction,
+        `构图光影：${input.composition}`,
+        `平台边界：${input.platformFit}`,
+        copyMode === "render-text"
+            ? "负面约束：除指定短文案外，不生成额外文字、水印、价格、促销徽章、认证标识或乱码包装字；指定短文案必须清晰可读、避免错字和伪字；不添加不存在的附件、颜色、SKU 或夸张功效；不出现畸形手指、错误透视、变形 Logo、无关道具和杂乱背景。"
+            : "负面约束：不生成画内文字、水印、价格、促销徽章、认证标识或乱码包装字；不添加不存在的附件、颜色、SKU 或夸张功效；不出现畸形手指、错误透视、变形 Logo、无关道具和杂乱背景。",
+        "输出要求：真实高质量商业摄影，主体清晰，缩略图可读，适合后期排版。",
+    ].join("\n");
+}
+function buildCopyInstruction(mode, copy) {
+    if (mode === "no-text") {
+        return "文案策略：生成纯视觉底图，但画面必须有清晰商品证据和用途表达，不能只是空背景或无意义留白。";
+    }
+    if (mode === "render-text" && copy) {
+        return `文案策略：在画面中准确渲染这句短文案：「${copy}」。文字必须清晰、少字、位置克制，不能新增其他文字。`;
+    }
+    if (copy) {
+        return `文案策略：不要在图里生成文字，但画面要围绕后期将要排版的短文案「${copy}」提供明确视觉证据，并预留合理标题/卖点区。`;
+    }
+    return "文案策略：不要在图里生成文字，但画面必须提供明确视觉证据和后期排版空间，不能是空白占位图。";
+}
+function resolveRoleRatios(value, defaults) {
+    const ratio = typeof value === "string" && /^\d+:\d+$/.test(value.trim())
+        ? value.trim()
+        : "";
+    if (!ratio)
+        return defaults;
+    return Object.fromEntries(Object.keys(defaults).map((key) => [key, ratio]));
+}
+function primaryBriefPoint(brief) {
+    return splitBriefPoints(brief)[0] ?? brief;
+}
+function renderTextCopyFromPrompt(prompt) {
+    const match = prompt.match(/准确渲染这句短文案：「([^」]+)」/);
+    return match?.[1]?.trim();
+}
+function extractEmbeddedBackendMessage(message) {
+    const match = message.match(/\\?"message\\?"\s*:\s*\\?"([^"\\]+)\\?"/);
+    return match?.[1]?.trim();
+}
+function fallbackGeneratePrompt(stepName, prompt) {
+    const copy = renderTextCopyFromPrompt(prompt);
+    return [
+        `电商图片生成任务：${stepName}。`,
+        "请基于参考商品图生成一张真实商业摄影风格的电商图片，商品主体清晰、形态一致、无水印、无假 logo、无乱码。",
+        copy
+            ? `画面中需要清晰渲染指定短文案「${copy}」，不得生成额外文字、假价格或假认证。`
+            : "如果原始需求没有指定画内短文案，则不生成画内文字；但画面必须有明确商品证据和场景价值，不能是空白底图。",
+        `原始需求：${prompt}`,
+    ].join("\n");
+}
+function safeGeneratePrompt(stepName, prompt) {
+    const copy = renderTextCopyFromPrompt(prompt);
+    return [
+        `电商图片生成任务：${stepName}。`,
+        "请生成安全保守的商品商业摄影图：无人物、无儿童、无敏感文字、无商标水印、无医疗政治元素、无暴露内容。",
+        copy
+            ? `商品主体清晰，使用干净桌面、自然光、纯色背景或简单生活道具，只渲染指定短文案「${copy}」，不生成额外文字。`
+            : "商品主体清晰，使用干净桌面、自然光、纯色背景或简单生活道具；不生成画内文字，但不能是空白占位图。",
+        `原始需求：${prompt}`,
+    ].join("\n");
+}
+function splitBriefPoints(brief) {
+    const points = brief
+        .split(/[，,。；;、\n]+/g)
+        .map(normalizeBriefPoint)
+        .filter((item) => item && !isWorkflowOnlyBriefPoint(item));
+    return [...new Set(points)].slice(0, 6);
+}
+function normalizeBriefPoint(value) {
+    return value
+        .trim()
+        .replace(/^(?:天猫\/京东上架素材包|淘宝上架素材|商品图库素材包|详情页\/A\+模块|详情页模块|小红书[^：:]*种草|Campaign\s*KV|[^：:]{0,16}Campaign)[：:]\s*/i, "")
+        .trim();
+}
+function isWorkflowOnlyBriefPoint(value) {
+    return /^(?:需要)?(?:白底主图|核心卖点证明图|结构细节图|桌面使用场景图|官网横版|社媒方图|电商竖图|多渠道投放|素材包|详情页模块)$/i
+        .test(value);
+}
+function parseRatioList(value, fallback) {
+    const raw = typeof value === "string" ? value : "";
+    const ratios = raw
+        .split(/[,\s，、]+/g)
+        .map((item) => item.trim())
+        .filter((item) => /^\d+:\d+$/.test(item));
+    return ratios.length > 0 ? [...new Set(ratios)].slice(0, 4) : fallback;
+}
+function slugKey(value) {
+    return value.replace(/[^a-zA-Z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "asset";
+}
+function buildSummary(sections) {
+    return sections
+        .filter(([, body]) => body.trim())
+        .map(([title, body]) => `## ${title}\n${body.trim()}`)
+        .join("\n\n");
+}
+function buildListingGalleryCopy(title, brief) {
+    const points = splitBriefPoints(brief);
+    return [
+        `标题：${title}`,
+        "",
+        "图库结构：",
+        "- 白底主图：看清商品主体、颜色、形态和核心配件。",
+        "- 卖点图：只回答一个购买问题，后期可加一句卖点文案。",
+        "- 细节图：证明材质、结构、工艺或关键功能。",
+        "- 生活方式图：让用户知道商品怎么用、适合谁、在什么场景使用。",
+        "",
+        "卖点拆解：",
+        ...(points.length ? points.map((point) => `- ${point}`) : [`- ${brief}`]),
+        "",
+        "上线检查：主体保真、无假字假认证、缩略图仍能看清商品。",
+    ].join("\n");
+}
+function buildPdpModuleCopy(title, brief) {
+    const points = splitBriefPoints(brief);
+    return [
+        `标题：${title}`,
+        "",
+        "详情页模块顺序：",
+        "1. 首屏模块：先给出核心利益点和商品全貌。",
+        "2. 痛点模块：解释用户为什么需要它。",
+        "3. 结构细节模块：用可见结构证明功能，不编造参数。",
+        "4. 使用场景模块：展示真实操作和生活环境。",
+        "5. 对比规格模块：留给后期添加参数、尺寸、适配信息。",
+        "",
+        "可展开卖点：",
+        ...(points.length ? points.map((point) => `- ${point}`) : [`- ${brief}`]),
+        "",
+        "上线检查：参数后期排版，AI 图不生成假认证、假数字和医疗化表述。",
+    ].join("\n");
+}
+function buildXhsCaption(title, brief) {
+    const points = splitBriefPoints(brief);
+    const highlights = points.length > 0
+        ? points.map((point) => `- ${point}`).join("\n")
+        : `- ${brief}`;
+    return [
+        title,
+        "",
+        "最近试到一个很适合日常分享的好物，第一眼不是硬广感，而是能看出真实使用场景。",
+        "它的重点不是堆参数，而是把用户真正关心的细节讲清楚：好不好用、适不适合日常、是不是值得入手。",
+        "",
+        "种草点：",
+        highlights,
+        "",
+        "#好物分享 #小红书种草 #日常好物 #真实使用感",
+    ].join("\n");
+}
+function buildCampaignCopy(title, brief, ratios) {
+    return [
+        `Campaign 标题：${title}`,
+        "",
+        "核心利益点：",
+        ...splitBriefPoints(brief).map((point) => `- ${point}`),
+        "",
+        "渠道裁切建议：",
+        ...ratios.map((ratio) => `- ${ratio}：保留商品为视觉锚点，文字、价格和活动利益点后期排版。`),
+        "",
+        "上线检查：KV 保持无字版本，确认横版、方图、竖图裁切后商品仍清楚。",
+    ].join("\n");
+}
+function requireString(value, message) {
+    const normalized = typeof value === "string" ? value.trim() : "";
+    if (!normalized)
+        throw new Error(message);
+    return normalized;
+}
+function optionalString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim();
+    return normalized ? normalized : undefined;
+}
+function allowSensitivePath(params) {
+    return (params.allow_sensitive_path === true ||
+        params.allowSensitivePath === true ||
+        params["allow-sensitive-path"] === true);
+}
+function outputString(result, key, required = true) {
+    const outputs = result.outputs;
+    const value = outputs?.[key];
+    if (typeof value === "string" && value.trim())
+        return value;
+    if (required) {
+        throw new Error(`App workflow 缺少上游输出字段: ${key}`);
+    }
+    return "";
+}