@aswless_854771076/ai_short_studio_cli 0.1.50 → 0.1.51

package/README.md

@@ -42,8 +42,14 @@ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写
 - `ai-short-studio canvas edge`：连线读写。
 - `ai-short-studio canvas continuity analyze`：视频生成前分析镜头依赖，可修复已具备源视频的首尾帧连线。
 - `ai-short-studio canvas asset`：资产列表、上传、版本选择和下载。
+- `ai-short-studio canvas folder`：画布资产目录管理（5 预设 + 用户子目录 + 软删 + 跨项目复制）。
+- `ai-short-studio canvas episode`：列出或创建无限画布分集。其他画布命令用 `--episode <ID|集数>` 选择分集。
 - `ai-short-studio task`：异步任务读取、批量等待和取消。
-- `ai-short-studio config`：模型、provider、默认模型、能力默认值和并发配置。
+- `ai-short-studio config`：读取管理员发布的全局模型，管理个人默认模型、能力默认值和并发配置；CLI 会拒绝写入 Provider 或模型目录。
+
+CLI 不提供分集删除或任务人工复核提交；这两类需要确认生产资产或保留范围的操作继续在网页端完成。
+
+`config get` 返回管理员发布的全局模型与个人默认值，不返回供应商密钥。Comfly 和 RunningHub 的凭据、服务地址与工作流均由服务端维护；CLI 预检只检查默认模型及能力选项。`config set` 会拒绝写入任何供应商或模型目录。
 
 ```bash
 ai-short-studio canvas edge add --project <projectId> --from <sourceNodeId>:<sourceHandle> --to <targetNodeId>:<targetHandle> --json
@@ -51,8 +57,15 @@ ai-short-studio canvas edge delete <edgeId> --project <projectId> --yes --json
 ai-short-studio canvas continuity analyze --project <projectId> --json
 ai-short-studio canvas continuity analyze --project <projectId> --apply-ready --json
 ai-short-studio canvas asset select-version <assetId> --project <projectId> --version <versionId> --json
+ai-short-studio canvas folder list --project <projectId> --json
+ai-short-studio canvas episode list --project <projectId> --json
+ai-short-studio canvas episode create --project <projectId> --number 2 --json
+ai-short-studio canvas get --project <projectId> --episode 2 --json
+ai-short-studio canvas folder copy-cross-project --project <sourceProjectId> --asset-id <assetId> --target-project <targetProjectId> --target-episode-id <episodeId> --target-folder-id <folderId> --json
 ```
 
