@aswless_854771076/ai_short_studio_cli 0.1.245 → 0.1.246

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.
Files changed (16) hide show
  1. package/package.json +1 -1
  2. package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +3 -1
  3. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +2 -0
  4. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +2 -0
  5. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +2 -2
  6. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +1 -1
  7. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +1 -1
  8. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +1 -1
  9. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +1 -1
  10. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +14 -0
  11. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +1 -1
  12. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/professional-directing.md +137 -0
  13. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +9 -1
  14. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/shot-transitions.md +103 -0
  15. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +4 -0
  16. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.245",
3
+ "version": "0.1.246",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -39,9 +39,11 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
39
39
  | 导演手册、摄影与表演 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/director-composition.md` | 在资产生成和拆镜前完成 `drama-director-book`;构图、轴线和表演决定必须来自剧本事实,证据不足时降级构图,不补陈设或天气 |
40
40
  | 人物、场景、道具和资产版本 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
41
41
  | 结构化分镜、分镜图、逐镜制作计划与跨镜连续性 | `references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | `Agent 自写分镜 → production-plan 文档 → continuity-plan 文档 → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,只生成已选择的板型;前镜真实完成并选版后允许 previous-tail,不要求内容审核 |
42
+ | 光影氛围、近景表情、运镜速度、构图与打斗 | `references/short-drama/prompt/professional-directing.md`、`references/short-drama/prompt/prompt-craft.md` | 按本镜目的与景别选约束;分清主体/相机/画面时间速度,保持光源、动作归属与可见性,不堆专业词 |
43
+ | 分镜转场、动作衔接、声音桥 | `references/short-drama/prompt/shot-transitions.md`、`references/short-drama/prompt/prompt-craft.md` | 写清前镜尾态、切点、后镜首态与声音交接;区分生成内切镜、后期剪辑和连续不剪,不虚构执行参数 |
42
44
  | 视频提示词、H3、Seedance、原生音频 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/prompt/h3-prompt-writing.md`、`references/short-drama/prompt/seedance-prompting.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存自由画布文档;先按通用规范确定类型与维度,再按实时 Provider schema 选择协议,完成输入结构与来源校验后提交视频,不自动审计 |
43
45
  | 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
44
- | 视频超分、媒体工具与经济出片链路 | `references/short-drama/generation/transform-drama-media.md` | `video-upscale` 使用 Comfly 1849 专用单视频协议;广告优先可用 Comfly H3 后接超分,短剧优先可用 Seedance 2.5 480p 后接超分,尽量不推荐高清直出;按实时目录执行 |
46
+ | 视频超分、媒体工具与经济出片链路 | `references/short-drama/generation/transform-drama-media.md` | `video-upscale` 使用 Comfly 1849 专用单视频协议;广告优先可用 Comfly H3 在支持 480p 时以 480p 生成后接超分,短剧优先可用 Seedance 2.5 480p 后接超分,尽量不推荐高清直出;按实时目录执行 |
45
47
  | 去字幕、参考视频复刻、深度视频 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → depth-video → video-generate`;不得把参考板或字幕带入成片 |
46
48
  | 参考对白转写、剪辑、字幕和多图模板 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
47
49
  | 逐镜审计、剪辑、字幕、声音平衡、成片交付 | `references/short-drama/review/review-drama-shots.md`、`references/short-drama/editing/edit-drama-timeline.md`、`references/short-drama/editing/edit-deliver-drama.md` | 默认 `drama-edit-plan → drama-edit-render`;审核模块仅用户明确要求时加载,真实来源与文件有效后即可交付 |
@@ -19,3 +19,5 @@
19
19
  多镜时间线必须为每个边界写 `edit_points[]`,明确 `cut_ms`、两帧内的 `anchor:{type,time_ms,evidence}`、`transition_reason` 与 `audio_bridge`。锚点可来自音乐节拍、动作冲击/峰值、对白意群、声音提示、气氛变化、视线落点或构图匹配;不能用一句“节奏需要”代替证据,也不能把所有镜头机械吸附到鼓点。转场字段必须落到 Remotion:`fade`/`dissolve` 使用 6–12 帧帧确定性 opacity 曲线,前一画面必须覆盖完整淡化区间,原生环境声同步做 constant-power 交叉淡化,不能出现“画面柔和、声音硬跳”;`action-cut` 只允许前后镜动作方向、主体姿态、空间位置与道具状态能连续承接,若同一造型人物跨地点或道具状态突变,应补建立镜头、重排或用有明确时空含义的短淡化,不能把“瞬移”标成动作切;`hard-cut`/`eyeline-cut` 保持零帧硬切,J/L-cut 通过独立音轨重叠实现。不得把所有切点统一套淡化。对每次转场至少抽取切点前一帧、精确帧、淡化中点和完成帧,复核没有单帧黑闪、跳轴、声音跳变或动作断裂。
20
20
 
21
21
  多镜时间线必须设 `audio_tracks_complete:true`,且独立音轨无缝覆盖全片;只有合同成立时镜头组件才静音,全部对白、环境、动作和音乐从 `audio_tracks` 独立混音,避免内嵌音轨与正式音轨重复叠加。旧单镜时间线没有该声明时继续保留镜头内嵌声音,不得在迁移前把合法旧成片变成无声片。`ambient`、`native` 与 `bgm` 音轨必须写 `fades:{in_ms,out_ms,curve:"constant-power"}`;constant-power 声音桥要求前后两条环境/原生音轨按 `duration_ms` 真实重叠,并分别使用等长淡出和淡入。BGM 的 `volume_envelope` 必须覆盖首尾并表达铺底、推进、高潮与收束层级。BGM 和对白/旁白重叠时,`mix.bgm_ducking` 必须显式配置 `enabled:true`、负值 `reduction_db`、`attack_ms` 与 `release_ms`,由脚手架编译为逐帧包络;禁止只给整轨一个固定音量。
22
+
23
+ 低分辨率生成后超分方案已确认时,先按 [媒体变换与视频超分](../generation/transform-drama-media.md) 执行正式 video-upscale,将实际输出的精确已选版本接入时间线;本地 Lanczos 放大、锐化或渲染输出尺寸仅用于规格适配,不能替代已确认的模型超分。输出分辨率、时长、帧率和音轨以实际媒体元信息为准。
@@ -54,3 +54,5 @@
54
54
  "labels": [], "mix": { "target_lufs": -15, "true_peak_dbtp": -1, "bgm_ducking": { "enabled": true, "reduction_db": -12, "attack_ms": 180, "release_ms": 350 } }
55
55
  }
