@aswless_854771076/ai_short_studio_cli 0.1.146 → 0.1.148

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +7 -7
  2. package/dist/commands/art-style/bind.d.ts +14 -0
  3. package/dist/commands/art-style/bind.js +11 -0
  4. package/dist/commands/art-style/create.d.ts +12 -0
  5. package/dist/commands/art-style/create.js +14 -0
  6. package/dist/commands/art-style/disable.d.ts +14 -0
  7. package/dist/commands/art-style/disable.js +12 -0
  8. package/dist/commands/art-style/generate.d.ts +12 -0
  9. package/dist/commands/art-style/generate.js +12 -0
  10. package/dist/commands/art-style/preview.d.ts +15 -0
  11. package/dist/commands/art-style/preview.js +12 -0
  12. package/dist/commands/art-style/update.d.ts +15 -0
  13. package/dist/commands/art-style/update.js +12 -0
  14. package/dist/commands/canvas/voice/bind.d.ts +16 -0
  15. package/dist/commands/canvas/voice/bind.js +12 -0
  16. package/dist/commands/canvas/voice/list.d.ts +11 -0
  17. package/dist/commands/canvas/voice/list.js +10 -0
  18. package/dist/commands/canvas/voice/unbind.d.ts +15 -0
  19. package/dist/commands/canvas/voice/unbind.js +12 -0
  20. package/dist/commands/canvas/voice/upload.d.ts +17 -0
  21. package/dist/commands/canvas/voice/upload.js +23 -0
  22. package/dist/domain/vvicat-api.d.ts +11 -0
  23. package/dist/domain/vvicat-api.js +38 -0
  24. package/package.json +1 -1
  25. package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +5 -5
  26. package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +3 -3
  27. package/skills/using-vvicat-ai-short-studio-cli/references/video-model-routing.md +10 -0
  28. package/skills/using-vvicat-ai-short-studio-cli/references/video-prompt-spec.md +32 -0
package/README.md CHANGED
@@ -11,11 +11,11 @@ ai-short-studio project list --json
11
11
  ai-short-studio canvas node types --json
