@gaoding/cli 0.0.0 → 1.0.0-alpha.25

package/dist/src/cli/dam-commands.js

@@ -0,0 +1,469 @@
+import { bindAction, bindPreparedAction } from "./action-binding.js";
+import { CliUsageError } from "./errors.js";
+import { repositoryListView } from "./presenter.js";
+export function registerDamCommands(program, runtime) {
+    const dam = program.command("dam")
+        .description("DAM 素材管理")
+        .helpCommand(false);
+    const repository = dam.command("repository")
+        .description("DAM 资源库")
+        .helpCommand(false);
+    const repositoryList = leaf(repository.command("list"))
+        .description("列出可用资源库")
+        .option("--json", "输出 JSON");
+    bindAction(repositoryList, "organization", async (context, signal) => {
+        const result = await runtime.telemetry.stage("repository", () => (runtime.dam.repositoryList({
+            access: organizationAccess(context.state),
+            signal
+        })));
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: repositoryList.opts().json === true,
+                view: repositoryListView
+            });
+        });
+    }, { operation: "dam.repository.list" });
+    const folder = dam.command("folder")
+        .description("DAM 文件夹")
+        .helpCommand(false);
+    const folderList = leaf(folder.command("list"))
+        .description("列出文件夹")
+        .option("--repository-id <id>", "指定资源库 ID")
+        .option("--parent-id <id>", "父文件夹 ID")
+        .option("--query <text>", "按名称筛选")
+        .option("--page <n>", "页码", positiveInteger)
+        .option("--page-size <1-100>", "分页大小", pageSize)
+        .option("--json", "输出 JSON");
+    bindPreparedAction(folderList, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = folderList.opts();
+        const input = {
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("parentId", options.parentId),
+            ...defined("query", options.query),
+            ...defined("page", options.page),
+            ...defined("pageSize", options.pageSize)
+        };
+        runtime.validators.damFolderListInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.folderList({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: folderList.opts().json === true,
+                view: folderListView
+            });
+        });
+    }, { operation: "dam.folder.list" });
+    const tag = dam.command("tag")
+        .description("DAM 标签")
+        .helpCommand(false);
+    const tagList = leaf(tag.command("list"))
+        .description("列出标签")
+        .option("--repository-id <id>", "指定资源库 ID")
+        .option("--query <text>", "按名称筛选")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(tagList, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = tagList.opts();
+        const input = {
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("query", options.query)
+        };
+        runtime.validators.damTagListInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.tagList({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: tagList.opts().json === true,
+                view: tagListView
+            });
+        });
+    }, { operation: "dam.tag.list" });
+    const download = leaf(dam.command("download"))
+        .description("下载一个素材")
+        .argument("<asset>", "素材 ID")
+        .option("--repository-id <id>", "所属资源库 ID")
+        .option("--output-dir <directory>", "输出目录")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(download, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = download.opts();
+        const input = {
+            asset_id: position(download, 0),
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("outputDir", options.outputDir)
+        };
+        runtime.validators.damDownloadInput(input);
+        runtime.telemetry.annotate({ content_id: input.asset_id, parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.download({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: download.opts().json === true,
+                view: downloadView
+            });
+        });
+    }, { operation: "dam.download" });
+    const rename = leaf(dam.command("rename"))
+        .description("重命名一个素材或文件夹")
+        .argument("<entry>", "素材或文件夹 ID")
+        .requiredOption("--kind <asset|folder>", "条目类型")
+        .requiredOption("--title <title>", "新标题")
+        .option("--repository-id <id>", "所属资源库 ID")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(rename, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = rename.opts();
+        const input = {
+            entry_id: position(rename, 0),
+            kind: options.kind,
+            title: options.title,
+            ...defined("repositoryId", options.repositoryId)
+        };
+        runtime.validators.damRenameInput(input);
+        runtime.telemetry.annotate({ content_id: input.entry_id, parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.rename({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: rename.opts().json === true,
+                view: renameView
+            });
+        });
+    }, { operation: "dam.rename" });
+    for (const operation of ["move", "copy"]) {
+        const command = leaf(dam.command(operation))
+            .description(operation === "move" ? "移动一个素材或文件夹" : "复制一个素材或文件夹")
+            .argument("<entry>", "素材或文件夹 ID")
+            .requiredOption("--kind <asset|folder>", "条目类型")
+            .requiredOption("--target-folder-id <id>", "目标文件夹 ID；根目录使用 0")
+            .option("--repository-id <source-id>", "源资源库 ID")
+            .option("--target-repository-id <target-id>", "目标资源库 ID")
+            .option("--json", "输出 JSON");
+        bindPreparedAction(command, "organization", async (signal) => {
+            signal.throwIfAborted();
+            const options = command.opts();
+            const input = {
+                entry_id: position(command, 0),
+                kind: options.kind,
+                targetFolderId: options.targetFolderId,
+                ...defined("repositoryId", options.repositoryId),
+                ...defined("targetRepositoryId", options.targetRepositoryId)
+            };
+            if (operation === "move")
+                runtime.validators.damMoveInput(input);
+            else
+                runtime.validators.damCopyInput(input);
+            runtime.telemetry.annotate({ content_id: input.entry_id, parameters: { ...input } });
+            return { handled: false, input: input };
+        }, async (context, input, signal) => {
+            const result = operation === "move"
+                ? await runtime.dam.move({
+                    input: input,
+                    access: organizationAccess(context.state),
+                    signal
+                })
+                : await runtime.dam.copy({
+                    input: input,
+                    access: organizationAccess(context.state),
+                    signal
+                });
+            await runtime.telemetry.stage("output", async () => {
+                runtime.presenter.result(result, {
+                    json: command.opts().json === true,
+                    view: operation === "move" ? moveView : copyView
+                });
+            });
+        }, { operation: `dam.${operation}` });
+    }
+    const list = browseCommand(leaf(dam.command("list")))
+        .description("查看最近素材");
+    bindPreparedAction(list, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const input = browseInput(list);
+        runtime.validators.damListInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.list({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: list.opts().json === true,
+                view: assetListView
+            });
+        });
+    }, { operation: "dam.list" });
+    const search = browseCommand(leaf(dam.command("search")))
+        .description("按关键词搜索素材")
+        .argument("<query>", "搜索关键词");
+    bindPreparedAction(search, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const input = {
+            query: position(search, 0),
+            ...browseInput(search)
+        };
+        runtime.validators.damSearchInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.search({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: search.opts().json === true,
+                view: assetListView
+            });
+        });
+    }, { operation: "dam.search" });
+    const get = leaf(dam.command("get"))
+        .description("查看素材完整信息")
+        .argument("<asset>", "素材 ID")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(get, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const input = { asset_id: position(get, 0) };
+        runtime.validators.damGetInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.get({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: get.opts().json === true,
+                view: assetDetailView
+            });
+        });
+    }, { operation: "dam.get" });
+    const upload = leaf(dam.command("upload"))
+        .description("上传本地文件并创建素材")
+        .argument("<file>", "本地文件路径")
+        .option("--repository-id <id>", "目标资源库 ID")
+        .option("--title <title>", "素材标题")
+        .option("--folder-id <id>", "目标文件夹 ID")
+        .option("--tag-ids <csv>", "标签 ID，逗号分隔")
+        .option("--allow-sensitive-path", "明确允许受保护路径")
+        .option("--wait-analysis", "等待素材分析结束")
+        .option("--json", "输出 JSON");
+    bindPreparedAction(upload, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = upload.opts();
+        const input = {
+            file: position(upload, 0),
+            ...defined("repositoryId", options.repositoryId),
+            ...defined("title", options.title),
+            ...defined("folderId", options.folderId),
+            ...defined("tagIds", csv(options.tagIds)),
+            ...(options.allowSensitivePath === true ? { allowSensitivePath: true } : {}),
+            ...(options.waitAnalysis === true ? { waitAnalysis: true } : {})
+        };
+        runtime.validators.damUploadInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        const result = await runtime.dam.upload({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.result(result, {
+                json: upload.opts().json === true,
+                view: assetDetailView
+            });
+        });
+    }, { operation: "dam.upload" });
+    const deleteCommand = leaf(dam.command("delete"))
+        .description("删除素材")
+        .argument("<asset>", "素材 ID")
+        .option("--repository-id <id>", "所属资源库 ID")
+        .option("--permanent", "移入回收站后永久删除");
+    bindPreparedAction(deleteCommand, "organization", async (signal) => {
+        signal.throwIfAborted();
+        const options = deleteCommand.opts();
+        const input = {
+            asset_id: position(deleteCommand, 0),
+            ...defined("repositoryId", options.repositoryId),
+            ...(options.permanent === true ? { permanent: true } : {})
+        };
+        runtime.validators.damDeleteInput(input);
+        runtime.telemetry.annotate({ parameters: { ...input } });
+        return { handled: false, input };
+    }, async (context, input, signal) => {
+        await runtime.dam.delete({
+            input,
+            access: organizationAccess(context.state),
+            signal
+        });
+        await runtime.telemetry.stage("output", async () => {
+            runtime.presenter.success(input.permanent === true
+                ? "素材已永久删除。"
+                : "素材已移入回收站。");
+        });
+    }, { operation: "dam.delete" });
+}
+function leaf(command) {
+    return command.allowExcessArguments(false);
+}
+function browseCommand(command) {
+    return command
+        .option("--repository-id <id>", "指定资源库 ID")
+        .option("--all-repositories", "查询全部可访问资源库")
+        .option("--folder-id <id>", "指定文件夹 ID")
+        .option("--no-include-child-folder", "不包含子文件夹")
+        .option("--type <type>", "素材类型")
+        .option("--asset-format <csv>", "文件格式，逗号分隔")
+        .option("--tag-ids <csv>", "标签 ID，逗号分隔")
+        .option("--page-size <1-100>", "请求分页大小", pageSize)
+        .option("--cursor <id>", "分页游标")
+        .option("--json", "输出 JSON");
+}
+function browseInput(command) {
+    const options = command.opts();
+    return {
+        ...defined("repositoryId", options.repositoryId),
+        ...(options.allRepositories === true ? { allRepositories: true } : {}),
+        ...defined("folderId", options.folderId),
+        ...(command.getOptionValueSource("includeChildFolder") === "cli"
+            ? { includeChildFolder: false }
+            : {}),
+        ...defined("type", options.type),
+        ...defined("assetFormats", csv(options.assetFormat)),
+        ...defined("tagIds", csv(options.tagIds)),
+        ...defined("pageSize", options.pageSize),
+        ...defined("cursor", options.cursor)
+    };
+}
+function defined(key, value) {
+    return value === undefined ? {} : { [key]: value };
+}
+function csv(value) {
+    return value?.split(",").map((item) => item.trim()).filter((item) => item !== "");
+}
+function pageSize(value) {
+    if (!/^\d+$/u.test(value))
+        throw new CliUsageError();
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100)
+        throw new CliUsageError();
+    return parsed;
+}
+function positiveInteger(value) {
+    if (!/^\d+$/u.test(value))
+        throw new CliUsageError();
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        throw new CliUsageError();
+    return parsed;
+}
+function position(command, index) {
+    const value = command.processedArgs[index];
+    if (typeof value !== "string")
+        throw new CliUsageError();
+    return value;
+}
+function organizationAccess(state) {
+    return {
+        credential: state.credential,
+        organizationId: state.organization.id
+    };
+}
+function assetListView(value) {
+    const assets = value.assets;
+    if (assets.length === 0)
+        return "暂无素材。";
+    return [
+        "ID\t标题\t类型\t格式",
+        ...assets.map(assetRow)
+    ].join("\n");
+}
+function assetRow(asset) {
+    return [asset.asset_id, asset.title ?? "", asset.type ?? "", asset.format ?? ""].join("\t");
+}
+function assetDetailView(value) {
+    const asset = value;
+    return [
+        `素材：${asset.title ?? asset.asset_id}`,
+        `ID：${asset.asset_id}`,
+        ...(asset.type === undefined ? [] : [`类型：${asset.type}`]),
+        ...(asset.format === undefined ? [] : [`格式：${asset.format}`]),
+        ...(asset.url === undefined ? [] : [`URL：${asset.url}`])
+    ].join("\n");
+}
+function folderListView(value) {
+    const folders = value.folders;
+    if (folders.length === 0)
+        return "暂无文件夹。";
+    return [
+        "ID\t名称\t子文件夹数\t素材数",
+        ...folders.map((folder) => [
+            folder.folder_id,
+            folder.title,
+            folder.child_folder_count,
+            folder.asset_count
+        ].join("\t"))
+    ].join("\n");
+}
+function tagListView(value) {
+    const tags = value.tags;
+    if (tags.length === 0)
+        return "暂无标签。";
+    return [
+        "ID\t名称\t素材数",
+        ...tags.map((tag) => [tag.tag_id, tag.name, tag.asset_count].join("\t"))
+    ].join("\n");
+}
+function downloadView(value) {
+    return value.files
+        .map((file) => `已下载：${file.path}`)
+        .join("\n");
+}
+function renameView(value) {
+    const result = value;
+    return `已重命名：${result.title} (${result.entry_id})`;
+}
+function moveView(value) {
+    const result = value;
+    return `已移动至：${result.repository_id} / ${result.folder_id}`;
+}
+function copyView(value) {
+    const result = value;
+    return [
+        `已复制至：${result.repository_id} / ${result.folder_id}`,
+        ...(result.copied_entry_id === undefined
+            ? []
+            : [`复制条目 ID：${result.copied_entry_id}`])
+    ].join("\n");
+}

