gaoding-cli 1.0.0-alpha.5

package/dist/src/middleware/output.js

@@ -0,0 +1,546 @@
+import Table from "cli-table3";
+import chalk from "chalk";
+import { capabilityMetadata, statusLabel, } from "../utils/capability-metadata.js";
+import { isDebug, isVerbose } from "../utils/config.js";
+export function formatOutput(data, format = "json", humanCtx) {
+    switch (format) {
+        case "json":
+            console.log(JSON.stringify(data, null, 2));
+            break;
+        case "human":
+            printHumanTaskResult(data, humanCtx);
+            break;
+        case "text":
+        case "pretty":
+            printPretty(data);
+            break;
+        case "table":
+            printTable(data);
+            break;
+        default:
+            console.log(JSON.stringify(data, null, 2));
+    }
+}
+/** TTY 默认：展示任务/工具结果中的链接与交付物说明，非原始 JSON */
+export function printHumanTaskResult(data, ctx) {
+    if (typeof data !== "object" || data === null) {
+        console.log(String(data));
+        return;
+    }
+    const r = data;
+    const status = String(r.status ?? "");
+    const taskId = r.task_id != null ? String(r.task_id) : "";
+    const label = ctx?.activityLabel?.trim();
+    if (status === "failed") {
+        printFailedTaskResult(r, ctx, label, taskId);
+        return;
+    }
+    if (status === "submitted" ||
+        status === "running" ||
+        status === "pending") {
+        console.log(chalk.cyan(label ? `\n⏳ ${label} · 进行中` : "\n⏳ 任务进行中"));
+        if (taskId)
+            console.log(`  任务 ID: ${taskId}`);
+        if (r.message)
+            console.log(`  ${String(r.message)}`);
+        if (taskId) {
+            console.log(chalk.dim(`  任务 ID: ${taskId}`));
+        }
+        console.log("");
+        return;
+    }
+    if (status === "completed" && r.outputs != null) {
+        if (label) {
+            console.log(chalk.green(`\n── ${label} · 结果 ──\n`));
+        }
+        else {
+            console.log(chalk.green("\n✓ 已完成\n"));
+        }
+        printOutputsDeliverables(r.outputs, ctx);
+        const zipPath = typeof r.deliverable_zip === "string" ? r.deliverable_zip.trim() : "";
+        if (zipPath) {
+            const who = label ? `「${label}」` : "本次";
+            console.log(chalk.green(`\n📦 此次${who}交付物已打包：${zipPath}\n   可直接下载使用（内含 Markdown 与各步骤图片）。`));
+        }
+        if (taskId) {
+            console.log(chalk.dim(`\n  任务编号（排错时可提供）: ${taskId}`));
+        }
+        console.log("");
+        return;
+    }
+    if (printAgentSkillResult(r))
+        return;
+    // 注册表详情、列表包装等
+    if (r.tasks != null && Array.isArray(r.tasks)) {
+        printPretty(data);
+        return;
+    }
+    printPretty(data);
+}
+function printFailedTaskResult(r, ctx, label, taskId) {
+    console.log(chalk.red(label ? `\n✗ ${label} · 处理失败` : "\n✗ 任务失败"));
+    const err = objectRecord(r.error);
+    const outputs = objectRecord(r.outputs);
+    const failedStep = objectRecord(err?.step) ?? objectRecord(outputs?.failed_step);
+    const message = stringField(err, "message") ??
+        (r.error == null ? "" : String(r.error)) ??
+        "任务执行失败";
+    console.log(`  ${message}`);
+    if (failedStep) {
+        const order = stringField(failedStep, "step_order");
+        const stepName = stringField(failedStep, "step_name") ?? "未知步骤";
+        const tool = stringField(failedStep, "tool");
+        const prefix = order ? `${order}. ` : "";
+        console.log(`  失败步骤: ${prefix}${stepName}${tool ? `（${tool}）` : ""}`);
+    }
+    const reason = stringField(err, "reason");
+    if (reason)
+        console.log(`  原因: ${reason}`);
+    const hint = stringField(err, "hint");
+    if (hint)
+        console.log(chalk.yellow(`\n  建议: ${hint}`));
+    const nextSteps = Array.isArray(err?.next_steps)
+        ? err.next_steps.map(String).filter(Boolean)
+        : [];
+    if (nextSteps.length > 0) {
+        console.log(chalk.bold("\n  下一步"));
+        for (const item of nextSteps)
+            console.log(`  - ${item}`);
+    }
+    const completedSteps = Array.isArray(outputs?.completed_steps)
+        ? outputs.completed_steps.map(objectRecord).filter((item) => !!item)
+        : [];
+    if (completedSteps.length > 0) {
+        console.log(chalk.bold("\n  已完成步骤"));
+        for (const step of completedSteps) {
+            const order = stringField(step, "step_order");
+            const name = stringField(step, "step_name") ?? "";
+            const tool = stringField(step, "tool");
+            console.log(`  - ${order ? `${order}. ` : ""}${name}${tool ? `（${tool}）` : ""}`);
+        }
+    }
+    if (outputs) {
+        const assets = collectSemanticAssets(outputs);
+        const textBlocks = collectTextBlocks(outputs);
+        if (assets.length > 0 || textBlocks.length > 0) {
+            console.log(chalk.bold("\n  已生成内容"));
+            printOutputsDeliverables(outputs, ctx);
+        }
+    }
+    const rawMessage = stringField(err, "raw_message");
+    if ((isVerbose() || isDebug()) && rawMessage && rawMessage !== message) {
+        console.log(chalk.dim(`\n  原始错误: ${rawMessage}`));
+    }
+    if (taskId)
+        console.log(chalk.dim(`\n  任务编号（排错时可提供）: ${taskId}`));
+    console.log("");
+}
+function guessMediaKind(url, mime) {
+    const m = String(mime ?? "").toLowerCase();
+    if (m.startsWith("video/"))
+        return "video";
+    if (m.startsWith("image/"))
+        return "image";
+    const u = url.split("?")[0].toLowerCase();
+    if (/\.(mp4|webm|mov|mkv)$/.test(u))
+        return "video";
+    if (/\.(png|jpe?g|gif|webp|svg)$/.test(u))
+        return "image";
+    return "file";
+}
+function labelForKind(k) {
+    if (k === "image")
+        return "图片";
+    if (k === "video")
+        return "视频";
+    return "文件";
+}
+function extractUrlsDeep(val, acc) {
+    if (val == null)
+        return;
+    if (typeof val === "string" && /^https?:\/\//.test(val)) {
+        acc.add(val);
+        return;
+    }
+    if (Array.isArray(val)) {
+        for (const x of val)
+            extractUrlsDeep(x, acc);
+        return;
+    }
+    if (typeof val === "object") {
+        const o = val;
+        for (const k of ["url", "uri"]) {
+            const v = o[k];
+            if (typeof v === "string" && /^https?:\/\//.test(v))
+                acc.add(v);
+        }
+        for (const v of Object.values(o))
+            extractUrlsDeep(v, acc);
+    }
+}
+function orderedUrls(outputs) {
+    const set = new Set();
+    extractUrlsDeep(outputs, set);
+    const all = [...set];
+    if (typeof outputs === "object" &&
+        outputs !== null &&
+        !Array.isArray(outputs)) {
+        const o = outputs;
+        if (typeof o.url === "string" && all.includes(o.url)) {
+            return [o.url, ...all.filter((u) => u !== o.url)];
+        }
+    }
+    return all;
+}
+function assetLabelFromKey(key) {
+    const normalized = key.toLowerCase();
+    const map = {
+        product: "原始商品图 / CDN 素材",
+        source: "原始素材",
+        input: "输入素材",
+        cutout: "抠图后图片",
+        matting: "抠图后图片",
+        hero: "生成主图",
+        scene: "生成场景图",
+        title: "标题文案",
+        prompt: "提示词",
+        video: "生成视频",
+        uploaded: "上传后的素材",
+    };
+    return map[normalized] ?? key;
+}
+function normalizeSemanticAsset(item, fallbackLabel) {
+    if (!item || typeof item !== "object")
+        return null;
+    const o = item;
+    const url = typeof o.url === "string" && /^https?:\/\//.test(o.url) ? o.url : "";
+    if (!url)
+        return null;
+    const type = o.type === "image" || o.type === "video" || o.type === "file"
+        ? o.type
+        : guessMediaKind(url, o.mime_type);
+    return {
+        label: typeof o.label === "string" && o.label.trim() ? o.label.trim() : fallbackLabel,
+        role: typeof o.role === "string" ? o.role : undefined,
+        url,
+        type,
+    };
+}
+function collectSemanticAssets(outputs) {
+    if (!outputs || typeof outputs !== "object" || Array.isArray(outputs))
+        return [];
+    const o = outputs;
+    const out = [];
+    const seen = new Set();
+    const push = (asset) => {
+        if (!asset || seen.has(asset.url))
+            return;
+        seen.add(asset.url);
+        out.push(asset);
+    };
+    const explicitAssets = o.assets;
+    if (Array.isArray(explicitAssets)) {
+        for (const item of explicitAssets) {
+            push(normalizeSemanticAsset(item, "资源"));
+        }
+        if (out.length)
+            return out;
+    }
+    for (const [key, value] of Object.entries(o)) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            continue;
+        const asset = normalizeSemanticAsset(value, assetLabelFromKey(key));
+        if (asset)
+            push(asset);
+    }
+    if (out.length)
+        return out;
+    if (typeof o.url === "string" && /^https?:\/\//.test(o.url)) {
+        push({
+            label: assetLabelFromKey(String(o.role ?? "结果")),
+            url: o.url,
+            type: guessMediaKind(o.url, o.mime_type),
+        });
+    }
+    return out;
+}
+function collectTextBlocks(outputs) {
+    if (!outputs || typeof outputs !== "object" || Array.isArray(outputs))
+        return [];
+    const o = outputs;
+    const blocks = [];
+    const push = (label, value) => {
+        if (typeof value !== "string")
+            return;
+        const text = value.trim();
+        if (!text)
+            return;
+        blocks.push({ label, text });
+    };
+    push("标题", o.title_text);
+    push("小红书种草文案", o.xhs_caption);
+    push("交付说明", o.delivery_copy);
+    push("文案模式", formatObjectText(o.copy_plan));
+    push("图上/后期文案建议", formatObjectText(o.overlay_copy));
+    if (blocks.length === 0) {
+        push("文案与说明", o.text);
+    }
+    return blocks;
+}
+function formatObjectText(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const entries = Object.entries(value)
+        .filter(([, item]) => item !== undefined && item !== null && String(item).trim())
+        .map(([key, item]) => `- ${key}: ${String(item)}`);
+    return entries.length > 0 ? entries.join("\n") : undefined;
+}
+function printTextBlocks(blocks) {
+    if (blocks.length === 0)
+        return;
+    console.log(chalk.bold("\n  文案\n"));
+    for (const block of blocks) {
+        console.log(`  【${block.label}】`);
+        for (const line of block.text.split("\n")) {
+            console.log(`  ${line}`);
+        }
+        console.log("");
+    }
+}
+function printOutputsDeliverables(outputs, ctx) {
+    const assets = collectSemanticAssets(outputs);
+    const textBlocks = collectTextBlocks(outputs);
+    if (assets.length > 0) {
+        const hint = ctx?.activityLabel
+            ? "  本次生成的资源如下：\n"
+            : "  交付物（链接可复制到浏览器打开）\n";
+        console.log(chalk.bold(hint));
+        for (const asset of assets) {
+            const k = asset.type ?? guessMediaKind(asset.url, undefined);
+            console.log(`  【${asset.label || labelForKind(k)}】`);
+            console.log(`  ${labelForKind(k)}链接：${asset.url}\n`);
+        }
+        printTextBlocks(textBlocks);
+        return;
+    }
+    const urls = orderedUrls(outputs);
+    if (urls.length === 0) {
+        if (textBlocks.length > 0) {
+            printTextBlocks(textBlocks);
+            return;
+        }
+        if (typeof outputs === "object" && outputs !== null) {
+            console.log(`  ${JSON.stringify(outputs, null, 2)}`);
+        }
+        else {
+            console.log(`  ${String(outputs)}`);
+        }
+        return;
+    }
+    const hint = ctx?.activityLabel
+        ? "  在浏览器中打开下方链接即可查看或下载：\n"
+        : "  交付物（链接可复制到浏览器打开）\n";
+    console.log(chalk.bold(hint));
+    for (const u of urls) {
+        const k = guessMediaKind(u, undefined);
+        console.log(`  【${labelForKind(k)}】`);
+        console.log(`  ${u}\n`);
+    }
+    printTextBlocks(textBlocks);
+}
+function printPretty(data) {
+    const printable = stripCapabilityMetadataForHuman(data);
+    if (Array.isArray(printable)) {
+        if (printable.length === 0) {
+            console.log("(empty)");
+            return;
+        }
+        const first = printable[0];
+        if (typeof first === "object" && first !== null && !Array.isArray(first)) {
+            const keys = Object.keys(first);
+            for (const row of printable) {
+                console.log(keys.map((k) => `${k}: ${row[k] ?? ""}`).join("    "));
+            }
+            return;
+        }
+    }
+    if (typeof printable !== "object" || printable === null) {
+        console.log(String(printable));
+        return;
+    }
+    const obj = printable;
+    const maxKeyLen = Math.max(...Object.keys(obj).map((k) => k.length));
+    for (const [key, value] of Object.entries(obj)) {
+        const label = key.padEnd(maxKeyLen);
+        if (Array.isArray(value)) {
+            console.log(`  ${label}  ${value.length} items`);
+            for (const item of value) {
+                console.log(`    - ${JSON.stringify(item)}`);
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            console.log(`  ${label}  ${JSON.stringify(value)}`);
+        }
+        else {
+            console.log(`  ${label}  ${String(value)}`);
+        }
+    }
+}
+const CAPABILITY_HUMAN_HIDDEN_KEYS = new Set([
+    "source",
+    "status",
+    "policy",
+]);
+function stripCapabilityMetadataForHuman(value) {
+    if (Array.isArray(value))
+        return value.map(stripCapabilityMetadataForHuman);
+    if (!value || typeof value !== "object")
+        return value;
+    const obj = value;
+    const isCapabilityMetadataCarrier = typeof obj.source === "string" &&
+        typeof obj.status === "string" &&
+        typeof obj.policy === "string";
+    const out = {};
+    for (const [key, child] of Object.entries(obj)) {
+        if (isCapabilityMetadataCarrier && CAPABILITY_HUMAN_HIDDEN_KEYS.has(key)) {
+            continue;
+        }
+        out[key] = stripCapabilityMetadataForHuman(child);
+    }
+    return out;
+}
+function printAgentSkillResult(r) {
+    if (r.skill !== "gd-cli" || !Array.isArray(r.targets))
+        return false;
+    const targets = r.targets
+        .map(objectRecord)
+        .filter((target) => !!target);
+    const changed = r.changed === true;
+    console.log(chalk.bold("\ngd-cli Agent Skill\n"));
+    for (const target of targets) {
+        const agent = String(target.agent ?? "");
+        const status = agentSkillStatusLabel(String(target.status ?? ""));
+        const mode = typeof target.mode === "string" ? ` · ${target.mode}` : "";
+        const changedLabel = target.changed === true ? " · 已变更" : "";
+        console.log(`  ${agent}: ${status}${mode}${changedLabel}`);
+        console.log(chalk.dim(`    ${String(target.path ?? "")}`));
+        if (target.reason)
+            console.log(chalk.yellow(`    ${String(target.reason)}`));
+    }
+    if (targets.length === 0)
+        console.log("  无需变更");
+    console.log(changed
+        ? chalk.green("\nAgent Skill 文件已变更。")
+        : chalk.dim("\nAgent Skill 文件没有变化。"));
+    if (r.restart_required === true) {
+        console.log("请重启 Agent 或开启新会话以加载最新 Skill。\n");
+    }
+    else {
+        console.log("");
+    }
+    return true;
+}
+function agentSkillStatusLabel(status) {
+    const labels = {
+        installed: "已安装",
+        outdated: "需更新",
+        missing: "未安装",
+        broken: "链接损坏",
+        conflict: "路径冲突",
+    };
+    return labels[status] ?? status;
+}
+function objectRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringField(value, key) {
+    const field = value?.[key];
+    if (typeof field === "number" && Number.isFinite(field))
+        return String(field);
+    return typeof field === "string" && field.trim() ? field.trim() : undefined;
+}
+const TABLE_DESC_MAX = 72;
+function truncateCell(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max - 1)}…`;
+}
+function printTable(data) {
+    if (!Array.isArray(data)) {
+        printPretty(data);
+        return;
+    }
+    if (data.length === 0) {
+        console.log("(empty)");
+        return;
+    }
+    const keys = Object.keys(data[0]);
+    const table = new Table({ head: keys });
+    for (const row of data) {
+        const r = row;
+        table.push(keys.map((k) => {
+            const v = r[k];
+            const cell = v === null || v === undefined
+                ? ""
+                : typeof v === "object"
+                    ? JSON.stringify(v)
+                    : String(v);
+            const key = k.toLowerCase();
+            if (key === "description" || key === "desc" || k === "描述") {
+                return truncateCell(cell, TABLE_DESC_MAX);
+            }
+            return cell;
+        }));
+    }
+    console.log(table.toString());
+}
+/** 工具列表：扁平列，避免把整份 spec 打进表格 */
+export function rowsForToolList(items) {
+    return items.map((item) => {
+        const i = item;
+        const spec = i.spec;
+        const id = String(i.id ?? i.name ?? spec?.name ?? "");
+        const desc = String(i.description ?? spec?.description ?? "");
+        const meta = capabilityMetadata("tool", id);
+        return {
+            id,
+            名称: String(i.display_name ?? i.name ?? spec?.display_name ?? ""),
+            分类: String(i.category ?? spec?.category ?? ""),
+            状态: statusLabel(i.status ?? meta.status),
+            描述: desc,
+        };
+    });
+}
+/** 应用列表 */
+export function rowsForAppList(items) {
+    return items.map((item) => {
+        const i = item;
+        const spec = i.spec;
+        const id = String(i.id ?? spec?.id ?? "");
+        const desc = String(i.description ?? spec?.description ?? "");
+        const meta = capabilityMetadata("app", id);
+        return {
+            id,
+            名称: String(i.display_name ?? i.name ?? spec?.name ?? ""),
+            分类: String(i.category ?? spec?.category ?? ""),
+            状态: statusLabel(i.status ?? meta.status),
+            描述: desc,
+        };
+    });
+}
+/** 搜索结果（Tool + App 混合） */
+export function rowsForSearchList(items) {
+    return items.map((item) => {
+        const i = item;
+        const spec = i.spec;
+        const desc = String(i.description ?? spec?.description ?? "");
+        return {
+            id: String(i.id ?? ""),
+            type: String(i.type ?? ""),
+            name: String(i.display_name ?? spec?.display_name ?? spec?.name ?? ""),
+            description: desc,
+        };
+    });
+}

package/dist/src/models/model-catalog.d.ts

@@ -0,0 +1,26 @@
+export type ModelType = "image" | "video";
+export type ModelCostLevel = "低" | "中" | "高";
+export interface ModelCatalogEntry {
+    type: ModelType;
+    name: string;
+    code: string;
+    description: string;
+    cost_level: ModelCostLevel;
+    aliases?: string[];
+}
+export interface PublicModelEntry {
+    name: string;
+    code: string;
+    description: string;
+    cost_level: ModelCostLevel;
+}
+export declare function parseModelType(value: unknown): ModelType;
+export declare function listModels(type: ModelType): PublicModelEntry[];
+export declare function modelEntriesForType(type: ModelType): ModelCatalogEntry[];
+export declare function getDefaultModelOrder(type: ModelType): string[];
+export declare function getConfiguredModel(type: ModelType): string;
+export declare function setConfiguredModel(type: ModelType, model: string): string;
+export declare function resolveModelOrder(type: ModelType, explicitModel?: string): string[];
+export declare function resolveModelEntry(type: ModelType, value: string): ModelCatalogEntry;
+export declare function publicModelByCode(type: ModelType, code: string): PublicModelEntry | undefined;
+export declare function toPublicModelEntry(entry: ModelCatalogEntry): PublicModelEntry;