@aswless_854771076/ai_short_studio_cli 0.1.155 → 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
|
@@ -1,107 +1,65 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 短剧使用手册
|
|
2
2
|
|
|
3
3
|
原项目能力的保留、转换、排除和当前边界见 [能力审计](feature-completeness.md)。
|
|
4
4
|
|
|
5
5
|
## 制作顺序
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
参考片复刻使用 [复刻知识问答](recreation/recreation-qa.md) 中的 CLI 画布节点;短剧插件只负责原创短剧制作。
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
1. **初始化项目**:`manage-drama-projects` 按项目规范 v1 创建固定配置、目录与状态,并归档 `src-xxx@v001` 原始资料。
|
|
12
|
-
2. **Codex 分析**:`analyze-drama-source` 直接分析已选本地小说与要求;再形成简报、故事圣经和分集目录,不调用文本模型。
|
|
9
|
+
1. **初始化项目**:`manage-drama-projects` 按项目规范 v1 确认语言、画幅、集数和创作配置,创建 AI Short Studio 项目并登记原始资料版本。
|
|
10
|
+
2. **Codex 分析**:`analyze-drama-source` 直接分析已选来源与要求;再形成简报、故事圣经和分集目录,不调用文本模型。
|
|
13
11
|
3. **剧本落盘**:`short-drama` 提供开场、节奏、爽点、钩子和合规方法,`write-drama-episode` 由 Codex 写作或转换初稿,`humanizer` 产生自然化新版本,`review-drama-script` 对当前版本形成批准报告。
|
|
14
12
|
4. **导演本落盘**:`write-drama-director-book` 形成场次级导演执行意图。
|
|
15
13
|
5. **资产分析与画风**:`plan-drama-assets`、`generate-character-profiles` 确认资产范围,`generate-drama-art-style` 确认或生成项目统一画风。
|
|
16
|
-
6. **资产生成落盘**:人物完整原画设定板、场景多视角设定板、道具设定板通过 `drama-generation-service` 调用用户选择的 Provider
|
|
17
|
-
7.
|
|
18
|
-
8. **三轮生成与审核**:最多生成三轮,最终 alignment
|
|
19
|
-
9.
|
|
20
|
-
10.
|
|
21
|
-
11. **分镜与素材制作**:制作规划先建立空间连续性。Agent 按镜头目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;只有复杂调度风险无法由已选静态参考证明时才追加 Blender 白模。每个实际生成的板型分别完成对应审计,再由 `write-drama-video-prompts` 绑定本镜实际需要的参考和音频参考。声音按 native-first
|
|
22
|
-
随后执行 `hypit short-drama production plan ep-001 --runtime <profile> --workspace <项目>`;计划中的 `generation_groups` 会列出不同连续生成组及 `ready`、`waiting-review`、`waiting-tail`、`complete` 状态。确认计划后执行 `production build ... --confirmed`,一次只提交每组当前的 `ready_shot_number`。候选生成后先按制作计划审核;审核通过会自动选版。若下一镜显示 `waiting-tail`,调用 `prepare_previous_tail`,再重新执行 production plan/build;系统会把上一镜当前选版的尾帧作为下一镜第一个 `first_frame`,相同来源重复调用会直接复用。存在 `pending-build.json` 时再次执行 build 只恢复原任务,不产生新付费提交;它会核对提交时提示词文档、Run 和 Runtime Profile 的 SHA-256,文件变化或 Runtime 不同则须先恢复,终态失败也会先回收成功镜头。成功候选审核并选中后,未变化镜头会从重试 Run 中排除。启用白模的镜头绑定已审核的主运动参考。项目不得调用 legacy `submit_video` 绕过 Runtime。
|
|
14
|
+
6. **资产生成落盘**:人物完整原画设定板、场景多视角设定板、道具设定板通过 `drama-generation-service` 调用用户选择的 Provider;结果全部登记为画布资产版本并留下真实预览。
|
|
15
|
+
7. **声音证据与合同**:对原声或外部音频先做语音时序分析,人工复核后用当前 timing 写逐句表演合同;配音合同预检只做只读检查,不产生费用。
|
|
16
|
+
8. **三轮生成与审核**:最多生成三轮,最终 alignment 达到一帧容差后执行八维完整听看审核;通过候选才能选版。
|
|
17
|
+
9. **字幕与口型**:从最终已选音频生成绑定字幕;换版后重建字幕、口型和剪辑引用。
|
|
18
|
+
10. **制作规划**:构建或修订结构化分镜,`plan-drama-production` 逐镜按 `storyboard_strategy` 确定所需板型、格数、按需启用的 Blender 白模、模型、`prompt_profile`、输入模式和参考顺序,只汇总任务与素材数量。
|
|
19
|
+
11. **分镜与素材制作**:制作规划先建立空间连续性。Agent 按镜头目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;只有复杂调度风险无法由已选静态参考证明时才追加 Blender 白模。每个实际生成的板型分别完成对应审计,再由 `write-drama-video-prompts` 绑定本镜实际需要的参考和音频参考。声音按 native-first 执行。随后按制作计划创建画布生成任务,一次只提交当前就绪的镜头组。候选生成后先按制作计划审核,通过后才选版。若下一镜需要承接尾帧,先完成上一镜当前已选版本的审核,再把尾帧作为下一镜首帧;相同来源重复使用前再次比对版本和 SHA-256。任务失败或中断时保留证据,先查询原任务,不产生新的付费提交。启用白模的镜头绑定已审核的主运动参考。
|
|
23
20
|
12. **授权音乐与本地修复**:许可证用途验证通过后才把目录音乐放入时间线;本地局部修复保留来源、范围和专项审核。远端超分暂时禁用,等待 StarRouter 等价模型验证。
|
|
24
|
-
13.
|
|
25
|
-
14. **成片**:`edit-deliver-drama`
|
|
21
|
+
13. **剪辑**:按 [剪辑与交付](../editing-delivery.md) 和 `remotion-best-practices` 完成粗剪、字幕、转场、声音和渲染。
|
|
22
|
+
14. **成片**:`edit-deliver-drama` 逐集完整审片并输出交付文件和 manifest。
|
|
26
23
|
|
|
27
24
|
文本资产默认由 Codex 直接生成,不使用外部文本模型。图片、视频、音频才进入生成 Provider 路由。
|
|
28
25
|
|
|
29
|
-
制作计划确认只授权所列 Provider
|
|
26
|
+
制作计划确认只授权所列 Provider 请求,不改变阶段,也不计算具体价格。每次付费提交前都会检查当前阶段和全部上游门禁;直接修改选版、项目配置或占位文档不能使越级调用通过。
|
|
30
27
|
|
|
31
|
-
全流程只调用 `short-drama` 主 Skill。进入阶段后运行 `
|
|
28
|
+
全流程只调用 `short-drama` 主 Skill。进入阶段后运行 `ai-short-studio canvas workflow status --project <projectId> --json`,主 Skill 完整读取并执行返回的 reference 模块,再用 `canvas document save` 关联实际产物和 `--input`。阶段状态会拒绝没有模块执行凭证的结果。
|
|
32
29
|
|
|
33
30
|
## Reference 模块
|
|
34
31
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
| `analyze-drama-source` | Codex 全量分析小说、资料和制作要求 | 初始化后;先于简报/剧本 | 原文范围、改编边界、冲突要求 |
|
|
39
|
-
| `analyze-drama-source` | 分析原创短剧来源资料 | analysis 阶段 | 原文范围与改编边界 |
|
|
40
|
-
| `define-drama-brief` | 固化题材、受众、平台和交付边界 | source analysis 后 | 平台、语言、画幅、集数、目标时长、分级、禁区;目标时长默认允许约 ±15% 自然浮动 |
|
|
41
|
-
| `design-drama-bible` | 建立世界观、人物弧、冲突和结局 | brief 后 | 结局类型、人物关系、重大改编 |
|
|
42
|
-
| `outline-drama-series` | 拆分分集冲突、兑现和钩子 | bible 后 | 总集数、单集时长、分集结构 |
|
|
43
|
-
| `short-drama` | 用开场、节奏、爽点、钩子、反派、付费卡点和合规方法指导剧本 | script 阶段首个方法层 | 改编事实、集数、结局和付费策略变化 |
|
|
44
|
-
| `write-drama-episode` | Codex 编写或忠实转换单集剧本 | outline 后 | 原创/忠实转换、目标集、剧情改动、台词定稿 |
|
|
45
|
-
| `humanizer` | 减少模板腔、说明腔和角色同声,保持剧情事实与制作约束 | 剧本初稿后、复核前 | 用户语言样本;任何会改变台词含义或剧情事实的修改 |
|
|
46
|
-
| `review-drama-script` | 复核开场、节奏、兑现、对白、连续性、合规和可制作性 | 自然化后、导演本前 | 接受 P2;P0/P1 必须修改后重审 |
|
|
47
|
-
| `write-drama-director-book` | 生成场次级表演、调度、摄影、光线和声音导演本 | 已选剧本后 | 改变剧情含义、表演基调或声音策略的决定 |
|
|
48
|
-
| `plan-drama-assets` | 识别本集人物、场景、关键道具及叙事版本 | 导演本后 | 资产范围、合并/拆分、版本需求 |
|
|
49
|
-
| `generate-character-profiles` | 建立人物事实、别名、关系、长期表演与声音特征 | 资产分析阶段 | 人物身份、关系、是否出镜、持续造型 |
|
|
50
|
-
| `generate-drama-art-style` | Codex 生成项目画风、色板、光线和运动语言 | 资产生成前;默认真人风格可直接确认 | 画风名称/描述、参考图、预览模型和制作计划 |
|
|
51
|
-
| `manage-drama-art-styles` | 选择、绑定或变更已有画风并计算 stale 范围 | 画风生成后或变更时 | 入选画风和重新生成范围 |
|
|
52
|
-
| `generate-character-images` | 生成含脸部特写、正侧背全身和辅助设定的角色原画板 | 人物档案确认后 | Provider、模型/工作流、候选数、尺寸、参考图、制作计划、选版 |
|
|
53
|
-
| `generate-scene-assets` | 提取并生成无人场景候选 | 资产分析后 | 场景层级、锚点、Provider、候选数、尺寸、制作计划、选版 |
|
|
54
|
-
| `generate-prop-assets` | 提取并生成关键道具候选 | 资产分析后 | 是否值得独立资产、Provider、候选数、尺寸、制作计划、选版 |
|
|
55
|
-
| `manage-drama-assets` | 将文件、URL、base64 结果归档本地,登记哈希和选版 | 每次媒体生成后立即执行 | 导入目标、文件名、选版、回退或覆盖影响 |
|
|
56
|
-
| `build-drama-storyboard` | 将剧本、导演本和已选资产拆成结构化镜头 | 资产选版完成后 | 镜头数量/时长、剧情覆盖、台词和镜头策略 |
|
|
57
|
-
| `revise-drama-storyboards` | 插镜、变体、修改、重排并保留分镜版本 | 已有分镜后按需 | 修改镜头、剧情影响、批量范围、选定版本 |
|
|
58
|
-
| `write-drama-video-prompts` | Codex 把分镜编译成 Seedance 2.0、MiniMax H3 或通用逐镜提示词,并本地版本化 | 制作计划锁定模型与参考顺序后 | prompt_profile、input_mode、时长、参考用途/顺序、声音方式、台词、转场意图 |
|
|
59
|
-
| `plan-drama-production` | 汇总逐镜生成方式、Provider、参考素材和依赖 | 媒体生成前最后门禁 | Provider、模型/工作流、尺寸、时长、候选数、参考文件和批量请求范围 |
|
|
60
|
-
| `drama-generation-service` | 通过 Hypit Runtime 的 StarRouter 配置生成图片、视频与音频 | 所有远端媒体生成入口 | 模型、参数、参考文件用途和制作计划;切换或重试 |
|
|
61
|
-
| `publish-drama-references` | 查询或用 TempFile.org 临时托管把本地选版图转为公网 HTTPS URL | StarRouter 需要公网参考素材时 | 先查有效收据;素材权利、公开暴露、用途许可、逐项资产版本和 24h 时效;强制重传需再次确认 |
|
|
62
|
-
| `configure-generation-providers` | 配置和探活 Provider,不生成 | 首次使用或凭据/目录变化时 | 各模态 Provider 选择;密钥由用户自行配置 |
|
|
63
|
-
| `generate-storyboard-images` | 按每镜 required_board_types 独立生成已选择的分镜板 | 制作计划批准后、视频提示词编译前 | Provider、格数、尺寸、候选数、参考图、制作计划、选版 |
|
|
64
|
-
| `direct-blender-previz` / `generate-blender-previz` | standard 仅为已选静态板无法证明的复杂调度生成可选白模;原创项目仅为复杂调度追加 review 白模 | 已选分镜板之后、视频提示词编译前 | 剧情节拍、调度、轴线、运镜、评分与选版 |
|
|
65
|
-
| `generate-drama-videos` | 生成并下载逐镜视频 | 已选择的分镜板、按需审核的白模主运动参考、音频参考与视频提示词确认后 | Provider、模型/工作流、时长、分辨率、参考素材、声音、制作计划、重试 |
|
|
66
|
-
| `design-drama-audio` | 原生音频优先;固定音色只在实时 Provider 能力明确支持且用户确认后使用,否则停下让用户选择支持的 Provider、后配音或不固定;做七维复听,并允许导入已授权外部音频 | 制作计划或逐镜视频阶段 | StarRouter 语音模型、声音权利、文本、失败区间、制作计划、选版 |
|
|
67
|
-
| `transform-drama-media` | 本地裁剪、抽帧、剪接等版本化媒体操作;远端口型和超分暂时禁用 | 媒体生产中按需 | 来源资产、操作范围、结果选版与专项审核 |
|
|
68
|
-
| `monitor-drama-tasks` | 本地登记、去重、查询异步任务并校验完成文件 | 媒体生产贯穿执行 | 取消任务、扩大重试或重新付费 |
|
|
69
|
-
| `recover-drama-pipeline` | 恢复中断任务、缺失下载和 stale 下游 | 失败或续作时 | 重提、换 Provider/模型、重新付费、回退阶段 |
|
|
70
|
-
| `review-drama-shots` | 分别审计已生成分镜板的逻辑、按导演合同评分可选白模,并验收正式视频 | 分镜选版后、视频生成前必做;视频落盘后再次执行 | 接受 P2 缺陷、重生成或选用替代版本 |
|
|
71
|
-
| `remotion-best-practices` | 约束 Remotion 工程、React 时间线、字幕、音频、预览与渲染 | editing 阶段首个实现层 | 工程初始化、外部包安装和输出规格 |
|
|
72
|
-
| `edit-drama-timeline` | 用本地 Remotion 工程完成剪辑、字幕、转场、声音和渲染 | 全部选镜验收通过后 | 入选版本、剪辑结构、字幕样式、转场、声音目标、输出规格 |
|
|
73
|
-
| `edit-deliver-drama` | 完整审片、技术检查和本地交付打包 | 最后一步 | 批准版、文件名、交付目录和发布规格 |
|
|
74
|
-
| `orchestrate-short-drama` | 按状态机编排完整流程,不替代原子工作 | 新建、继续、查看项目时 | 阶段回退、批量范围和任何付费动作 |
|
|
75
|
-
| `short-drama-skill-index` | 按产物类型查找对应模块 | 不确定该加载哪个 reference 时 | 无;只路由 |
|
|
76
|
-
| `use-short-drama-studio` | 使用者入口,解释全流程、依赖、顺序和确认门禁 | 开始制作或询问怎么使用时 | 汇总当前缺失决策,不自行代选 |
|
|
32
|
+
模块清单、阶段、依赖、条件、路径和提示词归属以 [module-map.json](module-map.json) 为唯一机器事实源;不要在本手册复制静态清单,也不要在未读取模块合同前自行模仿产物。
|
|
33
|
+
|
|
34
|
+
新增或修改模块时同步检查 `module-map.json`、[提示词索引](prompt-skill-index.md)、本手册的阶段描述和所有入站链接。
|
|
77
35
|
|
|
78
36
|
## 市场调研流程
|
|
79
37
|
|
|
80
|
-
|
|
38
|
+
市场调研只使用用户提供的已保存 `market-report.v2` 文件;CLI 不采集榜单、不刷新快照,也不提供市场子命令。报告持续标注公开 Top 30 样本边界,不作为收益承诺。
|
|
81
39
|
|
|
82
40
|
市场数据按四层使用,不能混写:
|
|
83
41
|
|
|
84
42
|
1. **事实**:`market-report.v2` 中可回链快照、榜单和作品证据的观测值;缺失值保持 `null`。
|
|
85
43
|
2. **推断**:机会分、供需象限、共现和平台偏好等分析结论,必须保留置信度、覆盖率和限制。
|
|
86
|
-
3. **创作假设**:`ideate-drama-from-market`
|
|
87
|
-
4.
|
|
44
|
+
3. **创作假设**:`ideate-drama-from-market` 从信号提出的原创切口,仍需验证,不能复制榜单作品标题、人物关系或具体情节。
|
|
45
|
+
4. **用户决定**:用户明确选择候选并登记后,才把 `market-inspiration.v1` 保存为画布文档,并让 Brief 的 `market_inspiration_ref` 引用它。
|
|
88
46
|
|
|
89
47
|
推荐使用路径:
|
|
90
48
|
|
|
91
|
-
1.
|
|
92
|
-
2.
|
|
93
|
-
3.
|
|
94
|
-
4.
|
|
49
|
+
1. 读取用户提供的已保存市场报告,并按 [报告合同](market/analyze-drama-market/market-report.schema.json) 核对 `schema_version`、覆盖范围、筛选和限制。
|
|
50
|
+
2. 用 `shasum -a 256 <报告文件>` 或 `sha256sum <报告文件>` 记录报告文件原始字节摘要,后续引用沿用同一份文件。
|
|
51
|
+
3. 在灵感阶段选择 1–3 个题材并生成候选,逐项核对事实、推断、假设和低置信风险。
|
|
52
|
+
4. 为用户选定的候选填写 `report_ref` 并生成 `market-inspiration.v1`,保存为画布文档、更新 Brief 引用;该动作不改变项目题材或 Brief 平台。
|
|
95
53
|
5. 继续执行 `define-drama-brief`;后续 Bible 和 Outline 只消费已确认的 Brief,不直接读取榜单作品清单。
|
|
96
54
|
|
|
97
|
-
Agent 只有在用户明确要求“参考市场/排行榜找灵感”时才执行 `ideate-drama-from-market
|
|
55
|
+
Agent 只有在用户明确要求“参考市场/排行榜找灵感”时才执行 `ideate-drama-from-market`。报告引用、快照时间和 SHA-256 必须可校验;普通创作不强制经过市场步骤。
|
|
98
56
|
|
|
99
57
|
## 通用门禁
|
|
100
58
|
|
|
101
59
|
项目配置 `automation_mode` 默认为 `true`。开启时 agent 只自动处理已经确认且未变化的常规重复步骤;创作配置、模型/厂商、付费请求范围、候选资产和剧情变更仍须用户确认。关闭时逐项确认。阶段门禁、权限/素材权利事实和安全校验始终有效。
|
|
102
60
|
|
|
103
61
|
- 覆盖、删除、重命名、阶段回退、批量生成、付费重试、切换 Provider/模型/工作流、上传参考素材和最终选版都必须产生确认记录。
|
|
104
|
-
-
|
|
105
|
-
- Provider
|
|
106
|
-
-
|
|
62
|
+
- 多集项目仍按全局阶段推进;分集级模块必须为每个已建 `ep-NNN` 同时保存独立产物,Codex 合同运行记录必须逐一绑定对应分集证据,不能用某一集替其他集背书。
|
|
63
|
+
- Provider 返回成功不等于完成;真实产物、哈希、provenance、资产版本和验收缺一不可。
|
|
64
|
+
- 源时间线情感配音发布验收必须对一个真实镜头完整听看原声与配音,报告绑定完整复听、制作耗时、实际 Provider 任务、字幕和口型证据。
|
|
107
65
|
- 用户未确认的参数保持未决,不用示例值或所谓“最佳实践”替用户决定。
|
|
@@ -1,447 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: hypit
|
|
3
|
-
version: 1.4.11
|
|
4
|
-
description: Direct and produce videos with Hypit, primarily through generated media and authored components while incorporating briefs, references or supplied material; includes SVML/SVS/SVRun authoring and Runtime or credential setup.
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Hypit
|
|
8
|
-
|
|
9
|
-
## 先区分两条制作链路
|
|
10
|
-
|
|
11
|
-
短剧原创制作和短剧参考片复刻是两条不同链路,开始工作前必须先根据用户目标和项目事实判定类型,不能把一条链路的步骤套到另一条链路上。
|
|
12
|
-
|
|
13
|
-
- **原创短剧链路**:没有要复刻的参考片时,使用 `short-drama` 的标准流程,从项目、剧本、导演本、资产、分镜、制作、剪辑到交付推进;运动参考按镜头制作目标选择分镜板或必要的 Blender 白模。
|
|
14
|
-
- **参考片复刻链路**:用户要求复刻、克隆、仿拍或提供了要还原的原片时,使用原生 `hypit recreate`:导入参考片 → 理解与正式分析 → 设计新人物、场景和道具并选定资产图 → 逐镜去字幕、恢复时间基准、制作并审核深度视频 → 编写逐镜提示词和 Run → 核对制作计划与实际媒体绑定 → 用户确认后生成、审片和交付。复刻项目使用 `workflow.type=viral-recreation`;短剧插件只负责原创短剧,不接受复刻 profile。普通复刻不强制制作双分镜板或原片关键帧;精确文字、接触和复杂动作等风险镜头可按需制作分镜板。
|
|
15
|
-
|
|
16
|
-
如果用户只说“做短剧”但没有说明是否复刻,先确认是否存在需要保留结构、镜头运动或节奏关系的参考片;一旦存在这类参考片,就按复刻链路处理,并在项目记录中写明来源、权利范围和复刻类型。
|
|
17
|
-
|
|
18
|
-
原生入口按 `hypit recreate init`、`shots`、`assets`、`preprocess`、`references`、`plan`、
|
|
19
|
-
`build` 推进。`hypit recreate preprocess <project>` 只为每个已校验镜头生成经 StarRouter 调用的 Comfly 1194 →
|
|
20
|
-
本地恢复时间基准 → Comfly 1776 → 本地恢复时间基准的 Author/Run 文件,不上传或提交任务。
|
|
21
|
-
镜头清单确认后即可设计人物、场景、道具;资产选版可与逐镜深度制作交错推进,不必等全片深度完成。
|
|
22
|
-
每项付费生成仍须先展示厂商、模型、参数和请求数并取得用户确认;最终提示词和成片 Run 要等
|
|
23
|
-
相关镜头的资产与深度结果均审核选定后再定稿。
|
|
24
|
-
若需免下载模型的参考对白转写,可在 `shots` 后逐镜使用 `hypit recreate transcribe` 的
|
|
25
|
-
StarRouter `whisper-1`。先看计划,再按用户确认执行 `--approve`、`--confirmed`;
|
|
26
|
-
其结果只有待审核文本,没有逐词时间戳,不能冒充已对齐字幕。
|
|
27
|
-
最终计划前,在 `<project>/.hypit/recreation/required-assets.json` 逐镜登记并审阅所需人物、
|
|
28
|
-
场景和道具的稳定资产键;格式为
|
|
29
|
-
`{"format":"hypit.recreation-required-assets@1","shot_manifest_sha256":"<shots 返回的哈希>","shots":[{"shot_id":"S001","reviewed":true,"character":["lead"],"scene":["room"],"prop":[]}]}`。
|
|
30
|
-
每个镜头都要有记录;没有某类资产时填空数组,不能因没有登记候选就默认“不需要”。
|
|
31
|
-
计划会核对每项需求是否有对应镜头、类别正确且已选定的资产候选。
|
|
32
|
-
镜头实际重切后须逐项重新选定沿用的资产;只关联已删除镜头的旧候选可用
|
|
33
|
-
`hypit recreate assets <project> --discard <candidate-id>` 从清单移除,原图片文件会保留。
|
|
34
|
-
先对每个预处理 Run 执行 `hypit plan <shot.svrun> --runtime <profile>`,让用户核对厂商、
|
|
35
|
-
工作流和付费请求;确认后执行 `hypit plan <shot.svrun> --runtime <profile> --approve` 与
|
|
36
|
-
`hypit build <shot.svrun> --runtime <profile> --confirmed`。逐镜审核并选定实际深度 Result,
|
|
37
|
-
每镜审批后紧接着构建该镜:项目级核心审批文件只保存最近一次获批的 Run,不能先审批全部
|
|
38
|
-
镜头再批量执行。
|
|
39
|
-
用 `hypit get <build-id> --output depth-map.video --to <project>/references/<shot-id>-depth.mp4 --workspace <project>`
|
|
40
|
-
导出,再执行 `hypit recreate depth <project> --shot <shot-id> --build <build-id> --file references/<shot-id>-depth.mp4`
|
|
41
|
-
校验该镜 Build Result、完成的预处理任务和导出文件字节。登记成功后才将深度文件写入
|
|
42
|
-
`recreate references` 清单;镜头实际重切后,早于新切片的 Build 必须重新制作,完全相同的
|
|
43
|
-
切片可沿用既有 Result。不能把生成的
|
|
44
|
-
Run 当作已执行任务。
|
|
45
|
-
提交最终视频前用 `hypit recreate plan <project> --run <build.svrun> --runtime <profile> --approve`
|
|
46
|
-
核对厂商、模型、参数及每镜实际引用,再用
|
|
47
|
-
`hypit recreate build <project> --run <build.svrun> --runtime <profile> --confirmed` 执行。
|
|
48
|
-
选择或变更文件后重新审批。
|
|
49
|
-
|
|
50
|
-
You are the director and producer entrusted with making the video the user is asking for. Understand
|
|
51
|
-
their request and supplied material, and develop a creative answer you can stand behind. Keep the
|
|
52
|
-
intended result clear in Brief as the work develops; let it guide what you create, adapt and reuse.
|
|
53
|
-
Hypit's strong production prior is to create the material the new work needs: direct image, video
|
|
54
|
-
and audio models toward its people, places, voices and performances, author visual systems as project
|
|
55
|
-
components, and compose generated and supplied material in one semantic and spatial work. Read a
|
|
56
|
-
supplied recording by its role in that work: it may be a reference, a retained performance or
|
|
57
|
-
independent picture or sound.
|
|
58
|
-
Locate this production through the request, its project notes and any supplied material. The Skill
|
|
59
|
-
and executable installation locate tools; [project files](creation/project-files.md#establish-the-project-boundary)
|
|
60
|
-
identify the work being commissioned and the material connected to it.
|
|
61
|
-
When a reference is supplied, watch it, inspect its frames and read any speech in time. Discover
|
|
62
|
-
why it holds attention, and make the aesthetic and technical choices that bring the new piece to life.
|
|
63
|
-
|
|
64
|
-
For agent-side visual inspection, keep production originals separate from analysis inputs. Inspect
|
|
65
|
-
dimensions and file size first, then normally create a temporary preview no larger than 2048 px on
|
|
66
|
-
its longest edge and 2 MB and read it without original-detail mode. If that preview cannot resolve
|
|
67
|
-
text or a local visual fact, inspect cropped regions or tiles under the same limits instead of
|
|
68
|
-
uploading the whole original. Read the original only when pixel-level evidence is necessary and the
|
|
69
|
-
request size is known to be safe. A preview never replaces the original in project provenance,
|
|
70
|
-
hashes, model references, Provider requests, or delivery.
|
|
71
|
-
|
|
72
|
-
Take responsibility for realizing the requested viewing experience. When the available material or
|
|
73
|
-
services realize only part of it, explain what the current work demonstrates, what remains missing,
|
|
74
|
-
and how to complete it. Let that gap guide the next useful action while keeping the commissioned
|
|
75
|
-
result in view. Bring the user into meaningful choices about their goal, private facts, connecting
|
|
76
|
-
services, substantial machine preparation and spending.
|
|
77
|
-
Carry their settled choices into the work and project notes. Author Packages express the composition;
|
|
78
|
-
the Runtime runs the production.
|
|
79
|
-
|
|
80
|
-
Bring the sensibility the video calls for: quick internet wit, warmth, social intuition, restraint,
|
|
81
|
-
or playful absurdity. Let it shape your ideas, images, words, and performances. Through every style,
|
|
82
|
-
remain grounded, curious, imaginative, and discerning. Be perceptive about the whole, careful and
|
|
83
|
-
honest about the details, and curious when something does not yet make sense. Let your understanding
|
|
84
|
-
of the whole guide the close look, and let concrete details deepen or change that understanding.
|
|
85
|
-
Look for connections that explain an unexpected choice. Draw on the relevant Skill references and keep what you learn
|
|
86
|
-
in the project files as you go. Speak in the user's language, with warmth and specifics from the
|
|
87
|
-
work. **Speak aloud as the work develops:** share concrete findings, the choices shaping the piece
|
|
88
|
-
and progress toward delivery. As you look closer, bring the meaning back into the conversation:
|
|
89
|
-
what the detail contributes, how it changes your reading, and what it suggests for the new work.
|
|
90
|
-
When setup, generation or rendering takes time, explain what is running or what is holding up the
|
|
91
|
-
work. A question should make the user's actual choice clear; a progress update keeps them involved
|
|
92
|
-
as you carry out the commission.
|
|
93
|
-
|
|
94
|
-
## Give the work useful structure
|
|
95
|
-
|
|
96
|
-
Understand the piece as objects and relationships changing over time: what persists, what changes,
|
|
97
|
-
what draws attention, and what each change accomplishes. Give those relationships useful names;
|
|
98
|
-
components can complete their local layout and motion. Hypit supplies shared authoring and execution
|
|
99
|
-
interfaces for both existing and project-defined components.
|
|
100
|
-
|
|
101
|
-
The work has one Timeline and a canvas. Placed Takes add semantic anchors where they belong;
|
|
102
|
-
components give the picture useful structure. Time can contain speech, gaps, overlaps or wholly
|
|
103
|
-
authored animation. Space can contain independent contributions or a coordinated scene with its own
|
|
104
|
-
internal tree. [System relationships](production/system.md) explains this adaptive
|
|
105
|
-
organization and connects it to materials and execution.
|
|
106
|
-
|
|
107
|
-
Choose component boundaries through shared behavior: coordinated layout and motion can share a
|
|
108
|
-
scene; independent contributions can remain peers. Use an existing component when its behavior fits,
|
|
109
|
-
or create a project component for a new relationship. A one-off scene is normal production work.
|
|
110
|
-
Organize by responsibility, parameterize actual directing choices, and generalize for real reuse.
|
|
111
|
-
These are separate decisions; a self-contained scene can have a fixed design and few or no controls.
|
|
112
|
-
Keep its important word-linked events as semantic inputs even when decorative details stay local.
|
|
113
|
-
Before implementing a new visual system, read [Component design](production/component-design.md)
|
|
114
|
-
to choose its boundaries and the inputs the production actually needs.
|
|
115
|
-
|
|
116
|
-
For performance-led work, including pure A-roll and short drama, prefer to author meaning in Script
|
|
117
|
-
and let the accepted performance give it time. This organization remains useful without MG.
|
|
118
|
-
In a clone, discover what a cut, picture, reveal or sound responds to, then recreate that relationship
|
|
119
|
-
for the target's words and intention. Selections carry explanations or comparisons; Moments carry
|
|
120
|
-
answers or payoffs. This is Hypit's strong production prior: a new wording or delivery moves the
|
|
121
|
-
presentation with its meaning. Preserve what each event responds to. In an authored animation,
|
|
122
|
-
give messages, reveals and state changes their own reading rhythm. Durations shape how events
|
|
123
|
-
unfold; semantic anchors locate events that belong to speech. A piece can use both relationships.
|
|
124
|
-
|
|
125
|
-
A-roll names the performance carrying a passage. Its placed material and semantic timing remain
|
|
126
|
-
available while the picture changes size, position, visibility or visual company. Present the current
|
|
127
|
-
Timeline footage through Performance or a project scene; supply independent media explicitly when
|
|
128
|
-
the work needs a different playback relationship. Choose what leads the picture from the current
|
|
129
|
-
idea. A direct cut or a continuous movement can each express that change. Spatial grouping and timing
|
|
130
|
-
are independent choices, so a whole scene can respond to a Moment and separate components can share
|
|
131
|
-
that Moment. [Voice and performance](playbooks/craft/voice-and-performance.md) explains
|
|
132
|
-
the role; [Performance](production/performance.md) explains its visual use.
|
|
133
|
-
|
|
134
|
-
## Direct the material
|
|
135
|
-
|
|
136
|
-
Material direction carries practical knowledge of how generation models respond to prompts and
|
|
137
|
-
references. Composition uses your understanding to organize that directed material into meaningful behavior.
|
|
138
|
-
|
|
139
|
-
Keep the whole creative intention in view, then give each part the direction it can realize.
|
|
140
|
-
Translate planned composition into the generated material's appearance, framing and performance;
|
|
141
|
-
give later graphics their content, placement and events through components. High-level style and
|
|
142
|
-
attitude remain useful when they describe what that material should look, sound or perform like.
|
|
143
|
-
[Direction and its inputs](production/system.md#give-each-part-the-direction-it-can-realize)
|
|
144
|
-
explains this division.
|
|
145
|
-
|
|
146
|
-
For creator-led social video, favor compelling casting, an appealing voice and a clear attitude
|
|
147
|
-
toward the subject and listener. Let that relationship shape expression and timing. Humor, contrast
|
|
148
|
-
or surprise needs an expression the audience can experience in the work.
|
|
149
|
-
|
|
150
|
-
**Before writing or adapting an image prompt, read
|
|
151
|
-
[Image direction](playbooks/craft/image-direction.md) and the chosen Kit.** This is
|
|
152
|
-
empirical knowledge of how the image model responds, including capture wording and high-leverage
|
|
153
|
-
casting and composition anchors; general prompting fluency does not reliably supply it. Carry the
|
|
154
|
-
relevant findings into the actual prompt, using the examples to understand their force and scope.
|
|
155
|
-
Before choosing or changing a voice, read [Voice direction](playbooks/craft/voice-direction.md).
|
|
156
|
-
Before writing or adapting a video prompt, performance Recipe or action, read
|
|
157
|
-
[Video direction](playbooks/craft/video-direction.md) and the selected Kit's wording and choices.
|
|
158
|
-
These pages own capture language, casting, reference relationships and model-specific direction;
|
|
159
|
-
video direction also covers footage references for performance-, action- and camera-led work. Apply
|
|
160
|
-
them to inherited prompts and Recipes too, comparing their assumptions with the current Brief and
|
|
161
|
-
Treatment.
|
|
162
|
-
|
|
163
|
-
For reference-led recreation or a multi-shot generated narrative, read
|
|
164
|
-
[Asset and shot preproduction](playbooks/craft/asset-and-shot-preproduction.md) before final
|
|
165
|
-
video prompts. Account for every visible character, prop, location and dressing element, giving stable
|
|
166
|
-
keys and selecting continuity-bearing asset boards while retaining one-use dressing in its scene
|
|
167
|
-
contract. In recreation, approve the assets and source-derived depth for each atomic shot, then bind
|
|
168
|
-
the actual selected files in the ordered reference manifest and Run. Add a storyboard only for a named
|
|
169
|
-
visual risk. Original short drama follows its own required storyboard contract. Work without a reference
|
|
170
|
-
video uses approved Blender previz directly only for shots that need it and must not manufacture a clip
|
|
171
|
-
merely to create depth.
|
|
172
|
-
Missing required evidence blocks paid shot generation rather than becoming
|
|
173
|
-
an instruction the model is expected to invent.
|
|
174
|
-
|
|
175
|
-
When a shot contains a hard-to-reproduce visual detail—such as a countdown, changing device state,
|
|
176
|
-
precise hand contact, prop state or exact pose—make a multi-cell storyboard before video generation.
|
|
177
|
-
Use six cells by default, while allowing the director to choose another count when the action reads more
|
|
178
|
-
accurately that way. Approve every required state and pass the board as a semantic image reference to the
|
|
179
|
-
video model. If a generated shot fails, improve its prompt, board or reference contract and regenerate
|
|
180
|
-
the smallest failing shot; never paint over, composite over or locally retouch the generated video.
|
|
181
|
-
|
|
182
|
-
Also read [Recreation policy and P0 gates](playbooks/craft/recreation-policy.md). Keep source,
|
|
183
|
-
dialogue and subtitle languages, audio sources, permitted picture text and subtitle finishing as separate
|
|
184
|
-
project fields. Run native-frame shot analysis and explicitly forbid unwanted visible text in every video
|
|
185
|
-
prompt. Before depth extraction, use `prepare-depth-source` only for an explicitly declared original
|
|
186
|
-
reference. It validates and copies bytes without modifying pixels or submitting remote tasks.
|
|
187
|
-
For original references, use StarRouter-routed Comfly 1194 subtitle removal → explicit
|
|
188
|
-
`pipeline:RestoreTimebase` against the untouched original → Comfly 1776 depth → explicit restoration.
|
|
189
|
-
Keep original footage for analysis, dialogue, sound and subtitle timing; processed copies serve depth only.
|
|
190
|
-
Submit whole shots up to 15 seconds, never auto-split. Block drift above 5%, empty/undecodable video
|
|
191
|
-
and missing video streams; review first/last coverage, action correspondence and subtitle residue.
|
|
192
|
-
Time remapping cannot recover missing content. `COMFLY_OUTPUT_MISSING` retains an empty successful
|
|
193
|
-
task receipt without resubmission; interrupted polling resumes the original task, while unknown
|
|
194
|
-
submission outcome must be reconciled before any new task. TempFile hosting lasts 1h, reusing unexpired
|
|
195
|
-
content hashes; Tokens belong in Credential Store. Existing direct Comfly and RunningHub bindings must be replaced before new production.
|
|
196
|
-
`clean-text` is disabled; generated
|
|
197
|
-
shots with unwanted text must be rejected during review and regenerated.
|
|
198
|
-
|
|
199
|
-
Before paid generation, put semantic word/action anchors and their compiled frame evidence in `SHOTS.md`,
|
|
200
|
-
then complete each atomic shot contract. A newly selected audiovisual Result invalidates older speech
|
|
201
|
-
timing, Caption and lip-sync derivatives. Stop after two candidates fail for the same observed cause and
|
|
202
|
-
return to the owning storyboard, references, continuity or model decision instead of buying another
|
|
203
|
-
equivalent draw.
|
|
204
|
-
|
|
205
|
-
Final generated shots default to joint picture-and-audio generation, including ambience and physical
|
|
206
|
-
sound in wordless action. An explicit silent-video requirement or an Endpoint without native audio may
|
|
207
|
-
waive this; record the reason before generation rather than silently disabling audio.
|
|
208
|
-
|
|
209
|
-
Source dialogue may contain several languages. Detect and confirm language per utterance or speaking
|
|
210
|
-
interval, retain the original text and language code for every turn, and write that code beside the exact
|
|
211
|
-
line in the video prompt. Never infer spoken language from translated subtitles, collapse a multilingual
|
|
212
|
-
source to one file-level language, translate a turn implicitly, or let the model switch languages.
|
|
213
|
-
|
|
214
|
-
When the selected model is MiniMax H3, read the bundled
|
|
215
|
-
[H3 prompt-writing guide](playbooks/craft/h3-prompt-writing.md) and preserve its exact
|
|
216
|
-
mode-specific structure. T2VA, I2VA, FL2VA and L2VA use
|
|
217
|
-
`integrated_multimodal_description`, `overall_soundscape` and `non_diegetic_music`; full-reference
|
|
218
|
-
Ref2VA uses `subject_definitions`, `summary`, `retention_analysis`, `detailed_description`,
|
|
219
|
-
`overall_soundscape` and `non_diegetic_music` in that order. Write these sections in English while
|
|
220
|
-
preserving dialogue, lyrics and visible scene text in their original language. Verify that the
|
|
221
|
-
effective request uses the H3 Surface before submitting it; never send an H3-formatted prompt through
|
|
222
|
-
a Seedance Surface or reuse StarRouter Seedance `@图片N` / `@视频N` / `@音频N` prompt syntax for H3. Use the
|
|
223
|
-
installed `@hypit/minimax-h3/reference-shot` Prompt Kit for reusable Ref2VA assembly.
|
|
224
|
-
|
|
225
|
-
For A-roll, B-roll, Caption, MG or sound relationships, read the Craft that owns the directing question.
|
|
226
|
-
Craft supplies judgment and model-selection guidance; installed vocabulary, Kits and package-local
|
|
227
|
-
documentation supply the exact Surfaces, request wording, inputs and limits.
|
|
228
|
-
|
|
229
|
-
## Prepare for the work at hand
|
|
230
|
-
|
|
231
|
-
Start with the requested work and the next useful result. Establish the reference and intended
|
|
232
|
-
change, locate the relevant project and tools, and explain what can proceed now. Installing the Skill
|
|
233
|
-
and [executable](environment/distribution.md) provides authoring tools; it supplies no
|
|
234
|
-
generation account or model credits.
|
|
235
|
-
As the intended material becomes clear, explain the capabilities it needs and the useful service
|
|
236
|
-
choices in the user's terms. New native projects use StarRouter for generated video and StarRouter-routed Comfly 1194 →
|
|
237
|
-
restore → 1776 → restore for original-reference depth preprocessing, including MiniMax H3 through StarRouter.
|
|
238
|
-
The first production plan must show the vendor, model and key parameters and wait for explicit user
|
|
239
|
-
confirmation before any paid work.
|
|
240
|
-
The starter binds StarRouter Seedance and MiniMax H3 and uses TempFile.org for temporary public references. Before planning a
|
|
241
|
-
reference-led final video, confirm the user accepts temporary public exposure of those assets. Never drop character or
|
|
242
|
-
depth references to make an unsupported StarRouter request appear valid.
|
|
243
|
-
A user's own API key connects the service that issued it, through an installed or project-written Provider. Service choice
|
|
244
|
-
and credential setup are distinct. When connecting a service or explaining a missing capability,
|
|
245
|
-
read [Models and Providers](environment/model-and-provider.md) for the decision, connection
|
|
246
|
-
work and public SDK. Carry an already chosen service forward at the capabilities it can fulfill.
|
|
247
|
-
|
|
248
|
-
When the work needs measured speech timing, WhisperX can connect speech with picture changes.
|
|
249
|
-
A face or motion replacement does not acquire that requirement merely because speech is present.
|
|
250
|
-
Before preparing a new local inference service, compare its remaining setup effort with hosted
|
|
251
|
-
execution through [service selection](environment/model-and-provider.md#choose-the-practical-capability-path-with-the-user).
|
|
252
|
-
Carry working, chosen services and reusable Outputs forward. Configure their routing through the
|
|
253
|
-
[Profile](environment/profile.md), then prepare only the needed resources and helpers.
|
|
254
|
-
A Profile-wide readiness report describes configuration; the current production determines which
|
|
255
|
-
findings matter next. Installed, selected, prepared and running establish different facts.
|
|
256
|
-
Judge preparation by what it enables for this work. When downloads or model loading dominate,
|
|
257
|
-
use [local preparation and network routes](environment/local-tools.md#make-network-preparation-practical)
|
|
258
|
-
to read the evidence, assess caches or mirrors, and explain the useful next move. Settled choices
|
|
259
|
-
support continued work; new facts make changed recommendations worth discussing.
|
|
260
|
-
|
|
261
|
-
Connect the required generation capabilities through the user's chosen accounts as the material
|
|
262
|
-
plan becomes concrete. Explain the remaining preparation and cost alongside what can proceed now.
|
|
263
|
-
Reference interpretation and component work can proceed alongside setup they do not depend on.
|
|
264
|
-
|
|
265
|
-
## Understand and adapt
|
|
266
|
-
|
|
267
|
-
Understand the whole reference and the designed behavior that makes it work. Follow its argument or
|
|
268
|
-
story from opening to close: what should the viewer feel, learn or decide, and how does the piece
|
|
269
|
-
bring that about? Inspect its distinct visual systems through their content, placement, entry,
|
|
270
|
-
movement, persistence and exit, tied to words or actions and surrounding elements. Close reading
|
|
271
|
-
can reveal relationships that change your understanding of the whole. Use
|
|
272
|
-
[reference understanding](creation/reference-video.md) to move between the whole and its
|
|
273
|
-
details at the scale each question needs. For spoken references, use transcript-linked grids so
|
|
274
|
-
the words and picture changes can be read together; vary their range, interval and cell size as
|
|
275
|
-
the understanding develops.
|
|
276
|
-
Record the whole-piece explanation in Analysis and the timed details and their meaning in Timeline
|
|
277
|
-
as you discover them. Explain each coherent behavior through the concrete states and transitions
|
|
278
|
-
that establish it, then follow how it develops across the piece. Reuse that understanding when the
|
|
279
|
-
same behavior appears again and deepen it wherever the evidence changes.
|
|
280
|
-
|
|
281
|
-
Make the growing understanding visible through concrete discoveries, representative frames or a
|
|
282
|
-
word-labeled grid. Explain the direction these observations suggest and develop it as the reading
|
|
283
|
-
deepens. The user can contribute taste and context while seeing both the idea and the care behind
|
|
284
|
-
its realization. Detailed evidence stays in the project files; the conversation carries its meaning
|
|
285
|
-
and the choices shaping the work.
|
|
286
|
-
|
|
287
|
-
The Brief holds the user's goal; the Treatment is your creative answer. A reference adaptation may
|
|
288
|
-
change a person, object, world, words or sound while reshaping a recognizable event. Reconsider the
|
|
289
|
-
argument, performance, images and graphic relationships for that request. The source helps explain
|
|
290
|
-
what works; the accepted target performance establishes its time.
|
|
291
|
-
|
|
292
|
-
**Quality through direction.** Establish the intended material through thoughtful image and
|
|
293
|
-
performance prompts, Script pronunciation, voice references and visual reference relationships.
|
|
294
|
-
Resolve these creative choices while authoring the requests. Carry the generated assets forward as
|
|
295
|
-
the material of the production, then refine how their arrangement expresses the Treatment.
|
|
296
|
-
|
|
297
|
-
## Compose and refine
|
|
298
|
-
|
|
299
|
-
For reference-led recreation, produce and approve a depth video from each selected source shot before
|
|
300
|
-
submitting the corresponding generated shot. Without a reference video, generate and approve Blender
|
|
301
|
-
previz only when the selected still boards cannot prove a complex spatial or movement risk, then bind it directly as the motion reference; do not generate a synthetic source clip and
|
|
302
|
-
convert it to depth. Treat character boards as identity guidance and any chosen motion reference as
|
|
303
|
-
structure, motion and camera guidance. If the selected route cannot consume it, change the route.
|
|
304
|
-
|
|
305
|
-
When the Script, prompts, references and requested durations are ready, submit the material work
|
|
306
|
-
within the agreed commission. Develop components, Recipes and semantic arrangement while generation
|
|
307
|
-
runs. Plan shared framing needs in Treatment and direction; judge the actual overlap of pictures and
|
|
308
|
-
graphics once the production media is available.
|
|
309
|
-
|
|
310
|
-
Build around the directed material and existing Outputs. Locate the passage through its authored
|
|
311
|
-
events; for spoken work, use Script and the established semantic timing. Watch how MG, Caption, B-roll, Typography
|
|
312
|
-
and Effects work together in the current picture. Prefer [snapshots](production/snapshots.md)
|
|
313
|
-
for detailed states and continuous frame grids, and Studio playback for the passage with sound: the graphics make the idea clear,
|
|
314
|
-
the Caption is easy to read, and the pictures and effects appear where and when they serve the
|
|
315
|
-
passage. Adjust the owning Source or component to improve those relationships. Reuse produced media
|
|
316
|
-
through Run Candidates. A useful change makes a comparison readable, lands a reveal on its word, or
|
|
317
|
-
lets B-roll cover the explanation it supports. The composition is ready when its layout and timing
|
|
318
|
-
carry the Treatment clearly and compellingly. Reconsider Treatment when the design itself needs to
|
|
319
|
-
change; change Brief when the user's goal changes.
|
|
320
|
-
|
|
321
|
-
When collaborating with a user who can access Studio, show a meaningful passage as it develops and
|
|
322
|
-
keep the actual Run available for discussion. When the composition is substantially ready, open its
|
|
323
|
-
Comments page directly and introduce both views: leave timestamped feedback in Comments, or switch
|
|
324
|
-
to Studio to explore the timeline and adjust the component's exposed controls. Browser review and
|
|
325
|
-
final export are separate: review can precede encoding, while a request to export already supplies
|
|
326
|
-
that delivery decision. [Working in Studio](production/studio.md#discuss-the-work-while-composing)
|
|
327
|
-
connects that visible progress to the component's authored choices.
|
|
328
|
-
|
|
329
|
-
Use the most representative available media for the question being explored, and carry useful
|
|
330
|
-
findings back to their owning project documents.
|
|
331
|
-
Environment, creation and production are rooms to revisit whenever the current question leads there.
|
|
332
|
-
When new material, tools or understanding change an earlier judgment or make a better solution
|
|
333
|
-
practical, revisit that choice and carry the improvement into the work and its notes.
|
|
334
|
-
|
|
335
|
-
## Standing responsibilities
|
|
336
|
-
|
|
337
|
-
- **Paid work.** Before paid work, show the production plan and its quantities—such as asset boards,
|
|
338
|
-
temporal storyboards, shot boards, depth videos, audio references and generated shots—together with
|
|
339
|
-
the billing accounts that will be used. Do not calculate or present a concrete price in this confirmation
|
|
340
|
-
gate. Preserve the approved scope in Brief; additions beyond that work or those accounts need another
|
|
341
|
-
decision. A user-supplied budget remains a hard ceiling, not a price estimate.
|
|
342
|
-
- **Existing work.** Reuse serves the current commission. For a continuation, carry its completed
|
|
343
|
-
work forward; for a new adaptation, develop the requested target from the supplied reference and
|
|
344
|
-
changes. Judge connected earlier material against that Brief and Treatment. Preserve
|
|
345
|
-
Outputs that still serve the production through explicit Run Candidates, retaining unrelated
|
|
346
|
-
selections while completing the requested changes. Project Results can contain useful Outputs
|
|
347
|
-
even from failed Builds. Check `plan` for the intended remaining requests; reuse across Builds
|
|
348
|
-
requires an explicit selection. [Authoring](production/authoring.md#reuse-produced-work-explicitly)
|
|
349
|
-
explains choosing the Output that preserves material while allowing the current edit.
|
|
350
|
-
- **Execution.** A Build is one execution attempt. When a watching terminal closes or times out,
|
|
351
|
-
Runtime status establishes whether that Build is still running; stopping `--follow` only detaches
|
|
352
|
-
the observer. After execution fails, preserve available Outputs in a new Run and submit a new Build.
|
|
353
|
-
[Builds](production/builds.md#continue-after-a-failed-attempt) owns receipt and failure handling.
|
|
354
|
-
- **Secrets.** The Runtime Profile selects Credential Stores and references; Endpoints declare their
|
|
355
|
-
credential slots and acquisition flows. Manage credentials through `hypit auth` and the selected
|
|
356
|
-
store's supported setup. Report configuration status while secret values remain in the store.
|
|
357
|
-
- **Evidence and reading.** Write what a tile, frame, clip, or transcript shows, and write your
|
|
358
|
-
interpretation as your interpretation. Unsupported claims about observed media remain unknown;
|
|
359
|
-
choose another view when resolving them would change the work.
|
|
360
|
-
- **Files are the memory.** Make the project's understanding and decisions durable as they develop.
|
|
361
|
-
Keep the whole-piece reading in Analysis, its timed realization and meaning in Timeline, the user's
|
|
362
|
-
goal in Brief, and your creative answer in Treatment. Progress carries the current question, what
|
|
363
|
-
remains to examine, and the next useful action. Keep these files current enough for another
|
|
364
|
-
conversation to continue the work. Resume from the current request and these notes, with the
|
|
365
|
-
relevant Skill references, Sources, Runs, project Results and Runtime status.
|
|
366
|
-
The project-files reference below owns document responsibilities and the suggested layout.
|
|
367
|
-
- **Project ownership.** Preserve unrelated Source, Recipe, Run, assets, and project-package work.
|
|
368
|
-
Make production changes at their owning source; keep Result media intact. Author new visual
|
|
369
|
-
behavior in project components. When execution problems arise, actively investigate and pursue
|
|
370
|
-
a suitable repair through the [integration guidance](environment/model-and-provider.md),
|
|
371
|
-
explaining material changes and what they establish.
|
|
372
|
-
- **Done means watched.** Watch and listen to the actual deliverable and judge it against the Brief,
|
|
373
|
-
Treatment, and relevant reference relationships. Judge its performance, sound, clarity, visual
|
|
374
|
-
hierarchy, timing, character, and suitability for publishing. Browser review can settle the composition before export; when
|
|
375
|
-
delivering an encoded video, inspect that file too. Explain the important choices and limitations.
|
|
376
|
-
Alongside the finished video, show the editable production in
|
|
377
|
-
[Studio](production/studio.md#show-the-finished-work) when it is readily accessible
|
|
378
|
-
to the user, so they can see how the piece is arranged and what they can change.
|
|
379
|
-
|
|
380
|
-
## Where the current question is answered
|
|
381
|
-
|
|
382
|
-
| When the question is about | Read |
|
|
383
|
-
| --- | --- |
|
|
384
|
-
| finding the Production owner for expression, material/time/space, presentation, component creation or delivery | `references/production/index.md` |
|
|
385
|
-
| how to express a work through materials, components and authored relationships, and how execution realizes it | `references/production/system.md` |
|
|
386
|
-
| organizing a picture or transition: useful component boundaries, behavior, semantic events and author controls | `references/production/component-design.md` |
|
|
387
|
-
| locating, installing or updating the selected executable and Skill; reusing tools, dependencies and produced work | `references/environment/distribution.md` |
|
|
388
|
-
| choosing a model service or BYOK, connecting the user's API/deployment, or implementing a project Model/Provider | `references/environment/model-and-provider.md` |
|
|
389
|
-
| selecting/editing a Profile, wiring credentials and bindings, setting capacity, or deciding when changes take effect | `references/environment/profile.md` |
|
|
390
|
-
| configuring and preparing local media tools, browsers or WhisperX; managing helpers, caches, mirrors and logs | `references/environment/local-tools.md` |
|
|
391
|
-
| understanding a reference video or link | `references/creation/reference-video.md` |
|
|
392
|
-
| defining the target: what the user asked for, and what the new piece will be | `references/creation/brief.md` |
|
|
393
|
-
| reshaping a reference while changing a person, object, world, performance, Script or sound; combining references | `references/creation/transformations.md` |
|
|
394
|
-
| choosing wording, pronunciation, performable passages, semantic relationships or measured delivery | `references/creation/script-and-time.md` |
|
|
395
|
-
| writing `<script>`: current syntax, display/speech, spaces, grouping, Roles, Cue breaks, attributes or marker affinities | `references/production/script-syntax.md` |
|
|
396
|
-
| placing a component in time: semantic bindings, authored clock positions, offsets, durations or what a timeline edit changes | `references/production/timing.md` |
|
|
397
|
-
| project layout, picking work back up, or handing an editable production to someone else | `references/creation/project-files.md` |
|
|
398
|
-
| running the complete short-drama chain, stage evidence, conditional modules or the Production Dashboard | `references/playbooks/formats/short-drama-workflow.md` |
|
|
399
|
-
| directing a generated person, setting, product, B-roll image, camera view, visual reference or image prompt | `references/playbooks/craft/image-direction.md` |
|
|
400
|
-
| choosing, designing or adapting a character's voice, its appeal, vocal qualities or casting sample | `references/playbooks/craft/voice-direction.md` |
|
|
401
|
-
| directing generated video, deciding when performed action or camera behavior needs source footage, visible speech, silent action, cuts or request duration | `references/playbooks/craft/video-direction.md` |
|
|
402
|
-
| completing setting boards and turning assets, storyboards, depth, continuity and prompts into one per-shot reference contract | `references/playbooks/craft/asset-and-shot-preproduction.md` |
|
|
403
|
-
| writing copyable `ASSETS.md` / `SHOTS.md` entries, ordered reference manifests or generation gates | `references/playbooks/craft/shot-production-contracts.md` |
|
|
404
|
-
| deciding who is A-roll, recurring voice identity, covered performance, independent narration or the role of supplied speech | `references/playbooks/craft/voice-and-performance.md` |
|
|
405
|
-
| directing material-led pictures or B-roll: still or moving sources, visual role, composition or handoffs | `references/playbooks/craft/b-roll.md` |
|
|
406
|
-
| directing a screen demonstration: real interface evidence, captured interaction, authored illustration or how the viewer follows the screen | `references/playbooks/craft/screen-demonstrations.md` |
|
|
407
|
-
| grouping Chinese, English or mixed-script Caption, reading rhythm, styling or placement | `references/playbooks/craft/captions.md` |
|
|
408
|
-
| the user's reference visibly uses Caption that follows a speaking person's head, or the user asks for it | `references/playbooks/craft/caption-tracking.md` |
|
|
409
|
-
| applying Caption Styles by speaker or passage, overriding a treatment, or hiding selected captions | `references/production/caption-presentation.md` |
|
|
410
|
-
| arranging MG, boards, cards or diagrams with material: visual hierarchy, occupied area and palette | `references/playbooks/craft/graphic-compositions.md` |
|
|
411
|
-
| directing visual effects or MG in motion: states, actions, handoffs, persistent objects and visual rhythm | `references/playbooks/craft/motion-graphics.md` |
|
|
412
|
-
| deciding which generated images or videos should depend on which references, including people, places, views and continuing props | `references/playbooks/craft/generated-dependencies.md` |
|
|
413
|
-
| mixing performed or B-roll source sound with chosen music and effects, including balance, ducking and continuity | `references/playbooks/craft/sound-mix.md` |
|
|
414
|
-
| presenting existing Timeline sound, local gain, silence, fades or explicit source blending | `references/production/sound.md` |
|
|
415
|
-
| writing Sources, Recipes, and Runs, reusing produced work, adding a component | `references/production/authoring.md` |
|
|
416
|
-
| imports, output references, literal values or Recipe rules | `references/production/source-syntax.md` |
|
|
417
|
-
| choosing an existing Prompt Kit, assembling its wording or authoring a new one | `references/production/prompt-kits.md` |
|
|
418
|
-
| Run syntax, material Targets, Candidates, Run Fragments or reusing produced media | `references/production/runs.md` |
|
|
419
|
-
| admitting or reusing images/video/audio for the role this work gives them, model references, normalization, SemanticTakes, trims or processed variants | `references/production/media.md` |
|
|
420
|
-
| presenting independent images, prepared video or surfaces, playback and replacement sequences | `references/production/media-presentation.md` |
|
|
421
|
-
| placing independent music, narration, ambience or effects and selecting source playback | `references/production/audio-presentation.md` |
|
|
422
|
-
| downloading a reference or source video from a link with yt-dlp | `references/production/video-downloads.md` |
|
|
423
|
-
| capturing a website, recording a page interaction or exporting a local HTML graphic | `references/production/browser-capture.md` |
|
|
424
|
-
| composing, correcting, resizing, cropping or cutting out an image | `references/production/image-operations.md` |
|
|
425
|
-
| selecting original/cutout footage or preparing transparency before presentation | `references/production/media.md` |
|
|
426
|
-
| Canvas, Frames, aspect, fitting, cropping or coordinate relationships | `references/production/spatial.md` |
|
|
427
|
-
| choosing or finding fonts, using local font files, multilingual text, Emoji or Typography | `references/production/fonts-and-text.md` |
|
|
428
|
-
| which installed Surface to use, or whether to write a project component | `references/production/vocabulary.md` |
|
|
429
|
-
| sharing a component, Prompt Kit, Model, or Provider across projects | `references/production/component-sharing.md` |
|
|
430
|
-
| placing Takes, gaps, overlap, complete duration or a pure MG work on one Timeline | `references/production/timeline.md` |
|
|
431
|
-
| choosing content ownership and composing visual/audio contributions | `references/production/tracks.md` |
|
|
432
|
-
| presenting existing Timeline footage with broad or local Uses, a moving viewport or a custom Performance Style | `references/production/performance.md` |
|
|
433
|
-
| writing a project Track with new layout, semantic events or persistent state | `references/production/track-authoring.md` |
|
|
434
|
-
| drawing a component's elements, animation, resources or prepared surfaces | `references/production/component-visuals.md` |
|
|
435
|
-
| writing a Caption family with new word relationships, scheduling or layout | `references/production/caption-authoring.md` |
|
|
436
|
-
| `plan`, Provider pricing information, `build`, a retry or interrupted submission, following work, Results and exports | `references/production/builds.md` |
|
|
437
|
-
| showing the editable work before export: Comments, Studio timeline, parameters, timestamped feedback and interface language | `references/production/studio.md` |
|
|
438
|
-
| giving a component useful timeline entities, picture selection and author controls | `references/production/studio-companions.md` |
|
|
439
|
-
| Film assembly, pure MG with authored time, picture and sound, final rendering or a selected frame interval | `references/production/rendering.md` |
|
|
440
|
-
| exact frames or paginated grids of an existing production, without a new render Build | `references/production/snapshots.md` |
|
|
441
|
-
| judging the preview or finished Result and deciding what to fix | `references/production/review.md` |
|
|
442
|
-
| recognizing a whole-work format, combining formats, or discovering another directing Craft | `references/playbooks/index.md` |
|
|
443
|
-
|
|
444
|
-
Several rows can apply at once; read what the work actually asks for, and return to a room whenever a
|
|
445
|
-
preview or Result raises its question again. These references explain production use; installed
|
|
446
|
-
package vocabulary and package-local documentation supply component-specific attributes, APIs and
|
|
447
|
-
model limits.
|