@aswless_854771076/ai_short_studio_cli 0.1.32 → 0.1.34

package/README.md

@@ -13,6 +13,8 @@ ai-short-studio canvas node types --json
 
 npm 包内置 `using-vvicat-ai-short-studio-cli` Agent Skill。安装或升级 CLI 时，`postinstall` 会自动把该 Skill 安装或更新到 Codex；用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
 
+npm 安装或升级现在会同时安装 `using-vvicat-ai-short-studio-cli` 和 `short-drama`。`skill install/status/update` 默认管理全部内置 Skill，也可用 `--skill short-drama` 只管理短剧 Skill；某个 Skill 被用户修改时会独立跳过，不影响另一个 Skill。创作剧本使用 `short-drama`，操作 VVICAT 使用主 CLI Skill。
+
 邮箱注册和登录从 stdin 读取密码：
 
 ```bash
@@ -78,10 +80,12 @@ ai-short-studio canvas settings set --project "$PROJECT_ID" --file settings.json
 }
 ```
 
-`null` 或空字符串会清除项目覆盖并恢复继承。设置 `artStyle` 会把当前关联的 `visualBible` 保存为项目快照，画风库后续变化不会反向更新项目；同一请求显式传入 `visualBible` 时以显式值为准。所有者和管理员可写，协作者只读；409 冲突后重新 `settings get` 并携带新 `expectedVersion` 重试。`canvas apply` 仍用于节点、连线和视口等低层画布图补丁；它显式请求完整画布响应，正常保存不预读全图，409 后才读取最新状态并合并重试。Pexels 继续使用 `project provider get|set|test`。
+`null` 或空字符串会清除项目覆盖并恢复继承。设置 `artStyle` 会把当前关联的 `visualBible` 保存为项目快照，画风库后续变化不会反向更新项目；同一请求显式传入 `visualBible` 时以显式值为准。所有者和管理员可写，协作者只读；409 冲突后重新 `settings get` 并携带新 `expectedVersion` 重试。`canvas apply` 仍用于节点、连线、删除和视口等低层画布图补丁；同阶段有多个可合并图变更时默认一次批量提交并统一回读，批量入口不可用或合法批量请求仍因粒度失败时才回退单条命令。Pexels 继续使用 `project provider get|set|test`。
 
 使用 `canvas node edit-shot <nodeId> --project <projectId> --file shot.json` 编辑镜头。命令会追加并选中不可变的人工 DOCUMENT 版本，不允许修改 `shotKey`、`shotIndex` 或来源身份，旧版本继续可选。
 
+使用 `canvas node edit-resource <nodeId> --project <projectId> --file resource.json` 编辑剧本、人物、人物视觉、场景、子场景或道具结构化资源。命令只替换完整父文档中的目标实体，追加并选中人工版本；名称、资源键、ID 和所属关系不可修改，兄弟资源节点保持原选版。资源版本写入不属于 `canvas apply` 图补丁，409 后需重新读取画布与当前选版。
+
 CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置预检，并直接使用现有 `/api/projects`、`/api/canvas/node-types`、项目画布与资产路由。
 
 `canvas node types [kind] --json` 同时兼容节点目录 schema v1/v2，并原样返回动态节点的 `source`、`definitionId` 和 `definitionVersionId`。后台发布后重新执行该命令即可读取新目录；归档节点不能新建，但已有实例仍按画布中的固定版本 schema 更新和执行。CLI 创建节点只提交 `kind` 与配置，版本由服务端固定，不能由客户端伪造。
@@ -112,9 +116,10 @@ CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置
 ai-short-studio skill install --target codex
 ai-short-studio skill status --target codex
 ai-short-studio skill update --target codex