56
56
  ```
57
+
58
+ 低分辨率生成后超分方案已确认时,先按 [媒体变换与视频超分](generation/transform-drama-media.md) 执行正式 video-upscale,将实际输出的精确已选版本接入时间线;本地 Lanczos 放大、锐化或渲染输出尺寸仅用于规格适配,不能替代已确认的模型超分。输出分辨率、时长、帧率和音轨以实际媒体元信息为准。
@@ -24,7 +24,7 @@
24
24
  | 临时参考素材发布 | 画布参考素材上传 | 平台临时公开地址、逐项确认、哈希绑定、复用和跨会话查询;不作为资产库 |
25
25
  | 异步任务与恢复 | `task list/get/wait`、monitor/recover Skills | 任务查询、输入去重、统一输出和结果对账 |
26
26
  | 剪辑与交付 | `remotion-best-practices`、timeline/delivery Skills | 吸收成熟 CLI 的选镜、切点、字幕、角标、转场、响度与完整审片规则,并用项目已有 Remotion 工程实现 |
27
- | 媒体能力主编排 | `canvas workflow status`、`orchestrate-short-drama` | 明确人物门禁、连续性/尾帧、原生声音、授权音乐、本地媒体修复和交付顺序;旧兜底、口型与远端超分节点已禁用 |
27
+ | 媒体能力主编排 | `canvas workflow status`、`orchestrate-short-drama` | 明确人物门禁、连续性/尾帧、原生声音、授权音乐、本地媒体修复和交付顺序;正式 `video-upscale` 使用 `starrouter::comfly/1849` 处理已选视频后接剪辑;旧兜底、口型和 SeedVR2.5 入口仍不恢复 |
28
28
  | 跨会话恢复与环境 | `canvas workflow status`、`ai-short-studio preflight` | 项目内恢复当前阶段、选版和任务;初始化及媒体/剪辑阶段留下无密钥环境报告 |
29
29
 
30
30
  ## 从原系统能力转换而来
@@ -52,7 +52,7 @@
52
52
  ## 当前边界
53
53
 
54
54
  - StarRouter 当前声明图片、视频、同步语音、音乐、语音转写和翻译能力;长文本异步语音返回 TAR,尚未开放为可直接剪辑的音频资产。
55
- - 百炼 CosyVoice 的自定义音色设计/克隆只在实时模型目录返回该能力时使用,必须使用真实音色 ID 并通过试听和审核;StarRouter 当前未提供等价能力,不支持时不得声称 H3 原生对白已固定。七维后配兜底、SeedVR2.5 超分及 MuseTalk 口型驱动仍缺少已验证的统一生产入口,当前明确禁用。
55
+ - 百炼 CosyVoice 的自定义音色设计/克隆只在实时模型目录返回该能力时使用,必须使用真实音色 ID 并通过试听和审核;StarRouter 当前未提供等价能力,不支持时不得声称 H3 原生对白已固定。七维后配兜底、旧厂商 SeedVR2.5 及 MuseTalk 口型入口仍不恢复。当前正式视频超分已由 `video-upscale` 节点提供,使用 `starrouter::comfly/1849` 单视频处理协议,按 [媒体变换与视频超分](generation/transform-drama-media.md) 执行;不把旧入口的限制解释为所有超分不可用。
56
56
  - 音乐目录不提供抓站下载器。在线结果只打开官方搜索入口,登录、试听、下载和当次许可证判断由用户在站点完成;插件只接收本地文件与证据,并在 audio-plan 和时间线两次核对用途。
57
57
  - 插件不内置大型模型价格表或替用户估价;生成前读取实时 Provider 目录并要求用户确认完整制作计划。
58
58
  - 画布参考素材的临时公开地址对持有链接者公开,使用前核对权利、公开范围和有效期;不保证长期可用,也不替代本地资产。
@@ -10,6 +10,6 @@ StarRouter 已列出的主要模型包括图片 `gpt-image-2`,视频 `MiniMax-
10
10
 
11
11
  无限画布使用音乐时,模型键为 `starrouter::suno_music`,节点 kind 为 `music-generate`,输出 AUDIO。节点 config 使用 `prompt`、`title`、`tags`、`lyrics` 和 `makeInstrumental`;`prompt` 必填,`lyrics` 与 `makeInstrumental: true` 互斥。成功结果只登记实际音频而非封面或视频。
12
12
 
13
- StarRouter 不提供 CosyVoice 自定义音色设计/克隆、SeedVR2.5 超分和 MuseTalk 口型驱动;百炼 CosyVoice 由平台实时目录注册,只有 `canvas node types` 返回对应节点和音色能力、且用户确认后才能使用。相关操作须先核对实时能力,未验证时停下并提示用户选择其他已支持方案。短剧最终视频通过 `video-generate` 节点执行,并继续遵循制作计划、审核与付费门禁。
13
+ 旧厂商 SeedVR2.5 和 MuseTalk 口型入口不恢复;当前视频超分使用 `video-upscale` 与 `starrouter::comfly/1849`,详见 [媒体变换与视频超分](transform-drama-media.md)。StarRouter 不提供 CosyVoice 自定义音色设计/克隆;百炼 CosyVoice 由平台实时目录注册,只有 `canvas node types` 返回对应节点和音色能力、且用户确认后才能使用。相关操作须先核对实时能力,未验证时停下并提示用户选择其他已支持方案。短剧最终视频通过 `video-generate` 节点执行,并继续遵循制作计划、审核与付费门禁。
14
14
 
15
15
  GIF、循环动图或表情动画优先评估 GPT Image 2.6 Flare/Sunburst;先核对实时目录与渠道状态,再按 [Image 2.6 动图合同](image26-animation.md) 设置输出格式;StarRouter 已支持自定义帧数和帧间隔,按实时合同设置并核对实际 GIF 时长。不能把 ChatGPT 界面能力当成平台已实现的逐帧编辑工具。
@@ -8,6 +8,6 @@
8
8
 
9
9
  同一依赖层的图片目标可批量提交;派生资产等母资产审核选版后进入下一层。并发由平台任务门禁控制,不通过切换厂商绕开限流。模型目录以实时 `canvas node types` 为准,当前主要包括 `gpt-image-2`、`MiniMax-H3`、Seedance、`speech-2.8-hd`、`speech-2.8-turbo`、`suno_music` 和默认转写 `whisper-1`。
10
10
 
11
- StarRouter 不提供 CosyVoice 自定义音色设计/克隆、SeedVR2.5 超分和 MuseTalk 口型驱动。百炼 CosyVoice 由平台实时目录动态注册,只有 `canvas node types` 返回对应节点和音色能力、用户确认后,才能用于音色设计;不得因为旧项目保存过配置就提交。RunningHub、Comfly 直连和 MuseTalk 的旧配置不能继续提交付费任务,需先改为实时目录中的模型并重新确认计划。调用前必须核对实时能力,缺失时明确停下并报告缺口。
11
+ 旧厂商 SeedVR2.5 和 MuseTalk 口型入口不恢复;当前视频超分使用 `video-upscale` 与 `starrouter::comfly/1849`,详见 [媒体变换与视频超分](transform-drama-media.md)。StarRouter 不提供 CosyVoice 自定义音色设计/克隆。百炼 CosyVoice 由平台实时目录动态注册,只有 `canvas node types` 返回对应节点和音色能力、用户确认后,才能用于音色设计;不得因为旧项目保存过配置就提交。RunningHub、Comfly 直连和 MuseTalk 的旧配置不能继续提交付费任务,需先改为实时目录中的模型并重新确认计划。调用前必须核对实时能力,缺失时明确停下并报告缺口。
12
12
 
13
13
  画布节点缺失、端口不匹配或 schema 不完整时停止提交并修复配置;不得绕过画布直接调用旧插件适配器。
@@ -10,4 +10,4 @@
10
10
 
11
11
  主运动参考在合同中记作 `reference_video`,必须绑定当前已选版本;生成前再次核对端口、版本和 SHA-256。
12
12
 
13
- 模型选择前读取 [媒体变换与超分](transform-drama-media.md):默认推荐广告使用可用的 Comfly H3 后接视频超分,短剧使用可用的 Seedance 2.5 480p 后接视频超分,尽量不推荐高清直出;用户指定和实时模型能力优先。
13
+ 模型选择前读取 [媒体变换与超分](transform-drama-media.md):默认推荐广告使用可用的 Comfly H3,在实时能力支持时以 480p 生成后接视频超分,短剧使用可用的 Seedance 2.5 480p 后接视频超分,尽量不推荐高清直出;用户指定和实时模型能力优先。
@@ -13,7 +13,7 @@
13
13
 
14
14
  ## 制作链路建议
15
15
 
