gaoding-cli 1.0.0-alpha.5

package/dist/src/models/model-catalog.js

@@ -0,0 +1,216 @@
+import { readSettings, writeSettings } from "../utils/settings-store.js";
+const IMAGE_MODELS = [
+    {
+        type: "image",
+        name: "智能图像",
+        code: "general",
+        description: "高画质｜40+风格",
+        cost_level: "低",
+        aliases: ["smart", "general-image"],
+    },
+    {
+        type: "image",
+        name: "万相 2.7",
+        code: "Wan27-image",
+        description: "印刷级文字渲染",
+        cost_level: "低",
+        aliases: ["wan-image", "text-render"],
+    },
+    {
+        type: "image",
+        name: "灵动图像 2.0",
+        code: "vivi-image-2-0",
+        description: "极致可控的编辑模型丨高质量",
+        cost_level: "低",
+        aliases: ["vivi", "edit", "gpt-edit"],
+    },
+    {
+        type: "image",
+        name: "全能图像 2.0 Flash",
+        code: "omni-image-2-0-flash",
+        description: "超强长文本理解",
+        cost_level: "低",
+        aliases: ["fast", "omni-flash"],
+    },
+    {
+        type: "image",
+        name: "全能图像 2.0",
+        code: "omni-image-2-0",
+        description: "多角色细节控制",
+        cost_level: "低",
+        aliases: ["omni", "nano2"],
+    },
+    {
+        type: "image",
+        name: "Seedream 5.0 Lite",
+        code: "Seedream-5-0-lite",
+        description: "即梦5.0 lite",
+        cost_level: "低",
+        aliases: ["seedream", "seedream-lite"],
+    },
+    {
+        type: "image",
+        name: "千问 Image 2.0 Pro",
+        code: "Qwen-image-2-0-Pro",
+        description: "图文/图表/PPT直出",
+        cost_level: "低",
+        aliases: ["qwen-pro", "doc-chart"],
+    },
+    {
+        type: "image",
+        name: "千问 Image 2.0",
+        code: "Qwen-image-2-0",
+        description: "超长文本渲染",
+        cost_level: "低",
+        aliases: ["qwen"],
+    },
+];
+const VIDEO_MODELS = [
+    {
+        type: "video",
+        name: "Seedance 2.0 Fast",
+        code: "OmniVideo-2-0-Fast",
+        description: "极速全能模型丨支持真人人脸",
+        cost_level: "高",
+        aliases: ["seedance-fast", "seedance"],
+    },
+    {
+        type: "video",
+        name: "万相 2.7",
+        code: "Wan27",
+        description: "阿里全能模型丨超强控制能力",
+        cost_level: "中",
+        aliases: ["wan-video", "wan27"],
+    },
+    {
+        type: "video",
+        name: "万相 2.6",
+        code: "Wan26",
+        description: "多角色互动丨连贯的叙事视频",
+        cost_level: "低",
+        aliases: ["wan26"],
+    },
+    {
+        type: "video",
+        name: "Happy horse 1.0",
+        code: "happy-horse-10",
+        description: "主体动作控制流畅丨极速模型",
+        cost_level: "高",
+        aliases: ["happy-horse", "happy"],
+    },
+    {
+        type: "video",
+        name: "可灵 3.0",
+        code: "Kling30",
+        description: "智能分镜视频丨转场流畅",
+        cost_level: "中",
+        aliases: ["kling", "kling30"],
+    },
+    {
+        type: "video",
+        name: "可灵 O3",
+        code: "KlingO3",
+        description: "更强的主体/场景一致性控制",
+        cost_level: "低",
+        aliases: ["kling-o3"],
+    },
+    {
+        type: "video",
+        name: "Vidu Q3",
+        code: "ViduQ3",
+        description: "专业动画制作丨画风控制稳定",
+        cost_level: "高",
+        aliases: ["vidu"],
+    },
+    {
+        type: "video",
+        name: "Vidu Q3 Turbo",
+        code: "ViduQ3Turbo",
+        description: "专业动画制作丨极速模型",
+        cost_level: "中",
+        aliases: ["vidu-turbo"],
+    },
+];
+export function parseModelType(value) {
+    const normalized = typeof value === "string" ? value.trim().toLowerCase() : "";
+    if (normalized === "image" || normalized === "video")
+        return normalized;
+    throw new Error("请传 --type image 或 --type video");
+}
+export function listModels(type) {
+    return entriesForType(type).map(toPublicModelEntry);
+}
+export function modelEntriesForType(type) {
+    return [...entriesForType(type)];
+}
+export function getDefaultModelOrder(type) {
+    return modelEntriesForType(type).map((model) => model.code);
+}
+export function getConfiguredModel(type) {
+    const configured = readSettings().models?.[type];
+    return configured && configured.trim() ? configured : "auto";
+}
+export function setConfiguredModel(type, model) {
+    const normalized = normalizeConfiguredModel(type, model);
+    const settings = readSettings();
+    writeSettings({
+        ...settings,
+        models: {
+            ...(settings.models ?? {}),
+            [type]: normalized,
+        },
+    });
+    return normalized;
+}
+export function resolveModelOrder(type, explicitModel) {
+    const explicit = normalizeOptionalModelValue(explicitModel);
+    const selected = explicit ?? getConfiguredModel(type);
+    if (!selected || selected === "auto")
+        return getDefaultModelOrder(type);
+    const entry = resolveModelEntry(type, selected);
+    return uniqueStrings([entry.code, ...getDefaultModelOrder(type)]);
+}
+export function resolveModelEntry(type, value) {
+    const normalized = normalizeModelLookup(value);
+    const entry = entriesForType(type).find((item) => {
+        const aliases = item.aliases ?? [];
+        return [item.code, item.name, ...aliases].some((candidate) => normalizeModelLookup(candidate) === normalized);
+    });
+    if (!entry) {
+        throw new Error(`未找到${type === "image" ? "图像" : "视频"}模型: ${value}。请检查模型 code / 名称，或使用 auto 由平台返回顺序执行。`);
+    }
+    return entry;
+}
+export function publicModelByCode(type, code) {
+    const entry = entriesForType(type).find((item) => item.code === code);
+    return entry ? toPublicModelEntry(entry) : undefined;
+}
+export function toPublicModelEntry(entry) {
+    return {
+        name: entry.name,
+        code: entry.code,
+        description: entry.description,
+        cost_level: entry.cost_level,
+    };
+}
+function normalizeConfiguredModel(type, value) {
+    const normalized = normalizeOptionalModelValue(value);
+    if (!normalized || normalized === "auto")
+        return "auto";
+    return resolveModelEntry(type, normalized).code;
+}
+function normalizeOptionalModelValue(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function entriesForType(type) {
+    return type === "image" ? IMAGE_MODELS : VIDEO_MODELS;
+}
+function normalizeModelLookup(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, "");
+}
+function uniqueStrings(values) {
+    return [...new Set(values.filter(Boolean))];
+}

