@aswless_854771076/ai_short_studio_cli 0.1.21 → 0.1.22

package/README.md

@@ -76,7 +76,7 @@ ai-short-studio canvas settings set --project "$PROJECT_ID" --file settings.json
 
 CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置预检，并直接使用现有 `/api/projects`、`/api/canvas/node-types`、项目画布与资产路由。
 
-视频节点的图片用途以实时 `configSchema.videoInputMode` 为准：`reference` 只把图片连接到 `references`，不连接 `start-frame`；`first-frame` 仅用于用户明确要求以指定图片开场的场景。
+视频生成节点固定使用参考图生视频，不再提供 `videoInputMode`；图片连接到 `references`，不会作为视频首帧。
 
 `storyboard-image` schema 现在暴露节点级 `gridSize`。CLI 继续按实时 schema 通用写入，配套 Skill 会分析每个镜头的动作、运镜、多人调度和连续性难度，向用户确认后逐镜设置；未单独设置或连接旧服务时回退到项目格数，系统默认为 6 格。
 

package/dist/domain/vvicat-api.js

@@ -7,8 +7,9 @@ function validateConfigEnums(nodeType, config) {
         return;
     for (const [key, value] of Object.entries(config)) {
         const schema = properties[key];
-        if (!schema || typeof schema !== 'object' || Array.isArray(schema))
-            continue;
+        if (!schema || typeof schema !== 'object' || Array.isArray(schema)) {
+            throw new Error(`节点 ${nodeType.kind} 的 ${key} 不在实时 schema 中`);
+        }
         const allowed = schema.enum;
         if (Array.isArray(allowed) && !allowed.some((candidate) => Object.is(candidate, value))) {
             throw new Error(`节点 ${nodeType.kind} 的 ${key} 不在实时 schema 允许范围内`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aswless_854771076/ai_short_studio_cli",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "VVICAT 无限画布项目命令行工具",
   "license": "MIT",
   "private": false,

package/skills/using-vvicat-ai-short-studio-cli/SKILL.md

@@ -36,7 +36,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 3. 原文需要改编时执行 `novel-to-script`。分镜拆解前必须先完成人物、场景、道具等本次故事涉及的素材生成。创建或执行 `character-turnaround`、`prop-turnaround` 时，建议值固定为 `aspectRatio: 16:9`，向用户确认后把最终画幅显式写入节点配置，不得继承项目默认画幅。人物视觉方案的每个 `appearance.descriptions` 候选必须拆成独立输入，并采用“一候选描述 → 一个三视图节点 → 一个独立图片资产”的方式生成；道具存在多个候选方案时同样处理。每个三视图节点只能接收一个人物形象或一个道具候选，提示词必须明确“只生成当前候选的一张三视图，不得拼接其他候选”；单张三视图内部可以包含同一对象的正面、侧面和背面，但禁止把多个候选方案纵向、横向或宫格拼成一张图。`count` 只表示同一候选的独立生成版本数，每个结果必须作为独立图片版本展示和选择，不得合并为一张长图。互不依赖的素材节点应同批执行并收集真实任务 ID，再并发 `task wait`，不得等待一个完成后才提交下一个；存在上游依赖时按依赖顺序分批执行。每个任务都必须到成功终态，并让用户确认后为每项素材设置 selected version。任一素材未生成成功、未确认或没有 selected version 时，禁止执行 `storyboard-breakdown`，先询问用户并补齐。
 4. 按实时节点 schema，把已确认的剧本节点，以及每个人物、场景、道具等相关素材节点，逐项连接到 `storyboard-breakdown` 对应输入 handle（通常为 `script`、`characters`、`locations`、`props`）。执行前重新读取画布和连线，确认本次故事涉及的素材节点无遗漏；即使服务端把素材输入标为可选，标准创作流程也不得省略。任一对应连线缺失时禁止拆解，先补线；素材范围不清楚时先询问用户。全部门禁满足后才执行并等待。成功后刷新画布，读取服务端自动创建的 `storyboard-shot` 和 `storyboard-image`，不得重复手工创建。
 5. 生成分镜图前，用 `canvas asset get/list` 取得人物、场景、道具等已选版本，必要时下载，并把实际图片或可访问预览展示给用户；只提供资产 ID、文件路径或文字说明不算展示。用户明确确认素材与选版后，读取 `storyboard-image` 的实时 `configSchema`，分析每个镜头的动作阶段、运镜变化、多人调度和连续性难度，选择 schema 允许的最小够用格数：简单镜头建议 4 格，常规镜头使用默认 6 格，复杂镜头建议 9 格，16/25 格只用于用户明确需要的长动作或高密度关键帧。向用户展示逐镜建议并确认后，将各自 `gridSize` 写入对应节点；旧服务 schema 未暴露该字段时才说明限制并回退到项目格数，用户未另行确认时为 6 格。连续叙事优先建议 `imageLayout: storyboard`，同时说明 `grid` 与 `single` 可选，最终由用户确认布局、镜头范围、参考资产、模型与费用范围。未展示或未确认时禁止生成分镜图。
-6. 执行分镜图后检查任务终态、候选资产与 selected version，并把实际分镜图或可访问预览展示给用户。用户明确确认分镜图以及需要制作的视频镜头后，才能刷新画布并复用服务端自动创建的 `storyboard-video-prompt`；提示词再经用户确认后执行自动创建的 `video-generate`。宫格或故事版进入视频时优先检查节点的 `videoInputMode`：需要保持人物、场景而不固定开场画面时使用 `reference`，把图片连接到 `references`，不得连接到 `start-frame`；只有用户明确要求以某张图开场时才使用 `first-frame`。音频按交付范围执行。未展示或未确认分镜图时禁止生成视频。
+6. 执行分镜图后检查任务终态、候选资产与 selected version，并把实际分镜图或可访问预览展示给用户。用户明确确认分镜图以及需要制作的视频镜头后，才能刷新画布并复用服务端自动创建的 `storyboard-video-prompt`；提示词再经用户确认后执行自动创建的 `video-generate`。视频生成固定使用参考图模式，把图片连接到 `references`，不得把分镜图作为首帧；节点不再提供 `videoInputMode`。音频按交付范围执行。未展示或未确认分镜图时禁止生成视频。
 7. 配置门禁固定用一次 `canvas settings set` 写入确认字段；通过门禁后的节点与连线写入，仍需在每次写入前重新读取画布版本，优先用专用 node/edge 命令，批量图变更才用低层 `canvas apply`。每次执行都读取真实任务 ID 并 `task wait`，不用固定 sleep。
 8. 交付前确认 selected version 与下载目录，记录项目、节点、任务和资产 ID、失败项与未决项。临时项目在所有结束路径删除；既有项目绝不擅自删除。