@aswless_854771076/ai_short_studio_cli 0.1.50 → 0.1.52

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

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * 恢复 30 天内软删的画布目录
+ * - --folder-id 目标目录 ID（camelCase 别名 --folder 也可）
+ * - 失败码：FOLDER_NOT_FOUND / GONE（超过 30 天回收窗口）
+ */
+export default class CanvasFolderRestore 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/restore.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_NOT_FOUND / GONE（超过 30 天回收窗口）
+ */
+export default class CanvasFolderRestore extends BaseCommand {
+    static description = '恢复软删的画布目录（Restore soft-deleted 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(CanvasFolderRestore);
+        const { api } = await commandApi(flags);
+        this.print(await api.restoreFolder(flags.project, flags['folder-id']));
+    }
+}

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

@@ -6,6 +6,7 @@ export default class CanvasGet 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/inspect.d.ts

@@ -14,6 +14,7 @@ export default class CanvasInspect 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/node/add.d.ts

@@ -13,6 +13,7 @@ export default class CanvasNodeAdd 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/node/delete.d.ts

@@ -10,6 +10,7 @@ export default class CanvasNodeDelete 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/node/edit-resource.d.ts

@@ -10,6 +10,7 @@ export default class CanvasNodeEditResource 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/node/edit-shot.d.ts

@@ -10,6 +10,7 @@ export default class CanvasNodeEditShot 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/node/get.d.ts

@@ -9,6 +9,7 @@ export default class CanvasNodeGet 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/node/list.d.ts

@@ -6,6 +6,7 @@ export default class CanvasNodeList 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/node/run.d.ts

@@ -13,6 +13,7 @@ export default class CanvasNodeRun 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/node/types.d.ts

@@ -9,6 +9,7 @@ export default class CanvasNodeTypes 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/node/update-many.d.ts

@@ -8,6 +8,7 @@ export default class CanvasNodeUpdateMany 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/node/update.d.ts

@@ -15,6 +15,7 @@ export default class CanvasNodeUpdate 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/settings/get.d.ts

@@ -6,6 +6,7 @@ export default class CanvasSettingsGet 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/settings/set.d.ts

@@ -17,6 +17,7 @@ export default class CanvasSettingsSet 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/config/get.d.ts

@@ -5,6 +5,7 @@ export default class ConfigGet 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/config/set.d.ts

@@ -6,6 +6,7 @@ export default class ConfigSet 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/preflight.d.ts

@@ -7,6 +7,7 @@ export default class Preflight 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/project/create.d.ts

@@ -7,6 +7,7 @@ export default class ProjectCreate 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/project/delete.d.ts

@@ -9,6 +9,7 @@ export default class ProjectDelete 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/project/get.d.ts

@@ -8,6 +8,7 @@ export default class ProjectGet 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/project/list.d.ts

@@ -9,6 +9,7 @@ export default class ProjectList 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/project/provider/get.d.ts

@@ -8,6 +8,7 @@ export default class ProjectProviderGet 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/project/provider/set.d.ts

@@ -9,6 +9,7 @@ export default class ProjectProviderSet 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/project/provider/test.d.ts

@@ -8,6 +8,7 @@ export default class ProjectProviderTest 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/project/update.d.ts

@@ -10,6 +10,7 @@ export default class ProjectUpdate 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/skill/install.d.ts

@@ -10,6 +10,7 @@ export default class SkillInstall 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/skill/path.d.ts

@@ -9,6 +9,7 @@ export default class SkillPath 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/skill/status.d.ts

@@ -9,6 +9,7 @@ export default class SkillStatus 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/task/cancel.d.ts

@@ -9,6 +9,7 @@ export default class TaskCancel 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/task/get.d.ts

@@ -8,6 +8,7 @@ export default class TaskGet 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/task/wait.d.ts

@@ -11,6 +11,7 @@ export default class TaskWait 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/domain/vvicat-api.d.ts