12
12
  ```
13
13
 
14
- npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill。hypit、短剧和 humanizer 等第三方资料统一放在该 Skill 的 `references/` 下。安装或升级 CLI 时,`postinstall` 会自动安装或更新这个 Skill;用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
14
+ npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill。短剧和 humanizer 等参考资料统一放在该 Skill 的 `references/` 下。安装或升级 CLI 时,`postinstall` 会自动安装或更新这个 Skill;用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
15
15
 
16
16
  短剧采用专业拆镜,Agent 按每镜制作目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;不会自动补生成未选择的板型。用户要求只完成分镜图时不执行视频提示词或视频。`canvas node edit-shot` 会同步镜头字段别名并拒绝改写来源原文;修改时长后检查响应的 `durationOverrides`,保留的下游手工时长需要逐项确认。
17
17
 
18
- `skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer 审计和 hypit 视频制作资料通过主 Skill 的 references 按需读取。
18
+ `skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer 审计和自由画布视频制作资料通过主 Skill 的 references 按需读取。
19
19
 
20
20
  CLI 默认使用 MemHub 浏览器授权。已有 Supabase 登录档案仍可用于兼容旧环境,但公开帮助只展示 MemHub 登录方式。
21
21
 
@@ -35,7 +35,7 @@ CLI 将长期凭据保存到系统钥匙串。短期 access token 会写入权
35
35
  - `ai-short-studio canvas edge`:连线读写。
36
36
  - `ai-short-studio canvas continuity analyze`:视频生成前分析镜头依赖,可修复已具备源视频的首尾帧连线。
37
37
  - `ai-short-studio canvas asset`:资产列表、上传、版本选择和下载。
38
- - `ai-short-studio canvas documents`:一次读取当前分集的 Hypit 文档、选版和阻塞原因;`canvas document get|save|status` 读取、保存或检查单个文档。
38
+ - `ai-short-studio canvas documents`:一次读取当前分集的 自由画布文档、选版和阻塞原因;`canvas document get|save|status` 读取、保存或检查单个文档。
39
39
  - `ai-short-studio canvas workflow status`:读取当前阶段、基础模块门禁和下一步缺失项。
40
40
  - `ai-short-studio canvas asset review-context|review`:读取当前媒体摘要和必需维度,提交实际逐项审核并追加独立审核文档;不自动生成通过结论。
41
41
  - `ai-short-studio canvas folder`:画布资产目录管理(5 预设 + 用户子目录 + 软删 + 跨项目复制)。
@@ -127,7 +127,7 @@ CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置
127
127
 
128
128
  `storyboard-breakdown` 还可按实时 schema 写入 `targetDurationSeconds`、`pacingPreset` 和 `maxShotCount`。结构化剧本会先生成固定镜号、顺序和来源的确定性骨架;其中 `maxShotCount` 是硬预算,无法完整覆盖来源时会在模型调用前明确失败。纯文本旧链路仍按软提醒处理镜头数,`targetDurationSeconds` 始终是柔性时长目标。留空时不限制镜头数,也不启用时长硬门禁。生成链采用滚动异步调度:单镜分镜图完成后立即进入视频提示词,提示词通过审计后立即提交该镜视频,可恢复失败不阻塞其他镜头。内置 Skill 同时补全字幕、人物/场景首次介绍角标、有动机的镜头衔接、声音平衡和成片验收流程。
129
129
 
130
- 标准短剧制作读取主 Skill `references/short-drama/` 与 `references/humanizer/`:先生成和复核专业剧本,再审计模板化台词、虚浮修辞与机械节奏,最后检查剧情连贯性。hypit 视频制作流程读取 `references/hypit/`。Humanizer 只润色表达,不改剧情事实、人物关系、专有名词、数字、时间线、世界观规则、场次结构或拍摄标记。剧本确认后再选择目标集数、创建或复用项目,并只建立目标集实际出现的人物、场景、道具和可选音色设定。拆镜前必须完成资产—剧情匹配审计;拆镜后逐镜全量检查重复、无效、缺失、冲突、穿帮、连续性、道具交互朝向、语言和来源身份。P0/P1 未清零时不得进入图片、声音或视频生产。
130
+ 标准短剧制作读取主 Skill `references/short-drama/` 与 `references/humanizer/`:先生成和复核专业剧本,再审计模板化台词、虚浮修辞与机械节奏,最后检查剧情连贯性。自由画布视频制作流程读取随包参考目录。Humanizer 只润色表达,不改剧情事实、人物关系、专有名词、数字、时间线、世界观规则、场次结构或拍摄标记。剧本确认后再选择目标集数、创建或复用项目,并只建立目标集实际出现的人物、场景、道具和可选音色设定。拆镜前必须完成资产—剧情匹配审计;拆镜后逐镜全量检查重复、无效、缺失、冲突、穿帮、连续性、道具交互朝向、语言和来源身份。P0/P1 未清零时不得进入图片、声音或视频生产。
131
131
 
132
132
  `character-visual-design` schema 暴露 `candidateCount`,范围为 1~3,默认值为 1。CLI 按实时 schema 校验和写入;多个视觉描述仍分别进入独立三视图和图片资产链。
133
133
 
@@ -215,10 +215,10 @@ npm run release:ci:test -- --version 0.1.1-beta.0
215
215
 
216
216
  ### Agent 恢复 / Agent recovery
217
217
 
218
- 新项目先运行 `canvas documents` 和 `canvas workflow status`,由 Agent 在无限画布创建 Hypit JSON 文档;用 `canvas document save` 追加版本,用 `canvas document status` 检查上游选版。`canvas node diagnose <nodeId>` 仅用于历史媒体节点的恢复,不是新流程入口。完整操作见随包 Skill 的 Hypit 文档流程。
218
+ 新项目先运行 `canvas documents` 和 `canvas workflow status`,由 Agent 在无限画布创建 自由画布 JSON 文档;用 `canvas document save` 追加版本,用 `canvas document status` 检查上游选版。`canvas node diagnose <nodeId>` 仅用于历史媒体节点的恢复,不是新流程入口。完整操作见随包 Skill 的 自由画布文档流程。
219
219
 
220
220
  Use `canvas node diagnose` to inspect inputs, selected versions, task status and recovery actions without running a model. `canvas node storyboard-draft` reads an unapproved planning draft; `--file` submits explicit edit/promote requests and `--dry-run` previews them. Content errors do not prevent draft saves. Promotion validates the complete plan; draft saves neither change the formal selection nor generate media. See the bundled Skill's `references/agent-recovery.md`. Image quality is inspected by a person or Agent; the platform checks review records and provenance, rather than detecting visual defects automatically.
221
221
 
222
- Agent 可直接在 `text-resource` 节点保存 `hypit.script.v1`、`hypit.director-book.v1` 和 `hypit.production-plan.v1` 等文档;每次保存都通过 `--input` 固化上游版本,审核使用独立 `hypit.review.v1` 文档。历史 `screenplay-resource` 和 `storyboard-draft` 只用于迁移旧项目,不得用于新项目。
222
+ Agent 可直接在 `text-resource` 节点保存剧本、导演本和制作计划等自由画布文档(底层 schema key 保持兼容);每次保存都通过 `--input` 固化上游版本,审核使用独立 `hypit.review.v1` 文档。历史 `screenplay-resource` 和 `storyboard-draft` 只用于迁移旧项目,不得用于新项目。
223
223
 
224
- Agents author Hypit JSON documents directly in `text-resource` nodes and preserve every source version through `--input`; legacy screenplay resources and storyboard drafts are migration-only compatibility paths.
224
+ Agents author freeform JSON documents directly in `text-resource` nodes and preserve every source version through `--input`; legacy screenplay resources and storyboard drafts are migration-only compatibility paths.
@@ -0,0 +1,14 @@
1
+ import { BaseCommand } from '../../base-command.js';
2
+ export default class ArtStyleBind extends BaseCommand {
3
+ static flags: {
4
+ project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
5
+ style: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
6
+ version: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
7
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
8
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
9
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
10
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
11
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ };
13
+ run(): Promise<void>;
14
+ }
@@ -0,0 +1,11 @@
1
+ import { Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../base-command.js';
3
+ import { commandApi, projectFlag } from '../../command-helpers.js';
4
+ export default class ArtStyleBind extends BaseCommand {
5
+ static flags = { ...BaseCommand.baseFlags, project: projectFlag, style: Flags.string({ required: true }), version: Flags.integer() };
6
+ async run() {
7
+ const { flags } = await this.parse(ArtStyleBind);
8
+ const { api } = await commandApi(flags);
9
+ this.print(await api.bindArtStyle(flags.project, flags.style, flags.version));
10
+ }
11
+ }
@@ -0,0 +1,12 @@
1
+ import { BaseCommand } from '../../base-command.js';
2
+ export default class ArtStyleCreate extends BaseCommand {
3
+ static flags: {
4
+ file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
5
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
6
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
7
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
8
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
9
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ };
11
+ run(): Promise<void>;
12
+ }
@@ -0,0 +1,14 @@
1
+ import { Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../base-command.js';
3
+ import { commandApi, readJsonInput } from '../../command-helpers.js';
4
+ export default class ArtStyleCreate extends BaseCommand {
5
+ static flags = { ...BaseCommand.baseFlags, file: Flags.string({ description: '完整画风 JSON;省略时读取 stdin' }) };
6
+ async run() {
7
+ const { flags } = await this.parse(ArtStyleCreate);
8
+ const { api } = await commandApi(flags);
9
+ const input = await readJsonInput(flags.file);
10
+ if (typeof input.name !== 'string' || typeof input.prompt !== 'string' || !input.visualBible)
11
+ throw new Error('画风必须包含 name、prompt 和 visualBible;请先完成用户确认');
12
+ this.print(await api.createArtStyle(input));
13
+ }
14
+ }
@@ -0,0 +1,14 @@
1
+ import { BaseCommand } from '../../base-command.js';
2
+ export default class ArtStyleDisable extends BaseCommand {
3
+ static args: {
4
+ styleId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static flags: {
7
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
8
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
9
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
10
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
11
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ };
13
+ run(): Promise<void>;
14
+ }
@@ -0,0 +1,12 @@
1
+ import { Args } from '@oclif/core';
2
+ import { BaseCommand } from '../../base-command.js';
3
+ import { commandApi } from '../../command-helpers.js';
4
+ export default class ArtStyleDisable extends BaseCommand {
5
+ static args = { styleId: Args.string({ required: true }) };
6
+ static flags = { ...BaseCommand.baseFlags };
7
+ async run() {
8
+ const { args, flags } = await this.parse(ArtStyleDisable);
9
+ const { api } = await commandApi(flags);
10
+ this.print(await api.disableArtStyle(args.styleId));
11
+ }
12
+ }
@@ -0,0 +1,12 @@
1
+ import { BaseCommand } from '../../base-command.js';
2
+ export default class ArtStyleGenerate extends BaseCommand {
3
+ static flags: {
4
+ file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
5
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
6
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
7
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
8
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
9
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ };
11
+ run(): Promise<void>;
12
+ }
@@ -0,0 +1,12 @@
1
+ import { Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../base-command.js';
3
+ import { commandApi, readJsonInput } from '../../command-helpers.js';
4
+ export default class ArtStyleGenerate extends BaseCommand {
5
+ static flags = { ...BaseCommand.baseFlags, file: Flags.string({ description: '画风描述 JSON;省略时读取 stdin' }), locale: Flags.string({ options: ['zh', 'en'], default: 'zh' }) };
6
+ async run() {
7
+ const { flags } = await this.parse(ArtStyleGenerate);
8
+ const { api } = await commandApi(flags);
9
+ const input = await readJsonInput(flags.file);
10
+ this.print(await api.generateArtStyle({ ...input, locale: flags.locale }));
11
+ }
12
+ }
@@ -0,0 +1,15 @@
1
+ import { BaseCommand } from '../../base-command.js';
2
+ export default class ArtStylePreview extends BaseCommand {
3
+ static args: {
4
+ styleId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static flags: {
7
+ model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
8
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
9
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
11
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
13
+ };
14
+ run(): Promise<void>;
15
+ }
@@ -0,0 +1,12 @@
1
+ import { Args, Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../base-command.js';
3
+ import { commandApi } from '../../command-helpers.js';
4
+ export default class ArtStylePreview extends BaseCommand {
5
+ static args = { styleId: Args.string({ required: true }) };
6
+ static flags = { ...BaseCommand.baseFlags, model: Flags.string({ required: true }), locale: Flags.string({ options: ['zh', 'en'], default: 'zh' }) };
7
+ async run() {
8
+ const { args, flags } = await this.parse(ArtStylePreview);
9
+ const { api } = await commandApi(flags);
10
+ this.print(await api.previewArtStyle({ styleId: args.styleId, model: flags.model, locale: flags.locale }));
11
+ }
12
+ }
@@ -0,0 +1,15 @@
1
+ import { BaseCommand } from '../../base-command.js';
2
+ export default class ArtStyleUpdate extends BaseCommand {
3
+ static args: {
4
+ styleId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static flags: {
7
+ file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
8
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
9
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
10
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
11
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
13
+ };
14
+ run(): Promise<void>;
15
+ }
@@ -0,0 +1,12 @@
1
+ import { Args, Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../base-command.js';
3
+ import { commandApi, readJsonInput } from '../../command-helpers.js';
4
+ export default class ArtStyleUpdate extends BaseCommand {
5
+ static args = { styleId: Args.string({ required: true }) };
6
+ static flags = { ...BaseCommand.baseFlags, file: Flags.string({ description: '画风更新 JSON;省略时读取 stdin' }) };
7
+ async run() {
8
+ const { args, flags } = await this.parse(ArtStyleUpdate);
9
+ const { api } = await commandApi(flags);
10
+ this.print(await api.updateArtStyle(args.styleId, await readJsonInput(flags.file)));
11
+ }
12
+ }
@@ -0,0 +1,16 @@
1
+ import { BaseCommand } from '../../../base-command.js';
2
+ export default class CanvasVoiceBind extends BaseCommand {
3
+ static args: {
4
+ characterId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static flags: {
7
+ project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
8
+ voice: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
9
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
11
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
12
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
13
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
14
+ };
15
+ run(): Promise<void>;
16
+ }
@@ -0,0 +1,12 @@
1
+ import { Args, Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../../base-command.js';
3
+ import { commandApi, projectFlag } from '../../../command-helpers.js';
4
+ export default class CanvasVoiceBind extends BaseCommand {
5
+ static args = { characterId: Args.string({ required: true }) };
6
+ static flags = { ...BaseCommand.baseFlags, project: projectFlag, voice: Flags.string({ required: true }) };
7
+ async run() {
8
+ const { args, flags } = await this.parse(CanvasVoiceBind);
9
+ const { api } = await commandApi(flags);
10
+ this.print(await api.bindCharacterVoice(flags.project, args.characterId, flags.voice));
11
+ }
12
+ }
@@ -0,0 +1,11 @@
1
+ import { BaseCommand } from '../../../base-command.js';
2
+ export default class CanvasVoiceList extends BaseCommand {
3
+ static flags: {
4
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
5
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
6
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
7
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
8
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
9
+ };
10
+ run(): Promise<void>;
11
+ }
@@ -0,0 +1,10 @@
1
+ import { BaseCommand } from '../../../base-command.js';
2
+ import { commandApi } from '../../../command-helpers.js';
3
+ export default class CanvasVoiceList extends BaseCommand {
4
+ static flags = { ...BaseCommand.baseFlags };
5
+ async run() {
6
+ const { flags } = await this.parse(CanvasVoiceList);
7
+ const { api } = await commandApi(flags);
8
+ this.print(await api.listVoices());
9
+ }
10
+ }
@@ -0,0 +1,15 @@
1
+ import { BaseCommand } from '../../../base-command.js';
2
+ export default class CanvasVoiceUnbind extends BaseCommand {
3
+ static args: {
4
+ characterId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static flags: {
7
+ project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
8
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
9
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
10
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
11
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
13
+ };
14
+ run(): Promise<void>;
15
+ }
@@ -0,0 +1,12 @@
1
+ import { Args } from '@oclif/core';
2
+ import { BaseCommand } from '../../../base-command.js';
3
+ import { commandApi, projectFlag } from '../../../command-helpers.js';
4
+ export default class CanvasVoiceUnbind extends BaseCommand {
5
+ static args = { characterId: Args.string({ required: true }) };
6
+ static flags = { ...BaseCommand.baseFlags, project: projectFlag };
7
+ async run() {
8
+ const { args, flags } = await this.parse(CanvasVoiceUnbind);
9
+ const { api } = await commandApi(flags);
10
+ this.print(await api.bindCharacterVoice(flags.project, args.characterId, null));
11
+ }
12
+ }
@@ -0,0 +1,17 @@
1
+ import { BaseCommand } from '../../../base-command.js';
2
+ export default class CanvasVoiceUpload extends BaseCommand {
3
+ static args: {
4
+ file: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static flags: {
7
+ name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
8
+ description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
9
+ folder: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
11
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
12
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
13
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
14
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
15
+ };
16
+ run(): Promise<void>;
17
+ }
@@ -0,0 +1,23 @@
1
+ import { basename, extname } from 'node:path';
2
+ import { readFile } from 'node:fs/promises';
3
+ import { Args, Flags } from '@oclif/core';
4
+ import { BaseCommand } from '../../../base-command.js';
5
+ import { commandApi } from '../../../command-helpers.js';
6
+ const MIME = { '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.m4a': 'audio/mp4', '.aac': 'audio/aac', '.ogg': 'audio/ogg' };
7
+ export default class CanvasVoiceUpload extends BaseCommand {
8
+ static args = { file: Args.string({ required: true }) };
9
+ static flags = { ...BaseCommand.baseFlags, name: Flags.string({ required: true }), description: Flags.string(), folder: Flags.string() };
10
+ async run() {
11
+ const { args, flags } = await this.parse(CanvasVoiceUpload);
12
+ const bytes = await readFile(args.file);
13
+ const form = new FormData();
14
+ form.set('file', new Blob([bytes], { type: MIME[extname(args.file).toLowerCase()] || 'application/octet-stream' }), basename(args.file));
15
+ form.set('name', flags.name);
16
+ if (flags.description)
17
+ form.set('description', flags.description);
18
+ if (flags.folder)
19
+ form.set('folderId', flags.folder);
20
+ const { api } = await commandApi(flags);
21
+ this.print(await api.uploadVoice(form));
22
+ }
23
+ }
@@ -82,6 +82,17 @@ export declare class VvicatApi {
82
82
  createCanvasEpisode(projectId: string, episodeNumber: number, name?: string): Promise<JsonObject>;
83
83
  canvasSettings(projectId: string): Promise<JsonObject>;
84
84
  updateCanvasSettings(projectId: string, input: JsonObject): Promise<JsonObject>;
85
+ listArtStyles(includeDrafts?: boolean): Promise<JsonObject>;
86
+ generateArtStyle(input: JsonObject): Promise<JsonObject>;
87
+ createArtStyle(input: JsonObject): Promise<JsonObject>;
88
+ previewArtStyle(input: JsonObject): Promise<JsonObject>;
89
+ updateArtStyle(styleId: string, input: JsonObject): Promise<JsonObject>;
90
+ disableArtStyle(styleId: string): Promise<JsonObject>;
91
+ bindArtStyle(projectId: string, styleId: string, expectedVersion?: number): Promise<JsonObject>;
92
+ listVoices(): Promise<JsonObject>;
93
+ uploadVoice(formData: FormData): Promise<JsonObject>;
94
+ bindCharacterVoice(projectId: string, characterId: string, globalVoiceId: string | null): Promise<JsonObject>;
95
+ characterVoice(projectId: string, characterId: string): Promise<JsonObject>;
85
96
  listFolders(projectId: string, query?: string): Promise<JsonObject>;
86
97
  createFolder(projectId: string, input: {
87
98
  name: string;
@@ -119,6 +119,44 @@ export class VvicatApi {
119
119
  updateCanvasSettings(projectId, input) {
120
120
  return this.client.request(`/api/projects/${projectId}/canvas/settings`, { method: 'PATCH', body: input });
121
121
  }
122
+ listArtStyles(includeDrafts = true) {
123
+ return this.client.request(`/api/art-styles?includeDrafts=${includeDrafts ? '1' : '0'}`);
124
+ }
125
+ generateArtStyle(input) {
126
+ return this.client.request('/api/art-styles/generate-prompt', { method: 'POST', body: input });
127
+ }
128
+ createArtStyle(input) {
129
+ return this.client.request('/api/art-styles', { method: 'POST', body: input });
130
+ }
131
+ previewArtStyle(input) {
132
+ return this.client.request('/api/art-styles/generate-preview', { method: 'POST', body: input });
133
+ }
134
+ updateArtStyle(styleId, input) {
135
+ return this.client.request(`/api/art-styles/${styleId}`, { method: 'PATCH', body: input });
136
+ }
137
+ disableArtStyle(styleId) {
138
+ return this.client.request(`/api/art-styles/${styleId}`, { method: 'DELETE' });
139
+ }
140
+ async bindArtStyle(projectId, styleId, expectedVersion) {
141
+ return this.updateCanvasSettings(projectId, {
142
+ values: { artStyleId: styleId },
143
+ ...(expectedVersion === undefined ? {} : { expectedVersion }),
144
+ });
145
+ }
146
+ listVoices() {
147
+ return this.client.request('/api/asset-hub/voices');
148
+ }
149
+ uploadVoice(formData) {
150
+ return this.client.request('/api/asset-hub/voices/upload', { method: 'POST', body: formData });
151
+ }
152
+ bindCharacterVoice(projectId, characterId, globalVoiceId) {
153
+ return this.client.request(`/api/novel-promotion/${projectId}/character/${characterId}/voice`, {
154
+ method: 'PATCH', body: { globalVoiceId },
155
+ });
156
+ }
157
+ characterVoice(projectId, characterId) {
158
+ return this.client.request(`/api/novel-promotion/${projectId}/character/${characterId}/voice`);
159
+ }
122
160
  listFolders(projectId, query = '') {
123
161
  // 树形目录列表;预设 5 项 + 用户子目录(含 deletedAt / purgeInDays / referencedBy)
124
162
  return this.client.request(`/api/projects/${projectId}/canvas-folders${query ? `?${query}` : ''}`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.146",
3
+ "version": "0.1.148",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: using-vvicat-ai-short-studio-cli
3
- description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI. Hypit freeform JSON documents and workflow status are the canonical production interface; legacy fixed-node commands are read-only compatibility paths for existing projects.
3
+ description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI. Freeform JSON documents and workflow status are the canonical production interface; legacy fixed-node commands are read-only compatibility paths for existing projects.
4
4
  ---
5
5
 
6
6
  # 使用 VVICAT AI Short Studio CLI
@@ -33,7 +33,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
33
33
  | 人物、场景、道具和资产版本 | `references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
