@aswless_854771076/ai_short_studio_cli 0.1.235 → 0.1.237
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.
- package/dist/commands/canvas/apply.d.ts +1 -0
- package/dist/commands/canvas/apply.js +1 -0
- package/dist/commands/canvas/node/types.d.ts +1 -0
- package/dist/commands/canvas/node/types.js +4 -0
- package/dist/domain/vvicat-api.d.ts +1 -0
- package/dist/domain/vvicat-api.js +4 -0
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +1 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-previs.md +4 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +5 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +2 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +18 -5
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { BaseCommand } from '../../base-command.js';
|
|
2
2
|
export default class CanvasApply extends BaseCommand {
|
|
3
|
+
static description: string;
|
|
3
4
|
static flags: {
|
|
4
5
|
project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
|
|
5
6
|
file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
@@ -2,6 +2,7 @@ import { Flags } from '@oclif/core';
|
|
|
2
2
|
import { BaseCommand } from '../../base-command.js';
|
|
3
3
|
import { commandApi, projectFlag, readJsonInput } from '../../command-helpers.js';
|
|
4
4
|
export default class CanvasApply extends BaseCommand {
|
|
5
|
+
static description = '批量保存画布;沿用回读的连线 ID。非法新增或改接会整体回滚,错误 details 提供具体边与端口。';
|
|
5
6
|
static flags = {
|
|
6
7
|
...BaseCommand.baseFlags,
|
|
7
8
|
project: projectFlag,
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { BaseCommand } from '../../../base-command.js';
|
|
2
2
|
export default class CanvasNodeTypes extends BaseCommand {
|
|
3
3
|
static description: string;
|
|
4
|
+
static examples: string[];
|
|
4
5
|
static args: {
|
|
5
6
|
kind: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
|
|
6
7
|
};
|
|
@@ -3,6 +3,10 @@ import { BaseCommand } from '../../../base-command.js';
|
|
|
3
3
|
import { commandApi } from '../../../command-helpers.js';
|
|
4
4
|
export default class CanvasNodeTypes extends BaseCommand {
|
|
5
5
|
static description = '读取完整节点目录、creationAudience 创建用途、配置与 schema(含镜头 shotEditSchema 视觉绑定合同;不带 --project)';
|
|
6
|
+
static examples = [
|
|
7
|
+
'<%= config.bin %> canvas node types video-upscale --json',
|
|
8
|
+
'<%= config.bin %> canvas node types video-audio-extract --json',
|
|
9
|
+
];
|
|
6
10
|
static args = { kind: Args.string() };
|
|
7
11
|
static flags = BaseCommand.baseFlags;
|
|
8
12
|
async run() { const { args, flags } = await this.parse(CanvasNodeTypes); const { api } = await commandApi(flags); const catalog = await api.nodeTypes(); this.print(args.kind ? catalog.nodeTypes.find((item) => item.kind === args.kind) ?? null : catalog); }
|
|
@@ -147,6 +147,7 @@ export declare class VvicatApi {
|
|
|
147
147
|
}): Promise<JsonObject>;
|
|
148
148
|
patchCanvas(projectId: string, input: JsonObject): Promise<JsonObject>;
|
|
149
149
|
updateStoryboardShot(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
|
|
150
|
+
directorDeskRead(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
150
151
|
previsRead(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
151
152
|
previsMotion(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
152
153
|
previsQa(projectId: string, nodeId: string): Promise<JsonObject>;
|
|
@@ -262,6 +262,10 @@ export class VvicatApi {
|
|
|
262
262
|
method: 'PATCH', body: input,
|
|
263
263
|
});
|
|
264
264
|
}
|
|
265
|
+
// 新版完整状态与旧版兼容投影同时返回,调用方不得用投影覆盖完整工程。
|
|
266
|
+
directorDeskRead(projectId, nodeId) {
|
|
267
|
+
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/director-desk`);
|
|
268
|
+
}
|
|
265
269
|
previsRead(projectId, nodeId) {
|
|
266
270
|
return this.client.request(`/api/projects/${encodeURIComponent(projectId)}/canvas/nodes/${encodeURIComponent(nodeId)}/previs`);
|
|
267
271
|
}
|
package/package.json
CHANGED
|
@@ -41,6 +41,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
41
41
|
| 结构化分镜、分镜图、逐镜制作计划与跨镜连续性 | `references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | `Agent 自写分镜 → production-plan 文档 → continuity-plan 文档 → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,只生成已选择的板型;前镜真实完成并选版后允许 previous-tail,不要求内容审核 |
|
|
42
42
|
| 视频提示词、H3、Seedance、原生音频 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/prompt/h3-prompt-writing.md`、`references/short-drama/prompt/seedance-prompting.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存自由画布文档;先按通用规范确定类型与维度,再按实时 Provider schema 选择协议,完成输入结构与来源校验后提交视频,不自动审计 |
|
|
43
43
|
| 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
|
|
44
|
+
| 视频超分、媒体工具与经济出片链路 | `references/short-drama/generation/transform-drama-media.md` | `video-upscale` 使用 Comfly 1849 专用单视频协议;广告优先可用 Comfly H3 后接超分,短剧优先可用 Seedance 2.5 480p 后接超分,尽量不推荐高清直出;按实时目录执行 |
|
|
44
45
|
| 去字幕、参考视频复刻、深度视频 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → depth-video → video-generate`;不得把参考板或字幕带入成片 |
|
|
45
46
|
| 参考对白转写、剪辑、字幕和多图模板 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
|
|
46
47
|
| 逐镜审计、剪辑、字幕、声音平衡、成片交付 | `references/short-drama/review/review-drama-shots.md`、`references/short-drama/editing/edit-drama-timeline.md`、`references/short-drama/editing/edit-deliver-drama.md` | 默认 `drama-edit-plan → drama-edit-render`;审核模块仅用户明确要求时加载,真实来源与文件有效后即可交付 |
|
|
@@ -188,3 +188,7 @@ CLI 用 `ai-short-studio canvas previs apply <nodeId> --project <projectId> --fi
|
|
|
188
188
|
|
|
189
189
|
|
|
190
190
|
帧图和视频渲染位置:`previs-frame` 与 `previs-video` 支持 `config.previs.executionLocation=auto|client|server`。网页及内置助手的 auto 任务优先由当前用户打开的本项目画布页面领取,客户端不可用或断线后可后台接管。client 必须保持画布页面打开,无法领取、断线或编码失败会失败;server 使用后台。CLI 默认 auto 且没有网页能力声明时使用后台;显式 client 会等待网页。内置助手仍通过 canvas_execute 提交,无需再次点击运行。客户端 WebGL 使用 GPU,视频按固定 24fps 时间戳使用 WebCodecs 编码 H.264 MP4,优先硬件编码,实际设备由浏览器决定;软件 WebGL 不作为客户端 GPU 路径。单帧、首尾帧、深度、法线、联系表和视频使用同一冻结版本及角色合同。正式媒体由服务端验证执行权、来源、PNG 尺寸、MP4 编码/帧数/帧率/时长并解码后提交;客户端上传不等于审核通过。工程导出继续后台。
|
|
191
|
+
|
|
192
|
+
## 历史导演台完整状态
|
|
193
|
+
|
|
194
|
+
检查既有导演台时,GET `/api/projects/{projectId}/canvas/nodes/{nodeId}/director-desk` 的 `panel.directorState` 是新版完整状态(`format: pixelshort-director-state`、`schemaVersion: 1`),包括完整 `project` 和工作 `settings`;`panel.directorLayout` 仅是旧版兼容投影。不得将投影转换后覆盖已有完整状态,不把旧版运动记录写入成功视为新版路线或运镜已更新。网页负责完整状态编辑、持久素材上传、串行保存及失败重试;CLI 目前没有完整工程编辑或本地素材上传命令,不猜测命令或绕过网页保存。历史缺失信息只能从仍存在的本机备份恢复,不能伪造。
|
|
@@ -120,7 +120,7 @@ ai-short-studio canvas continuity analyze --project <projectId> --json
|
|
|
120
120
|
ai-short-studio canvas continuity analyze --project <projectId> --apply-ready --json
|
|
121
121
|
```
|
|
122
122
|
|
|
123
|
-
handle
|
|
123
|
+
handle 来自实时节点目录。保存位置、视图或分组时沿用回读的边 ID、端口和来源,不重建历史边。`FREEFORM_CANVAS_EDGE_INVALID` 的 details 包含 edgeId、sourceHandle、targetHandle 和 reason;定位并修正本次新增/改接,不能通过批量删边绕过。CLI 使用完整画布回执,后续操作以回执中的正式边 ID 为准。只删除精确 edge ID;`--apply-ready` 只在用户确认连续性建议后执行。
|
|
124
124
|
|
|
125
125
|
## 节点诊断和未批准草稿
|
|
126
126
|
|
|
@@ -154,3 +154,7 @@ handle 来自实时节点目录。只删除精确 edge ID;`--apply-ready` 只
|
|
|
154
154
|
|
|
155
155
|
内置助手的节点执行也区分只读预检失败与写入阶段结果不明:前者返回明确 `failed` 与字段诊断,修正后再发起;后者仍为 `unknown`,先核对原调用。CLI 不应将网络失败、进程终止或阶段状态变化等同于“任务没有提交”。
|
|
156
156
|
节点阶段门禁失败时,CLI 保留服务端返回的 `details`(例如 `missingHandles`、`invalidFields`、`contentCheck`)供修复使用;先按诊断补齐当前版本,再重新读取节点和文档,不用重复提交掩盖门禁。
|
|
157
|
+
|
|
158
|
+
## 分组与自动整理
|
|
159
|
+
|
|
160
|
+
网页主动点击自动整理会为未分组节点保存普通分组;已有成员、名称与折叠状态保留,刷新与生成不会建组。新产物仅继承落库时直接生产者的已有组,已有产物的人工归属不被覆盖。所有组可编辑、合并或解散。CLI 修改坐标时不会自动分组,也不能把素材来源连线当成分组字段。
|
|
@@ -9,3 +9,5 @@
|
|
|
9
9
|
同一输入指纹只允许一个在途任务。提交结果未知时先查询原任务,不自动重试。成功输出登记为候选版本:per-stage 逐镜完整观看并通过画面、声音和连续性审核后选版;final-only 可按共享门禁选作制作候选并继续剪辑,完整看听与交付验收仍须完成,不能把选版当作人工批准。失败镜头定位原因后按已有授权评估单独重跑。旧项目中保存的 RunningHub、Comfly 直连等配置不能继续提交付费任务,必须先按当前项目重新确认模型、参数和能力。
|
|
10
10
|
|
|
11
11
|
主运动参考在合同中记作 `reference_video`,必须绑定当前已选版本;生成前再次核对端口、版本和 SHA-256。
|
|
12
|
+
|
|
13
|
+
模型选择前读取 [媒体变换与超分](transform-drama-media.md):默认推荐广告使用可用的 Comfly H3 后接视频超分,短剧使用可用的 Seedance 2.5 480p 后接视频超分,尽量不推荐高清直出;用户指定和实时模型能力优先。
|
|
@@ -1,9 +1,22 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 媒体变换与视频超分
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
先运行 `canvas node types` 读取实时目录,再按已选视频版本接线、配置并执行正式节点。工具栏按钮可用不等于 Agent 已有同名工具;仅使用实时目录中存在的能力。保留原素材与来源关系,不以修改源视频尺寸冒充模型处理结果。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 视频超分
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
正式节点为 `video-upscale`,输入 `video` 接收一个上游已选视频,输出 `video` 为超分视频。当前固定使用 `starrouter::comfly/1849` 的单视频处理协议;不通过 `video-generate.reference-videos` 执行,不要求 durationOptions、提示词或通用视频生成的参考模式。模型目录的 `capabilities.video = {}` 不表示该专用处理节点不可用,也不授予通用视频生成能力。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
1. 读取实时节点目录、模型可用性与源视频真实选版;按正式画布写入流程创建 `video-upscale`,将源节点的 VIDEO 输出连接至其 `video` 输入。不要复制远端 URL 到 config,也不手工生成资源节点。
|
|
10
|
+
2. 配置只写实时 schema 声明的字段;当前 `model` 仅支持 `starrouter::comfly/1849`。不猜测放大倍数、分辨率、帧率或片长参数,不将生成时长当作截取长度。
|
|
11
|
+
3. 使用 `canvas node run` 执行该节点,并按回执等待原任务。任务成功后回读产物版本、来源与媒体信息,再按正式选版流程接入剪辑或下游;提交成功、渲染尺寸为 720p/1080p 均不能证明超分已完成。结果尺寸仅按实际媒体元信息报告。
|
|
12
|
+
4. 接口拒绝或回执未知时检查原任务,不以同样参数反复提交,不静默切换成高清重新生成。
|
|
13
|
+
|
|
14
|
+
## 制作链路建议
|
|
15
|
+
|
|
16
|
+
在用户没有指定模型或高清直出的情况下,先核对已发布模型和实时 Provider schema:广告且平台 Comfly H3 可用时,优先建议 **H3 生成 → video-upscale → 剪辑/交付**;短剧优先建议 **Seedance 2.5 480p 生成 → video-upscale → 剪辑/交付**,尽量不推荐直接生成高清。Seedance 2.5 或 480p 不在当前目录/能力中时如实说明,不用其他版本冒充,不从模型名称猜 ID。模型、分辨率及用户明确偏好优先于建议;H3/Seedance 提示词仍遵守各自正式合同。
|
|
17
|
+
|
|
18
|
+
## 其他媒体工具
|
|
19
|
+
|
|
20
|
+
视频去字幕使用 `recreation-subtitle-remove`,深度视频使用 `depth-video`,片段截取使用 `recreation-shot-extract`,抽帧使用 `video-frame-extract`,音频提取使用 `video-audio-extract`,转写/翻译使用 `recreation-transcribe`。逐项读取各自端口与配置;本地截片不依赖生成模型。工具栏独有且目录未暴露的操作,明确报告能力缺口,不用相似节点伪造执行。
|
|
21
|
+
|
|
22
|
+
旧厂商 SeedVR2.5、MuseTalk/PainterAV2V 等入口仍不恢复;历史 RunningHub 或 MuseTalk 配置不能作为新提交依据。旧提示词模板 `2d_to_live_action` 和 `image_prompt_modify` 仅保留历史项目读取含义。默认制作不额外引入内容审核门禁;用户明确要求审核时按对应合同执行。
|