@aswless_854771076/ai_short_studio_cli 0.1.156 → 0.1.157
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 +1 -1
- package/dist/commands/canvas/document/get.js +3 -3
- package/dist/commands/canvas/document/save.js +8 -2
- package/dist/commands/canvas/documents.js +1 -1
- package/dist/commands/canvas/workflow/status.js +1 -1
- package/dist/domain/canvas-schema-key.d.ts +2 -0
- package/dist/domain/canvas-schema-key.js +21 -0
- package/dist/domain/vvicat-api.js +1 -1
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +13 -13
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +21 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/SOURCE.md +9 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md +408 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +16 -30
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-art-styles.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-assets.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.en.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.zh.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.en.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/plan-drama-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/analyze-drama-source.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/define-drama-brief.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/design-drama-bible.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/outline-drama-series.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/short-drama.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-director-book.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-episode.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-deliver-drama.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +4 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/remotion-best-practices.md +4 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +8 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +25 -25
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +5 -11
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/design-drama-audio.md +4 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +6 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/monitor-drama-tasks.md +9 -7
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +9 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md +8 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/README.md +59 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.mjs +517 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.test.mjs +354 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.mjs +188 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.test.mjs +218 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.mjs +458 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.test.mjs +236 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/report.mjs +69 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.mjs +341 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.test.mjs +302 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +43 -133
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/music-catalog-providers.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/manage-drama-projects.md +5 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +7 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/recover-drama-pipeline.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +7 -7
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +4 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +40 -65
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +91 -131
- package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/h3-prompt-writing.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +185 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +64 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/recreation-qa.md +87 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +5 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +1 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +0 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/generate-blender-previz.md +5 -10
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +2 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +28 -70
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +0 -447
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/brief.md +0 -93
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/project-files.md +0 -246
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/reference-video.md +0 -266
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/script-and-time.md +0 -253
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/transformations.md +0 -141
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/distribution.md +0 -176
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/local-tools.md +0 -411
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/model-and-provider.md +0 -275
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/profile.md +0 -286
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/asset-and-shot-preproduction.md +0 -193
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/b-roll.md +0 -94
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/caption-tracking.md +0 -125
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/captions.md +0 -252
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/conversation-images.md +0 -218
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/image-direction.md +0 -123
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/generated-dependencies.md +0 -38
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/graphic-compositions.md +0 -85
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/image-direction.md +0 -95
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/motion-graphics.md +0 -68
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/recreation-policy.md +0 -51
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/screen-demonstrations.md +0 -51
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/shot-production-contracts.md +0 -161
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/sound-mix.md +0 -76
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/video-direction.md +0 -433
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-and-performance.md +0 -224
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-direction.md +0 -99
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/narration-led-demo.md +0 -87
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/presenter-led-explainer.md +0 -160
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/ranking-listicle.md +0 -71
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +0 -19
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama-workflow.md +0 -165
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama.md +0 -88
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/street-interview.md +0 -92
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/talking-head.md +0 -82
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/two-person-podcast.md +0 -101
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/index.md +0 -77
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/audio-presentation.md +0 -49
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/authoring.md +0 -228
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/browser-capture.md +0 -112
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/builds.md +0 -330
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-authoring.md +0 -156
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-presentation.md +0 -66
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-design.md +0 -217
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-sharing.md +0 -150
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-visuals.md +0 -152
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/detail.svrun +0 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/direction.svs +0 -14
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/look.svs +0 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/material.svrun +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svml +0 -73
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svrun +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/visuals.ts +0 -62
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/fonts-and-text.md +0 -138
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/image-operations.md +0 -102
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/index.md +0 -73
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media-presentation.md +0 -111
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media.md +0 -246
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/performance.md +0 -114
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/prompt-kits.md +0 -165
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/rendering.md +0 -141
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/review.md +0 -211
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/runs.md +0 -151
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/script-syntax.md +0 -236
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/snapshots.md +0 -90
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/sound.md +0 -75
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/source-syntax.md +0 -163
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/spatial.md +0 -189
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio-companions.md +0 -186
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio.md +0 -249
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/system.md +0 -169
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timeline.md +0 -74
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timing.md +0 -96
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/track-authoring.md +0 -215
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/tracks.md +0 -67
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/video-downloads.md +0 -47
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/vocabulary.md +0 -119
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/README.md +0 -11
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/comfly-provider.md +0 -12
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/seedance-community-skills.md +0 -23
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/publish-drama-references/litterbox.md +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/runninghub-provider.md +0 -33
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/starrouter-provider.md +0 -53
- package/skills/using-vvicat-ai-short-studio-cli/references/video-model-routing.md +0 -10
- package/skills/using-vvicat-ai-short-studio-cli/references/video-prompt-spec.md +0 -32
- /package/skills/using-vvicat-ai-short-studio-cli/references/{short-drama/assets/modules/humanizer → humanizer}/LICENSE +0 -0
- /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-base-prompt-writing.md +0 -0
- /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-reference-prompt-writing.md +0 -0
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
# 通用提示词规范
|
|
2
|
+
|
|
3
|
+
本文件定义图片、视频、音频和文本节点的提示词内容结构,适用于 Agent 直接编写或审查提示词。它不定义任何 Provider 参数:H3 的六段英文合同、Seedance 的引用语法和图片模板分别以正式模板与实时 schema 为准;但它会标注每类提示词实际落在哪个画布节点字段,避免把内容写成没有落点的长文本。编写短剧视频提示词时,读完本文件再进入 [编写视频提示词](../generation/write-drama-video-prompts.md);H3 目标叠加 [H3 提示词规范](h3-prompt-writing.md);Seedance 目标叠加 [Seedance 2.0 逐镜提示词规范](seedance-prompting.md)。
|
|
4
|
+
|
|
5
|
+
优先级固定为:模型正式合同 > 实时平台参数 > 本规范的内容结构 > 风格偏好。无法确认目标模型协议时停止,不把通用结构冒充平台专用提示词。
|
|
6
|
+
|
|
7
|
+
## 相关模型规范
|
|
8
|
+
|
|
9
|
+
- H3 视频:在本文件的内容结构之上叠加 [H3 提示词规范](h3-prompt-writing.md);任务类型、引用标签、六段顺序和声音字段以该文件为准。
|
|
10
|
+
- Seedance 视频:叠加 [Seedance 2.0 逐镜提示词规范](seedance-prompting.md);素材上限、输入模式、参数和语言合同以该文件为准。
|
|
11
|
+
- 目标模型未确认时,不套用任一模型规范;先读取实时 `canvas node types` 和项目确认的模型配置。
|
|
12
|
+
|
|
13
|
+
## 先定模态与任务类型
|
|
14
|
+
|
|
15
|
+
先按节点模态确定主类型,再按主体数量和镜头复杂度决定信息量。一个节点只选一个主类型,必要时标注辅类型;不要用风格标签或一段长模板代替类型判断。
|
|
16
|
+
|
|
17
|
+
| 类型 | 必写 | 常见失败 |
|
|
18
|
+
| ---------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |
|
|
19
|
+
| 图片资产 | 资产身份、视图/构图、材质颜色、光线背景、不可改变项、负向约束 | 把动作写成剧情;三视图身份不一致;文字、比例或配件漂移 |
|
|
20
|
+
| 单素材运动 | 主体锁定、一个动作链、景别运镜、光影风格、必要声音 | 一镜塞入多个无关动作;没有镜尾状态;人物与背景一起漂移 |
|
|
21
|
+
| 多素材叙事 | 每个素材的编号、来源、用途、空间位置、互动因果 | 素材没有用途;编号前后变化;道具瞬移 |
|
|
22
|
+
| 结构化分镜 | 镜号、时间顺序、景别、站位、动作、表演结果、对白和声音来源 | 镜头之间没有动作衔接;台词没有归属;运镜拍不到关键动作 |
|
|
23
|
+
| 动作/视频复刻 | 复刻范围、保留项、替换项、节拍、禁止继承项 | 只说“参考视频”;复制主体但没复制时序;把参考身份带入成片 |
|
|
24
|
+
| 产品与商业展示 | 产品不可改变属性、材质比例、展示路线、接触关系、品牌文字 | 产品变形、文字乱码、只拍到局部、结束构图缺失 |
|
|
25
|
+
| 灾难与动作大场面 | 空间尺度、前中远景、主体锚点、物理来源、摄影稳定性 | 只有“宏大、震撼”;破坏没有来源;运镜与主体运动冲突 |
|
|
26
|
+
| 角色对白(视频节点) | 说话人、听者、台词顺序、视线、口型、情绪、听者反应、声音主次 | 多人同时说话无主次;声音与动作不对应;旁白写成角色对白 |
|
|
27
|
+
| 配音与音色(音频节点) | 音色来源、语言口音、情绪语速、停顿、口型同步、环境声与混音限制 | 多人台词没有顺序;外部 TTS 覆盖原生音频;声线来源不明 |
|
|
28
|
+
| 视频延长/连续镜头 | 继承状态、新增时间段、动作/镜头/声音接续、结束状态 | 续段重新生成人物;镜头方向反转;环境音断裂 |
|
|
29
|
+
| 首尾帧路径/视频编辑 | 输入模式、首尾帧或原视频用途、保留项、修改项、过渡路径、禁止继承项 | 把编辑写成全新剧情;尾帧不可达;替换后仍继承原身份 |
|
|
30
|
+
| 音乐与歌曲 | 用途、曲风、人声或纯音乐、曲式、情绪曲线、乐器节奏、结尾方式 | 同时要求纯音乐和歌词;只堆曲风标签;把对白塞进歌曲 |
|
|
31
|
+
| 音乐卡点 | 节拍来源、动作/转场落点、镜头长度、高潮收束 | 只写“卡点”;镜头总时长超过音频 |
|
|
32
|
+
|
|
33
|
+
节点建议:一个资产目标一个节点;连续对白按 3–6 镜一个视频节点,超过后拆成连续节点;一次只延长一个明确动作段;对白、歌曲和纯音乐分开建节点;音乐卡点单独声明时间轴。
|
|
34
|
+
|
|
35
|
+
## 通用覆盖维度
|
|
36
|
+
|
|
37
|
+
每条视频提示词至少覆盖以下九组维度,缺少某一维时按镜头复杂度省略,但不得省略模型合同要求的字段:
|
|
38
|
+
|
|
39
|
+
- **生成合同**:输入模式、参考素材用途与优先级、每个素材的保留/修改/忽略范围、标签与提交顺序、输出用途、时长、画幅、分辨率、帧率和透明背景,以及模型实际支持的能力边界。
|
|
40
|
+
- **主体与素材**:主体身份(年龄、外观、服装、状态、不可改变特征)、稳定编号,以及每个引用只承担一个主要职责。
|
|
41
|
+
- **空间与连续性**:前后左右高低、距离、站位、视线和接触点;服装、发型、伤口、道具持有者、门窗、时间和天气;屏幕方向、180 度轴线、镜头高度、主体在画面中的相对大小和画面锚点。
|
|
42
|
+
- **事件与表演**:起始状态、按时间发生的动作链、因果与接触点、结束状态;可见人物的 `performance_contract`。
|
|
43
|
+
- **摄影与时间**:景别、机位、构图、焦段、景深、焦点变化和曝光;运镜方向、速度和起止;实时、升格、慢动作、节拍和停顿;总时长、时间码、动作预算和镜尾预留;转场动机(硬切、动作切、视线切、声音先行、遮挡或连续不剪)。
|
|
44
|
+
- **光影、色彩、材质与物理**:主光方向、色温、轮廓光、反射、阴影、体积光和曝光;主色、对比色、饱和度和冷暖关系;皮肤、玻璃、金属、布料、液体、尘埃和湿度;重量、碰撞、摩擦、惯性、碎片轨迹、烟尘来源和接触反应。
|
|
45
|
+
- **声音**:说话人、语言口音、情绪语速、台词顺序和口型;环境声、动作音、空间反射和距离衰减;声音来源(模型原生、绑定音色、参考音频或后期独立音轨);对白、环境声、动作音和音乐的主次、ducking 与静音点。
|
|
46
|
+
- **画面文字与交付**:画面文字的原文、语言、位置、出现时机和可读性;字幕策略(无字幕、烧录或独立文件);logo、UI 和剧情内文字分开处理;输出合同中的时长、画幅、分辨率、帧率、色彩和透明背景。
|
|
47
|
+
- **风格与负向约束**:写实、电影、纪录、动漫、广告、年代、地域和摄影质感;只写必须发生的正向画面事实;只排除已知高风险错误的最小必要负向约束,并检查正负约束不互相矛盾。
|
|
48
|
+
|
|
49
|
+
按任务类型再追加:
|
|
50
|
+
|
|
51
|
+
- 人物互动或对白:表演、微表情、视线、重心、说话人、口型、台词顺序、环境声和动作音;
|
|
52
|
+
- 跨镜或延长:服装、发型、伤口、道具持有者、屏幕方向、光线、环境声和上一镜结束状态;
|
|
53
|
+
- 产品/广告:形状、比例、材质、颜色、品牌文字、展示路径、完整可见和结束构图;
|
|
54
|
+
- 灾难/动作大场面:前中远景、主体锚点、破坏来源、碰撞/烟尘/碎片路径和摄影稳定性;
|
|
55
|
+
- 图片资产:资产身份、视图、构图、材质、光线、文字来源和不可改变属性;
|
|
56
|
+
- 配音/音乐:说话人或曲式、语言/音色、情绪、时序、是否原生音频、BGM/字幕/混音限制。
|
|
57
|
+
|
|
58
|
+
## 按模态裁剪
|
|
59
|
+
|
|
60
|
+
- 图片:先写资产身份和视图,再写构图、材质、光线、画面文字来源和不可改变属性;一个节点只解决一个资产目标。
|
|
61
|
+
- 音频/音乐:先写说话人或曲式,再写语言/音色或段落结构、情绪、时序和混音限制;对白、歌曲和纯音乐分开建节点。
|
|
62
|
+
- 文本:写清事实、说话人、语气和交付格式,不套用镜头或音色字段。
|
|
63
|
+
|
|
64
|
+
## 画布节点与写入字段
|
|
65
|
+
|
|
66
|
+
先读取实时 `canvas node types` 确认节点类型、提示词字段和配套参数,再决定内容写到哪里。图片、音频和视频都有各自的画布节点和 Provider schema,不存在只能离线描述、不能提交的模态;只有用户明确要求不落画布的纯文本建议,才停留在内容合同。
|
|
67
|
+
|
|
68
|
+
| 节点 | 提示词与配套字段 | 写入方式 |
|
|
69
|
+
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
|
|
70
|
+
| `image-generate` | `prompt`(也可从 prompt 端口接入文本节点);`count`、比例、分辨率和模型按实时 schema | `canvas node update <id> --set prompt=<JSON>` 或 `canvas apply` |
|
|
71
|
+
| `image-edit` | `instruction`;原图走 `image` 端口,不在文本里描述“那张图” | 同上 |
|
|
72
|
+
| `grid-enhance` | 没有提示词字段;只接收拆分图和参考图,参数按实时 schema | 只连端口与 config,不补写 prompt |
|
|
73
|
+
| `character-turnaround` / `location-image` / `prop-turnaround` | 提示词来自 `CHARACTERS` / `LOCATIONS` / `PROPS` 结构化输入端口;`count`、比例、目的字段在 config,身份以已选资产为准 | 先连结构化设定节点,不手写 `config.prompt` 冒充设定 |
|
|
74
|
+
| `storyboard-image` / `storyboard-grid-image` / `storyboard-board-image` | 提示词来自 `STORYBOARDS` 结构化输入端口;板型、`gridSize`、布局和比例按 schema,先确认项目已选板型 | 同上;不得用自由文本替代分镜数据 |
|
|
75
|
+
| `voice-design` | `prompt` 描述音色;`previewText` 为试听文本 | `canvas node update` / `canvas apply`;试听后用户确认才绑定 |
|
|
76
|
+
| `voice-clone` | 没有提示词字段;参考音频走 `audio` 端口,`prefix`、`targetModel`、`maxPromptAudioLength` 等在 config | 只连端口与 config;样本来源与截取区间必须先确认 |
|
|
77
|
+
| `tts` | `text` 为正式台词;`voice` 走端口或 `voice` 字段,`instruction`、`rate`、`volume`、`pitch`、`format` 等按 schema | 同上;不用 `prompt` 顶替 `text`,不用 TTS 生成音乐 |
|
|
78
|
+
| `music-generate` | `prompt`、`title`、`tags`、`lyrics`、`makeInstrumental` | 同上;`lyrics` 与 `makeInstrumental: true` 互斥 |
|
|
79
|
+
| `video-generate` | 自由画布写 `prompt`;短剧流程用 `write-video-prompt` 写 `h3`/`seedance` 正式文本;首尾帧、参考图/视频/音频走端口 | 不得用 `prompt` 覆盖模型语言和结构合同 |
|
|
80
|
+
|
|
81
|
+
- 节点 `prompt` 只补充创作意图,服务端会追加语言与最终结构合同;冲突时以后置合同为准。不要把语言标签、引用语法或 JSON 结构塞进 `prompt` 去覆盖服务端。
|
|
82
|
+
- 结构化资产和分镜节点的 `prompt` 端口只接受对应类型的输入:人物、场景、道具和分镜数据先由自由画布文档或结构化节点产出并选版,再连到节点;直接写一段自由文本不能代替结构化输入。
|
|
83
|
+
- 图片和音频节点同样有实时模型能力:分辨率、时长、素材上限和输入端口以 `canvas node types` 为准。不要因为它们不是视频,就把九组视频维度原样粘贴进 `prompt`;按本节之前的模态裁剪选取必要维度。
|
|
84
|
+
- 写入后回读节点 config 与连线,确认字段落在正确键上、参考素材仍连在端口上、模型与参数未被覆盖,再提交付费任务。只写 `prompt` 却让端口悬空,等同于没有引用素材。
|
|
85
|
+
|
|
86
|
+
## 复杂度选择
|
|
87
|
+
|
|
88
|
+
- 单主体单动作或氛围:一个动作链、一个镜头、一个明确结果,不套长模板;
|
|
89
|
+
- 多主体互动、道具交接或对白:编号主体、空间关系、交接顺序、反应和镜头覆盖;
|
|
90
|
+
- 连续剧情、复杂表演、广告分镜或灾难大场面:按镜头拆开,写时间点、运动结果、声音桥、首尾状态和锁定条款。
|
|
91
|
+
|
|
92
|
+
复杂度只决定信息量,不决定堆砌程度。缺少某一维时按镜头复杂度省略,但不得省略模型合同要求的字段。
|
|
93
|
+
|
|
94
|
+
## 场景规则矩阵
|
|
95
|
+
|
|
96
|
+
先选一个主场景类型,再读取对应规则;场景规则补充导演意图,不改变 H3/Seedance 的正式格式。
|
|
97
|
+
|
|
98
|
+
| 场景 | 必写内容 | 先拆镜的条件 |
|
|
99
|
+
| ------------------- | -------------------------------------------------------------------------- | ---------------------------------------------- |
|
|
100
|
+
| 单人物动作/氛围 | 起始姿态、一个主动作、速度、支撑脚/重心、可见范围、结束姿态 | 走路、转身、拿物、说话和复杂运镜同时成为主动作 |
|
|
101
|
+
| 两人对白 | 说话人、听者、台词顺序、视线、口型、听者反应、情绪变化、声音主次 | 说话归属、打断顺序或镜头可见口型不清 |
|
|
102
|
+
| 多主体互动/道具交接 | 稳定编号、站位、持有者、伸手/接触/交接/收回、接触点、受力和反应延迟 | 手部归属、人数或道具状态无法稳定追踪 |
|
|
103
|
+
| 产品/商业展示 | 不可改变属性、材质比例、展示路线、接触关系、镜头覆盖、结束构图和品牌文字 | 产品完整性、文字或展示顺序无法保证 |
|
|
104
|
+
| 动作/追逐/打斗 | 空间建立、双方朝向、蓄力/接触/受力/结果、轴线、重心和反应镜头 | 没有运动参考却要求精确招式,或肢体归属不清 |
|
|
105
|
+
| 灾难/大场面 | 前中远景、主体锚点、破坏来源、传播路径、烟尘碎片方向、摄影稳定性、镜尾残留 | 只有“宏大/震撼”而没有空间或物理来源 |
|
|
106
|
+
| 动作复刻/参考视频 | 复刻范围、保留项、替换项、禁止继承项、节拍、声音来源和身份绑定 | 不能区分复刻动作、运镜、节奏还是转场 |
|
|
107
|
+
| 视频延长/连续镜头 | 首尾来源、继承状态、新动作起点、镜头/声音接续、结束状态 | 接续点、尾帧状态或声音交接不明确 |
|
|
108
|
+
| 首尾帧/视频编辑 | 首帧/尾帧身份、变化发生的时间段、保留项、修改项、过渡路径、结束状态 | 变化时段、保留范围或尾帧可达性不明确 |
|
|
109
|
+
|
|
110
|
+
## 表演合同 `performance_contract`
|
|
111
|
+
|
|
112
|
+
每个可见人物都必须记录:当前主动作、注意对象、反应触发、未参与状态、动作结果和镜尾状态。多人默认错开起始时刻、动作幅度、视线、反应延迟、呼吸和眨眼;只有剧情明确要求同步时才同步。
|
|
113
|
+
|
|
114
|
+
- **近景/特写**:可写眼神启动/停留/回避/返回、眉眼或嘴角的一至两个低幅变化、呼吸、吞咽、停顿、表情面具和短暂泄露;不把 FACS/AU 编码写进最终提示词。
|
|
115
|
+
- **中景**:写肩胸髋、重心、支撑脚、手势、道具关系、人物距离、走位、头部与身体的启动顺序及听者反应。
|
|
116
|
+
- **全景/远景**:用姿态、轮廓、走位、距离、方向、停顿、速度和环境相对位置替代不可读的微表情。
|
|
117
|
+
- **心理戏**:按“刺激/信息 → 注意或眼神变化 → 维持的表情 → 短暂泄露 → 决定/动作 → 镜尾残留”编排,不直接堆“悲伤、震惊、腹黑”等抽象词。
|
|
118
|
+
- **自然感**:写支撑脚、重心、关节路径、加减速、惯性跟随、呼吸和恢复;头发、衣摆、饰物只由已有风、重力、加速或接触驱动,环境不凭空增加天气和特效。
|
|
119
|
+
- **跨镜表演**:人物离画时记录离画边、最后姿态、运动方向和持物状态;长期习惯只有在角色档案触发条件成立时才复现。
|
|
120
|
+
|
|
121
|
+
## 质量分级
|
|
122
|
+
|
|
123
|
+
P0 包括:模态或输出目标不明确;输入模式、参考素材用途或保留/修改/忽略范围不明确;没有明确主体、动作或可执行画面目标;关键素材没有来源;镜头、动作或空间关系完全缺失;主体或说话人不明;动作无起止;表演不可见;动作与镜头冲突;互动无法归因;声音归属冲突;输入模式不受当前模型支持。
|
|
124
|
+
|
|
125
|
+
P1 包括:主体编号前后不一致;动作顺序违反物理或时间逻辑;同一时刻要求互相冲突的动作;正向描述与禁止项直接冲突;运镜拍不到指定动作;角色、道具、服装或伤口无解释变化;道具瞬移;轴线或视线冲突;重心与接触不合理;多人同步冻结;灾难无物理来源;镜尾不能接续;复刻保留/替换混淆;时间码、镜头时长或动作预算超过目标时长;首尾帧、原视频或参考音频的继承关系不明确;图片资产的身份、比例、视图或关键材质冲突;音频节点没有说话人或音乐用途,或同时要求纯音乐和歌词。
|
|
126
|
+
|
|
127
|
+
P2 包括:缺少景别、机位、主体位置或动作结束状态;缺少时间预算、镜尾状态或转场动机;有对白但缺少说话人、音色或口型要求;复杂动作缺少声音或物理反馈;只有风格词而没有可观察的光影、材质或色彩;画面文字、logo、字幕的保留或可读性没有说明;对白、环境声和音乐没有主次或混音关系;缺少呼吸、停顿或微反应;图片没有构图、视图或不可改变属性;配音没有语言、音色或台词顺序;音乐没有曲式或情绪目标;未使用对应场景模板。
|
|
128
|
+
|
|
129
|
+
P0/P1 阻止提交,P2 必须记录并修复或由用户确认。
|
|
130
|
+
|
|
131
|
+
P3 为可交付:主体和素材用途明确、动作按时间顺序可执行、镜头能覆盖动作、关键连续性已锁定、负向约束少而具体。P4 为稳定样板:多镜头之间有明确动作因果和空间连续性,表演细节服务于情绪,声音与动作、距离和空间自然同步,结尾状态可直接接下一段或剪辑。
|
|
132
|
+
|
|
133
|
+
## 检查顺序
|
|
134
|
+
|
|
135
|
+
1. 列出每个主体和参考素材,检查编号、来源、用途和优先级一一对应。
|
|
136
|
+
2. 用时间线检查每镜起始状态、动作、结果和下一镜继承状态。
|
|
137
|
+
3. 用俯视图检查人物、道具、镜头和运动方向是否冲突。
|
|
138
|
+
4. 检查输入模式、素材的保留/修改/忽略范围和标签顺序。
|
|
139
|
+
5. 检查时间码、总时长、动作预算、镜尾状态和转场动机。
|
|
140
|
+
6. 删除无法验收的形容词,替换成可观察的画面或声音事实。
|
|
141
|
+
7. 检查正向约束与禁止项是否互相否定,保留最小必要集合。
|
|
142
|
+
8. 检查画面文字、logo、字幕和交付格式与对白、语言合同是否一致。
|
|
143
|
+
9. 检查是否残留占位符、项目专用字段或故事板布局说明。
|
|
144
|
+
10. 标记等级:P0/P1 必须重写,P2 补齐,P3/P4 可输出。
|
|
145
|
+
|
|
146
|
+
## 反模式
|
|
147
|
+
|
|
148
|
+
- 用“电影感、高清、震撼、自然”等泛化质量词替代动作、镜头、声音或连续性合同;
|
|
149
|
+
- 用模板段落堆砌长度,或重复同一质量词而不增加可验收信息;
|
|
150
|
+
- 精确复制样本的角色、对白、项目名称或整段原文,只复用结构、维度和可迁移方法;
|
|
151
|
+
- 把多个互不相容的独立主动作塞进一个镜头,或让镜头拍不到所写的动作;
|
|
152
|
+
- 同一素材承担多个互相冲突的职责,或只写“参考图片”而不说明用途;
|
|
153
|
+
- 未解析的占位符、临时 URL、未选版资产或未确认画风进入提示词;
|
|
154
|
+
- 用提示词文字伪造模型不支持的参考类型、编辑或延长能力;
|
|
155
|
+
- 让模型自填随机画面文字,或把字幕、logo、UI 和剧情内文字混为一类;
|
|
156
|
+
- 对白、环境声和音乐没有主次与混音关系,或存在未声明 BGM。
|
|
157
|
+
|
|
158
|
+
## 输出结构
|
|
159
|
+
|
|
160
|
+
未指定平台时使用以下结构;指定 H3 或 Seedance 时保留素材用途和检查结果,把提示词正文改写成对应模型合同的正式格式。
|
|
161
|
+
|
|
162
|
+
```text
|
|
163
|
+
【类型】图片资产 / 多素材叙事 / 产品展示……
|
|
164
|
+
【素材用途】逐项列出每个参考素材的身份、来源和用途
|
|
165
|
+
【提示词】可直接提交的完整提示词
|
|
166
|
+
【检查】主体、动作、镜头、连续性、声音、冲突与质量等级
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
通用骨架只用于组织信息,不替代模型字段:
|
|
170
|
+
|
|
171
|
+
```text
|
|
172
|
+
[输入模式与输出合同]
|
|
173
|
+
[主体及素材用途]
|
|
174
|
+
[起始状态 → 主动作与因果次级动作 → 结束状态]
|
|
175
|
+
[景别、机位、构图、轴线、运镜、转场]
|
|
176
|
+
[表演、光影、材质、物理]
|
|
177
|
+
[对白、口型、环境声、动作音、音乐]
|
|
178
|
+
[连续性锁定与最小必要负向约束]
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
## 模型编译边界
|
|
182
|
+
|
|
183
|
+
本规范只提供内容结构。H3 必须先读 [H3 提示词规范](h3-prompt-writing.md) 与 [H3 成片规则](../../h3-video-delivery.md),按实时能力选择输入模式,并只输出规定的字段和顺序;Seedance 必须先读 [Seedance 2.0 逐镜提示词规范](seedance-prompting.md) 和实时 Provider schema;两者不得混用字段或引用语法。最终编译前必须读取实时节点 schema、项目有效 `artStyle`、画幅、时长和音频能力。
|
|
184
|
+
|
|
185
|
+
音色绑定后,角色长期档案保留 `voice_identity`。模型支持参考音频时,把已选全局音色作为 `audio_reference`;H3 仍使用原生音频,不运行外部 TTS 覆盖。模型不支持参考音频时只写稳定声线描述,并在结果中保留能力限制。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md
ADDED
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# Seedance 2.0 逐镜提示词规范
|
|
2
|
+
|
|
3
|
+
本文件是随包内置的 Seedance 提示词检查层,不依赖外部站点或社区仓库。正式提交模板是 `assets/modules/write-drama-video-prompts/prompts/seedance2_video.zh.txt` 与 `.en.txt`;本文件只规定编译前的判断、素材用途、动作、镜头、表演、声音、连续性和返工顺序。类型决策、描述维度和质量分级见 [通用提示词规范](prompt-craft.md)。模型参数、素材上限和输入模式以实时 Provider schema 为准,模板与实时能力冲突时先修正路由。
|
|
4
|
+
|
|
5
|
+
## 先定本镜任务
|
|
6
|
+
|
|
7
|
+
为每个镜头先写内部镜头表:机位一侧、人物位置与朝向、视线、主动作、其他可见人物的持续行为、持物手、光线方向、镜尾可见状态。表格只用于核对,不复制进提交给模型的正文。
|
|
8
|
+
|
|
9
|
+
只编译当前镜头实际需要的身份、素材用途、动作、声音、连续性和镜尾;删除上一段已经由参考图表达的静态背景、重复画质词和无法验收的形容词。
|
|
10
|
+
|
|
11
|
+
## 素材用途与引用
|
|
12
|
+
|
|
13
|
+
- `@图片1`、`@视频1`、`@音频1` 的编号、类型和用途必须与实际提交数组、引用清单一一对应;未使用的素材不写标签,没有素材不造标签。
|
|
14
|
+
- 每个素材只承担一个主要职责:人物身份、当前画面/分镜、首帧、动作或运镜参考、音频节拍。不要让一张图同时无条件控制身份、动作和场景。
|
|
15
|
+
- 项目合同上限:素材总数不超过 12;图片不超过 9;视频不超过 3 且合计 2–15 秒;音频不超过 3 且合计不超过 15 秒;单次生成时长 4–15 秒。超限、真实人脸参考冲突、用途冲突或缺时长时,把问题写入 `errors`,不生成提示词。
|
|
16
|
+
- `person_reference` 必须按素材实际内容声明;音频不包含该字段,也不按用途猜测。
|
|
17
|
+
|
|
18
|
+
## 动作与空间
|
|
19
|
+
|
|
20
|
+
- 主动作按“起势 → 接触或变化 → 物理后果 → 收势”排序;每个阶段都有可观察结果,动作在镜尾前清晰成立并短暂稳定。
|
|
21
|
+
- 道具写清哪只手持有、接触点、交接后的归属和必须保持连接或静止的邻接物,防止只生成手势而物体不响应。
|
|
22
|
+
- 多人镜锁定准确人数、从左到右顺序、朝向、视线和每只参与动作的手;动作归属不清、人数不稳或时间顺序不可拍摄时先拆镜。
|
|
23
|
+
- 一个镜头只保留一个叙事主动作和少量有因果的次级运动。动作完成后不得自动倒放、回弹或用无关动作填满剩余时长;需要延续时拆成同方向的后续节拍。
|
|
24
|
+
- 起始参考缺少本镜必需的人物、道具或空间结构时,退回分镜补齐或改用能绑定该资产的输入模式;只有剧本明确要求从画外进入时,才写首帧缺席、进入方向和出现路径。
|
|
25
|
+
|
|
26
|
+
## 镜头与时间
|
|
27
|
+
|
|
28
|
+
- 运镜写起点、路径、速度变化和终点;固定镜头不得自动漂移,除非制作计划明确要求。
|
|
29
|
+
- 时间轴覆盖完整时长:起始状态、动作发展、峰值、反应或收束、镜尾。13–15 秒使用 `[0–Ns]` 分段,所有时间段从 0 开始、首尾相接、无间隙无重叠。
|
|
30
|
+
- 动作预算必须能放进目标时长;对白放不下时回到剧本或分镜调整,不加速硬塞。
|
|
31
|
+
- 画面文字、屏幕界面和品牌标识必须来自原文或已批准图形合同;没有证据时保持关闭、空白或不可辨读。剧情依赖的精确文字交给后期图形层。
|
|
32
|
+
- 故事板、宫格和分镜板只传递构图、轴线和动作顺序;模板规定的反宫格声明和禁生成文字声明必须原样保留,不改写、不移动、不用近义句替代。
|
|
33
|
+
|
|
34
|
+
## 表演
|
|
35
|
+
|
|
36
|
+
- 每个可见人物写一个当前主要动作、注意对象、反应触发、未参与状态和镜尾状态;听者与说话者在同一时间段交叠表演,不轮流冻结。
|
|
37
|
+
- 多人默认错开起始时刻、动作幅度、视线、反应延迟、呼吸和眨眼;只有剧情明确要求同步时才同步。
|
|
38
|
+
- 近景/特写使用一至两个可读面部区域的低幅起势—峰值—释放,眼睛写注视对象、方向、持续/扫视/回避/返回和眼头启动顺序;中景写肩胸髋、重心、支撑脚、手势和走位;远景用姿态、轮廓、距离、方向和速度替代不可读的微表情。
|
|
39
|
+
- 心理戏沿“刺激或信息 → 注意或眼神变化 → 维持的表情 → 短暂泄露 → 决定或动作 → 镜尾残留”编排,不直接堆“悲伤、震惊、腹黑”等抽象词,不提交 FACS/AU 编码。
|
|
40
|
+
- 自然感写支撑脚、重心、关节路径、加减速、惯性跟随和恢复;头发、衣摆、饰物只由已有风、重力、加速或接触驱动,环境不凭空增加天气和特效。
|
|
41
|
+
|
|
42
|
+
## 对白与声音
|
|
43
|
+
|
|
44
|
+
- 对白、旁白和画内文字逐字保留原文与语言标签,不用项目默认语言覆盖多语言台词。
|
|
45
|
+
- 声音策略使用三层合同:`delivery_mode` 只允许 native/post_dub/external_audio;`presentation` 只允许 visible-dialogue/offscreen-dialogue/narration;`fallback_mode` 只允许 none/post-dub/cinematic-tts/sound-design。
|
|
46
|
+
- 原生音频镜头写清说话人、口型、台词时间范围和听者反应;同一句里避免同时要求大幅转头和复杂运镜。不能保证跨镜声纹一致时,保留说话人身份并在制作计划标记后配或可审计的后期处理。
|
|
47
|
+
- 环境声写声源、距离、空间反射、连续起止和跨镜延续;动作声只绑定可见接触或运动,写清起音、瞬态、余响和停止点。对白期间环境底自然压低但不消失。
|
|
48
|
+
- 明确禁止未声明 BGM;授权配乐走独立音乐流程。不得把 `post_dub` 或 `external_audio` 偷换成模型直出对白,也不在提示词阶段假定后续一定能对口型。
|
|
49
|
+
|
|
50
|
+
## 返工与续镜
|
|
51
|
+
|
|
52
|
+
- 返工先记录画面中实际失败的动作、口型、道具或连续性,再只改一个主要变量;连续两次无效后停止盲重试,回到分镜、参考或模型能力定位原因。
|
|
53
|
+
- 续镜以已验收视频的实际镜尾为准,不把计划镜尾当成已经发生的事实;上一镜换版后必须重新派生尾帧并核对来源版本与 SHA-256。
|
|
54
|
+
- 不因一次失败切换 Provider、重复付费或静默降低输入模式;超出既有授权时先说明缺口并取得确认。
|
|
55
|
+
|
|
56
|
+
## 提交前检查
|
|
57
|
+
|
|
58
|
+
P0(阻止提交):主体或说话人不明;动作没有起止;关键素材没有真实来源;人数、手部归属或空间关系无法稳定追踪;输入模式不支持当前素材组合。
|
|
59
|
+
|
|
60
|
+
P1(必须重写):动作因果或时间顺序矛盾;运镜拍不到指定动作;道具瞬移;正负约束互相冲突;镜尾接不上下一镜;多格分镜板的构图被写进成片。
|
|
61
|
+
|
|
62
|
+
P2(补齐后提交):缺少镜尾状态、转场动机、环境声、声音主次或光影材质;有对白但没有说话人或口型要求;质量词无法对应到画面或声音事实。
|
|
63
|
+
|
|
64
|
+
通过检查后再用 `canvas node write-video-prompt` 写入正式文本,回读版本并完成选版,才能提交视频。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
所有文件都是插件内置静态资产,不依赖外部提示词目录、数据库或业务系统。先读取 [Codex 原生合同说明](codex-contracts.md):文本类文件是 Codex 执行合同,不再作为 system prompt 发送给另一个 LLM;`module-map.json` 的 `provider_prompts` 才是直接提交媒体模型的模板。主 Skill 按 module ID 决定何时加载哪一份,Codex 每次只处理当前原子步骤。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
花括号变量是具名输入槽。文本步骤完成后,用登记模板留存合同、变量和产物;媒体模板由 Codex 填值后写入画布节点(`canvas node write-video-prompt`),不存在本地渲染子命令。缺少变量或包含密钥字段时失败。
|
|
6
6
|
|
|
7
7
|
| 原子产物 | 模块 | 模板 |
|
|
8
8
|
|---|---|---|
|
|
@@ -59,4 +59,4 @@
|
|
|
59
59
|
| 通用音色推荐 | `design-drama-audio` | `character_voice_recommend` |
|
|
60
60
|
| 自然语言音色描述 | `design-drama-audio` | `character_voice_description` |
|
|
61
61
|
|
|
62
|
-
完整机器可读归属见 `module-map.json
|
|
62
|
+
完整机器可读归属见 `module-map.json`。`ai-short-studio skill status` 只核对安装校验和与包版本;中英文模板配对、变量槽对称、`module-map.json` 路径和本索引的一致性由 CLI 包测试 `test/skill-content.test.ts`(`npm test`)在打包前校验。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/recreation-qa.md
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# 参考片复刻知识问答
|
|
2
|
+
|
|
3
|
+
本文件只描述 CLI 画布上可直接执行的复刻能力。不要执行任何本地进程或随包不存在的脚本;先运行 `ai-short-studio canvas node types --json` 读取实时节点目录,确认输入端口、配置字段和模型能力后再提交。
|
|
4
|
+
|
|
5
|
+
复刻仍受素材权利、用户付费授权、模型实时能力和画布审核门禁约束。结构迁移不等于获得原片人物、声音、音乐、字幕、品牌或镜头素材的使用权。
|
|
6
|
+
|
|
7
|
+
## Q1:复刻由哪些画布节点组成?
|
|
8
|
+
|
|
9
|
+
| 节点 | 输入 | 关键配置 | 输出 | 用途 |
|
|
10
|
+
| --- | --- | --- | --- | --- |
|
|
11
|
+
| `recreation-shot-extract` | `video`:参考片 | `startSeconds`、`durationSeconds` | `video`:独立镜头 | 按动作边界切出单镜 |
|
|
12
|
+
| `recreation-subtitle-remove` | `video`:已核对镜头 | `model` 固定为 `starrouter::comfly/1194` | `video`:去字幕镜头 | 清理画面字幕 |
|
|
13
|
+
| `recreation-depth-preprocess` | `video`:已核对镜头 | `model` 固定为 `starrouter::comfly/1776` | `video`:深度视频 | 生成深度预演参考 |
|
|
14
|
+
| `depth-video` | `video`:源视频 | `model` 默认 `starrouter::comfly/1776` | `video`:深度视频 | 历史兼容的深度视频入口 |
|
|
15
|
+
| `recreation-transcribe` | `audio`:参考音频 | `task`、`language`、`responseFormat` 等 | `text`:转写或翻译文本 | 对白转写,不是最终字幕 |
|
|
16
|
+
| `video-generate` | 提示词与参考素材端口 | 实时视频模型参数 | `video`:生成镜头 | 正式视频生成 |
|
|
17
|
+
|
|
18
|
+
节点字段以 `canvas node types` 的实时输出为准;表中模型键是当前默认值,不是永久能力承诺。
|
|
19
|
+
|
|
20
|
+
## Q2:拆镜节点怎么配置?
|
|
21
|
+
|
|
22
|
+
`recreation-shot-extract` 的 `startSeconds` 和 `durationSeconds` 决定切出的区间,默认从 0 秒开始、长 5 秒。每个节点只承载一个完整镜头,按动作起止切分,不要把一个节点写成整段参考片。
|
|
23
|
+
|
|
24
|
+
提交前确认:
|
|
25
|
+
|
|
26
|
+
- 区间覆盖完整动作,包含起势、接触或变化、结果和镜尾;
|
|
27
|
+
- 只输出这一镜真正需要的画面,不为凑时长带入无关镜头;
|
|
28
|
+
- 生成后回读真实视频,核对时长、画面和方向,再进入下一步;
|
|
29
|
+
- 实时节点能力给出更严格的时长上限时,以上限为准。
|
|
30
|
+
|
|
31
|
+
## Q3:去字幕节点怎么用?
|
|
32
|
+
|
|
33
|
+
把已核对镜头连到 `recreation-subtitle-remove` 的 `video` 端口。该节点使用 StarRouter Comfly 去字幕能力,默认模型 `starrouter::comfly/1194`。
|
|
34
|
+
|
|
35
|
+
每次只提交一个镜头;完成后回读去字幕视频,确认字幕区域没有残留、画面没有明显变形、时长和音轨未被意外改变。参考片中的字幕、水印和品牌文字不得作为最终成片内容继承。
|
|
36
|
+
|
|
37
|
+
## Q4:深度视频用哪个节点?
|
|
38
|
+
|
|
39
|
+
`recreation-depth-preprocess` 和 `depth-video` 都输出深度视频,默认模型 `starrouter::comfly/1776`。新流程优先使用 `recreation-depth-preprocess`;已有项目可以继续读取 `depth-video`。
|
|
40
|
+
|
|
41
|
+
深度视频只是动作、镜头和连续性分析的运动参考。深度预处理成功不代表目标视频模型支持参考视频输入;进入正式生成前必须重新读取模型实时能力,适配器拒绝参考类型时停止该请求,不能通过删掉参考或切换模型偷偷降低复刻目标。
|
|
42
|
+
|
|
43
|
+
## Q5:参考对白转写怎么用?
|
|
44
|
+
|
|
45
|
+
把参考音频连到 `recreation-transcribe` 的 `audio` 端口。默认模型为 `starrouter::whisper-1`,配置字段包括:
|
|
46
|
+
|
|
47
|
+
- `task`:`transcription` 或 `translation`;
|
|
48
|
+
- `language`:默认 `auto`,转写时只有非 `auto` 才会作为语言提示提交;
|
|
49
|
+
- `responseFormat`:`json`、`text`、`verbose_json`、`vtt` 或 `srt`;
|
|
50
|
+
- `prompt`、`temperature` 等可选参数按实时 schema。
|
|
51
|
+
|
|
52
|
+
边界:
|
|
53
|
+
|
|
54
|
+
- 音频输入不能为空,单次不超过 10 MB;
|
|
55
|
+
- WAV 必须是合法 RIFF/WAVE 文件;
|
|
56
|
+
- `json` 结果只有文本,不保证逐词时间戳;需要词级时间戳时使用 `verbose_json` 并核对实际返回;
|
|
57
|
+
- 转写或翻译结果只是待审核文本,不能直接冒充已对齐的最终字幕;
|
|
58
|
+
- 上游超时或失败时保留 HTTP 状态和请求标识,不自动重复提交付费请求。
|
|
59
|
+
|
|
60
|
+
## Q6:复刻结果怎样进入正式视频生成?
|
|
61
|
+
|
|
62
|
+
先完成拆镜、去字幕、深度参考和对白转写,再把已确认的镜头、动作、人物身份、道具状态、逐句语言和深度参考整理进结构化镜头与制作合同。随后按实时视频模型 schema 选择输入模式,把已选版本通过端口连到 `video-generate`,并让 `write-video-prompt` 生成对应模型的正式提示词。
|
|
63
|
+
|
|
64
|
+
不要把参考片整段直接当作生成结果,也不要用一句 `prompt` 覆盖模型的语言、引用标签、输入模式或结构合同。
|
|
65
|
+
|
|
66
|
+
## Q7:素材和网络有哪些硬限制?
|
|
67
|
+
|
|
68
|
+
- 参考视频必须是公开可访问的 HTTPS 地址;
|
|
69
|
+
- `localhost`、内网地址、`*.local`、`*.internal`、私有 IP 和带用户名密码的 URL 会被拒绝;
|
|
70
|
+
- 提交超时可能表示上游已经创建任务,先查询原任务,不连续重试;
|
|
71
|
+
- 失败时保存 HTTP 状态、详细消息和请求标识,不把单个错误码解释成其他变量已被排除。
|
|
72
|
+
|
|
73
|
+
## Q8:哪些内容不能从参考片继承?
|
|
74
|
+
|
|
75
|
+
- 原片人物身份、声音、音乐、品牌、字幕和水印;
|
|
76
|
+
- 只允许分析或深度参考的素材,不能直接改接成首帧或正式生成输入;
|
|
77
|
+
- 参考板、分镜宫格、编号、箭头、纸张质感、UI 和水印;
|
|
78
|
+
- 未选版、未审核、带临时 URL 或占位符的素材。
|
|
79
|
+
|
|
80
|
+
## Q9:提交前的快速检查
|
|
81
|
+
|
|
82
|
+
1. 每个复刻节点只处理一个镜头,区间和动作边界一致;
|
|
83
|
+
2. 去字幕和深度视频都已回读真实产物;
|
|
84
|
+
3. 转写文本已人工核对,且没有冒充最终字幕;
|
|
85
|
+
4. 参考视频地址是公开 HTTPS,任务超时有查询而非重试;
|
|
86
|
+
5. 正式视频模型支持当前输入模式,提示词、端口和已选版本一致;
|
|
87
|
+
6. 用户已确认付费范围,素材权利和禁止继承项已记录。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 复核短剧剧本
|
|
2
2
|
|
|
3
|
-
读取已选剧本、source-analysis、brief、bible、outline,并读取 [合规清单](../writing/compliance-checklist.md)。由 Codex 使用
|
|
3
|
+
读取已选剧本、source-analysis、brief、bible、outline,并读取 [合规清单](../writing/compliance-checklist.md)。由 Codex 使用 `../assets/modules/review-drama-script/prompts/review_drama_script.{zh,en}.txt` 复核,不调用外部文本模型。
|
|
4
4
|
|
|
5
5
|
把结果保存为 `script-review` 不可变版本并选定。`approved` 仅在来源覆盖、开场、节奏、兑现、对白、连续性、合规与可制作性都通过,且无 P0/P1 问题时为 true。问题必须定位到场次或台词;需要修改时回到 `humanizer` 或 `write-drama-episode` 产生新剧本版本,再对新版本复核,旧报告不得复用。
|
|
6
6
|
|
|
7
|
-
使用 `
|
|
7
|
+
使用 `canvas document save` 保存,再用 `canvas document get` 选定。导演本阶段只接受与当前 selected 剧本版本一致且已批准的报告。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# 验收短剧镜头
|
|
2
2
|
|
|
3
|
-
人物定妆候选先执行独立的人物视觉专项审核,不能套用普通镜头总分。必须完整检查整张设定板及必要的局部细节;Agent 使用符合主 Skill 体积上限的保真预览和局部裁切完成检查,不直接上传生产原件。审核需写 `review_type:"character-appeal"`、`assetKey`、`versionId`、`watched_or_inspected_full:true`、`approved`、`protection_flags[]`,以及六个不可互相补偿的维度:`age_classification:{status,observation,observed_age_class}`、`identity:{status,observation}`、`grooming_costume:{status,observation}`、`memory_anchors:{status,observation}`、`audience_appeal:{status,observation}`、`art_style_fidelity:{status,art_style_id,observation}`。最后一项绑定项目当前画风,按其 renderingContract 检查媒介/渲染、材质、色彩和光线;不得把真人写实当通用标准,二维、三维、定格、像素及自定义画风分别按自身合同审核。任一维度 failed
|
|
3
|
+
人物定妆候选先执行独立的人物视觉专项审核,不能套用普通镜头总分。必须完整检查整张设定板及必要的局部细节;Agent 使用符合主 Skill 体积上限的保真预览和局部裁切完成检查,不直接上传生产原件。审核需写 `review_type:"character-appeal"`、`assetKey`、`versionId`、`watched_or_inspected_full:true`、`approved`、`protection_flags[]`,以及六个不可互相补偿的维度:`age_classification:{status,observation,observed_age_class}`、`identity:{status,observation}`、`grooming_costume:{status,observation}`、`memory_anchors:{status,observation}`、`audience_appeal:{status,observation}`、`art_style_fidelity:{status,art_style_id,observation}`。最后一项绑定项目当前画风,按其 renderingContract 检查媒介/渲染、材质、色彩和光线;不得把真人写实当通用标准,二维、三维、定格、像素及自定义画风分别按自身合同审核。任一维度 failed、年龄观察与档案不符或任何保护标记存在都不得批准。使用审核记录后,才原子选择候选并绑定资产 SHA、人物档案 SHA 与当前画风 SHA;不得直接调用资产选版绕过。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
新生成场景和道具候选写入审核记录,审核写 `review_type:"visual-asset"`、`assetKey`、`versionId`、`inspected_full:true`、`approved`、`structure_identity`、`sheet_consistency`、`unsupported_content` 和同结构的 `art_style_fidelity`。审核观察必须是画面实际可见证据,不得把提示词里的画风名称当作通过证据;画风 ID 或合同内容变化后旧审核哈希自动失效。
|
|
6
6
|
|
|
7
7
|
每镜已选择的分镜板生成候选后,先用图像查看能力逐张检查完整画面的保真预览;小字、面部、手部、道具或格间细节另做局部裁切检查,不得把生产原件直接上传,也不能只看界面缩略图、文件存在或生成状态。随后结合前后镜、结构化分镜、人物/场景/道具选版和项目画风做整集连续审计。每个已生成板型都必须写独立审核记录,`criteria` 严格按以下八项原顺序记录 `{criterion,status,observation}`:`空间关系与轴线`、`时间与动作连续性`、`物理与交互逻辑`、`光线与色彩连续性`、`人物身份与造型一致性`、`场景与道具一致性`、`构图与镜头语言`、`叙事覆盖与阅读顺序`。时间故事版重点核对动作阶段与状态变化,镜头分镜板重点核对景别、调度、轴线和叙事节拍;每个已选择的板型都需完整通过八项。任何一项 failed 都必须修订或重生成后复审,所有已选板型通过前不得制作正式视频。
|
|
8
8
|
|
|
@@ -16,15 +16,15 @@
|
|
|
16
16
|
|
|
17
17
|
构图缺陷分级固定:构图导致剧情因果、人物关系或动作结果不可读(首要信息被构图/遮挡/光效淹没,动作的地理、蓄力、接触或结果因果不可读,多人关系站位不可辨,竖屏裁切丢失关键元素等)记 P1;构图合同已经兑现、信息完整可读,仅风格强度或氛围不足(模式感偏弱、留白偏空、对称偏呆板等不损信息的问题)记 P2;无证据新增雨、雪、雾、霓虹、镜面、烟尘、门窗廊柱、武器、多余人物等高风险元素,即使画面美观也至少记 P1,并把无据元素与所缺证据写入退回分镜的修订要求,不得在审片端放行或用后期掩盖。
|
|
18
18
|
|
|
19
|
-
分镜图验收记录使用 `visual=passed|failed`,`audio/transition/captions=not-applicable`,并记录 P0/P1/P2 issues。视频镜头则实际观看完整画面并听完整音轨,按制作计划 `review_checks` 原顺序填写 criteria;缺失关键剧情点必须 failed
|
|
19
|
+
分镜图验收记录使用 `visual=passed|failed`,`audio/transition/captions=not-applicable`,并记录 P0/P1/P2 issues。视频镜头则实际观看完整画面并听完整音轨,按制作计划 `review_checks` 原顺序填写 criteria;缺失关键剧情点必须 failed。用审核记录直接验收未失效候选版本;通过时原子选版,失败时保留为未选候选。
|
|
20
20
|
|
|
21
21
|
visual 必须 passed;无声音或字幕时使用 not-applicable,不得伪造通过。P0/P1 只修复受影响镜头并重新验收;不得用字幕掩盖错误人声,用长叠化掩盖动作/轴线错误,或用外部 TTS 覆盖要求原生音频的镜头。四项通过且无 P0/P1 后才加入剪辑候选池。
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
任务回写时脚本会对每条视频成片自动做宫格/分屏启发式检测(媒体探测可手工复跑):高置信命中写 `grid_high_confidence` 并自动禁止批准,中置信命中写 `grid_suspect`,检测环境异常写 `grid_check_failed`。后两类必须实际观看整段素材后二选一——确认是宫格/分屏/拼贴就把 `visual` 判为 `failed` 并按最小变量重生成;确认是结构误报,才在验收 JSON 中写 `grid_check:{"status":"false-positive","observation":"具体可见证据"}` 放行。视频验收必须写 `watchedFull:true`,并使用结构化播放证据 `watch_evidence:{method,duration_seconds,start,middle,end}`;`method` 只能是 `human-playback` 或真正接收视频的 `agent-video-tool`,首/中/尾分别写 `{time_seconds,observation}`,时间必须落在实际媒体对应区间且三条观察不能重复。每个通过的 `criteria[].observation` 还必须引用具体秒数或帧号;仅写“已观看”“动作合理”或由合同批量套出的通用观察会被门禁拒绝。随后在 `continuity` 中逐项以 `status/observation` 记录 `identity`、`screen_direction`、`facing_and_gaze`、`entry_exit`、`end_state`;任一项 failed 都不能选版。
|
|
24
24
|
|
|
25
25
|
每个缺陷先记录实际症状,再判断最可能的生成机制,并给出只改变一个变量的最小修复;无法从成片区分原因时明确标为待验证,不把猜测写成结论。重生成后对照旧版验证该症状是否消失;同一修复连续失败两次就停止盲重试,回到分镜、参考绑定、提示词或模型能力边界重新定位。
|
|
26
26
|
|
|
27
|
-
H3
|
|
27
|
+
H3 原生音频镜头在候选选版后整集批量审计:先列出待审计清单(自动跳过无 speech_timeline、未选版和已按当前 sha256 审计过的镜头),向用户展示 ASR 模型、镜头数和请求次数,不计算具体价格;用户确认后按顺序执行。单镜重生成后只对该镜单独审计。默认使用 StarRouter `whisper-1`,可在项目设置中显式切换 ASR 模型,核对 speech_timeline 的对白文本、说话人和时间偏差;接口未返回时间戳或说话人时不能自动通过,任一未通过项都不得标记审计完成。再人工核对统一 music_anchor 和相邻 transition_pair;任一对白错位、音乐断层或声音桥不成对都记为 audio/transition 缺陷,不用后配音静默掩盖。
|
|
28
28
|
|
|
29
29
|
审片采用分层取证,不对整段视频逐帧人工检查:先用媒体 QC 检查解码、黑帧、冻结、静音、时长和响度;再完整观看和听完每镜,在首/中/尾及自动检测出的异常区间记录实际观察;仅对关键动作入点、接触点、完成点、镜尾和转场前帧/切点/淡化中点/完成帧逐帧复核。六个维度仍须分别填写,不能用计划或提示词代替画面证据。`action-cut` 接缝还要核对地点、主体姿态、运动方向和道具状态;任一突变记为 P1。
|
|
30
30
|
|
|
@@ -1,13 +1,11 @@
|
|
|
1
1
|
# 构建分镜
|
|
2
2
|
|
|
3
|
-
先核对源剧本语言、交付语言、人物说话语言和字幕语言,并从已选 Provider/制作计划取得 `shot_duration_constraints`。由 Codex 使用本 Skill 的
|
|
3
|
+
先核对源剧本语言、交付语言、人物说话语言和字幕语言,并从已选 Provider/制作计划取得 `shot_duration_constraints`。由 Codex 使用本 Skill 的 `../assets/modules/build-drama-storyboard/prompts/agent_storyboard_plan.{zh,en}.txt` 生成严格 JSON;需要整集合同输出时,向 `professional_storyboard` 显式传入 screenplay_contract、asset_whitelist、cinema_knowledge、production_constraints、correction 和 target_language。新生成分镜必须依次执行 `agent_cinematographer`、`agent_acting_direction` 与 `agent_storyboard_detail`,不得把表演、眼神、自然运动和声音证据留到最终视频提示词阶段才临时补写;只有读取旧项目且不重制分镜时允许保留历史薄合同。
|
|
4
4
|
|
|
5
5
|
分镜初稿开始前必须读取每个在场角色的 `performance_bible`,但不能把长期档案机械复制到每镜。初稿先确定每个可见角色的主要动作、注意对象、反应触发和未参与时状态;表演指导再把有证据的重心、步态、视线、眨眼节奏、压力反应与习惯触发编译为逐镜可见节拍;分镜细化最后核对多人起势与反应延迟不齐步、头发衣摆等次级运动有物理原因、眼神与微表情符合景别、动作声有 `visible_event_keys`。任一步缺少来源证据都应删去该细节或阻塞,不得靠“自然一点”“电影感”补全。
|
|
6
6
|
|
|
7
|
-
|
|
8
7
|
分镜选定且制作计划完成后,必须交给 `plan-shot-continuity` 建立独立的 `camera_setup_id`、`start_state`、`end_state` 和 `transition_link` 合同,再进入视频提示词编译。分镜只描述本镜事实,不得提前伪造上一镜尾帧资产或用模糊的“保持连续”代替状态字段。分镜选定后,若后续 `plan-drama-production` 或 `write-drama-video-prompts` 因缺构图证据、素材缺口或镜头需要拆并而产生 `unresolved`,必须退回 `revise-drama-storyboards` 生成新的不可变分镜版本,不覆盖旧版,再重新走制作计划与视频提示词。
|
|
9
8
|
|
|
10
9
|
分镜必须是可拍摄的原子单元:一镜只允许一个时间地点、一个连续摄影机动作和一条主要因果动作链;不得把蒙太奇、平行剪辑、多个地点或互不依赖的动作塞进同一 panel。若剧作需要多个动作,拆成连续 panel,并为每个 panel 写清入点、动作完成点、出点、轴线、视线、道具接触和下一镜承接证据。生成前后都要检查人物数量、关键道具状态和屏幕/文字禁绘约束,不能用后期字幕替代缺失的画面因果。
|
|
11
10
|
|
|
12
|
-
|
|
13
11
|
三名以上具名人物同框时先设计可读覆盖:锁定人数、左右顺序、朝向、前后层次和每人的说话/倾听任务;同一时刻只让能清楚归属的角色承担主要说话或道具交互,其余角色用有任务的关系反应维持在场。若一个镜头同时要求群体全貌、两人表演、手部细节和复杂交互,按叙事重心拆为关系镜、动作/插入镜与反应镜,不把所有信息塞进一次生成。
|
|
@@ -76,7 +76,7 @@ JSON 顶层同时保存编导依据和 Blender 可执行场景:
|
|
|
76
76
|
|
|
77
77
|
`beats` 必须按时间顺序排列;相邻节拍可共享一个边界帧或首尾相接,但不得倒序、被前一节拍完全覆盖或大段重叠。`review_contract.hard_gates` 至少完整包含示例中的五项固定硬门禁,不得用模糊名称删减。
|
|
78
78
|
|
|
79
|
-
`purpose=motion-reference` 时,合同 `duration_seconds` 必须与制作计划该镜 `duration_seconds` 完全一致;`beats`、人物与相机关键帧均不得超出该范围,并应覆盖镜尾停稳。白模、合同或登记 provenance 任一时长不一致,都不得选版或提交正式视频。当前只允许 StarRouter `MiniMax-H3
|
|
79
|
+
`purpose=motion-reference` 时,合同 `duration_seconds` 必须与制作计划该镜 `duration_seconds` 完全一致;`beats`、人物与相机关键帧均不得超出该范围,并应覆盖镜尾停稳。白模、合同或登记 provenance 任一时长不一致,都不得选版或提交正式视频。当前只允许 StarRouter `MiniMax-H3`,经平台画布确认的参考素材流程临时发布本地资产;视频提示词必须把当前 selected 白模登记为 `type=video, role=reference_video` 的执行期派生引用,该引用不回写制作计划 `reference_assets`。
|
|
80
80
|
|
|
81
81
|
武打合同还应提供 `contact_checks[]`,用双方人物逻辑骨骼或对象的 `origin`/`mid`/`tip`、接触帧和 `max_distance` 在渲染前验证接触距离;提供 `plant_checks[]`,用人物、左右足、帧段和 `max_drift` 验证支撑脚没有明显滑动。检查失败时生成器直接停止,不输出可选版视频。
|
|
82
82
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
白模作为正式视频运动参考时,合同 `duration_seconds` 必须与当前制作计划该镜 `duration_seconds` 完全一致,所有节拍和镜尾停稳必须覆盖完整时长;不得用三秒动作摘要替代八秒镜头。若台词尚未配音,也要为说话表演、反应停顿和可剪辑镜尾分配明确帧段。
|
|
10
10
|
|
|
11
|
-
按 [白模导演合同与评分](direct-blender-previz/direction-contract.md)
|
|
11
|
+
按 [白模导演合同与评分](direct-blender-previz/direction-contract.md) 输出导演合同 JSON,保存为当前 storyboard 文档引用的合同版本。合同必须包含当前分镜与制作计划版本、剧情意图、覆盖首帧到镜尾且无空档、无倒序或过度重叠的节拍表、轴线与屏幕方向、相机动机、连续性和验收项;五项固定硬门禁不得删减。单机位使用 `camera`,正反打覆盖使用 `cameras` 与 `camera_cuts`,并配合 `objects`、人物 `walk`、根节点关键帧和 `arm_keyframes`。接触检查声明的帧不得同时作为机位切点;生成前必须完成合同结构校验,不能用文字约定替代可执行门禁。
|
|
12
12
|
|
|
13
13
|
镜头含武打、追逐、擒抱、跌倒、兵器或明确身体接触时,还必须读取 [动作白模编导门禁](direct-blender-previz/action-previz.md)。涉及兵器、常用灰模道具或修仙术法时,同时读取 [武器、灰模与术法预设](direct-blender-previz/weapons-vfx.md)。先验证当前骨架控制能否表现所需肢体链、落脚和接触;能力不足就停止并报告缺口,不用直臂、滑步或模型穿插冒充武打。没有真实剧本来源的能力测试必须标记 `test_only`,不得声称符合项目剧情。
|
|
14
14
|
|
|
@@ -1,20 +1,15 @@
|
|
|
1
1
|
# 生成 Blender 白模分镜
|
|
2
2
|
|
|
3
|
-
|
|
4
3
|
直接执行导演合同中的 JSON 场景。基础灰模使用 `cube`、`cylinder`、`sphere`、`human`;确有叙事需要时使用经过门禁的 `weapon` 与 `effect` 预设,不临时下载来源和授权不明的模型。人物位移区间使用 `walk` 保留落脚节奏,身体调度使用根节点 `rotation_degrees`,视线反应使用 `head_keyframes`,阻挡等关节动作使用 `arm_keyframes`;不在生成阶段重新解释剧情或改变相机动机。人物可以共用白色材质,但同框身份难辨时应使用稳定的色块或标签,不为预演制作精细模型、贴图和毛发。
|
|
5
4
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
```bash
|
|
9
|
-
"${BLENDER_BIN:-blender}" --background --python "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/blender-previz.py" -- --spec <场景.json> --output <预演.mp4> --blend-output <场景.blend> --expected-duration <制作计划镜头时长>
|
|
10
|
-
```
|
|
5
|
+
渲染前读取当前制作计划并核对该镜时长;预演输出必须与计划中的 `duration_seconds` 一致,不一致就停止,不生成可选版视频。
|
|
11
6
|
|
|
12
|
-
|
|
7
|
+
人物默认使用随包提供的 UE Mannequin 模型,以便检查肩胯、手脚和关节动作;默认模型缺失时必须停止,不得静默退回程序化简模。只有用户明确指定其他兼容骨架时才允许替换默认模型。模型只用于本地渲染,不登记为项目资产,不上传给视频 Provider。
|
|
13
8
|
|
|
14
9
|
兵器用 `attach_to` 绑定 UE Mannequin 的 `left_hand` 或 `right_hand`,并以 `contact_checks` 检查 `tip`/`origin` 到对手骨骼或另一件兵器的距离。术法预设只表达发射、轨迹、碰撞和消散,不把辉光或粒子数量当成动作成立;施法者起手、目标反应、冲击点和镜尾结果仍须分别可读。预设字段与适用边界见 `direct-blender-previz/generate-blender-previz/weapons-vfx.md`。
|
|
15
10
|
|
|
16
|
-
没有 Blender
|
|
11
|
+
没有 Blender 可执行文件时不得伪造预演或把占位视频登记为白模。实际项目输出登记为 `other-previz-epNNN-NNN` 的 `other` 画布资产版本;provenance 使用 `origin=generated`、`created_by=codex`、`model_or_workflow=blender-eevee-previz`,`prompt_document` 指向当前 storyboard 镜头,`parameters` 必须同时写入计划时长 `duration`、导演合同路径 `direction_contract` 和该合同文件的 `direction_contract_sha256`。缺少任一绑定都不得登记候选。
|
|
17
12
|
|
|
18
|
-
MP4
|
|
13
|
+
MP4 生成成功不等于白模完成。登记和审核前必须核对 MP4 实际时长、平均帧率、帧数和分辨率与合同、制作计划一致,并重新核对 MP4 与合同 SHA-256;不能只相信 provenance 声明。随后完整观看,结合首/中/尾和自动检测出的异常区间记录实际观察;仅在动作入点、接触点、完成点、每个多机位切点和镜尾逐帧核对。检查剧情因果与节拍、人物调度与表演、相机动机与运动曲线、构图与视觉层级、空间/轴线/连续性、物理与接触、技术交付七项。把媒体 `asset_sha256`、各项得分、P0/P1/P2 问题以及与导演合同同序的 `hard_gates[]` 写入 `canvas.review.v1` 审核文档;每项硬门禁必须包含 `gate/status/frame/observation` 的实际逐帧证据,任一失败即不得选版。审核入口会在自动选版前重新验证合同版本与哈希、实际媒体参数和当前制作计划版本。正式镜头还必须给出真实来源剧本、导演本、结构化分镜和制作计划版本;没有真实来源的临时演示只能标记 `test_only`,不得判断“符合剧情”、不得选版或进入正式视频。
|
|
19
14
|
|
|
20
|
-
人数、身份、剧情因果、对白对象关系、轴线、物理接触、关键物可见性或剧本要求的镜尾反应任一未在实际画面中成立,都不得用合同字段或总分抵消。存在 P0/P1、任一硬门禁失败、总分低于 85/100 或任一项低于该项满分 70% 时,必须明确标记“不通过”,不得以“完成”“可用”或“已通过”交付;需要展示失败样片时必须同时展示审计结论。登记的 provenance `parameters.duration`、导演合同 `duration_seconds` 与制作计划镜头时长必须完全一致。通过后才可选中预演资产。`purpose=motion-reference` 当前只允许 StarRouter `MiniMax-H3`,把 selected 预演版本作为 `type=video, role=reference_video` 的执行期派生引用写入新 video-prompts
|
|
15
|
+
人数、身份、剧情因果、对白对象关系、轴线、物理接触、关键物可见性或剧本要求的镜尾反应任一未在实际画面中成立,都不得用合同字段或总分抵消。存在 P0/P1、任一硬门禁失败、总分低于 85/100 或任一项低于该项满分 70% 时,必须明确标记“不通过”,不得以“完成”“可用”或“已通过”交付;需要展示失败样片时必须同时展示审计结论。登记的 provenance `parameters.duration`、导演合同 `duration_seconds` 与制作计划镜头时长必须完全一致。通过后才可选中预演资产。`purpose=motion-reference` 当前只允许 StarRouter `MiniMax-H3`,把 selected 预演版本作为 `type=video, role=reference_video` 的执行期派生引用写入新 video-prompts 版本;公网临时发布必须先确认素材权利、公开范围和用途,并按平台画布支持的参考素材流程处理。
|
|
@@ -1,13 +1,9 @@
|
|
|
1
1
|
# 规划短剧制作
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
读取本地已选导演本、人物/场景/道具、分镜和项目配置。由 Codex 使用 `../../assets/modules/plan-drama-production/prompts/production_plan.{zh,en}.txt` 输出 `production-plan.json`,逐镜记录:输入版本、`storyboard_strategy`、分镜图类型与实际格数、`previz_strategy`、视频方式、声音方式、Provider、模型或工作流、`prompt_profile`、`input_mode`、分辨率、画幅、时长、候选数、参考素材及其用途与顺序、依赖关系、预计付费次数、失败回退和验收项。
|
|
6
|
-
|
|
3
|
+
读取本地已选导演本、人物/场景/道具、分镜和项目配置。由 Codex 使用 `../assets/modules/plan-drama-production/prompts/production_plan.{zh,en}.txt` 输出 `production-plan.json`,逐镜记录:输入版本、`storyboard_strategy`、分镜图类型与实际格数、`previz_strategy`、视频方式、声音方式、Provider、模型或工作流、`prompt_profile`、`input_mode`、分辨率、画幅、时长、候选数、参考素材及其用途与顺序、依赖关系、预计付费次数、失败回退和验收项。
|
|
7
4
|
|
|
8
5
|
时间故事版用于连续动作阶段、运镜轨迹和状态变化;镜头分镜板用于景别、人物关系、调度、轴线与叙事节拍。Agent 按镜头目标选择一种或多种板型,分别记录 `required_board_types` 和 `selection_basis`;视频只引用实际存在且已审核的板。其余人物、场景、道具超过 Provider 剩余图片槽位时按既有 `overflow_strategy` 处理。
|
|
9
6
|
|
|
10
|
-
|
|
11
7
|
格数必须按本分镜构图合同复核(`visual_plan.composition`、`composition_contract` 或 `photographyPlan.composition` 的 primary/secondary code、evidence 与 ai_risks;权威解释见 [导演构图模式参考](../director-composition.md)):静态单一情绪仍至少用 2 格固定起止状态;追逐、接触、倒计时和运镜按不可合并阶段增加格数;多人站位、包围、遮挡、武器或多手交互按叙事节拍增加格数。风险只决定格数与回退,不得用增加格数替代证据。证据不足时 `status=blocked` 并写入 `unresolved`,退回分镜修订。
|
|
12
8
|
|
|
13
9
|
每镜 `review_checks` 必须从合同 ai_risks 与证据元素反推具体、可观察、具名的验收项,不得复制同一组空泛检查:镜面/光滑水面核对映像与真人及现场陈设一致、无多指或多余摄像机;雨、雾、霓虹、烟尘核对天气光色有据、方向统一且不淹没接触点与人物身份;群体镜核对人数、身份和服色锚点、无多余路人;武器与多手交互核对形制、持有关系、手数和接触前/中/后;窄门缝或前景遮挡核对可见宽度、双眼完整和关键动作不被盖;高速拖影核对双眼、面部与接触点清晰可辨;前后夹击/包围核对前后景两方身份、距离和朝向可辨;竖屏镜头核对脸、关键道具和接触点位于中上安全区、底部字幕安全区不被占、动势边缘留余量。这些构图风险项与对白嘴部、道具三态、行走打斗物理、画内屏幕等既有风险项按命中取舍组合,视频验收会按此原顺序逐项核对。
|
|
@@ -16,6 +12,6 @@
|
|
|
16
12
|
|
|
17
13
|
Provider 支持 MiniMax H3 原生音频(`video.native-audio`)时,默认使用 `audio_strategy.mode=native`,并锁定逐秒对白表、全片音乐锚点和相邻镜头成对声音转场;此时不安排独立 TTS。仅当用户明确要求后配、或 Provider/模型明确声明不支持原生音频时,才写 `post-dub`/`independent` 并进入 `design-drama-audio`;能力信息缺失不得作为转后配的理由。
|
|
18
14
|
|
|
19
|
-
使用 `
|
|
15
|
+
使用 `canvas document save` 保存不可变版本。选定后,所有镜头执行 `generate-storyboard-images`,只生成 `required_board_types` 中已选择的板型并完成对应审计;启用白模的镜头再执行 `direct-blender-previz`、`generate-blender-previz` 并完成导演评分。逐镜门禁全部通过后才能调用 `generate-drama-videos`。计划不得包含 API Key、Token 或远程业务对象 ID。
|
|
20
16
|
|
|
21
17
|
只有已选择的板型和独立参考图实际超过 Provider 槽位才使用 `compose-assets`,未超槽位保留独立参考图。项目 `automation_mode=true` 且仅缺 Provider 已支持的分辨率时,agent 直接选择并落档,不等待用户。
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
# 规划跨镜连续性
|
|
2
2
|
|
|
3
|
-
读取当前 selected 且已批准的 `storyboard`、`director-book` 和 `production-plan`,并使用
|
|
3
|
+
读取当前 selected 且已批准的 `storyboard`、`director-book` 和 `production-plan`,并使用 `../assets/modules/plan-shot-continuity/prompts/continuity_plan.{zh,en}.txt` 生成一份 `continuity-plan`。只采用这些结构化文档和已选资产中的证据;不得引用尚未生成、未被 `required_board_types` 选择或未审核通过的分镜板或白模,也不得推断未声明的道具、持物关系、入画边、出画边或精确米制坐标。
|
|
4
4
|
|
|
5
5
|
规划阶段固定使用 `coordinate_mode=semantic`,以画面左/中/右、前/中/后景、朝向、视线对象和出入画边表达语义位置;不得从结构化分镜、图片透视或经验估算三维坐标。后续 Blender 白模只能验证或暴露冲突,不能静默改写已批准连续性计划;冲突必须回退规划阶段生成新版本。
|
|
6
6
|
|
|
7
|
-
逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜调用
|
|
7
|
+
逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜调用 连续性文档 导出的 `recommendTailLink(previous,current)`:仅同场景、同机位、同轴线且状态无未解释跳变时,才可启用 `previous-tail`;第一镜、切换机位、越轴、场景变化或有意状态跳变使用 `independent`。合法 previous-tail 必须绑定上一镜号、上一镜 `camera_setup_id` 和 `video.first-frame` 能力。
|
|
8
8
|
|
|
9
9
|
任何无法由证据解释的差异都写入 `unresolved`,并令 `approved=false`;不得把猜测写进 `allowed_changes` 以绕过校验。`allowed_changes` 只记录剧本、导演本或已批准调度明确要求的变化,`evidence` 指向相应来源。
|
|
10
10
|
|
|
11
|
-
用 `
|
|
11
|
+
用 `canvas document save` 保存不可变版本。只有 `unresolved=[]` 且逐镜校验通过后才能写 `approved=true`,随后必须用同一脚本的 `canvas document get` 显式选定;未选定的连续性计划不能进入视频提示词编译。
|
|
12
12
|
|
|
13
|
-
计划确定使用上一镜尾帧时,媒体阶段调用
|
|
13
|
+
计划确定使用上一镜尾帧时,媒体阶段调用 上一镜尾帧承接。上一镜视频换版后必须重新派生尾帧,不能继续使用旧文件或旧 SHA-256。
|
|
14
14
|
|
|
15
15
|
`storyboard.shot_group` 是导演叙事分组,必须完整、连续且保持同组 type/pattern 一致;它可以包含反打、蒙太奇或其他切机位镜头,因此不能直接等同于尾帧链。执行阶段把每段连续的 `previous-tail` 链派生为一个生成镜头组:不同生成组可以并行,同组只开放一个前沿镜头。前镜候选未审核时状态为 `waiting-review`;前镜已审核选版但首帧尚未派生时为 `waiting-tail`;只有尾帧版本、来源版本和 SHA-256 全部匹配后,下一镜才可进入 `ready`。
|