34
34
  | 导演手册、摄影、表演、分镜和镜头变体 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/director-composition.md` | `drama-director-book → storyboard-breakdown → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,读取构图受控词表,证据不足时降级构图,不补陈设或天气 |
35
35
  | 逐镜制作、跨镜连续性、previous-tail | `references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | 先生成 `drama-production-plan`,再生成 `drama-continuity-plan`;只有前镜已审核且选版时允许 previous-tail |
36
- | 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/generation/seedance-community-skills.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存 Hypit 文档;按实时 Provider schema 选择协议并审计后提交视频 |
36
+ | 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/generation/seedance-community-skills.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存 自由画布文档;按实时 Provider schema 选择协议并审计后提交视频 |
37
37
  | 背景音乐、主题曲、纯音乐 | `references/short-drama/generation/design-drama-audio.md`、`references/short-drama/starrouter-provider.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
38
38
  | 去字幕、参考视频复刻、深度视频 | `references/hypit/playbooks/formats/reference-recreation-canvas.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → recreation-depth-preprocess/depth-video → video-generate`;不得把参考板或字幕带入成片 |
39
39
  | 参考对白转写、剪辑、字幕和多图模板 | `references/hypit/SKILL.md`、`references/hypit/environment/local-tools.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
@@ -41,9 +41,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
41
41
 
42
42
  自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `hypit.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