16
- 在用户没有指定模型或高清直出的情况下,先核对已发布模型和实时 Provider schema:广告且平台 Comfly H3 可用时,优先建议 **H3 生成 → video-upscale → 剪辑/交付**;短剧优先建议 **Seedance 2.5 480p 生成 → video-upscale → 剪辑/交付**,尽量不推荐直接生成高清。Seedance 2.5 或 480p 不在当前目录/能力中时如实说明,不用其他版本冒充,不从模型名称猜 ID。模型、分辨率及用户明确偏好优先于建议;H3/Seedance 提示词仍遵守各自正式合同。
16
+ 在用户没有指定模型或高清直出的情况下,先核对已发布模型和实时 Provider schema:广告且平台 Comfly H3 可用时,优先建议 **H3 480p 生成(实时能力支持时)→ video-upscale → 剪辑/交付**;短剧优先建议 **Seedance 2.5 480p 生成 → video-upscale → 剪辑/交付**,尽量不推荐直接生成高清。H3 或 Seedance 2.5 的实时能力不支持 480p,或推荐模型/超分节点不可用时,如实说明并按真实可用选项确认替代方案;不静默提高生成分辨率、不用其他版本冒充、不从模型名称猜 ID。模型、分辨率及用户明确偏好优先于建议;H3/Seedance 提示词仍遵守各自正式合同。
17
17
 
18
18
  ## 其他媒体工具
19
19
 
@@ -59,3 +59,17 @@ H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider
59
59
  同一角色跨当前/未来时空的对白必须共享音色身份合同。若视频模型不能保证跨镜声纹一致,提示词仍保留说话人身份,但制作计划必须标记 `post-dub` 或可审计的后期电话处理,不能让每镜原生音频各自随机生成后再假定为同一角色。
60
60
 
61
61
  不得把故事板的铅笔、炭笔、单色、纸张质感、分格、箭头、编号、水印或 UI 生成进成片;故事板只传递构图、轴线和动作顺序,提示词必须重申项目成片媒介。每个无错镜头的 `prompt` 必须原样包含模板规定的固定反宫格声明和固定禁生成文字声明(中文模板用中文句、H3 用英文句,按模板要求放置);禁止模型在源视频中生成字幕、标题、标签、Logo、水印、UI 文字或其他可读文字,获批文字统一交给后期图形层。`canvas document save` 会逐镜校验,缺失即校验失败,不得改写或用近义句替代。多格分镜板(`panel_grid_size > 1`)整张作为语义参考引用时,prompt 还必须原样包含模板中的分镜板时间顺序条款(画格只表示动作时间顺序,禁止画格边框/分割线/编号/多格并排),画布提交前逐镜校验;多格板只能配 `full-reference`/`Ref2VA`/`reference_image`,禁止配首帧/尾帧像素模式。用 `canvas document save` 保存不可变版本,再显式选定;每镜记录制作计划版本、分镜版本、模型、提示词协议、引用资产版本和最终 prompt。修改任一上游版本必须生成新版本,不覆盖旧提示词。
62
+
63
+ ## 转场编译与前后镜交接
64
+
65
+ 多镜头及跨视频段按 [分镜转场与衔接规范](../prompt/shot-transitions.md) 执行。先读取当前前镜真实选版与后镜正式来源,确定同一动作继续、结果切、跨时空省略或平行叙事,再选择方法。每对相邻镜头写清 A 镜尾、切点触发、B 镜头起点、视觉锚点及声音交接;不为使用遮挡或闪白虚构柱子、烟雾、强光等无来源元素。
66
+
67
+ H3 把画面顺序、动作相位和切点编入 detailed_description,按当前模式正式声音字段表达声源与交接;Seedance 编入正式中文 prompt 正文,引用只对应实际提交数组。辅助表格不能替代供应商收到的正文,不新增 transition_contract 等自造字段。连续不剪写可行的相机路径,换机位保留正式机位与轴线,不将动作匹配误写为所有首尾帧像素相同。
68
+
69
+ 生成内多镜头先核对模型支持及时间预算;独立片段只生成可接续的首尾状态,后期剪辑另按真实计划执行。J/L-cut 依赖真实音轨与逐句时间证据,不在提示词阶段虚报已拼接、已混音或已验收;后期效果按实际执行路径判断:平台画布计划尚无画面叠化参数;CLI 本地 Remotion 可按已有工程与模板合同实现 fade/dissolve,见上述共享规范,不能把本地字段写入画布计划。只有所选路径确实没有实现时才标记执行缺口。保存仍走正式 write-video-prompt 并回读,不改现有工具或来源合同,不因本节新增强制内容审核步骤。
70
+
71
+ ## 专业视听细化与模型编译
72
+
73
+ 按需读取 [专业视听提示词](../prompt/professional-directing.md),将光影、表情、运镜速度、构图和打斗转为本镜实际可见内容。光源与材质服从已选场景和画风,近景只保留一至两个可读表情区域,运镜独立于主体速度与慢动作;构图写几何和焦点,攻防写动作归属、接触/落空、受力与结果。不得为强化气氛虚构环境、能力或改变正式胜负。
74
+
75
+ H3 的画面细化进入 detailed_description,声音仍按正式模式字段;Seedance 进入中文 prompt 正文。内部设计表和构图编码不作为新增 JSON/config 字段。写作自检不新增审核环节,保存回读与真实工具能力沿用当前正式流程。
@@ -60,7 +60,7 @@
60
60
 
61
61
  声音采用 `native-first`:先选同时满足画面引用和 `video.native-audio` 的 StarRouter 模型,原生生成对白、电影感旁白、环境声和动作声;BGM 走独立配乐与许可证流程。项目已确认固定 `voice_id` 时默认走原生绑定,只有实时能力明确返回不支持该 voice reference 时才停在声音方案确认并分流,不静默改用其他音色。每个原生声候选必须完成 `speech_intelligibility`、`speaker_identity`、`narration_performance`、`ambience_action_sync`、`lip_sync`、`technical_audio`、`undeclared_music` 七维审核;失败时把受控 reason 和证据写入 `native_audio_exception`。能力返回不支持的自定义音色、七维后配和口型驱动能力不得伪装成可用,也不得用旧厂商自动补做。
62
62
 
63
- 媒体能力按 `character-appeal → continuity-plan → previous-tail → native-audio → native-audio-review → licensed-music → local-media-editing → delivery` 推进。previous-tail 是有前置证据的可选节点;历史状态机中的 audio-fallback、lip-sync 和 video-upscale 节点目前禁用,不能为了填满流程伪造任务或切到旧厂商。
63
+ 媒体能力按 `character-appeal → continuity-plan → previous-tail → native-audio → native-audio-review → licensed-music → video-upscale(已选方案需要时)→ local-media-editing → delivery` 推进。previous-tail 是有前置证据的可选节点。视频超分使用当前正式 `video-upscale` 画布节点和 `starrouter::comfly/1849` 单视频协议,读取 [媒体变换与视频超分](generation/transform-drama-media.md),按已确认方案处理已选视频,再将实际超分结果接入剪辑;不依赖历史状态机的同名能力。历史 audio-fallback、lip-sync 及旧厂商 SeedVR2.5 入口不因正式超分节点可用而恢复,不伪造任务或切到旧厂商。
64
64
 
65
65
  配乐分为 `music.generate` 与 `music.catalog`。生成曲使用 `music-generate` 画布节点;目录曲只返回已授权结果或 Pixabay、YouTube Audio Library、Uppbeat 官方搜索页,不自动登录或下载。用户试听并取得文件与许可证证据后,先写不可变许可证收据,再登记未选音频候选。audio-plan 绑定精确资产、许可证收据与项目用途,时间线再次验证选版和 allowed uses;普通视频页面、无同步权与母带权凭证的热曲不能进入资产库。
66
66
 