package/dist/src/cli/editor-commands.js

@@ -0,0 +1,73 @@
+import { bindAction, bindPreparedAction } from "./action-binding.js";
+export function registerEditorCommands(program, runtime) {
+    const editor = program.command("editor")
+        .description("连接并操作 AI+ Editor")
+        .helpCommand(false);
+    const connect = leaf(editor.command("connect"))
+        .description("打开并连接一个 AI+ Editor 作品")
+        .argument("[target]", "作品 ID 或完整 URL");
+    bindPreparedAction(connect, "none", async (signal) => {
+        signal.throwIfAborted();
+        const target = connect.processedArgs[0];
+        const input = typeof target === "string" ? { target } : {};
+        runtime.validators.editorConnectInput(input);
+        return { handled: false, input };
+    }, async (_context, input, signal) => {
+        const result = await runtime.editor.connect({ input, signal });
+        writeJson(runtime, result);
+    });
+    const disconnect = leaf(editor.command("disconnect"))
+        .description("断开当前 Editor 连接");
+    bindAction(disconnect, "none", async (_context, signal) => {
+        writeJson(runtime, await runtime.editor.disconnect({ signal }));
+    });
+    const snapshot = leaf(editor.command("snapshot"))
+        .description("读取当前作品快照");
+    bindAction(snapshot, "none", async (_context, signal) => {
+        writeJson(runtime, await runtime.editor.snapshot({ signal }));
+    });
+    const apply = leaf(editor.command("apply"))
+        .description("按顺序应用元素操作")
+        .requiredOption("--input <file|->", "从文件或标准输入读取 JSON");
+    bindPreparedAction(apply, "none", async (signal) => {
+        signal.throwIfAborted();
+        const source = apply.opts().input;
+        const input = await runtime.jsonInput.read(source, signal);
+        runtime.validators.editorApplyInput(input);
+        return { handled: false, input };
+    }, async (_context, input, signal) => {
+        writeJson(runtime, await runtime.editor.apply({ input, signal }));
+    });
+    const screenshot = leaf(editor.command("screenshot"))
+        .description("导出当前作品 PNG 截图")
+        .option("--json", "输出 JSON");
+    bindAction(screenshot, "none", async (_context, signal) => {
+        const result = await runtime.editor.screenshot({ signal });
+        runtime.presenter.result(result, {
+            json: screenshot.opts().json === true,
+            view: screenshotView
+        });
+    });
+    const save = leaf(editor.command("save"))
+        .description("保存当前 AI+ Editor 作品")
+        .option("--json", "输出 JSON");
+    bindAction(save, "none", async (_context, signal) => {
+        const result = await runtime.editor.save({ signal });
+        runtime.presenter.result(result, {
+            json: save.opts().json === true,
+            view: saveView
+        });
+    });
+}
+function leaf(command) {
+    return command.allowExcessArguments(false);
+}
+function writeJson(runtime, value) {
+    runtime.io.writeOut(`${JSON.stringify(value)}\n`);
+}
+function screenshotView(value) {
+    return `截图已保存至 ${value.path}`;
+}
+function saveView(value) {
+    return `作品已保存：${value.url}`;
+}