package/dist/src/program.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function createProgram(): Promise<Command>;

package/dist/src/program.js

@@ -0,0 +1,152 @@
+import { Command, Option } from "commander";
+import { CLI_VERSION } from "./utils/config.js";
+import { registerAuthCommand } from "./commands/auth.js";
+import { registerOrgCommand } from "./commands/org.js";
+import { registerWorkflowsCommand } from "./commands/workflows.js";
+import { registerToolsCommand } from "./commands/tools.js";
+import { registerDamCommand } from "./commands/dam.js";
+import { registerModelsCommand } from "./commands/models.js";
+import { registerUpdateCommand } from "./commands/update.js";
+import { registerSkillsCommand } from "./commands/skills.js";
+import { registerUsageCommand } from "./commands/usage.js";
+import { maybeNotifyUpdate } from "./update/notifier.js";
+import { formatOutput } from "./middleware/output.js";
+import { buildManifest, buildTopExamples, rowsForManifest, } from "./registry/agent-contracts.js";
+import { resolveListOutputFormat } from "./utils/list-output-format.js";
+import { setStaticHelp } from "./utils/static-help.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);
+    program
+        .command("manifest")
+        .description("输出 Agent 可解析的 gd-cli 能力清单")
+        .action((_opts, command) => {
+        const manifest = buildManifest("all");
+        const format = resolveListOutputFormat(command);
+        formatOutput(format === "json" ? manifest : rowsForManifest(manifest), format);
+    });
+    program
+        .command("examples")
+        .description("查看常用场景示例")
+        .action((_opts, command) => {
+        const examples = buildTopExamples();
+        const format = resolveExplicitExamplesFormat(command);
+        if (format === "json") {
+            formatOutput(examples, "json");
+        }
+        else {
+            printExamples(examples);
+        }
+    });
+    const agent = program
+        .command("agent", { hidden: true })
+        .description("Agent 调用 gd-cli 的机器可读入口说明")
+        .action(() => {
+        console.log(AGENT_HELP.trim());
+    });
+    agent.addHelpText("afterAll", `\n${AGENT_HELP}`);
+    registerAuthCommand(program);
+    registerOrgCommand(program);
+    registerWorkflowsCommand(program);
+    registerToolsCommand(program);
+    registerSkillsCommand(program);
+    registerModelsCommand(program);
+    registerDamCommand(program);
+    registerUpdateCommand(program);
+    registerUsageCommand(program);
+    program.hook("postAction", async (_thisCommand, actionCommand) => {
+        await maybeNotifyUpdate(actionCommand);
+    });
+    return program;
+}
+const TOP_LEVEL_HELP = `
+Usage: gd-cli <command> [options]
+
+GD CLI — 让稿定成为 Agent 的创意生产引擎
+
+核心命令:
+  auth      登录、退出、查看登录状态
+  org       查看和切换当前组织
+  workflows 运行完整创意场景任务，例如商品上新、批量海报、内容矩阵
+  tools     调用单项 AI 创意能力，例如生图、抠图、高清化、标题生成
+  skills    安装和管理 gd-cli Agent Skill
+  dam       素材管理，上传、查询、删除素材
+  update    检查并升级 gd-cli
+
+常用流程:
+  gd-cli auth login                         登录稿定账号
+  gd-cli org list                           查看可用组织
+  gd-cli org switch                         切换当前组织
+  gd-cli workflows ls                       查看完整创意场景
+  gd-cli tools ls                           查看单项 AI 创意能力
+  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
+
+更多:
+  gd-cli examples        查看常用场景示例
+  gd-cli manifest        可解析的能力清单
+`;
+const AGENT_HELP = `
+Agent 推荐入口:
+  gd-cli manifest --format json             读取完整能力清单
+  gd-cli workflows manifest --format json   读取 Workflows 清单
+  gd-cli tools manifest --format json       读取 Tools 清单
+  gd-cli workflows schema <workflow-id> --format json 查看 Workflow 输入/输出结构
+  gd-cli tools schema <tool-id> --format json 查看 Tool 输入/输出结构
+
+调用规则:
+  1. 优先用 --format json 或 --json。
+  2. 复杂输入用 --input <json-file> 或 stdin: cat input.json | gd-cli tools call <tool-id> - --json。
+  3. 完整业务场景优先选 workflows；单项能力选 tools；素材复用选 dam。
+  4. Agent 不切换模型、环境或组织；这些由 CLI 配置和用户显式命令管理。
+`;
+function resolveExplicitExamplesFormat(command) {
+    const root = command.parent;
+    const opts = (root?.opts() ?? {});
+    if (opts.json)
+        return "json";
+    const source = root?.getOptionValueSource("format");
+    return source && source !== "default" && source !== "implied"
+        ? opts.format ?? "human"
+        : "human";
+}
+function printExamples(payload) {
+    const examples = Array.isArray(payload.examples) ? payload.examples : [];
+    console.log("常用场景示例\n");
+    examples.forEach((item, index) => {
+        const record = item;
+        console.log(`${index + 1}. ${String(record.title ?? "")}`);
+        const description = record.description;
+        if (typeof description === "string" && description.trim()) {
+            console.log(`   ${description.trim()}`);
+        }
+        console.log("");
+        console.log(`   ${String(record.command ?? "")}`);
+        const input = record.input_json;
+        if (input && typeof input === "object" && Object.keys(input).length > 0) {
+            console.log("");
+            console.log("   input_json:");
+            for (const [key, value] of Object.entries(input)) {
+                console.log(`     ${key}: ${String(value)}`);
+            }
+        }
+        console.log("");
+    });
+}

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