@@ -0,0 +1,137 @@
1
+ # 专业视听提示词:光影、表演、摄影、构图与动作
2
+
3
+ 适用于短剧、广告、动画、产品、追逐和动作视频。本文是随包通用写作知识,不依赖 LibTV、外部案例、网站或本地采集目录;方法源于样本写法的归纳,场景建议与原创示例不构成模型效果保证。先按 [通用提示词规范](prompt-craft.md) 确定任务,再只取本镜需要的部分;跨镜结合 [转场与衔接](shot-transitions.md),复杂打斗结合 [打斗设计](../storyboard/design-fight-video.md),构图模式结合 [导演构图参考](../director-composition.md)。
4
+
5
+ 模型正式格式、真实素材、项目画风及实时能力优先。不把这里的设计表当 Provider 参数,不要求每镜填写全套,不新增审核节点、确认停点或强制生产顺序。创作自检消除矛盾;实际看图、播放、听音和审核证据按当前工具与用户目标另行处理。
6
+
7
+ 按需阅读:光影氛围 → 景别与表演 → 运镜与速度 → 构图与焦点 → 打斗与物理 → 组合示例与自检。
8
+
9
+ ## 从导演目的选控制量
10
+
11
+ | 本镜目的 | 优先控制 | 通常应删去的干扰 |
12
+ | --- | --- | --- |
13
+ | 察觉异常、隐瞒情绪 | 视线目标、近景细节、短暂停顿、稳定机位 | 全脸夸张、无因落泪、镜头绕到看不清眼睛 |
14
+ | 温暖、亲近、日常 | 有来源的柔光、人物距离、自然呼吸、轻缓或固定摄影 | 无来源金光、强逆光遮脸、集体同步微笑 |
15
+ | 压迫、悬疑、威胁 | 明暗取舍、负空间、遮挡后的信息、视线与声音来源 | 自动加雨雾、反复闪烁、完全不可读的黑脸 |
16
+ | 动势、追逐、紧迫 | 空间方向、主体与相机相对速度、动作起止与结果 | 全程乱晃、所有层同时加速、无来源运动模糊 |
17
+ | 产品质感、关键证物 | 有效反射、材质、焦点、可读轮廓与完整形态 | 金属塑料化、过曝高光、浅景深抹掉关键结构 |
18
+ | 打斗策略与胜负变化 | 空间、动作归属、接触/落空、受力结果与恢复 | 只写招式名、只给面部特写、爆闪掩盖接触 |
19
+
20
+ “冷色=悲伤”“仰拍=强大”只能作为候选方向,不能代替具体叙事。相同光线或机位可以服务不同情绪,选用理由应能落到本镜可见信息。
21
+
22
+ ## 光影与氛围:光源先于情绪词
23
+
24
+ 按需要写成:**已有光源 → 世界方向/照射对象 → 软硬与强弱关系 → 阴影/反射 → 色彩层次 → 随时间的变化及原因**。
25
+
26
+ | 方法 | 适用场景 | 可执行描述 | 避免 |
27
+ | --- | --- | --- | --- |
28
+ | 柔和侧光/窗光 | 日常、对话、皮肤与细微表情 | 由已存在的窗面形成宽柔光,脸部有渐变阴影,眼部仍可读 | 把柔光写成无影;额外创造窗户 |
29
+ | 硬侧光/明暗分区 | 对峙、悬疑、几何空间 | 一个明确方向的窄硬光,在脸/墙面形成有边缘的阴影,保留必要细节 | 为“阴暗”压掉证物、眼睛和接触点 |
30
+ | 逆光/轮廓分离 | 剪影、人物入场、材质边缘 | 已有背光勾出肩发轮廓;脸是否可读由现有环境反射决定 | 既要求全剪影又要求可读微表情;无源发光描边 |
31
+ | 冷暖分区 | 室内外关系、空间层次、人物分离 | 既有灯火为暖色局部光,窗口冷光落在另一侧;光位跨镜稳定 | 把“冷暖对比”变成全画面交替换色或人物换肤色 |
32
+ | 低调光/高调光 | 压迫与留白;轻盈与明亮 | 低调保留大面积暗区及关键层次;高调抬高整体明度但保留体积与高光细节 | 低调等于纯黑,高调等于过曝;固定照搬光比数字 |
33
+ | 动态光与局部反射 | 已有车辆、火光、门开合、能量变化 | 先发生有依据的事件,再让光斑、阴影、金属或湿面反光响应 | 为气氛凭空增加闪电、灯牌、雨水、烟雾或能量 |
34
+
35
+ 区分**灯光变化**与**相机曝光变化**:人物经过明暗区并不等于全画面自动提亮;仅在需要且有可解释动机时描述曝光适应。主光方向按场景世界坐标继承,换到反拍后其画面左右可能改变。
36
+
37
+ 氛围由多项事实共同形成:亮暗分布、色彩、空间距离、材质、活动密度、声源远近、停顿。雾中的体积光需要已有雾尘等介质,湿地反射需要真实湿面;来源不足就用现有环境表达,不为了套模板补景。
38
+
39
+ 材质分别写响应:皮肤保留明暗和纹理;金属亮点随视角移动;玻璃保留边缘、折射和允许的内部可见性;布料受力后反光与褶皱变化。不要给所有物体同一层光滑高亮。动画、绘画或像素项目按其媒介表达,不默认改成真人摄影。
40
+
41
+ ## 近景与表情:从触发写到释放
42
+
43
+ 可用链条:**刺激/信息 → 注视目标改变 → 试图维持的表情 → 可见泄露 → 决定/动作 → 镜尾残留**。只保留本镜实际发生的环节,不为填满链条发明心理或新剧情。
44
+
45
+ | 景别 | 可读表演证据 | 不宜强塞的细节 |
46
+ | --- | --- | --- |
47
+ | 面部特写/近景 | 具名视线目标、停留/扫视/回避/返回;眉眼或嘴角/下颌一至两个区域的低幅变化;可见呼吸/吞咽 | 同时眉飞色舞、瞳孔精确缩放、不可见脚步、全部 AU 编码 |
48
+ | 中景/中近景 | 头部与眼睛启动顺序、肩胸姿态、手势、持物、支撑与重心可见的部分 | 镜外脚部被声称清晰可见;远小于可读尺度的面肌细节 |
49
+ | 全景/远景 | 姿态轮廓、站位距离、走位方向、速度、停步和人与环境关系 | 依靠嘴角毫米变化传递核心剧情 |
50
+
51
+ 写眼神需交代**看谁/什么、朝向、何时开始、停多久、何时移开**。眼睛先动再转头、避开后返回、直视不退让等是按角色和刺激选用的方法,不是所有人物的固定模式。不要把注视目标写成抽象“远方”,也不要意外让所有角色看镜头。
52
+
53
+ 微表情有起势、短峰值与释放,不保持在同一张表情上。静止不等于冻结:按景别保留少量非机械的眼动、呼吸、重心调整。多人反应按信息到达、注意对象、性格和动作状态错开;听者有自己的反应,不在说话人讲完后集体补演一遍,也不代说或跟口型。
54
+
55
+ 角色长期习惯和禁演项以现有人物档案为准。哭泣、颤抖、流汗、发怒、笑容等不得自动升级;“克制”也不能覆盖源剧本要求的外放表演。近景必须能看到关键区域,焦点/遮挡不能同时把其藏掉。
56
+
57
+ ## 运镜与速度:分清三个运动层
58
+
59
+ 分别描述**主体速度、摄影机速度、画面时间速度**。镜头快速跟拍不代表人物加速;相机与人物同速时主体大小可能近似稳定,前后景的视差仍会变化。慢推不等于慢动作,zoom 变焦不等于摄影机 dolly 位移。
60
+
61
+ 运动合同按需要包含:**信息目的/触发 → 起始机位与景别 → 路径和方向 → 跟随/保持距离关系 → 加减速及停顿 → 终点构图/焦点**。
62
+
63
+ | 方法 | 适用目的 | 控制要点 |
64
+ | --- | --- | --- |
65
+ | 固定机位 | 读表情、看动作全程、重复动作对照 | 明确固定;主体和环境可动;不额外推近、漂移或环绕 |
66
+ | 推近/拉远 | 强调线索、进入压力;揭示空间/后果 | 从什么景别到什么景别、真实移动还是变焦、停止/继续的时刻 |
67
+ | 横移/侧跟/倒退跟拍 | 人物行进、交接、追逐 | 与主体距离和相对速度、运动轴一侧、画面入口/出口、可行路径 |
68
+ | 摇镜/俯仰 | 从一个对象带到另一个、上下揭示 | 摄影机位置是否固定、旋转方向、目标和落稳时刻;不写成无端漂移 |
69
+ | 小弧环绕/升降 | 揭示遮挡后结构、空间权力变化、接触侧面 | 起止角度/高度和目的,避免绕过轴线或遮住主体;不默认完整 360° |
70
+ | 受控手持 | 临场、压迫、贴近运动 | 有限的不规则起伏仍保留关键动作;震动方向/时机有事件依据 |
71
+ | 甩镜/突推 | 突发刺激、快速注意转移、冲击 | 触发物、方向、短促段和落点;需要换镜时另写切点 |
72
+ | 选择性变速 | 突出接触前判断或关键瞬间 | 在哪里进入/退出慢动作或加速、覆盖哪个事件;对白和动作音如何处理 |
73
+
74
+ 速度变化用事件与时间窗绑定,如“看见门后物体后逐渐减速,落稳时能读清证物”;不要用一串“快、慢、极速、丝滑”互相竞争。时长容不下“建立—运行—停止”时减少路径、删次要动作或拆镜,不缩掉动作结果。
75
+
76
+ 画面时间变速属于生成意图或真实后期能力。当前剪辑计划不支持任意 retime/speed ramp,不能只改时间线长度宣称已经变速。数字帧数、焦段、角速度或快门描述只有在影响明确且模型可理解时使用,不当成真实相机参数已被执行的证据。
77
+
78
+ ## 构图与焦点:先决定观众看什么
79
+
80
+ 写可见几何:**主信息/次信息 → 主体位置与尺度 → 视线/运动留白 → 前中后景 → 遮挡与清晰区域 → 终点构图**。构图名称只作内部选择,最终正文翻译成这些可见关系;不把构图 code 或目录名称发给模型。
81
+
82
+ | 方法 | 运用场景 | 可见约束与风险 |
83
+ | --- | --- | --- |
84
+ | 中轴/对称 | 秩序、仪式、制度性空间、产品正视 | 主轴、两侧重量和主体偏离程度;不要求现实不对称场景强行变形 |
85
+ | 偏置与负空间 | 孤立、等待、未知威胁、微小光点 | 主体在哪侧,留白向谁/什么开放;留白不是要求新增一个对象 |
86
+ | 对角线与引导线 | 运动路径、冲突方向、纵深 | 由已有道路、桌沿或身体关系形成;指向何处,不为凑线条新增建筑 |
87
+ | 前中后景/框景 | 窥视、距离、空间层次 | 前景提供位置,中景承载行动,后景交代环境;关键眼睛/接触点保持可读 |
88
+ | 过肩与双人关系 | 对白、对峙、反应 | 肩部归属、主体焦点、视线、双方世界位置和轴线;前景不盖核心信息 |
89
+ | 局部插入/证物特写 | 握持、按钮、武器或产品细节 | 有足够上下文确认归属、真实尺寸和接触;避免断肢或悬浮手 |
90
+ | 竖屏纵深/上下关系 | 9:16 人物互动、多人场景 | 用前后距离、过肩或分段呈现,保留脸和关键道具的安全区域;不把人硬挤成横排 |
91
+
92
+ 景深服务信息:一个人说话时可隔离背景;两人的手和道具接触需要足够共同清晰范围;拉焦明确从 A 到 B 的时刻和信息理由。不能既要求极浅景深又要求不同距离的全部对象始终锐利。
93
+
94
+ 焦段词与机位、距离一起理解:单改焦距不自动改变透视;宽近机位可能夸张近远关系,远机位长焦取景可压缩表观距离。不要照搬样本的毫米数或角度作为所有模型默认值。镜头可见范围必须支持表演:特写不能同时声称完整拍清全身发力链;如需两者,改景别或拆镜。
95
+
96
+ ## 打斗、追逐与物理:从行动目标到可见结果
97
+
98
+ 这是影视动作编排与模型描述规范,不是现实搏击教学。先锁剧本中的冲突目的、人物能力、武器归属、胜负、伤势、时长与画风,再选本镜一个可归因主动作。
99
+
100
+ 主动作写成:**起态/距离 → 动作发动者与身体/道具路径 → 对手反应 → 接触或落空 → 受力与位移 → 恢复/失衡/停留 → 下镜起态**。
101
+
102
+ | 动作类型 | 本镜关键约束 | 何时拆镜或简化 |
103
+ | --- | --- | --- |
104
+ | 单次攻防 | 谁发动、谁响应、哪侧肢体/道具、路径、是否接触、结果 | 双方互换身份、连续招式无法追踪、没有镜位覆盖接触 |
105
+ | 格挡/闪避/落空 | 防守动作发生在攻击到达前,错开的路径、落空后的惯性与恢复 | 只写“激烈打斗”,不清楚是谁挡住谁 |
106
+ | 握持/兵器交接 | 起始持有者、手侧、接触点、释放/接住的先后、最终持有者 | 多人抢夺导致手与武器粘连、同一武器重复出现 |
107
+ | 跌倒/碰撞/恢复 | 当前支撑、重心失稳、落地顺序、环境接触和伤势继承 | 无因飞出、落地后瞬间站稳、已受伤部位无解释恢复 |
108
+ | 追逐/远程动作 | 双方路径、先后距离、相对速度、攻击/躲避触发与结果 | 运动方向反转、距离瞬间归零、同一障碍反复出现 |
109
+ | 一对多/大场面 | 当前主攻者、其他人的位置和持续状态、前中远景信息 | 背景对手排队冻结,所有人同时发动且无法归因 |
110
+ | 能力/幻想战 | 有来源的发动条件、介质、传播路径、作用对象与终止 | 效果淹没接触,凭空新增能力或改变胜负 |
111
+
112
+ 重量来自可读的支撑、重心、接触、惯性与恢复;衣摆、头发、饰物滞后响应已有运动,不无风持续飘动。环境反馈只由真实作用产生:接触后才有局部震动、声音或碎屑,特效规模服从既定画风与能力,不自动升级成爆炸。
113
+
114
+ 镜头覆盖可按信息需要选择:全/中景交代地理、双方距离与身体路径;接触近景确认归属与结果;反应近景交代后果。它是可选覆盖方案,不是固定的三镜生产顺序。快切、手持、烟尘、闪光和模糊不能把关键接触完全藏掉。打斗不必每镜都快:观察、判断、蓄势和结果停顿可以建立节奏对比。
115
+
116
+ 没有可验证动作参考或实时模型能力时,把具名招式转译成简单可观察动作,降低连续组合密度;不能声称模型已保证精确招式。已有 fight_design/正式镜头来源则保留其事实,不为增加“专业感”改写攻防或伤势,不将设计表直接写成新 config 字段。
117
+
118
+ ## 组合写法:每次只加能改变结果的约束
119
+
120
+ 以下为原创中立示例,具体身份、光源和道具须先有实际来源。时间是示例设计,不是默认值;最终按目标模型正式语言和引用编译。
121
+
122
+ **克制近景,约 4 秒**:人物保持坐姿,听见画外的钥匙声后,眼睛先移向右侧门口,头部稍晚转动。嘴角原有的笑意短暂绷住,随后放松;不追加落泪。固定中近景,门口方向保留少量留白,焦点在近侧眼睛。沿用既有窗面柔光与较暗背景,曝光不随转头跳变;声音来自画外,不驱动人物口型。镜尾停在注视门口的状态。
123
+
124
+ **运动揭示,约 5 秒**:人物向画面右侧行进,摄影机沿轴线同侧侧跟,保持上半身大小近似稳定;已存在的近处栏杆比远处墙面更快掠过。人物发现墙上的标记后减速停步,相机随之减速,最终让人物与标记同时进入可读构图。环境不凭空加雾,固定光源的光位沿场景继承,不要求全程运动模糊。
125
+
126
+ **单次攻防,约 4 秒**:双方位于同一通道,A 在画面左、B 在右;A 向前伸手试图抓住 B 手中的袋子,B 先把袋子收向身体内侧并后撤,A 手掌从袋子原位置掠过。A 因前倾踏出一步恢复支撑,B 保持原手持袋,双方拉开距离。采用轴线同侧双人中全景,让手、袋子和支撑变化可读;不增加第二轮攻击、飞身动作或爆闪。镜尾保留双方新的距离,接下镜用真实状态衔接。
127
+
128
+ ## 写作自检与交付边界
129
+
130
+ - 光源、天气、遮挡物、道具及能力是否有来源?光线变化是否有原因,换机位是否仍服从世界方向?
131
+ - 表情是否能在本景别读到,是否有刺激与释放?是否强迫全员同步、全脸堆表情或无因升级情绪?
132
+ - 主体、相机与画面时间速度是否分清?固定与运动、浅景深与全景清晰是否互相矛盾?
133
+ - 构图是否让关键眼神、证物或接触可读?几何、焦点与画幅是否支持动作,而非只列风格名称?
134
+ - 动作能否归因到主体与具体肢体/道具?接触、落空、受力、结果及伤势是否前后一致?时长放不下时先删次要动作或拆镜。
135
+ - 保存是否仍走正式正文与真实工具字段?不把设计表、AU/code、未解析引用或内部来源哈希发送模型。
136
+
137
+ 按现有质量分级处理:缺少关键身份/来源/动作归属为 P0;已确认的空间、时序、可见性与正负冲突为 P1;目的明确但缺少控制量为 P2。提示词自检不代替实际成片证据;未执行内容审核时如实说明,不自动引入审核批准或声称模型已遵循。
@@ -10,6 +10,14 @@
10
10
  - Seedance 视频:叠加 [Seedance 2.0 逐镜提示词规范](seedance-prompting.md);素材上限、输入模式、参数和语言合同以该文件为准。