+ai-short-studio skill update --target codex --skill short-drama --json
 ```
 
-手动恢复或安装到其他 Agent 时，可使用 `--target agents` 或 `--directory <path>`。CLI 会记录版本和 SHA-256；已安装 Skill 被用户修改后，更新默认停止，只有显式 `--force` 才覆盖。自动安装可通过 `VVICAT_SKIP_SKILL_INSTALL=1` 跳过。
+手动恢复或安装到其他 Agent 时，可使用 `--target agents`；自定义全部内置 Skills 的父目录使用 `--root <path>`。旧版 `--directory <path>` 保留为兼容入口，只把主 CLI Skill 精确安装到该目录。自动安装对应使用 `VVICAT_SKILLS_ROOT`；旧变量 `VVICAT_SKILL_DIRECTORY` 仍保持主 Skill 精确目录语义。CLI 会记录版本和 SHA-256；已安装 Skill 被用户修改后，更新默认停止，只有显式 `--force` 才覆盖。自动安装可通过 `VVICAT_SKIP_SKILL_INSTALL=1` 跳过。
 
 ## 发布
 

package/dist/commands/canvas/node/edit-resource.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class CanvasNodeEditResource extends BaseCommand {
+    static args: {
+        nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        file: 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>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/canvas/node/edit-resource.js

@@ -0,0 +1,45 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
+export default class CanvasNodeEditResource extends BaseCommand {
+    static args = { nodeId: Args.string({ required: true }) };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        file: Flags.string({ description: '结构化资源 JSON 文件；省略时读取 stdin' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CanvasNodeEditResource);
+        const { api } = await commandApi(flags);
+        const canvas = await api.canvas(flags.project);
+        const node = canvas.nodes.find((candidate) => candidate.id === args.nodeId);
+        const rawArtifact = node?.data.artifact;
+        const artifact = rawArtifact && typeof rawArtifact === 'object' && !Array.isArray(rawArtifact)
+            ? rawArtifact
+            : null;
+        if (!node || !artifact
+            || artifact.type !== 'GENERATED_RESOURCE'
+            || typeof artifact.operation !== 'string' || !artifact.operation
+            || typeof artifact.resourceKey !== 'string' || !artifact.resourceKey
+            || typeof artifact.resourceType !== 'string' || !artifact.resourceType) {
+            throw new Error(`结构化资源节点不可编辑：${args.nodeId}`);
+        }
+        let basedOnVersionId = typeof node.data.selectedOutputVersionId === 'string'
+            ? node.data.selectedOutputVersionId
+            : '';
+        if (!basedOnVersionId && typeof node.refId === 'string') {
+            const payload = await api.asset(flags.project, node.refId);
+            const asset = payload.asset && typeof payload.asset === 'object' && !Array.isArray(payload.asset)
+                ? payload.asset
+                : {};
+            basedOnVersionId = typeof asset.selectedVersionId === 'string' ? asset.selectedVersionId : '';
+        }
+        if (!basedOnVersionId)
+            throw new Error('结构化资源当前版本不存在');
+        this.print(await api.updateStructuredResource(flags.project, args.nodeId, {
+            expectedCanvasVersion: canvas.version,
+            basedOnVersionId,
+            resource: await readJsonInput(flags.file),
+        }));
+    }
+}

package/dist/commands/skill/install.d.ts

@@ -4,6 +4,8 @@ export default class SkillInstall extends BaseCommand {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         target: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        skill: 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>;

package/dist/commands/skill/install.js

@@ -1,8 +1,17 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import { installSkill } from '../../skill/skill-manager.js';
-import { resolveSkillTarget, skillFlags } from '../../skill/command-flags.js';
+import { installSkill, installSkills, withLegacySkillFields } from '../../skill/skill-manager.js';
+import { resolveSkillsRoot, selectedSkillNames, skillFlags } from '../../skill/command-flags.js';
 export default class SkillInstall extends BaseCommand {
     static flags = { ...BaseCommand.baseFlags, ...skillFlags, force: Flags.boolean({ description: '覆盖非托管或已修改的 Skill' }) };
-    async run() { const { flags } = await this.parse(SkillInstall); this.print(await installSkill({ target: resolveSkillTarget(flags), force: flags.force })); }
+    async run() {
+        const { flags } = await this.parse(SkillInstall);
+        if (flags.directory) {
+            this.print(await installSkill({ target: flags.directory, force: flags.force }));
+            return;
+        }
+        this.print(withLegacySkillFields(await installSkills({
+            root: resolveSkillsRoot(flags), skills: selectedSkillNames(flags.skill), force: flags.force,
+        })));
+    }
 }

package/dist/commands/skill/path.d.ts

@@ -1,6 +1,10 @@
 import { BaseCommand } from '../../base-command.js';
 export default class SkillPath extends BaseCommand {
     static flags: {
+        target: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        skill: 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>;

package/dist/commands/skill/path.js

@@ -1,6 +1,17 @@
 import { BaseCommand } from '../../base-command.js';
+import { join } from 'node:path';
 import { bundledSkillPath } from '../../skill/skill-manager.js';
+import { resolveSkillsRoot, selectedSkillNames, skillFlags } from '../../skill/command-flags.js';
 export default class SkillPath extends BaseCommand {
-    static flags = { ...BaseCommand.baseFlags };
-    async run() { await this.parse(SkillPath); this.print({ path: bundledSkillPath() }); }
+    static flags = { ...BaseCommand.baseFlags, ...skillFlags };
+    async run() {
+        const { flags } = await this.parse(SkillPath);
+        if (flags.directory) {
+            this.print({ path: bundledSkillPath(), target: flags.directory });
+            return;
+        }
+        const root = resolveSkillsRoot(flags);
+        const skills = selectedSkillNames(flags.skill).map((name) => ({ name, path: join(root, name), bundledPath: bundledSkillPath(name) }));
+        this.print({ path: skills[0]?.bundledPath ?? bundledSkillPath(), root, skills });
+    }
 }

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

@@ -3,6 +3,8 @@ export default class SkillStatus extends BaseCommand {
     static flags: {
         target: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        skill: 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>;

package/dist/commands/skill/status.js

@@ -1,7 +1,17 @@
 import { BaseCommand } from '../../base-command.js';
-import { skillStatus } from '../../skill/skill-manager.js';
-import { resolveSkillTarget, skillFlags } from '../../skill/command-flags.js';
+import { skillStatus, skillStatuses, withLegacySkillFields } from '../../skill/skill-manager.js';
+import { resolveSkillsRoot, selectedSkillNames, skillFlags } from '../../skill/command-flags.js';
 export default class SkillStatus extends BaseCommand {
     static flags = { ...BaseCommand.baseFlags, ...skillFlags };
-    async run() { const { flags } = await this.parse(SkillStatus); this.print(await skillStatus(resolveSkillTarget(flags))); }
+    async run() {
+        const { flags } = await this.parse(SkillStatus);
+        if (flags.directory) {
+            this.print(await skillStatus(flags.directory));
+            return;
+        }
+        const result = await skillStatuses(resolveSkillsRoot(flags));
+        const selected = new Set(selectedSkillNames(flags.skill));
+        const skills = result.skills.filter((item) => selected.has(item.name));
+        this.print(withLegacySkillFields({ ...result, current: skills.every((item) => item.current), skills }));
+    }
 }

package/dist/domain/vvicat-api.d.ts

@@ -63,6 +63,7 @@ export declare class VvicatApi {
     }): Promise<JsonObject>;
     patchCanvas(projectId: string, input: JsonObject): Promise<JsonObject>;
     updateStoryboardShot(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
+    updateStructuredResource(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
     nodeTypes(): Promise<{
         schemaVersion: 1 | 2;
         catalogRevision?: string;

package/dist/domain/vvicat-api.js

@@ -121,6 +121,11 @@ export class VvicatApi {
             method: 'PATCH', body: input,
         });
     }
+    updateStructuredResource(projectId, nodeId, input) {
+        return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/structured-resource`, {
+            method: 'PATCH', body: input,
+        });
+    }
     async nodeTypes() {
         const payload = await this.client.request('/api/canvas/node-types');
         if (payload.data.schemaVersion !== 1 && payload.data.schemaVersion !== 2) {

package/dist/skill/command-flags.d.ts

@@ -1,8 +1,12 @@
+import { type BundledSkillName } from './skill-manager.js';
 export declare const skillFlags: {
     target: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    root: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    skill: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
 };
-export declare function resolveSkillTarget(flags: {
+export declare function resolveSkillsRoot(flags: {
     target: string;
-    directory?: string;
+    root?: string;
 }): string;
+export declare function selectedSkillNames(skill: string): readonly BundledSkillName[];

package/dist/skill/command-flags.js

@@ -1,9 +1,14 @@
 import { Flags } from '@oclif/core';
-import { defaultSkillTarget } from './skill-manager.js';
+import { BUNDLED_SKILL_NAMES, defaultSkillsRoot, normalizeSkillsRoot, } from './skill-manager.js';
 export const skillFlags = {
     target: Flags.string({ options: ['codex', 'agents'], default: 'codex', description: 'Agent 类型' }),
-    directory: Flags.string({ description: '自定义安装目录' }),
+    directory: Flags.string({ description: '兼容旧版：主 Skill 的精确安装目录', exclusive: ['root'] }),
+    root: Flags.string({ description: '全部内置 Skills 的根目录', exclusive: ['directory'] }),
+    skill: Flags.string({ options: ['all', ...BUNDLED_SKILL_NAMES], default: 'all', description: '要管理的内置 Skill' }),
 };
-export function resolveSkillTarget(flags) {
-    return flags.directory || defaultSkillTarget(flags.target);
+export function resolveSkillsRoot(flags) {
+    return normalizeSkillsRoot(flags.root || defaultSkillsRoot(flags.target));
+}
+export function selectedSkillNames(skill) {
+    return skill === 'all' ? BUNDLED_SKILL_NAMES : [skill];
 }

package/dist/skill/skill-manager.d.ts

@@ -1,7 +1,12 @@
+export declare const BUNDLED_SKILL_NAMES: readonly ["using-vvicat-ai-short-studio-cli", "short-drama"];
+export type BundledSkillName = typeof BUNDLED_SKILL_NAMES[number];
 export type SkillTarget = 'codex' | 'agents';
-export declare function bundledSkillPath(): string;
+export declare function bundledSkillPath(name?: BundledSkillName): string;
+export declare function defaultSkillsRoot(target: SkillTarget): string;
 export declare function defaultSkillTarget(target: SkillTarget): string;
+export declare function normalizeSkillsRoot(path: string): string;
 export declare function skillStatus(target: string): Promise<{
+    name: "using-vvicat-ai-short-studio-cli" | "short-drama";
     target: string;
     installed: boolean;
     managed: boolean;
@@ -10,10 +15,99 @@ export declare function skillStatus(target: string): Promise<{
     installedVersion: string | null;
     modified: boolean;
 }>;
+export declare function installSkills(input: {
+    root: string;
+    skills?: readonly BundledSkillName[];
+    force?: boolean;
+}): Promise<{
+    root: string;
+    current: boolean;
+    skills: ({
+        action: "unchanged";
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    } | {
+        action: "skipped";
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    } | {
+        action: "updated" | "installed";
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    })[];
+}>;
+export declare function autoInstallSkills(root: string): Promise<{
+    root: string;
+    current: boolean;
+    skills: ({
+        action: "unchanged";
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    } | {
+        action: "skipped";
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    } | {
+        action: "updated" | "installed";
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    })[];
+}>;
+export declare function skillStatuses(rootInput: string): Promise<{
+    root: string;
+    current: boolean;
+    skills: {
+        name: "using-vvicat-ai-short-studio-cli" | "short-drama";
+        target: string;
+        installed: boolean;
+        managed: boolean;
+        current: boolean;
+        packageVersion: string;
+        installedVersion: string | null;
+        modified: boolean;
+    }[];
+}>;
 export declare function installSkill(input: {
     target: string;
     force?: boolean;
 }): Promise<{
+    name: "using-vvicat-ai-short-studio-cli" | "short-drama";
     target: string;
     installed: boolean;
     managed: boolean;
@@ -23,6 +117,7 @@ export declare function installSkill(input: {
     modified: boolean;
 }>;
 export declare function autoInstallSkill(target: string): Promise<{
+    name: "using-vvicat-ai-short-studio-cli" | "short-drama";
     target: string;
     installed: boolean;
     managed: boolean;
@@ -32,6 +127,7 @@ export declare function autoInstallSkill(target: string): Promise<{
     modified: boolean;
     action: "unchanged";
 } | {
+    name: "using-vvicat-ai-short-studio-cli" | "short-drama";
     target: string;
     installed: boolean;
     managed: boolean;
@@ -41,6 +137,7 @@ export declare function autoInstallSkill(target: string): Promise<{
     modified: boolean;
     action: "skipped";
 } | {
+    name: "using-vvicat-ai-short-studio-cli" | "short-drama";
     target: string;
     installed: boolean;
     managed: boolean;
@@ -50,3 +147,10 @@ export declare function autoInstallSkill(target: string): Promise<{
     modified: boolean;
     action: "updated" | "installed";
 }>;
+export declare function withLegacySkillFields<T extends {
+    root: string;
+    current: boolean;
+    skills: Array<Record<string, unknown> & {
+        current: boolean;
+    }>;
+}>(result: T): Record<string, unknown>;

package/dist/skill/skill-manager.js

@@ -1,72 +1,112 @@
 import { createHash } from 'node:crypto';
 import { cp, mkdir, readFile, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
-import { dirname, join, relative } from 'node:path';
+import { basename, dirname, join, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
-const BUNDLED_SKILL = fileURLToPath(new URL('../../skills/using-vvicat-ai-short-studio-cli', import.meta.url));
+export const BUNDLED_SKILL_NAMES = ['using-vvicat-ai-short-studio-cli', 'short-drama'];
 const PACKAGE_JSON = fileURLToPath(new URL('../../package.json', import.meta.url));
 const MANIFEST = '.vvicat-skill.json';
-export function bundledSkillPath() {
-    return BUNDLED_SKILL;
+export function bundledSkillPath(name = BUNDLED_SKILL_NAMES[0]) {
+    return fileURLToPath(new URL(`../../skills/${name}`, import.meta.url));
+}
+export function defaultSkillsRoot(target) {
+    return join(homedir(), target === 'codex' ? '.codex' : '.agents', 'skills');
 }
 export function defaultSkillTarget(target) {
-    return join(homedir(), target === 'codex' ? '.codex' : '.agents', 'skills', 'using-vvicat-ai-short-studio-cli');
+    return join(defaultSkillsRoot(target), BUNDLED_SKILL_NAMES[0]);
 }
-export async function skillStatus(target) {
+export function normalizeSkillsRoot(path) {
+    return BUNDLED_SKILL_NAMES.includes(basename(path)) ? dirname(path) : path;
+}
+async function statusFor(name, target) {
     const packageVersion = await readPackageVersion();
-    const bundledChecksum = await directoryChecksum(BUNDLED_SKILL);
+    const bundledChecksum = await directoryChecksum(bundledSkillPath(name));
     const installed = await exists(target);
     const manifest = installed ? await readManifest(target) : null;
     const installedChecksum = installed ? await directoryChecksum(target) : null;
     return {
-        target,
-        installed,
-        managed: Boolean(manifest),
+        name, target, installed, managed: Boolean(manifest),
         current: Boolean(manifest && manifest.packageVersion === packageVersion && installedChecksum === bundledChecksum),
-        packageVersion,
-        installedVersion: manifest?.packageVersion ?? null,
+        packageVersion, installedVersion: manifest?.packageVersion ?? null,
         modified: Boolean(manifest && installedChecksum !== manifest.checksum),
     };
 }
-export async function installSkill(input) {
-    const current = await skillStatus(input.target);
-    if (current.installed && !input.force) {
-        if (!current.managed)
-            throw new Error('目标目录不是 CLI 管理的 Skill；使用 --force 才能替换');
-        if (current.modified)
-            throw new Error('已安装 Skill 已被修改；使用 --force 才能替换');
-    }
-    const checksum = await directoryChecksum(BUNDLED_SKILL);
+export async function skillStatus(target) {
+    return statusFor(BUNDLED_SKILL_NAMES[0], target);
+}
+async function installOne(name, target) {
+    const checksum = await directoryChecksum(bundledSkillPath(name));
     const packageVersion = await readPackageVersion();
-    const temporary = `${input.target}.tmp-${process.pid}`;
-    const backup = `${input.target}.backup-${process.pid}`;
-    await mkdir(dirname(input.target), { recursive: true });
+    const temporary = `${target}.tmp-${process.pid}`;
+    const backup = `${target}.backup-${process.pid}`;
+    await mkdir(dirname(target), { recursive: true });
     await rm(temporary, { recursive: true, force: true });
-    await cp(BUNDLED_SKILL, temporary, { recursive: true });
+    await cp(bundledSkillPath(name), temporary, { recursive: true });
     await writeFile(join(temporary, MANIFEST), `${JSON.stringify({ packageVersion, checksum }, null, 2)}\n`, 'utf8');
-    const hadTarget = await exists(input.target);
+    const hadTarget = await exists(target);
     try {
         if (hadTarget)
-            await rename(input.target, backup);
-        await rename(temporary, input.target);
+            await rename(target, backup);
+        await rename(temporary, target);
         if (hadTarget)
             await rm(backup, { recursive: true, force: true });
     }
     catch (error) {
         await rm(temporary, { recursive: true, force: true });
-        if (hadTarget && await exists(backup) && !await exists(input.target))
-            await rename(backup, input.target);
+        if (hadTarget && await exists(backup) && !await exists(target))
+            await rename(backup, target);
         throw error;
     }
-    return skillStatus(input.target);
+    return statusFor(name, target);
+}
+export async function installSkills(input) {
+    const root = normalizeSkillsRoot(input.root);
+    const results = [];
+    for (const name of input.skills ?? BUNDLED_SKILL_NAMES) {
+        const target = join(root, name);
+        const current = await statusFor(name, target);
+        if (current.current) {
+            results.push({ ...current, action: 'unchanged' });
+            continue;
+        }
+        if (current.installed && !input.force && (!current.managed || current.modified)) {
+            results.push({ ...current, action: 'skipped' });
+            continue;
+        }
+        results.push({ ...await installOne(name, target), action: current.installed ? 'updated' : 'installed' });
+    }
+    return { root, current: results.every((item) => item.current), skills: results };
+}
+export function autoInstallSkills(root) {
+    return installSkills({ root });
+}
+export async function skillStatuses(rootInput) {
+    const root = normalizeSkillsRoot(rootInput);
+    const skills = await Promise.all(BUNDLED_SKILL_NAMES.map((name) => statusFor(name, join(root, name))));
+    return { root, current: skills.every((item) => item.current), skills };
+}
+export async function installSkill(input) {
+    const name = BUNDLED_SKILL_NAMES[0];
+    const current = await statusFor(name, input.target);
+    if (current.installed && !input.force) {
+        if (!current.managed)
+            throw new Error('目标目录不是 CLI 管理的 Skill；使用 --force 才能替换');
+        if (current.modified)
+            throw new Error('已安装 Skill 已被修改；使用 --force 才能替换');
+    }
+    return installOne(name, input.target);
 }
 export async function autoInstallSkill(target) {
-    const current = await skillStatus(target);
+    const name = BUNDLED_SKILL_NAMES[0];
+    const current = await statusFor(name, target);
     if (current.current)
         return { action: 'unchanged', ...current };
     if (current.installed && (!current.managed || current.modified))
         return { action: 'skipped', ...current };
-    return { action: current.installed ? 'updated' : 'installed', ...await installSkill({ target }) };
+    return { action: current.installed ? 'updated' : 'installed', ...await installOne(name, target) };
+}
+export function withLegacySkillFields(result) {
+    return { ...result.skills[0], root: result.root, allCurrent: result.current, skills: result.skills };
 }
 async function directoryChecksum(root) {
     const files = await filesBelow(root);

package/package.json

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

package/scripts/postinstall.mjs

@@ -1,4 +1,4 @@
-import { resolve } from 'node:path'
+import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const packageRoot = fileURLToPath(new URL('../', import.meta.url))
@@ -11,9 +11,21 @@ export function shouldAutoInstallSkill(environment = process.env) {
 export async function main(environment = process.env) {
   if (!shouldAutoInstallSkill(environment)) return
   try {
-    const { autoInstallSkill, defaultSkillTarget } = await import('../dist/skill/skill-manager.js')
-    const result = await autoInstallSkill(environment.VVICAT_SKILL_DIRECTORY || defaultSkillTarget('codex'))
-    process.stdout.write(`VVICAT Skill ${result.action}: ${result.target}\n`)
+    const { autoInstallSkill, autoInstallSkills, defaultSkillsRoot, installSkills } = await import('../dist/skill/skill-manager.js')
+    const result = environment.VVICAT_SKILL_DIRECTORY
+      ? {
+          skills: [
+            await autoInstallSkill(environment.VVICAT_SKILL_DIRECTORY),
+            ...(await installSkills({
+              root: dirname(environment.VVICAT_SKILL_DIRECTORY),
+              skills: ['short-drama'],
+            })).skills,
+          ],
+        }
+      : await autoInstallSkills(environment.VVICAT_SKILLS_ROOT || defaultSkillsRoot('codex'))
+    for (const skill of result.skills) {
+      process.stdout.write(`VVICAT Skill ${skill.name} ${skill.action}: ${skill.target}\n`)
+    }
   } catch (error) {
     process.stderr.write(`VVICAT CLI 已安装，Skill 自动安装已跳过：${error instanceof Error ? error.message : String(error)}\n`)
   }

package/skills/short-drama/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 0xsline
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.