43
43
 
44
- 新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource` Hypit 文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的 Hypit 文档和选定媒体版本。
44
+ 新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的 自由画布文档和选定媒体版本。
45
45
 
46
- 旧版固定节点命令仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 Hypit 文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 Hypit 文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点。
46
+ 旧版固定节点命令仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点。
47
47
  ## 核心原则
48
48
 
49
49
  生产环境认证优先使用 MemHub;CLI 通过浏览器 PKCE 登录或个人 API Key 访问,只有本地明确关闭 MemHub 时才使用 Supabase 兼容登录。
@@ -57,7 +57,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
57
57
  1. **预检与恢复**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`。只有历史项目需要新增媒体节点时才读取实时 `canvas node types`。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
58
58
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
59
59
  3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
60
- 4. **Hypit 文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `hypit.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `hypit.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有 Hypit 文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 Hypit 文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
60
+ 4. **自由画布文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `hypit.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `hypit.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
61
61
  5. **资产门禁**:先完成人物、场景、道具及其派生版本,展示真实预览并确认 selected version。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
62
  6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
63
63
  7. **视频规划**:视频生成前依次完成素材连线、镜头逻辑和上下镜连续性审计。读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。
@@ -10,7 +10,7 @@ ai-short-studio canvas node types --json
10
10
 