@@ -0,0 +1,43 @@
+import type { OutputSpec, ParamSpec } from "./types.js";
+import { type CapabilityPolicy, type CapabilitySource, type CapabilityStatus } from "../utils/capability-metadata.js";
+type CapabilityKind = "workflow" | "tool";
+type ManifestScope = "all" | "workflows" | "tools";
+export interface JsonSchemaObject {
+    type: "object";
+    properties: Record<string, Record<string, unknown>>;
+    required: string[];
+    additionalProperties?: boolean;
+}
+export interface CapabilityManifestCommand {
+    id: string;
+    type: CapabilityKind | "dam" | "org";
+    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;
+    dependency_tools?: string[];
+    affected_workflows?: string[];
+}
+export interface CapabilityManifest {
+    name: "gd-cli";
+    version: string;
+    description: string;
+    commands: CapabilityManifestCommand[];
+}
+export declare function buildInputJsonSchema(params: ParamSpec[], extraProperties?: Record<string, Record<string, unknown>>): JsonSchemaObject;
+export declare function buildOutputJsonSchema(output: OutputSpec): JsonSchemaObject;
+export declare function buildToolSchema(toolId: string): Record<string, unknown>;
+export declare function buildWorkflowSchema(appId: string): Record<string, unknown>;
+export declare function buildToolExamples(toolId: string): Record<string, unknown>;
+export declare function buildWorkflowExamples(appId: string): Record<string, unknown>;
+export declare function buildManifest(scope?: ManifestScope): CapabilityManifest;
+export declare function rowsForManifest(manifest: CapabilityManifest): Record<string, string>[];
+export declare function buildTopExamples(): Record<string, unknown>;
+export {};