@aswless_854771076/ai_short_studio_cli 0.1.124 → 0.1.126

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/README.md CHANGED
@@ -218,3 +218,5 @@ npm run release:ci:test -- --version 0.1.1-beta.0
218
218
  ```
219
219
 
220
220
  `release:ci` 会依次运行测试和类型检查、发布 npm、等待 registry 可见,再从 npm 安装该精确版本并验证 CLI 与配套 Skill。无需配置自有 Runner;只有访问内网或需要固定出口 IP 时才使用自有构建集群。
221
+
222
+ 专业拆镜增量修订:`canvas node revise-storyboard <parentNodeId> --project <projectId> --json` 读取当前版本、来源合同、资产白名单及软提示;`--file patch.json --dry-run` 预览差异、硬错误和下游影响,移除 `--dry-run` 原子保存指定镜头。请求必须携带画布、父版本及镜头基础版本;409 不自动重试。来源、原文、镜号与顺序只读,跨镜合同需同时修改两侧。未改镜头和历史媒体保留,受影响下游标记待更新。专业模式中的节奏、突出比例及建议预算只提示,硬错误最多纠错三轮;细化失败保留合法规划与完成批次。
@@ -0,0 +1,18 @@
1
+ import { BaseCommand } from '../../../base-command.js';
2
+ export default class CanvasNodeReviseStoryboard extends BaseCommand {
3
+ static description: string;
4
+ static args: {
5
+ nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
6
+ };
7
+ static flags: {
8
+ project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
9
+ file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ 'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
11
+ 'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
13
+ locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
14
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
15
+ episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
16
+ };
17
+ run(): Promise<void>;
18
+ }
@@ -0,0 +1,20 @@
1
+ import { Args, Flags } from '@oclif/core';
2
+ import { BaseCommand } from '../../../base-command.js';
3
+ import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
4
+ export default class CanvasNodeReviseStoryboard extends BaseCommand {
5
+ static description = '读取专业拆镜诊断或按明确基础版本原子修订多镜;冲突不自动重试';
6
+ static args = { nodeId: Args.string({ required: true }) };
7
+ static flags = { ...BaseCommand.baseFlags, project: projectFlag,
8
+ file: Flags.string({ description: '完整修订请求 JSON;省略时只读取诊断和当前版本' }),
9
+ 'dry-run': Flags.boolean({ description: '仅预览差异、硬错误和剩余提示,不写入' }) };
10
+ async run() {
11
+ const { args, flags } = await this.parse(CanvasNodeReviseStoryboard);
12
+ const { api } = await commandApi(flags);
13
+ if (!flags.file) {
14
+ this.print(await api.storyboardRevision(flags.project, args.nodeId));
15
+ return;
16
+ }
17
+ const input = await readJsonInput(flags.file);
18
+ this.print(await api.storyboardRevision(flags.project, args.nodeId, { ...input, ...(flags['dry-run'] ? { dryRun: true } : {}) }));
19
+ }
20
+ }
@@ -113,6 +113,7 @@ export declare class VvicatApi {
113
113
  }): Promise<JsonObject>;
114
114
  patchCanvas(projectId: string, input: JsonObject): Promise<JsonObject>;
115
115
  updateStoryboardShot(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
116
+ storyboardRevision(projectId: string, nodeId: string, input?: JsonObject): Promise<JsonObject>;
116
117
  updateStructuredResource(projectId: string, nodeId: string, input: JsonObject): Promise<JsonObject>;
117
118
  nodeTypes(): Promise<{
118
119
  schemaVersion: 1 | 2;
@@ -208,6 +208,9 @@ export class VvicatApi {
208
208
  method: 'PATCH', body: input,
209
209
  });
210
210
  }
211
+ storyboardRevision(projectId, nodeId, input) {
212
+ return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/storyboard-revision`, input ? { method: 'PATCH', body: input } : {});
213
+ }
211
214
  updateStructuredResource(projectId, nodeId, input) {
212
215
  return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/structured-resource`, {
213
216
  method: 'PATCH', body: input,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.124",
3
+ "version": "0.1.126",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -69,7 +69,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
69
69
  - H3 成片中的人物说话、旁白、环境音和 BGM 全部由 H3 原生生成;不得用 `voice-design`、`voice-clone`、`tts` 或其他外部 TTS 覆盖。独立音频交付才读取专项 TTS 流程。
70
70
  - 独立交付的背景音乐、主题曲或纯音乐使用 `music-generate`,不要用 TTS 模型模拟。默认模型键为 `starrouter::suno_music`;运行前以 `canvas settings get` 和实时节点 schema 为准。
71
71
  - 涉及剪辑、字幕、转场、音频编排或渲染时,读取 `references/hypit/` 中对应的制作规则。
72
- - 编辑镜头用 `canvas node edit-shot`,编辑结构化资源用 `canvas node edit-resource`,均追加不可变版本。项目 `outputLanguage` 在创建后固定,画布只读;手工首尾帧使用 `video-frame-extract`。
72
+ - 专业拆镜出现软提示时,可按 [增量修订流程](references/assets-and-storyboard.md#专业拆镜软提示与增量修订) 使用 `canvas node revise-storyboard` 读取诊断、预览并保存局部补丁;冲突不得盲目重试。普通编辑镜头用 `canvas node edit-shot`,编辑结构化资源用 `canvas node edit-resource`,均追加不可变版本。项目 `outputLanguage` 在创建后固定,画布只读;手工首尾帧使用 `video-frame-extract`。
73
73
 
74
74
  ## 安全与完成条件
75
75
 
@@ -127,3 +127,12 @@ P0/P1 必须清零;只修复受影响镜头或边,禁止全量重建掩盖
127
127
  ### 同一母场景的天气变体
128
128
 
129
129
  `location-image` 的 `data.config.locationWeatherVariant` 可设 `sunny` 或 `thundercloud`,用途必须为 `background-plate`。将同一已选干净基础背景连接到 `masterLocation`,该输入必须唯一对应一张图片,且母场景自身不是天气变体。未选天气时不要连接此端口;其他参考仍走 `reference`。模型参考图数量能力必须明确且足够。服务端生成 `locationWeatherContract`,只允许天气/光照变化,保存母场景选版和字节摘要;不要手写该合同。实际请求使用母场景参考序号并要求固定地形、建筑、门窗、通道、机位和画风。母场景换版后,天气图、双板、视频审核及剪辑/交付检查会拒绝旧来源;依次重跑并重新审核,既有产物留存。合同不证明实际像素一致。详见 `/docs/production/location-weather-variants`。
130
+
131
+
132
+ ## 专业拆镜软提示与增量修订
133
+
134
+ 专业拆镜的节奏、重点比例和建议预算是软提示;来源原文、资产、素材时长、双板和相邻合同仍是硬门禁。部分细化回退不等于已完成独立设计或媒体审核。
135
+
136
+ 读取 `canvas node revise-storyboard PARENT_NODE_ID --project PROJECT_ID --json`,取得 `data.canvasVersion`、`data.parentVersionId`、`data.shots` 当前版本、来源合同、白名单及结构化提示。构造 `{expectedCanvasVersion,basedOnVersionId,edits:[{nodeId,basedOnVersionId,patch,warningIds?}]}` 文件,先用同一命令的 `--file patch.json --dry-run --json` 预览,再去掉 `--dry-run` 保存,最后重新读取。
137
+
138
+ 只针对已授权范围修改。对象递归合并、数组替换;使用 shot_type/camera_move/video_prompt 等专业字段。镜号、来源和原文只读,不增删或拆合镜头。跨镜转场两侧须同批修改。硬错误拒绝、软提示保留;409 后重新审阅,不盲目覆盖。旧版本和媒体保留,下游待更新,不自动生图或生视频。未完成细化可再次运行原节点恢复;Agent 修订会使旧检查点失效。