11
11
  常见审计优先通过 `inspect` 的 `--kind`、`--status`、`--search`、`--operation`、`--resource-type`、`--producer-node` 过滤。同阶段多个图变更用一次 `apply`;409 后重读并合并。
12
12
 
13
- ## Hypit 自由文档(新项目唯一入口)
13
+ ## 自由画布文档(新项目唯一入口)
14
14
 
15
15
  新项目不得通过固定功能节点编排短剧。先运行:
16
16
 
@@ -23,7 +23,7 @@ ai-short-studio canvas workflow status --project <projectId> --json
23
23
 
24
24
  ## 历史节点兼容
25
25
 
26
- 下面的节点命令仅用于读取、审计和迁移历史项目,不得作为新项目的流程入口,也不得与 Hypit 文档并行写入同一阶段。
26
+ 下面的节点命令仅用于读取、审计和迁移历史项目,不得作为新项目的流程入口,也不得与 自由画布文档并行写入同一阶段。
27
27
 
28
28
  ## 节点
29
29
 
@@ -43,7 +43,7 @@ ai-short-studio canvas node delete <nodeId> --project <projectId> --yes --json
43
43
 
44
44
  `--asset-id` 仅用于 `image`、`video`、`audio` 媒体节点,把已有资产的 selected 版本绑定为节点输出;CLI 会先按实时节点目录拒绝非媒体节点,资产类型仍由服务端校验。上传资产后先用 `canvas asset list` 或上传响应取得资产 ID,再创建媒体节点并连线。