@@ -67,8 +67,29 @@ export declare class VvicatApi {
     testProjectMaterialProvider(projectId: string): Promise<JsonObject>;
     deleteProject(projectId: string): Promise<JsonObject>;
     canvas(projectId: string): Promise<CanvasDto>;
+    listCanvasEpisodes(projectId: string): Promise<JsonObject[]>;
+    createCanvasEpisode(projectId: string, episodeNumber: number, name?: string): Promise<JsonObject>;
     canvasSettings(projectId: string): Promise<JsonObject>;
     updateCanvasSettings(projectId: string, input: JsonObject): Promise<JsonObject>;
+    listFolders(projectId: string, query?: string): Promise<JsonObject>;
+    createFolder(projectId: string, input: {
+        name: string;
+        parentId?: string | null;
+    }): Promise<JsonObject>;
+    updateFolder(projectId: string, folderId: string, input: {
+        name?: string;
+    }): Promise<JsonObject>;
+    deleteFolder(projectId: string, folderId: string): Promise<JsonObject>;
+    restoreFolder(projectId: string, folderId: string): Promise<JsonObject>;
+    moveFolder(projectId: string, folderId: string, input: {
+        newParentId: string | null;
+    }): Promise<JsonObject>;
+    copyAssetCrossProject(projectId: string, input: {
+        assetId: string;
+        targetProjectId: string;
+        targetFolderId: string | null;
+        targetCanvasEpisodeId?: string | null;
+    }): Promise<JsonObject>;
     listNodes(projectId: string): Promise<CanvasNode[]>;
     node(projectId: string, nodeId: string): Promise<CanvasNode>;
     listEdges(projectId: string): Promise<JsonObject[]>;

package/dist/domain/vvicat-api.js

@@ -102,12 +102,51 @@ export class VvicatApi {
         const payload = await this.client.request(`/api/projects/${projectId}/canvas`);
         return payload.data.canvas;
     }
+    async listCanvasEpisodes(projectId) {
+        const payload = await this.client.request(`/api/projects/${projectId}/canvas-episodes`);
+        return payload.episodes;
+    }
+    async createCanvasEpisode(projectId, episodeNumber, name) {
+        return this.client.request(`/api/projects/${projectId}/canvas-episodes`, {
+            method: 'POST', body: { episodeNumber, ...(name ? { name } : {}) },
+        });
+    }
+    // CLI 只开放分集查询与创建；删除涉及“至少保留一集”约束，继续由网页交互确认。
     canvasSettings(projectId) {
         return this.client.request(`/api/projects/${projectId}/canvas/settings`);
     }
     updateCanvasSettings(projectId, input) {
         return this.client.request(`/api/projects/${projectId}/canvas/settings`, { method: 'PATCH', body: input });
     }
+    listFolders(projectId, query = '') {
+        // 树形目录列表；预设 5 项 + 用户子目录（含 deletedAt / purgeInDays / referencedBy）
+        return this.client.request(`/api/projects/${projectId}/canvas-folders${query ? `?${query}` : ''}`);
+    }
+    createFolder(projectId, input) {
+        return this.client.request(`/api/projects/${projectId}/canvas-folders`, { method: 'POST', body: input });
+    }
+    updateFolder(projectId, folderId, input) {
+        return this.client.request(`/api/projects/${projectId}/canvas-folders/${folderId}`, { method: 'PATCH', body: input });
+    }
+    deleteFolder(projectId, folderId) {
+        return this.client.request(`/api/projects/${projectId}/canvas-folders/${folderId}`, {
+            method: 'DELETE',
+        });
+    }
+    restoreFolder(projectId, folderId) {
+        return this.client.request(`/api/projects/${projectId}/canvas-folders/${folderId}/restore`, { method: 'POST' });
+    }
+    moveFolder(projectId, folderId, input) {
+        // 服务端契约使用 newParentId；调用方传入 null 表示提升到根
+        return this.client.request(`/api/projects/${projectId}/canvas-folders/${folderId}/move`, {
+            method: 'PATCH', body: { newParentId: input.newParentId },
+        });
+    }
+    copyAssetCrossProject(projectId, input) {
+        return this.client.request(`/api/projects/${projectId}/canvas-assets/copy-cross-project`, {
+            method: 'POST', body: input,
+        });
+    }
     async listNodes(projectId) {
         return (await this.canvas(projectId)).nodes;
     }
@@ -284,6 +323,7 @@ export class VvicatApi {
     task(taskId) {
         return this.client.request(`/api/tasks/${taskId}`);
     }
+    // CLI 只读取、等待或取消任务；人工复核结果仍由网页端提交，避免自动化误选生产资产。
     cancelTask(taskId) {
         return this.client.request(`/api/tasks/${taskId}`, { method: 'DELETE' });
     }
@@ -299,6 +339,8 @@ export class VvicatApi {
         return this.client.request('/api/user/api-config?redactSecrets=1');
     }
     updateConfig(input) {
+        if (Object.hasOwn(input, 'providers') || Object.hasOwn(input, 'models'))
+            throw new Error('供应商和模型目录只能由管理员维护');
         return this.client.request('/api/user/api-config', { method: 'PUT', body: input });
     }
     raw(path, options) {

package/dist/preflight.js

@@ -87,7 +87,6 @@ export function updateCliPackage(input) {
 }
 export function inspectCreationConfig(config) {
     const value = isRecord(config) ? config : {};
-    const providers = Array.isArray(value.providers) ? value.providers.filter(isRecord) : [];
     const models = Array.isArray(value.models) ? value.models.filter(isRecord) : [];
     const defaults = isRecord(value.defaultModels) ? value.defaultModels : {};
     const capabilityDefaults = isRecord(value.capabilityDefaults) ? value.capabilityDefaults : {};
@@ -105,9 +104,6 @@ export function inspectCreationConfig(config) {
             addMissing(`models.${modelKey}`);
             continue;
         }
-        const provider = providers.find((item) => item.id === model.provider);
-        if (!provider || provider.hasApiKey !== true)
-            addMissing(`providers.${String(model.provider)}.apiKey`);
         inspectModelCapabilities(model, modelKey, expectedType, capabilityDefaults, addMissing);
     }
     if (!isRecord(value.capabilityDefaults))

package/dist/runtime.d.ts

@@ -5,6 +5,7 @@ interface RuntimeFlags {
     'base-url'?: string;
     locale?: string;
     profile?: string;
+    episode?: string;
     'supabase-publishable-key'?: string;
     'supabase-url'?: string;
 }

package/dist/runtime.js

@@ -36,7 +36,7 @@ export async function createRuntime(flags) {
     return {
         profile,
         session,
-        client: new ApiClient({ baseUrl, session, locale: flags.locale }),
+        client: new ApiClient({ baseUrl, session, locale: flags.locale, episode: flags.episode }),
     };
 }
 function resolveAuthConfig(profile, flags) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aswless_854771076/ai_short_studio_cli",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "description": "VVICAT 无限画布项目命令行工具",
   "license": "MIT",
   "private": false,

package/skills/using-vvicat-ai-short-studio-cli/SKILL.md

@@ -18,8 +18,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 创建项目或修改任何资源前，按顺序执行：
 
 1. 运行 `ai-short-studio preflight --json`。它通过 API base URL 检查连通性和 CLI 最新稳定版，未配置地址时使用测试环境 `https://ai-short-studio.vvicat.dev`，默认发现更新就更新当前全局包；`restartRequired` 为真时必须重跑。连不上时提醒用户检查 `--base-url`、`VVICAT_BASE_URL`、profile 或默认测试环境，不猜其他地址。
-2. 未登录且已有账号时执行 `ai-short-studio auth login --google` 或邮箱登录；没有账号且用户明确要求注册时，先核对 profile 的 `baseUrl` 确实指向目标环境，再使用 `auth signup --email <email> --password-stdin`。CLI 会从服务端取得 Supabase 公共配置，并把同域的 `/{locale}/auth/callback` 显式设为注册确认回调。注册返回 `confirmationRequired: true` 时，等待用户完成邮件验证后再登录。登录后重跑 preflight。`ready` 为 false 时，把 `missing` 一次性告知用户并询问如何补齐；新配置模型首选公司的 [StarRouter](https://starrouter.io/)，账号开通联系邱茂。
-3. 运行账户级只读命令 `ai-short-studio config get --json`，取得账户默认模型及可用 provider。创建项目至少要求已配置 `defaultModels.analysisModel`；缺失时 `project create` 会在发送创建请求前停止，需先由用户在设置中心完成配置。此步骤只用于计算继承后的有效模型，不得用 `config set` 改账户配置来完成项目配置。
+2. 未登录且已有账号时执行 `ai-short-studio auth login --google` 或邮箱登录；没有账号且用户明确要求注册时，先核对 profile 的 `baseUrl` 确实指向目标环境，再使用 `auth signup --email <email> --password-stdin`。CLI 会从服务端取得 Supabase 公共配置，并把同域的 `/{locale}/auth/callback` 显式设为注册确认回调。注册返回 `confirmationRequired: true` 时，等待用户完成邮件验证后再登录。登录后重跑 preflight。`ready` 为 false 时，把缺失的默认模型和能力选项一次性告知用户；供应商与模型目录问题交由管理员处理。
+3. 运行账户级只读命令 `ai-short-studio config get --json`，取得账户默认模型及管理员已发布的全局模型。创建项目至少要求已配置 `defaultModels.analysisModel`；缺失时 `project create` 会在发送创建请求前停止，需先由用户在设置中心完成配置。供应商、密钥和模型目录只能由管理员维护；`config set` 只维护个人默认模型及其能力默认值和工作流并发，不得写入 `providers` 或 `models`。
+   Comfly 和 RunningHub 同样从全局目录选择；其凭据、服务地址和工作流映射由管理员或服务端维护，CLI 不要求也不接受用户配置供应商连接。
 4. 运行 `ai-short-studio canvas node types --json`，按实时 `inputSchema`、`outputSchema`、`configSchema` 和 `defaultConfig` 确定能力与必填项。
 5. 运行 `project list` 判断目标是新项目还是既有项目。新项目先确认账户默认分析模型已配置，再按“确认名称和用途 → `project create` → `project get` + 一次 `canvas inspect --include summary --include nodes --include edges --include assets --include settings --include node-types`”继续；未通过模型审查时不得尝试创建。既有项目同样用 `project get` 加一次聚合查询取得画布、项目配置、节点目录和资产。只有聚合结果缺少专用命令独有字段时才补充单项读取，不得把这些查询拆成一串 CLI 进程；也不得要求尚未创建的新项目先读取项目或画布。任何缺口仍按核心原则询问。
 6. 运行 `ai-short-studio skill status --target codex --json`；非 current 时询问后更新，用户修改或非托管目录不得擅自 `--force` 覆盖。
@@ -80,6 +81,45 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 
 结构字段漏项属于上游产物或物化缺陷，不得静默绕过。能用确定映射恢复 reference 时按上述幂等流程修复；不能确定时停止并报告缺口，等待用户选择重新拆解或确认映射。
 
+## 画布资产目录管理（canvas folder）
+
+无限画布项目按分集隔离画布、目录和资产。用 `canvas episode list --project <projectId>` 列出分集，用 `canvas episode create --project <projectId> --number <n>` 创建分集；其他 `canvas *` 命令传 `--episode <episodeId|集数>` 选择作用域。
+
+CLI 不提供分集删除或任务人工复核提交。遇到需要删除分集、选择一致性测试结果或提交视频人工复核的场景，转到网页端完成，不得用低层请求绕过确认。
+
+画布资产目录是项目内"道具 / 人物 / 场景 / 配音 / 分镜"五类的物理容器，命令族 `canvas folder *` 独立于 `canvas asset *`，专管目录结构。
+
+### 概述
+
+- 5 个预设目录（道具、人物、场景、配音、分镜）在项目初始化时自动创建，名称固定，不可重命名、不可移动、不可删除
+- 用户可在 5 个预设目录的任意层下创建子目录，递归层级上限 32 层
+- 删除目录走软删逻辑：节点进入 30 天回收窗口，可恢复；窗口外返回 `FOLDER_GONE`
+- 跨项目复制资产时不复制目录结构，仅复制资产条目与所属版本
+
+### 强制顺序
+
+1. 执行 `canvas folder list --project <projectId> --json` 取得活动目录树（含 5 个预设 + 用户子目录）。只有传 `--include-soft-deleted` 时才同时返回软删节点
+2. 需要修改目录结构前必须先 list，避免对不存在的 `folderId` 操作触发 `404 / FOLDER_NOT_FOUND`
+3. 创建子目录：`canvas folder create --project <projectId> --name "..." --parent-id <folderId>`。省略 `--parent-id` 时创建在项目根层
+4. 重命名：`canvas folder rename --project <projectId> --folder <folderId> --name "..."`。预设目录禁止重命名，返回 `FOLDER_PRESET_IMMUTABLE`
+5. 移动：`canvas folder move --project <projectId> --folder <folderId> --parent-id <parentId>`。预设目录禁止移动；同项目内不允许形成环（目标 `parentId` 不能是 `folderId` 的后代），返回 `FOLDER_CYCLE_DETECTED`
+6. 删除：`canvas folder delete --project <projectId> --folder <folderId>`。预设目录禁止删除；被引用时返回 `FOLDER_IN_USE` 并附引用方列表，必须先解除引用再重试
+7. 恢复软删目录：`canvas folder restore --project <projectId> --folder <folderId>`。超过 30 天回收窗口返回 `FOLDER_GONE`，无法恢复
+8. 跨项目或跨分集复制资产：`canvas folder copy-cross-project --project <sourceProjectId> --asset-id <assetId> --target-project <targetProjectId> --target-episode-id <episodeId> --target-folder-id <folderId>`。`--target-episode-id` 指定目标分集；省略 `--target-folder-id` 时复制到该分集的未分类。目标目录必须属于目标项目和目标分集。该命令只复制资产及版本，不复制目录结构；目标项目无写入权限时返回 `FOLDER_FORBIDDEN`
+
+### 批量操作原则
+
+- 单次命令只处理一个目录；批量场景按目录循环执行
+- 删除、移动、重命名互不依赖时可并发执行；存在依赖（先重命名再删除）必须按顺序串行
+- 操作前后用 `canvas folder list --project <projectId>` 回读验证结果是否生效
+- 任何 `404 / FOLDER_NOT_FOUND / FOLDER_PRESET_IMMUTABLE / FOLDER_IN_USE` 错误必须停下修正；被引用时必须先解除引用再重试
+
+### 与现有 CLI 命令的关系
+
+- `canvas folder *` 命令**独立于** `canvas asset *`。folder 操作对象是目录容器，asset 操作对象是容器内的资产条目
+- `canvas folder list` 是取得目标目录 ID 的唯一目录命令；`canvas asset list` 当前仅支持 `--kind` 与 `--search`，不接受目录筛选参数
+- 复制后用目标项目的 `canvas asset get <assetId>` 或网页资产目录回读；目录结构和回收站状态以 `canvas folder list` 为准
+
 ## 关联资产参考图门禁（真假/版本/衍生）
 
 故事里存在“真/假”“原版/复制品”“同款不同状态”的成对道具、不同年龄同一人物、或母题相关的场景时，三视图和分镜图必须保持视觉血缘一致性，禁止各版本互不相干地自由发挥：
@@ -204,7 +244,7 @@ RunningHub MiniMax H3 的实时 `aspectRatio` 只有 16:9、9:16，`resolution`
 - 邮箱注册同样只通过交互式隐藏输入或安全 stdin 传递密码，不把密码放入命令参数、日志或仓库。
 - 用户已在当前会话明确提供密码时，可将其直接写入正在等待的交互式隐藏密码提示；不得复述密码、拼入 shell 命令、写入临时文件或跨会话保存。
 - 注册环境通过 profile `baseUrl` 区分；Supabase Redirect URLs 应预先允许各环境，禁止为单次本地注册临时修改全局 Site URL。
-- `config get` 只应返回 `hasApiKey`，不得依赖或要求服务端回显密钥。
+- `config get` 不返回全局 Provider 密钥；返回的模型已经过管理员发布和可用性校验，预检不得要求用户持有 Provider 密钥。
 - `project provider get` 只返回配置状态。`project provider set` 的 JSON 必须来自安全 stdin 或不入库的临时秘密文件，禁止把 Key 写进命令参数、仓库文件或会回显的 shell 历史。
 - 删除用户既有项目、覆盖完整画布或修改模型配置前，先明确目标和影响；没有授权就停在读取或生成变更计划。
 - `canvas apply` 只用于节点、连线、删除、视口等低层图补丁，不能代替 `canvas settings set`。同阶段有多个图变更时优先一次批量提交；已有画布快照时必须传 `--canvas-id` 和 `--expected-version`，不让 CLI 再预读全图。批量失败按“核心原则”分类处理，不能通过逐条重试绕过权限、schema、业务门禁或付费确认。遇到 409 才重新读取、合并并确认后重试。项目配置遇到 409 时也必须重新读取和确认。

package/skills/using-vvicat-ai-short-studio-cli/references/commands.md

@@ -193,7 +193,7 @@ ai-short-studio config get --json
 ai-short-studio config set --file <config.json> --json
 ```
 
-`config set` 接受 `models`、`providers`、`defaultModels`、`capabilityDefaults`、`workflowConcurrency` 的部分对象。provider 的 `apiKey` 缺省时保留现有密钥，空字符串表示清除；敏感配置文件不要提交到版本库。标准创作启动只执行只读的 `config get` 来计算账户默认模型的继承结果；不得用账户级 `config set` 代替项目的 canvas settings。
+`config set` 只接受 `defaultModels`、`capabilityDefaults`、`workflowConcurrency` 的部分对象；CLI 与服务端都会拒绝 `providers` 或 `models`。Provider 密钥和全局模型目录只能由管理员后台维护。标准创作启动只执行只读的 `config get` 来计算账户默认模型的继承结果；不得用账户级 `config set` 代替项目的 canvas settings。
 
 ## 标准创作命令顺序