+`canvas folder copy-cross-project` 可用 `--target-episode-id` 指定复制品所属分集；省略 `--target-folder-id` 时，复制品进入该分集的未分类资产。目标目录必须属于目标项目和目标分集。两个参数都会去除首尾空白并拒绝空白值。该命令只复制资产及版本，不复制源目录结构。
+
 ## 项目配置
 
 ```bash

package/dist/base-command.d.ts

@@ -5,6 +5,7 @@ export declare abstract class BaseCommand extends Command {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected print(value: unknown): void;
     catch(error: unknown): Promise<void>;

package/dist/base-command.js

@@ -7,6 +7,7 @@ export class BaseCommand extends Command {
         json: Flags.boolean({ description: '输出稳定 JSON', default: false }),
         locale: Flags.string({ description: '响应语言', default: 'zh', options: ['zh', 'en'] }),
         profile: Flags.string({ description: '配置档案名称' }),
+        episode: Flags.string({ description: '画布分集 ID 或集数', env: 'VVICAT_CANVAS_EPISODE' }),
     };
     print(value) {
         this.log(formatJson(value));

package/dist/client/api-client.d.ts

@@ -11,11 +11,13 @@ export declare class ApiClient {
     private readonly fetcher;
     private readonly locale;
     private readonly session;
+    private readonly episode?;
     constructor(input: {
         baseUrl: string;
         session: ApiSession;
         fetcher?: typeof fetch;
         locale?: string;
+        episode?: string;
     });
     request<T = unknown>(path: string, options?: ApiRequestOptions): Promise<T>;
     response(path: string, options?: ApiRequestOptions): Promise<Response>;

package/dist/client/api-client.js

@@ -4,11 +4,13 @@ export class ApiClient {
     fetcher;
     locale;
     session;
+    episode;
     constructor(input) {
         this.baseUrl = input.baseUrl.replace(/\/+$/, '');
         this.session = input.session;
         this.fetcher = input.fetcher ?? fetch;
         this.locale = input.locale ?? 'zh';
+        this.episode = input.episode?.trim() || undefined;
     }
     async request(path, options = {}) {
         const firstToken = options.auth === false ? null : await this.session.accessToken();
@@ -39,6 +41,8 @@ export class ApiClient {
         headers.set('accept-language', this.locale);
         if (accessToken)
             headers.set('authorization', `Bearer ${accessToken}`);
+        if (this.episode)
+            headers.set('x-canvas-episode', this.episode);
         let body = inputBody;
         if (inputBody !== undefined && isJsonBody(inputBody)) {
             headers.set('content-type', 'application/json');

package/dist/commands/auth/login.d.ts

@@ -11,6 +11,7 @@ export default class AuthLogin extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/auth/logout.d.ts

@@ -6,6 +6,7 @@ export default class AuthLogout extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/auth/signup.d.ts

@@ -11,6 +11,7 @@ export default class AuthSignup extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/auth/status.d.ts

@@ -6,6 +6,7 @@ export default class AuthStatus extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/apply.d.ts

@@ -9,6 +9,7 @@ export default class CanvasApply extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/asset/download.d.ts

@@ -11,6 +11,7 @@ export default class CanvasAssetDownload extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/asset/get.d.ts

@@ -9,6 +9,7 @@ export default class CanvasAssetGet extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/asset/list.d.ts

@@ -8,6 +8,7 @@ export default class CanvasAssetList extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/asset/select.d.ts

@@ -10,6 +10,7 @@ export default class CanvasAssetSelect extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/asset/upload.d.ts

@@ -10,6 +10,7 @@ export default class CanvasAssetUpload extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/continuity/analyze.d.ts

@@ -8,6 +8,7 @@ export default class CanvasContinuityAnalyze extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/edge/connect.d.ts

@@ -8,6 +8,7 @@ export default class CanvasEdgeConnect extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/edge/disconnect.d.ts

@@ -10,6 +10,7 @@ export default class CanvasEdgeDisconnect extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/edge/list.d.ts

@@ -6,6 +6,7 @@ export default class CanvasEdgeList extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/episode/create.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class CanvasEpisodeCreate extends BaseCommand {
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        number: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/episode/create.js

@@ -0,0 +1,16 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+export default class CanvasEpisodeCreate extends BaseCommand {
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        number: Flags.integer({ required: true, min: 1, description: '集数' }),
+        name: Flags.string({ description: '分集名称' }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasEpisodeCreate);
+        const { api } = await commandApi(flags);
+        this.print(await api.createCanvasEpisode(flags.project, flags.number, flags.name?.trim() || undefined));
+    }
+}

package/dist/commands/canvas/episode/list.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class CanvasEpisodeList extends BaseCommand {
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/episode/list.js

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+export default class CanvasEpisodeList extends BaseCommand {
+    static flags = { ...BaseCommand.baseFlags, project: projectFlag };
+    async run() {
+        const { flags } = await this.parse(CanvasEpisodeList);
+        const { api } = await commandApi(flags);
+        this.print(await api.listCanvasEpisodes(flags.project));
+    }
+}

package/dist/commands/canvas/folder/copy-cross-project.d.ts

@@ -0,0 +1,25 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 跨项目复制画布资产；可明确指定目标项目中的目录。
+ * - --asset-id 源资产 ID（alias --asset）
+ * - --target-project 目标项目 ID
+ * - --target-episode-id 可选；指定复制品所属的目标分集
+ * - --target-folder-id 可选；省略时进入目标项目未分类
+ * - 失败码：FOLDER_FORBIDDEN / GONE
+ */
+export default class CanvasFolderCopyCrossProject extends BaseCommand {
+    static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'asset-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'target-project': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'target-folder-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'target-episode-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/folder/copy-cross-project.js

@@ -0,0 +1,51 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+/**
+ * 跨项目复制画布资产；可明确指定目标项目中的目录。
+ * - --asset-id 源资产 ID（alias --asset）
+ * - --target-project 目标项目 ID
+ * - --target-episode-id 可选；指定复制品所属的目标分集
+ * - --target-folder-id 可选；省略时进入目标项目未分类
+ * - 失败码：FOLDER_FORBIDDEN / GONE
+ */
+export default class CanvasFolderCopyCrossProject extends BaseCommand {
+    static description = '跨项目复制画布资产（Copy canvas asset across projects）';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        'asset-id': Flags.string({
+            description: '源资产 ID；可用 --asset 替代（Source asset id）',
+            required: true,
+            aliases: ['asset'],
+        }),
+        'target-project': Flags.string({
+            description: '目标项目 ID（Target project id）',
+            required: true,
+        }),
+        'target-folder-id': Flags.string({
+            description: '目标目录 ID；省略则放入未分类（Target folder id; omit for Uncategorized）',
+        }),
+        'target-episode-id': Flags.string({
+            description: '目标分集 ID；省略则沿用服务端默认分集（Target canvas episode id）',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasFolderCopyCrossProject);
+        const rawTargetFolderId = flags['target-folder-id'];
+        const rawTargetEpisodeId = flags['target-episode-id'];
+        if (typeof rawTargetFolderId === 'string' && !rawTargetFolderId.trim()) {
+            this.error('--target-folder-id 不能为空白；省略该参数可复制到未分类');
+        }
+        if (typeof rawTargetEpisodeId === 'string' && !rawTargetEpisodeId.trim()) {
+            this.error('--target-episode-id 不能为空白；省略该参数可使用服务端默认分集');
+        }
+        const { api } = await commandApi(flags);
+        this.print(await api.copyAssetCrossProject(flags.project, {
+            assetId: flags['asset-id'],
+            targetProjectId: flags['target-project'],
+            targetFolderId: rawTargetFolderId?.trim() || null,
+            ...(rawTargetEpisodeId ? { targetCanvasEpisodeId: rawTargetEpisodeId.trim() } : {}),
+        }));
+    }
+}

package/dist/commands/canvas/folder/create.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 在画布项目下新建一个用户自建目录。
+ * - --name 必填；--parent-id 缺省时 parentId 显式置 null，服务端挂到项目根
+ * - 失败码：FOLDER_CONFLICT / FOLDER_INVALID_PARAMS
+ */
+export default class CanvasFolderCreate extends BaseCommand {
+    static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'parent-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/folder/create.js

@@ -0,0 +1,28 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+/**
+ * 在画布项目下新建一个用户自建目录。
+ * - --name 必填；--parent-id 缺省时 parentId 显式置 null，服务端挂到项目根
+ * - 失败码：FOLDER_CONFLICT / FOLDER_INVALID_PARAMS
+ */
+export default class CanvasFolderCreate extends BaseCommand {
+    static description = '新建画布目录（Create canvas asset folder）';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        name: Flags.string({ description: '目录名称（Folder name）', required: true }),
+        'parent-id': Flags.string({
+            description: '父目录 ID；省略则挂到项目根（Parent folder id; omit for root）',
+            aliases: ['parent'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasFolderCreate);
+        const rawParent = flags['parent-id'];
+        // 显式传值时透传；缺省或空字符串 → null 表示挂到项目根（与服务端契约保持一致）
+        const parentId = typeof rawParent === 'string' && rawParent.length > 0 ? rawParent : null;
+        const { api } = await commandApi(flags);
+        this.print(await api.createFolder(flags.project, { name: flags.name, parentId }));
+    }
+}

package/dist/commands/canvas/folder/delete.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 软删画布目录（含引用拦截 + 30 天快照回滚窗口）
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - 失败码：FOLDER_PRESET_IMMUTABLE / FOLDER_IN_USE
+ */
+export default class CanvasFolderDelete extends BaseCommand {
+    static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'folder-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/folder/delete.js

@@ -0,0 +1,25 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+/**
+ * 软删画布目录（含引用拦截 + 30 天快照回滚窗口）
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - 失败码：FOLDER_PRESET_IMMUTABLE / FOLDER_IN_USE
+ */
+export default class CanvasFolderDelete extends BaseCommand {
+    static description = '软删画布目录（Soft-delete canvas asset folder）';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        'folder-id': Flags.string({
+            description: '目录 ID；可用 --folder 替代（Folder id）',
+            required: true,
+            aliases: ['folder'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasFolderDelete);
+        const { api } = await commandApi(flags);
+        this.print(await api.deleteFolder(flags.project, flags['folder-id']));
+    }
+}

package/dist/commands/canvas/folder/list.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 列出画布目录（5 预设 + 用户子目录的树形结构）
+ * - 默认仅活跃目录（query 为空，依赖服务端默认行为）
+ * - --include-soft-deleted 携带 true 时返回含 deletedAt / purgeInDays / referencedBy 的回收站视图
+ */
+export default class CanvasFolderList extends BaseCommand {
+    static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'include-soft-deleted': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/folder/list.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+/**
+ * 列出画布目录（5 预设 + 用户子目录的树形结构）
+ * - 默认仅活跃目录（query 为空，依赖服务端默认行为）
+ * - --include-soft-deleted 携带 true 时返回含 deletedAt / purgeInDays / referencedBy 的回收站视图
+ */
+export default class CanvasFolderList extends BaseCommand {
+    static description = '列出画布目录树（List canvas asset folders）';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        'include-soft-deleted': Flags.boolean({
+            description: '包含 30 天软删回收站目录（Include soft-deleted folders）',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasFolderList);
+        // 默认空 query 走服务端默认行为；仅在用户显式开启回收站视图时追加参数
+        const query = flags['include-soft-deleted'] === true ? 'includeSoftDeleted=true' : '';
+        const { api } = await commandApi(flags);
+        this.print(await api.listFolders(flags.project, query));
+    }
+}

package/dist/commands/canvas/folder/move.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 移动画布目录到新父目录（同项目内移动）
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - --parent-id 父目录 ID 必填（alias --parent）；服务端契约字段为 newParentId
+ * - 失败码：FOLDER_CYCLE / FOLDER_INVALID_PARAMS
+ */
+export default class CanvasFolderMove extends BaseCommand {
+    static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'folder-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'parent-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/folder/move.js

@@ -0,0 +1,32 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+/**
+ * 移动画布目录到新父目录（同项目内移动）
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - --parent-id 父目录 ID 必填（alias --parent）；服务端契约字段为 newParentId
+ * - 失败码：FOLDER_CYCLE / FOLDER_INVALID_PARAMS
+ */
+export default class CanvasFolderMove extends BaseCommand {
+    static description = '移动画布目录（Move canvas asset folder）';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        'folder-id': Flags.string({
+            description: '目录 ID；可用 --folder 替代（Folder id）',
+            required: true,
+            aliases: ['folder'],
+        }),
+        'parent-id': Flags.string({
+            description: '新父目录 ID（New parent folder id）',
+            required: true,
+            aliases: ['parent'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasFolderMove);
+        // 服务端契约：body 字段为 newParentId；调用方仅传字符串 ID（不允许传 null）
+        const { api } = await commandApi(flags);
+        this.print(await api.moveFolder(flags.project, flags['folder-id'], { newParentId: flags['parent-id'] }));
+    }
+}

package/dist/commands/canvas/folder/rename.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 重命名画布目录（仅用户自建目录，preset 不可改）
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - --name 新名称
+ * - 失败码：FOLDER_PRESET_IMMUTABLE / FOLDER_NOT_FOUND
+ */
+export default class CanvasFolderRename extends BaseCommand {
+    static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'folder-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/folder/rename.js

@@ -0,0 +1,27 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag } from '../../../command-helpers.js';
+/**
+ * 重命名画布目录（仅用户自建目录，preset 不可改）
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - --name 新名称
+ * - 失败码：FOLDER_PRESET_IMMUTABLE / FOLDER_NOT_FOUND
+ */
+export default class CanvasFolderRename extends BaseCommand {
+    static description = '重命名画布目录（Rename canvas asset folder）';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        'folder-id': Flags.string({
+            description: '目录 ID；可用 --folder 替代（Folder id）',
+            required: true,
+            aliases: ['folder'],
+        }),
+        name: Flags.string({ description: '新目录名称（New folder name）', required: true }),
+    };
+    async run() {
+        const { flags } = await this.parse(CanvasFolderRename);
+        const { api } = await commandApi(flags);
+        this.print(await api.updateFolder(flags.project, flags['folder-id'], { name: flags.name }));
+    }
+}