11
11
  - 目标模型未确认时,不套用任一模型规范;先读取实时 `canvas node types` 和项目确认的模型配置。
12
12
 
13
+ ## 专业视听细化
14
+
15
+ 涉及光影氛围、近景表情、运镜速度、构图或打斗时,按需读取 [专业视听提示词](professional-directing.md):将导演目的转成已有光源与材质响应、景别可读的表演、主体/相机/画面时间速度、可见几何与焦点、攻防接触与结果。只取本镜必要维度,不照搬样本参数或增加无来源环境;构图与打斗仍保留正式来源事实。
16
+
17
+ ## 分镜转场与衔接
18
+
19
+ 涉及多镜头、前后视频段或首尾帧过渡时,读取 [分镜转场与衔接规范](shot-transitions.md):先定时空与因果关系,再选切镜/匹配/遮挡/甩镜/叠化/声音桥或连续不剪;写清 A 镜尾 → 切点 → B 镜头起点 → 声音交接,并标明生成内切镜或真实后期剪辑。正文不能只写“无缝、自然、丝滑”,不能把写作说明当新增 Provider 字段或自动剪辑能力。
20
+
13
21
  ## 先定模态与任务类型
14
22
 
15
23
  先按节点模态确定主类型,再按主体数量和镜头复杂度决定信息量。一个节点只选一个主类型,必要时标注辅类型;不要用风格标签或一段长模板代替类型判断。
