@aswless_854771076/ai_short_studio_cli 0.1.121 → 0.1.123

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
@@ -14,6 +14,8 @@ ai-short-studio canvas node types --json
14
14
 
15
15
  npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill。hypit、短剧和 humanizer 等第三方资料统一放在该 Skill 的 `references/` 下。安装或升级 CLI 时,`postinstall` 会自动安装或更新这个 Skill;用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
16
16
 
17
+ 短剧默认采用专业拆镜,逐镜保留时间宫格与镜头故事版;`count: 1` 不表示单格,用户要求只完成分镜图时不执行视频提示词或视频。`canvas node edit-shot` 会同步镜头字段别名并拒绝改写来源原文;修改时长后检查响应的 `durationOverrides`,保留的下游手工时长需要逐项确认。普通单帧不能提交为专业双板审核。
18
+
17
19
  `skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer 审计和 hypit 视频制作资料通过主 Skill 的 references 按需读取。
18
20
 
19
21
  生产环境登录使用 MemHub 浏览器授权;兼容 Supabase 的邮箱注册和登录从 stdin 读取密码:
@@ -1,5 +1,6 @@
1
1
  import { BaseCommand } from '../../../base-command.js';
2
2
  export default class CanvasNodeEditShot extends BaseCommand {
3
+ static description: string;
3
4
  static args: {
4
5
  nodeId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
6
  };
@@ -2,6 +2,7 @@ import { Args, Flags } from '@oclif/core';
2
2
  import { BaseCommand } from '../../../base-command.js';
3
3
  import { canvasEditConflictReason, commandApi, projectFlag, readJsonInput, resolveCanvasNodeVersionId, } from '../../../command-helpers.js';
4
4
  export default class CanvasNodeEditShot extends BaseCommand {
5
+ static description = '追加镜头修订版本;来源原文只读,别名冲突会拒绝。修改时长后检查返回的 durationOverrides,确认下游手工覆盖。';
5
6
  static args = { nodeId: Args.string({ required: true }) };
6
7
  static flags = {
7
8
  ...BaseCommand.baseFlags,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.121",
3
+ "version": "0.1.123",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -58,7 +58,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
58
58
  3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
59
59
  4. **剧本和目标集**:已有专业剧本时直接复用,不得重复执行 `novel-to-script`。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
60
60
  5. **资产门禁**:先完成人物、场景、道具及其派生版本,展示真实预览并确认 selected version。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
61
- 6. **拆镜和滚动生成**:拆镜前按 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁) 核对源剧本语言、交付语言、项目 `outputLanguage` 和节点 `targetLanguage`,不一致时禁止执行。把该集剧本与全部确认资产连接到 `storyboard-breakdown`,复用服务端自动创建的 `storyboard-shot` / `storyboard-image`。完成后逐镜执行语言与镜头质量审计且不抽样;P0/P1 未清零不得继续。分镜图生成前按实时 schema 确认画幅、布局、格数和费用。进入付费生成后读取 [滚动异步调度](references/async-pipeline.md):分镜图完成一镜即审计并提交该镜视频提示词,提示词完成即审计、显式写入视频配置并提交该镜视频;不得等待同阶段全部镜头完成。单镜可恢复失败只标记并重试该镜,不阻塞其他已就绪镜头。
61
+ 6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,复用每镜首帧、时间宫格及镜头故事版;不得因片长短、失败、仅生成分镜图或 `count: 1` 改走普通模式或覆盖 `imageLayout: single`。逐镜核对来源、时长、语言、布局与真实双板,P0/P1 未清零不得继续。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务在双板验收后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
62
62
  7. **视频规划**:视频生成前依次完成素材连线、镜头逻辑和上下镜连续性审计。读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。
63
63
  8. **H3 生成门禁**:`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值;旧 `seedance` 覆盖必须清除并回读,否则不得执行视频提示词或视频生成。编写或改写 H3 提示词时读取 `references/hypit/playbooks/craft/h3-prompt-writing.md`;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
64
64
  9. **逐镜后验**:每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
@@ -2,6 +2,20 @@
2
2
 
3
3
  仅在生产人物/场景/道具、拆镜、分镜图或视频前审计时读取本文件。
4
4
 
5
+ ## 拆镜模式与交付范围
6
+
7
+ 新建短剧或修复专业链路时,默认使用专业拆镜:JSON 剧本设置 `--source-format screenplay-json.v1 --platform short-drama`,Markdown 设置对应格式;回读确认 `sourceFormat`、`platform` 和 `storyboardPipelineVersion: 2`。只有用户明确选择普通自由分镜或单帧交付时才采用普通链路,不能把“只到分镜图停止”理解成取消双板,也不能因一分钟片长、调用次数或校验失败自行降级。失败应修复来源或当前阶段,不清除专业字段绕过校验。
8
+
9
+ `count: 1` 只表示一次生成一张图片;该图可以包含 6 格。专业每镜必须保留时间宫格 `temporal/grid` 与镜头故事版 `shot/storyboard`,首帧 `keyframe/single` 是另一种产物,不能代替双板。普通单图节点允许合法覆盖布局,但代理不得仅凭“单图更清楚”覆盖用户已确认的项目宫格设置。提交生图前回读每个节点的实际 `imageLayout/gridSize/aspectRatio` 及 `data.production`,按镜号列出双板覆盖;只看项目 settings 或节点标题不算核验。
10
+
11
+ 用户要求“不生成视频,只到分镜图完成”时,停止点是范围内所有必需板图的实际验收,不运行视频提示词或视频任务。节点自动派生不代表有权执行。专业板使用正式 `stage: board` 审核;普通单帧只能报告人工目检,接口返回 `MEDIA_REVIEW_PROFESSIONAL_BOARD_REQUIRED` 时不得伪造 production 合同或称系统审核通过。结构完成、像素合格、审核批准和视频生成分别报告。
12
+
13
+ 重排剧情节拍、对白或镜头归属必须先改源剧本并重新拆镜,不能用 `edit-shot` 伪造 `sourceText/source_text` 或 `sourceUnitIds/speechUnits`。编辑描述不会自动改写语义不同的 `imagePrompt`,运行前检查完整的实际图像/视频提示词。别名 `shotSize/shot_type`、`camera/camera_move`、`videoPrompt/video_prompt`、`location/scene` 应一致;同次提交冲突会拒绝。修改连续性时同时核对 `continuity.mode` 和旧 `continuity_mode`。
14
+
15
+ 时长验收分别汇总素材 `duration` 与剪辑 `edit_plan.intended_duration`;修改镜头时长后回读下游,检查返回的 `durationOverrides`,手工覆盖不能静默算成继承值。没有继承记录的历史节点仅在配置等于修改前镜头时长时可按继承处理;不一致时逐项核对并明确更新配置。来源变动后旧媒体只保留历史,不改写其真实时长。实时倒计时按镜头起止时间核对,中途跳时须有剧本依据,不能只检查数字是否齐全。
16
+
17
+ 计时分别报告墙钟、任务处理区间并集和累计任务处理时长;并发任务累计时间不能从墙钟直接相减以归因提示词编辑时间。没有事件记录时明确归因未知,不伪造纯模型耗时。
18
+
5
19
  ## 实际媒体审核记录
6
20
 
7
21
  先用 `canvas asset review-context <assetId> --project <projectId> --node <nodeId> --version <versionId> --stage board|video|delivery --json` 读取当前选版、真实 SHA-256、来源版本和必需维度。查看真实板图或完整播放并复听视频后,使用 `canvas asset review <assetId> --project <projectId> --file review.json --json` 提交;省略文件则读 stdin。