45
45
 
46
- Hypit JSON 产物保存到 `text-resource` 节点;每次保存追加版本,`--input` 记录上游节点当前资产选版。续写前先读状态,`ready: false` 时根据 `staleInputs` 重做受影响产物,不能沿用旧审核。
46
+ 自由画布 JSON 产物保存到 `text-resource` 节点;每次保存追加版本,`--input` 记录上游节点当前资产选版。续写前先读状态,`ready: false` 时根据 `staleInputs` 重做受影响产物,不能沿用旧审核。
47
47
 
48
48
  ```bash
49
49
  ai-short-studio canvas document get <scriptNodeId> --project <projectId> --json
@@ -0,0 +1,10 @@
1
+ # 视频模型路由
2
+
3
+ 1. 模型合同优先于 LibTV 风格偏好。
4
+ 2. MiniMax H3 使用 H3 的 Ref2VA 六段字段、稳定主体标签、说话者 ID 和原生音频合同。
5
+ 3. Seedance 使用 `seedance2_video` 的中文 `full-reference` 结构、真实素材顺序和实时素材限制。
6
+ 4. 未确认模型协议时停止,不把通用文本冒充平台专用提示词。
7
+
8
+ 音色绑定后,角色长期档案保留 `voice_identity`。模型支持参考音频时,把已选全局音色作为 `audio_reference`;H3 仍使用原生音频,不运行外部 TTS 覆盖。模型不支持参考音频时只写稳定声线描述,并在结果中保留能力限制。
9
+
10
+ H3 与 Seedance 不得混用字段或引用语法。最终编译前必须读取实时节点 schema、项目有效 `artStyle`、画幅、时长和音频能力。
@@ -0,0 +1,32 @@
1
+ # 项目通用视频提示词规范
2
+
3
+ LibTV 语料只用于提炼可执行的内容维度,不直接复制其占位符或平台字段。先写平台中立的镜头事实,再由 H3 或 Seedance 编译器生成最终提示词。
4
+
5
+ ## 必写维度
6
+
7
+ - 主体身份和每个参考素材的用途;
8
+ - 起始状态、按时间排序的动作、结束状态;
9
+ - 人物之间的站位、视线、距离和屏幕方向;
10
+ - 景别、机位、构图、镜头方向和运镜;
11
+ - 表演、光影、材质和接触物理;
12
+ - 对白、旁白、环境声、动作声和音乐策略;
13
+ - 跨镜人物、服装、道具、伤口、光线和声音连续性;
14
+ - 最小必要的禁止项。
15
+
16
+ ## 三档复杂度
17
+
18
+ - 单主体单动作:一个动作链、一个镜头、一个明确结果。
19
+ - 多主体互动:编号主体、空间关系、交接顺序、反应和镜头覆盖。
20
+ - 连续剧情或大场面:按镜头拆分,写时间点、运动结果、声音桥和首尾状态。
21
+
22
+ ## 编译前清洗
23
+
24
+ - 解析 `{{Image N}}`、`{{Mixed N}}` 为真实资产版本和用途;未解析变量不得提交。
25
+ - 故事板、宫格和分镜板只作为构图与动作顺序参考,禁止生成成片中的格线、纸张、编号、字幕或 UI。
26
+ - 删除无法验证的质量词和互相冲突的正负约束。
27
+ - 一个镜头只保留一个叙事主动作;多人动作归属不清时先拆镜。
28
+ - `art_style` 必须来自项目当前完整画风合同,不能只传画风名称。
29
+
30
+ ## 质量门禁
31
+
32
+ 主体、素材用途、动作顺序、镜头可见性、空间关系、光线连续性、声音归属和平台 schema 任一缺失,都不得提交付费视频任务。