@aswless_854771076/ai_short_studio_cli 0.1.218 → 0.1.219
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/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-media-gates.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-previs.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-production-principles.md +6 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +1 -1
package/package.json
CHANGED
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
|
|
23
23
|
自写镜头物化后回读实际派生节点、父来源、镜号、板型和选版,不重复创建。每镜按 storyboard_strategy.required_board_types 选择时间宫格 temporal/grid、镜头故事版 shot/storyboard 中一种或两种,并记录 selection_basis;只生成、引用和审核已选板型,不强制双板。选择两板时须分别提供不同证据,keyframe/single 不替代已选板;count=1 不表示画面必须单格。板型、格数、布局、画幅及参考端口以当前节点目录和实际配置为准。缺少选择依据、来源、必需板或参考能力时停止,不削减参考绕过门禁。
|
|
24
24
|
|
|
25
|
-
人物、场景、道具的真实资产绑定须与当前镜头选版一致,并连接到实际板图参考端口;不能写服务端维护的 production
|
|
25
|
+
人物、场景、道具的真实资产绑定须与当前镜头选版一致,并连接到实际板图参考端口;不能写服务端维护的 production 来源字段。构图说明落到可见的站位、视线、前中后景、光源、动作方向与镜尾状态;没有来源或已确认调度依据时不补天气、陈设、武器或额外人物。修改镜头或上游选版后核对时长覆盖;已有媒体与历史选版均保留,不传播 stale、不改其真实时长。
|
|
26
26
|
|
|
27
27
|
## 视频、声音与连续性
|
|
28
28
|
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
|
|
35
35
|
正式媒体审核接口只接受节点当前选中的精确版本。新任务完成或资产全局选版不证明该节点已切换,先检查节点选版,按授权切换新候选后再审核;来源过期诊断含 nodeId/currentVersionId 时回读该节点,不通过修改无关文档、改写批准或删除参考绕过。
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
保存审核不改变媒体字节,同生产者、同资产、同选版且当前可用的派生输出资源保留可用状态;已有下游资源不传播过期状态。历史 stale 标记不要求重新选版或生成;核对当前精确选版、文件与真实来源,保留审核事实。
|
|
38
38
|
|
|
39
39
|
正式单幅关键帧只呈现当前镜头的起始状态。 审核优先按 motion_plan.start_state 判断,后续动作或镜尾接触尚未出现不构成首帧缺项,不因此判起始帧叙事失败;真实起始站位、朝向、道具和交互距离仍须核对。 纠错提示词先核对本镜起始状态、连续场景的前镜镜尾和当前景别,不把伸手、持物或朝向重置为通用站姿;涉及按键、交接等接触时,首帧站位和距离必须允许后续动作成立。画外脚部或道具不强行塞入画面,避免为描述起始状态破坏景别。上游 imagePrompt 或 frame_plan 可能描述完整时间板,不能把其中的多格布局与后续阶段继续当作单幅绘图指令。提交时核对实际编译上下文;审核以目标媒体的真实 keyframe 角色为准,出现宫格、拼贴或多个时间格应判构图失败,不能因来源时间板要求多格或旧审核 approved=true 就送入视频参考。
|
|
40
40
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
文件结构为 `{ "base": { "canvasVersion": 1, "nodeVersion": 0, "sceneVersionId": null }, "actions": [{ "type": "project.rename", "name": "预演" }] }`。示例版本必须替换成实际读取结果。历史恢复用 `restoreVersionId` 替代 actions。共享服务严格拒绝未知操作、字段和任意脚本;409 后重读并审阅,不自动换基线重试。
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
保存追加不可变版本;下游已有结果保持可用,不自动渲染。帧图和视频执行复用 `canvas node execute`;只使用实际生成的输出角色,不把首尾帧和辅助通道混为第一张图。预演不自动成为身份依据或审核通过记录。
|
|
21
21
|
|
|
22
22
|
`canvas previs upload <nodeId> <imageFile> --project <projectId> --base base.json` 上传 PNG/JPEG/WebP 参考图,最多 16 MiB,`base.json` 仅保存 read 返回的完整 base 对象。服务端重新解码为 PNG 并按正式字节计算内容哈希,素材资产、来源版本和场景绑定同事务保存。移除绑定提交 `asset.remove {assetId}`,assetId 是场景 assets 中的绑定 id;不删除历史素材。参考图用于存档和工程导出,不自动进入画面;仅存档的参考图不会阻止已适配场景渲染。模型和 HDR 需走各自的正式适配入口。
|
|
23
23
|
|
|
@@ -178,7 +178,7 @@ postEdit.rootPath 在场景原定帧0及每个骨骼路径点检查最终髋部
|
|
|
178
178
|
尺寸使用 `object.update {sceneId,objectId,patch:{height?,width?,stretch?}}`:width 为目标米制宽度,stretch 为0.1~10的宽度倍率,宽度优先于同次 stretch;底部枢轴和占地由原生实现重算。位置、旋转、分组、路径及骨骼附着沿用已有操作。删除所有场景中引用它的纸片后才能 `asset.remove`,否则返回 PREVIS_ASSET_IN_USE;删除纸片保留正式图片及历史版本。保存仍用 read 返回的三重版本,不自动渲染;渲染显式执行。纸片只提供空间/构图参考,不自动建立人物身份或审核记录。深度/法线保留透明孔洞,闲置参考图不进入渲染清单。网页支持按需打开画笔,以原图像素进行背景取样及擦除/恢复;预览不保存,须显式提交新版本。原生复制尚未接入,不能宣称已具备该入口。
|
|
179
179
|
|
|
180
180
|
|
|
181
|
-
显式抠图与蒙版重编辑使用同一编辑合同:`{base,matte:{sceneId,objectId,selection:"auto"|"saved",options:{...}}}`,与 actions/restoreVersionId 互斥。先读取当前已保存场景和纸片 ID;保留完整 base,不自动重读替换。auto 默认按边缘颜色选择背景,也可给 points 原图像素坐标(1~128点)及 tolerance=0.01~0.9;saved 使用已有原尺寸蒙版,不接受 points/tolerance。options 可设 shrink/feather 整数0~8、trim 布尔值,以及最多4096条 strokes:`{x,y,radius,value}`,x/y 为原图像素,radius>0且<=512,value=1 擦除、-1 恢复。输入不接受 URL、媒体ID
|
|
181
|
+
显式抠图与蒙版重编辑使用同一编辑合同:`{base,matte:{sceneId,objectId,selection:"auto"|"saved",options:{...}}}`,与 actions/restoreVersionId 互斥。先读取当前已保存场景和纸片 ID;保留完整 base,不自动重读替换。auto 默认按边缘颜色选择背景,也可给 points 原图像素坐标(1~128点)及 tolerance=0.01~0.9;saved 使用已有原尺寸蒙版,不接受 points/tolerance。options 可设 shrink/feather 整数0~8、trim 布尔值,以及最多4096条 strokes:`{x,y,radius,value}`,x/y 为原图像素,radius>0且<=512,value=1 擦除、-1 恢复。输入不接受 URL、媒体ID或任意脚本;原图、选区、渲染图保留各自不可变版本。裁剪沿用原生全图高度补偿,重复操作不累乘比例;操作会保存场景新版本;下游已有结果保持可用,不自动渲染或审核。409 后重新读取并审阅;结果未知时查询原回执,不能盲目重试。
|
|
182
182
|
|
|
183
183
|
CLI 用 `ai-short-studio canvas previs apply <nodeId> --project <projectId> --file matte.json --json` 提交此合同。
|
|
184
184
|
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
|
|
27
27
|
模型素材兼容性在资产计划和画风确认时核对,早于付费图片生成;Seedance 按 seedance-prompting.md 区分普通人脸 URL 限制与 Provider 已接入的素材审核链路。本项目 StarRouter Seedance 2.0/2.0-fast/2.5 可在明确隐私拒绝后由后端审核素材,等待 Active 后以真实 asset:// 引用有界重提;不能把一次裸 URL 拒绝等同于真人画风不可用。审核缺配置、失败或超时时报告准确缺口,不自动替换已确认选择。
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
更新已有计划前,先读取当前精确版本的完整正文,状态摘要或旧对话记忆不能代替正文;刷新来源须保留原有有效字段与逐镜细节。制作计划描述制作合同,生成计数、任务状态和最新媒体审核结果记录在对应媒体台账;已有媒体不会因计划换版而自动标记过期,进度仍记录在媒体台账。
|
|
30
30
|
|
|
31
31
|
PRODUCTION_VIDEO_SOURCE_STALE 先核对错误中的具体文档和 staleInputs,按依赖顺序先更新来源、再更新使用它的文档;声音计划更新后,引用它的逐镜预检须再次核对。只有真实过期的依赖才需要刷新,不能通过重生无关首幅或反复提交同一提示词试错。
|
|
32
32
|
|
|
@@ -40,7 +40,7 @@ PRODUCTION_VIDEO_PROMPT_STALE 按 mismatchedFields 定位实际差异;referenc
|
|
|
40
40
|
|
|
41
41
|
默认烧录对白与旁白字幕,并保留同源 UTF-8 SRT;用户明确不要字幕时才关闭。字幕语言默认继承项目 outputLanguage,用户明确指定时才覆盖;先读取当前项目语言,不能用界面语言、提示词语言或原声语言替代。视频提示词禁止源画面生成文字,不等于禁止后期字幕。字幕依据当前已选实际音轨的 ASR/真实听写时间证据,不能由剧本或提示词补造;final-only 保留识别差异和未听音范围供最终复核,不伪造人工通过。
|
|
42
42
|
|
|
43
|
-
PRODUCTION_REFERENCE_SOURCE_STALE 按 nodeId/reason 定位真实媒体依赖,不只查看顶层视频或提示词的 done 状态。node-not-ready 先检查该参考的实际选版与来源;selection-changed
|
|
43
|
+
PRODUCTION_REFERENCE_SOURCE_STALE 按 nodeId/reason 定位真实媒体依赖,不只查看顶层视频或提示词的 done 状态。node-not-ready 先检查该参考的实际选版与来源;selection-changed 或 content-changed 分别复核明确选版或真实文件,不改哈希、不自动重生。已有媒体仍须满足当前来源合同,不能靠重选旧版本掩盖来源变更。
|
|
44
44
|
|
|
45
45
|
PRODUCTION_EDIT_SOURCE_STALE 先按 nodeId/reason 检查具体文档或转写来源;补审可能使下游 ASR 与剪辑计划过期,先完成审核,再刷新当前真实转写,最后执行计划及渲染。顶层视频 done 不代表其下游字幕就绪,不反复重选无关视频试错。
|
|
46
46
|
|
|
@@ -53,3 +53,7 @@ PRODUCTION_VIDEO_SOURCE_STALE/预检错误的 blockers 列出同时发现的文
|
|
|
53
53
|
## 异步等待与目标恢复
|
|
54
54
|
|
|
55
55
|
媒体任务提交回执不是制作完成。图片、视频、音频、抽帧、ASR和渲染统一等待原任务的真实终态;优先使用当前入口提供的等待能力,不能只查一次 processing 就结束已授权制作或要求用户点击继续。单次等待超时只表示仍在处理,继续观察同一 taskId,不能重新生成。独立就绪任务可继续推进;终态后再选版和执行真实审核。用户停止等待不等于取消媒体任务。内置目标模式没有累计轮数、调用次数或运行时长的产品上限;旧目标恢复保留原任务与进度,不重复发起付费操作。其他入口仍按其真实能力与用户授权范围执行,不伪造后台续跑。
|
|
56
|
+
|
|
57
|
+
## 资源状态与媒体版本
|
|
58
|
+
|
|
59
|
+
资源不再具有过期状态。编辑上游文档、配置、镜头、连线或选版,不会把下游标成 stale,也不要求为消除旧标记而重新选版或生成。历史 stale 标记按已有选版使用;媒体是否存在、归属、明确选择的版本和任务身份仍须核验。当前选中版本、最新生成候选与历史版本保持区别,切版仍走正式入口,旧任务不能覆盖新任务。
|
|
@@ -132,7 +132,7 @@ handle 来自实时节点目录。只删除精确 edge ID;`--apply-ready` 只
|
|
|
132
132
|
|
|
133
133
|
## 节点选版与资产全局选版
|
|
134
134
|
|
|
135
|
-
`canvas asset select-version`(或 `asset select`)修改资产全局选版,不覆盖任何节点的 `selectedOutputVersionId`。网页“查看版本”和内置 `canvas_select_version`
|
|
135
|
+
`canvas asset select-version`(或 `asset select`)修改资产全局选版,不覆盖任何节点的 `selectedOutputVersionId`。网页“查看版本”和内置 `canvas_select_version` 只切换目标节点、保留兄弟节点与全局选版,;下游已有结果保持可用;运行中节点不可切版。读取节点内容和编辑基线时优先使用节点固定版本。CLI 没有把全局选版命令自动转换为节点切版;需要更改固定版本时使用网页节点入口,不能用普通 config patch 写服务端选版字段。
|
|
136
136
|
|
|
137
137
|
### 审核文档与阶段缺失诊断
|
|
138
138
|
|