@aswless_854771076/ai_short_studio_cli 0.1.236 → 0.1.238

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.
@@ -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,
@@ -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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.236",
3
+ "version": "0.1.238",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -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 来自实时节点目录。只删除精确 edge ID;`--apply-ready` 只在用户确认连续性建议后执行。
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 修改坐标时不会自动分组,也不能把素材来源连线当成分组字段。