@@ -146,7 +154,7 @@ P3 为可交付:主体和素材用途明确、动作按时间顺序可执行
146
154
  4. 检查输入模式、素材的保留/修改/忽略范围和标签顺序。
147
155
  单幅首态须检查参考图是否已包含未来的持物或转身姿态:人物设定图只继承身份与服装,场景图只继承空间与光线,不能把参考图的后段动作复制到本镜 0 秒。明确实际可见的空手、持物和朝向,生成后以真实图片核对,来源正确或提示词写了首态均不等于图像已遵守。
148
156
  前镜尾帧作为状态参考不等于继承机位。正式镜头为 independent 换机位时,保留其 camera_setup_id、轴线和构图设计,只从尾帧继承身份、姿态与持物;不能为了复用尾帧把换机位改写成同机位或声称首帧严格锁定。新机位仍须覆盖本镜关键接触与结果。
149
- 5. 检查时间码、总时长、动作预算、镜尾状态和转场动机。
157
+ 5. 检查时间码、总时长、动作预算、镜尾状态和转场动机。跨镜按 [衔接写作自检](shot-transitions.md#衔接写作自检) 核对动作相位、持物手、轴线、遮挡/匹配锚点、声音归属和实际执行位置;禁止同一时间段既要求一镜到底又要求硬切。
150
158
  以对白或接触完成为触发条件的反应,其时间窗不得早于该事件的完成点;“说完后”与绝对秒数必须一致,不能同时要求先后顺序和重叠起始。人物前后方向与画面左右分别说明,倾身或退让用支撑位置及可见肩胸终点消除歧义;画外支撑只作物理约束,不能作为已观察到动作的证据。
151
159
  6. 删除无法验收的形容词,替换成可观察的画面或声音事实。
152
160
  7. 检查正向约束与禁止项是否互相否定,保留最小必要集合。
@@ -0,0 +1,103 @@
1
+ # 分镜转场与衔接规范
2
+
3
+ 本文件是 CLI 与内置 Agent 共用的随包视频提示词内容规范,适用于多镜头、前后视频段、首尾帧过渡及连续长镜头。方法从公开工作流的提示词写法归纳,场景选择、交接合同和示例为通用制作建议;不需要访问外部样本、采集目录或网站,不代表任何模型的效果保证。
4
+
5
+ 先读取 [通用提示词规范](prompt-craft.md) 与目标模型正式合同,再按本文件选择转场。H3 的段落/标签/语言、Seedance 的模板/引用与实时 Provider schema 优先;这里的表格是写作说明,不新增节点、工具、API 参数或强制审核步骤。自检用于消除正文矛盾与不支持的执行要求,不创建审计/审核节点、不等待额外批准;用户明确要求内容审核时才执行对应流程。
6
+
7
+ ## 先选叙事关系,再选形式
8
+
9
+ 1. **同一时间、同一动作**:优先动作匹配或视线/反应切,保持动作进度、轴线和道具持有者。
10
+ 2. **同一事件、换视角或展示结果**:优先硬切,切点落在动作、反应、信息揭示或声音触发处。
11
+ 3. **跨时间或跨地点**:明确省略了什么;可用图形匹配、叠化、淡出或有来源的声音桥,不暗示现实空间连续。
12
+ 4. **需要速度与冲击**:有动机的甩镜、遮挡切、闪白;不能为了藏错误把关键接触点或结果遮掉。
13
+ 5. **需要沉浸与真实路径**:连续移动或穿越前景,不切镜;不要同时要求换到不可能到达的机位。
14
+ 6. **需要幻想、变身或材质转换**:明确允许形变的对象和中间过程;普通跨镜身份连续不要靠人脸融变实现。
15
+
16
+ 默认选择能完成信息交接的最简方法;不要每镜换一种特效。视觉切点与声音切点可以不同,声音桥可与硬切、动作切等组合。
17
+
18
+ ## 方法、场景与提示词控制量
19
+
20
+ | 方法 | 适用场景/作用 | 必须写清的控制量 | 常见失败与限制 |
21
+ | --- | --- | --- | --- |
22
+ | 硬切/反应切 | 对白、反转、打斗结果、信息揭示;快速改变观看重点 | 谁的什么动作/声音触发;A 镜尾、B 镜头起点;人物与空间继承 | “硬切”不等于闪黑;避免关键动作无结果或人物瞬移 |
23
+ | 动作匹配切 | 开门、落脚、翻页、拿取、挥击;跨机位保持事件连续 | 同一主体、同一只手/脚、同一道具、运动方向、切点动作相位及接触点 | 下一镜重复起手、落脚两次、持物手互换;匹配切不自动表示连续时间 |
24
+ | 视线匹配/正反打 | 对话、看见线索、威胁揭示、听者反应 | A 看向何处、B 被看对象;轴线同侧、屏幕左右、机位高度/视线关系 | 不是每镜都直视镜头;无意越轴会改变双方关系 |
25
+ | 图形/构图匹配切 | 地图到实景、眼睛到圆形物、跨时空意象或产品联想 | A 的轮廓/色块/位置/尺度如何对应 B;在匹配处切换;时间地点变化 | 匹配剪辑不是默认形变;不要求两对象融成一团。样本中的 Match Cut 也可能指动作匹配,须读上下文 |
26
+ | 遮挡切/擦镜 | 追逐、柱后换位、人物经过、门框/衣袖/碎片掠镜;隐藏切点 | 遮挡物来源、运动方向、覆盖范围、切换时刻、B 揭开方向与接续动作 | 两段须有可配对的遮挡窗口;局部遮挡不能假设全画面可隐藏剪切 |
27
+ | 甩镜衔接 | 动作追随、快速转移注意、强节奏广告 | 由谁/什么触发,甩向何处,A 末/B 初的方向与速度、模糊区切点、B 如何减速落稳 | 甩镜本身是运镜;只有明确切点或接续镜头才是转场。不用无动机晃动代替动作 |
28
+ | 推近/拉远与穿越衔接 | 地图到地点、微观到宏观、空间导览、从前景进入新空间 | 连续可行的摄影机路径、进入/退出锚点、尺度变化、主体与环境的保留范围 | 若换地点需另选匹配切/遮挡/形变机制;只写“推进转场”会产生凭空穿墙 |
29
+ | 叠化/交叉溶解 | 数日变化、回忆、梦境、柔和的时间或地点省略 | A/B 交叠窗口、叠化起止、需要保留的构图锚点;新时空标识 | 交叠会出现双重影像;不适合精确交接、人脸身份核对和必须看清的接触动作 |
30
+ | 淡入/淡出 | 开场、章节收束、情绪停顿、明确时间间隔 | 整幅画面淡向黑/白或从中出现、时长、是否留空场;声音是否同步渐弱 | 画面整体淡出与某个物体透明消失不同;不能同时要求镜尾完整可见且已全黑 |
31
+ | 闪白/闪黑 | 有来源的强光冲击、记忆断点、幻想离场 | 闪光/暗场来源、覆盖时刻、持续时间、B 的显露状态;声音是延续还是中断 | 闪白可指照明变化而非转场;不要掩盖打斗因果,不默认反复闪烁。闪黑需独立验证,不能由闪白样本推定采用 |
32
+ | 声音桥:先行/延续(J-cut/L-cut) | 下一地点先入耳;说话人切到听者反应;对白和情绪跨镜延续 | J:B 声音在 A 画面结束前进入;L:A 声音在 B 画面开始后保留。写声源、先后时间、结束点、空间与混音 | 不把剪辑术语当模型参数;不让画外台词驱动听者口型。声源换空间须交代音色/混响变化 |
33
+ | 平行/交叉剪辑 | 追逐双方、救援倒计时、两条行动线、相似行为对照 | A/B 各自地点和时间关系;切回时动作进度;节奏递进与最终汇合/对照点 | 平行叙事不自动代表同时发生;明确未同框,防止模型把两处人物合到一景 |
34
+ | 形变/材质过渡 | 幻想、意识空间、广告意象、明确要求的变身 | 哪个轮廓/材质逐步变成什么、变化顺序、运动轨迹、最终稳定状态;身份变化是否被允许 | 风险是面部融化、道具粘连与身份漂移;现实动作衔接优先切镜而非形变 |
35
+ | 连续不剪/一镜到底 | 沉浸式移动、表演完整性、动作因果与空间展示 | 摄影机连续路径、主体运动、焦点转移、遮挡后的状态、总时长 | 属于连续调度,不是剪辑转场;段落或“镜号”可以只是同一镜内的节拍,须明确哪些地方允许剪切 |
36
+
37
+ ## 两镜交接合同
38
+
39
+ 写提示词前先用下表做制作说明。它是分析/交付格式,不是新增 CLI 字段或 Provider schema,不得未经核实写入工具参数。
40
+
41
+ | 项目 | 需要回答 |
42
+ | --- | --- |
43
+ | 目的与关系 | 为何此处换镜?同一时刻连续、短暂省略、跨地点、回忆还是对照? |
44
+ | A 镜尾 | 人物身份、姿态、注意对象、动作相位、持物手、道具位置、屏幕运动方向、光线、声音 |
45
+ | 切点与机制 | 硬切/遮挡/匹配等;什么可观察事件触发;是否有重叠/遮挡窗口? |
46
+ | B 镜头起点 | 哪些状态继承、哪些有意改变;新景别、机位、视线与轴线关系 |
47
+ | 视觉匹配锚点 | 动作接触点、图形轮廓、构图位置、运动速度或遮挡物;不适用则说明 |
48
+ | 声音交接 | 声源归属、先行/延续、开始和停止时间、口型归属、混响与混音主次 |
49
+ | 执行位置 | 单次生成内切镜、两段独立生成后剪辑、实际支持的首尾帧/延长功能? |
50
+ | 验收 | 切点前后逐帧看什么;如何确认无动作重演、错手、跳轴、重复音节或多余黑帧? |
51
+
52
+ 状态继承是跨镜合同,有意的时空跳转可改变状态,但必须写原因。不要机械要求所有镜头首尾构图完全相同。
53
+
54
+ ## 执行边界
55
+
56
+ - **单次生成多镜头**:先核对目标模型实时能力与时长,再在正式提示词格式里按时间段写切点。每个镜头保持一个主要叙事动作,不把多次切镜写成一个含混动作。
57
+ - **两段独立生成后剪辑**:A 写到可剪的镜尾,B 从指定状态继续;转场窗口和声音偏移交给真实剪辑流程。仅写提示词不能保证输出文件之间自动拼接、采样级音频连续或帧级匹配。
58
+ - **首尾帧/延长**:只有模式和实时 schema 支持时才用;明确参考帧职责、允许变化和结束落点。两张不相关的首尾帧容易被补成形变,必须说明希望的过渡机制,必要时分别生成再剪辑。
59
+ - **未知工具能力**:记录执行缺口并交付两镜提示词与剪辑说明,不虚构转场 API、自动拼接工具或专有参数。H3、Seedance 的正式模型合同继续优先。
60
+
61
+ ## 原创示例:把“流畅衔接”展开为可验收描述
62
+
63
+ ### 动作匹配:开门接反应
64
+
65
+ A:侧后中景,人物右手压下门把并将门推开约三分之一;肩膀继续向门内前移。切点落在门扇仍在打开时,镜尾保留正在运动的门沿。
66
+
67
+ B:在同一动作相位切到门内反应近景,门沿从画面同侧继续移开;右手仍握原把手,不重做压把动作。人物看见室内空椅后停步,手仍扶门。保留门轴声跨切点延续,停步后声响结束。
68
+
69
+ ### 遮挡切:追逐换位
70
+
71
+ A:摄影机跟随奔跑者向画面右侧移动,近处深色柱子由右向左掠过并覆盖整个画面;全遮挡窗口内切镜。
72
+
73
+ B:柱子继续由右向左移出,奔跑者保持向画面右侧运动、相同速度及手中道具;机位在原运动轴线同侧。显露后继续当前跑步相位,不重新起跑。
74
+
75
+ ### 图形匹配:圆形物到新地点
76
+
77
+ A:俯拍白色杯口,圆形位于画面中央,推近至约占画面一半;在圆形构图稳定时硬切。
78
+
79
+ B:新地点的圆形天窗从相同画面位置和近似尺度出现,再拉远交代室内空间。此处明确跨地点;杯子不融化为建筑,不制造虚假的连续穿越路径。
80
+
81
+ ### 声音桥:下一场先入耳
82
+
83
+ 在已剪辑时间线上,A 的室内近景最后 0.4 秒先进入 B 所在车站的到站广播;切至 B 的站台全景后广播继续。广播来自站台扬声器,A 中人物不对口型。A 的室内底噪在切点退出,B 的站台环境声随画面进入。0.4 秒是本例剪辑设计,须按成片节奏调整,不是模型默认值。
84
+
85
+ ## 衔接写作自检
86
+
87
+ - **P0**:依赖的前段、关键参考帧或声音素材缺失且无法确定交接状态;要求执行的输入模式没有有效来源。
88
+ - **P1**:同一时间段既要求不切镜又要求硬切;同一连续动作错手/重演/跳进度;无意越轴;明确禁止形变却要求两张身份不同的脸连续融变;转场时长挤掉动作结果;声源或口型错绑。
89
+ - **P2**:只写“无缝、自然、丝滑”而无 A 尾/B 初/切点;声音桥没有先后与终止点;遮挡或甩镜缺少方向/覆盖窗口;执行位置不明。
90
+ - **提示词可交付**:镜尾与下镜起点能逐项核对,时空变化有理由,必要剪辑操作有真实执行入口;没有入口时明确标记待剪辑,不能宣称已经实现或验收。
91
+
92
+ ## 剪辑执行与能力边界
93
+
94
+ 生成提示词只描述期望镜头。后期直切与声音桥使用现有正式剪辑计划:画面片段和音轨分别排时,J-cut 让后镜声音提前进入,L-cut 让前镜声音延续。使用真实已选媒体、完整来源合同与实测时长;对白按真实逐句时间证据完整保留一次,不能凭提示词或字数猜音频切点。
95
+
96
+ 执行前先区分平台画布时间线与 CLI 本地 Remotion 工程,不能把其中一端的能力或限制直接套到另一端:
97
+
98
+ - **平台画布时间线(CLI 与内置 Agent 共用)**:当前正式计划支持直切、来源裁切和独立音轨排时/声音淡化,未提供画面叠化、擦镜、形变、闪白等后期效果参数。不能向该计划虚构 transition 字段、用音量 fade 代替画面淡化,或把 cut_reason 中的术语当作已经实现。
99
+ - **CLI 本地 Remotion 工程**:按 [Remotion 剪辑规范](../editing/remotion-best-practices.md) 和 [时间线剪辑规范](../editing/edit-drama-timeline.md) 核对已有工程与模板合同;该路径允许用本地 timeline 的 `{type,duration_frames}` 转场描述实现 fade/dissolve,使用帧确定的 opacity 曲线并核对前后画面覆盖及声音重叠。实际参数必须由工程读取并渲染,不能把本地字段写入平台画布计划,或仅凭文字声明效果已实现。
100
+
101
+ 其他效果先核对当前执行路径的真实实现;没有实现时才选择受支持的生成模式实际产出,或交付待外部剪辑的说明。内置 Agent 没有本地工程文件与 Shell 工具时,按平台画布合同执行并说明缺口,不能因共享文档介绍了 Remotion 就声称可以调用本地工程。
102
+
103
+ previous-tail 只按已有正式连续性合同绑定前镜当前选版和真实尾帧;参考模式不保证严格首帧锁定。independent 换机位继承身份、姿态和持物,保留新机位、轴线与构图。动作匹配可以切在运动中,不能把所有跨镜都改为同机位/像素相同的首尾帧,也不能在接触尚未发生时让后镜凭空拥有动作结果。动作峰值处换视角需继续同一动作相位;若省略了接触过程,下一镜须有可理解且来源一致的结果。
@@ -13,3 +13,7 @@
13
13
  保存前运行:
14
14
 
15
15
  校验通过后,再将其中的动作事实转译到 `storyboard` 和 `plan-shot-continuity`;不要把 `fight_design` 当成正式视频提示词,也不要跳过逐镜审核。
16
+
17
+ ## 编译为生成提示词
18
+
19
+ 动作事实确定后,按 [专业视听提示词的打斗与物理规则](../prompt/professional-directing.md#打斗追逐与物理从行动目标到可见结果) 选择可拍的景别与机位,将发动、对手响应、接触/落空、受力结果和恢复编入当前镜头。镜头覆盖是按信息目的选择的方法,不强制全景—接触特写—反应的固定生产顺序;精确招式缺少可靠参考或模型能力时简化。使用快切、手持或效果仍须保留关键因果,不改变正式胜负或已有伤势。
@@ -17,7 +17,7 @@
17
17
  9. **字幕与口型**:从最终已选音频生成绑定字幕;换版后重建字幕、口型和剪辑引用。
18
18
  10. **制作规划**:构建或修订结构化分镜,`plan-drama-production` 逐镜按 `storyboard_strategy` 确定所需板型、格数、按需启用的 Blender 白模、模型、`prompt_profile`、输入模式和参考顺序,只汇总任务与素材数量。
19
19
  11. **分镜与素材制作**:制作规划先建立空间连续性。Agent 按镜头目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;只有复杂调度风险无法由已选静态参考证明时才追加 Blender 白模。每个实际生成的板型分别完成对应审计,再由 `write-drama-video-prompts` 绑定本镜实际需要的参考和音频参考。声音按 native-first 执行。随后按制作计划创建画布生成任务,一次只提交当前就绪的镜头组。候选生成后先按制作计划审核,通过后才选版。若下一镜需要承接尾帧,先完成上一镜当前已选版本的审核,再把尾帧作为下一镜首帧;相同来源重复使用前再次比对版本和 SHA-256。任务失败或中断时保留证据,先查询原任务,不产生新的付费提交。启用白模的镜头绑定已审核的主运动参考。
20
- 12. **授权音乐与本地修复**:许可证用途验证通过后才把目录音乐放入时间线;本地局部修复保留来源、范围和专项审核。远端超分暂时禁用,等待 StarRouter 等价模型验证。
20
+ 12. **授权音乐与本地修复**:许可证用途验证通过后才把目录音乐放入时间线;本地局部修复保留来源、范围和专项审核。视频超分已提供正式 `video-upscale` 节点,使用 `starrouter::comfly/1849`;按 [媒体变换与视频超分](generation/transform-drama-media.md) 核对实时能力与已确认方案,低分辨率已选视频处理成功后,将实际超分结果接入剪辑。旧厂商 SeedVR2.5 入口不恢复,不能将本地放大或渲染尺寸变化当作模型超分。
21
21
  13. **剪辑**:按 [剪辑与交付](../editing-delivery.md) 和 `remotion-best-practices` 完成粗剪、字幕、转场、声音和渲染。
22
22
  14. **成片**:`edit-deliver-drama` 逐集完整审片并输出交付文件和 manifest。
23
23