@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,85 +1,60 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 短剧生产合同
|
|
2
2
|
|
|
3
3
|
标准流程固定为:
|
|
4
4
|
|
|
5
5
|
`analysis → script → director-book → asset-analysis → asset-generation → production-plan → per-shot image or Blender storyboard → plan-shot-continuity → video prompts → videos/audio → editing → delivery`
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
市场调研和市场灵感位于正式状态机之外,是 `analysis`
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
│ ├── scripts/<version>.(json|md|txt)
|
|
34
|
-
│ ├── script-review/<version>.json
|
|
35
|
-
│ ├── director-book/<version>.json
|
|
36
|
-
│ ├── asset-plan/<version>.json
|
|
37
|
-
│ ├── production-plan/<version>.json
|
|
38
|
-
│ ├── continuity-plan/<version>.json
|
|
39
|
-
│ ├── video-prompts/<version>.json
|
|
40
|
-
│ ├── audio-plan/<version>.json
|
|
41
|
-
│ └── storyboard/<version>.json
|
|
42
|
-
├── assets/{characters,scenes,props,storyboards,audio,videos,other}/
|
|
43
|
-
├── editing/ep-NNN/timeline.json / review.json
|
|
44
|
-
└── delivery/ep-NNN/
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
所有项目必须遵循 [项目规范 v1](project-spec-v1.md):JSON 使用 snake_case 业务字段,项目 key 使用小写 kebab-case,分集使用 `ep-001`,版本使用 `v001`,媒体资产使用类型前缀并携带 provenance。
|
|
48
|
-
|
|
49
|
-
市场灵感严格分层:报告保存可追溯事实和分析推断,灵感文档保存待验证的创作假设,`decision` 保存用户已选择/拒绝的决定。报告引用绑定 report ID、snapshot IDs、筛选条件、生成时间和 SHA-256;登记时同时校验并原子写入 `market-inspiration.json` 与 Brief 引用。该可选动作不得覆盖 `project.json` 的题材、Brief 的平台、来源事实或合规约束,Bible 与 Outline 也不得绕过 Brief 直接消费榜单作品清单。
|
|
50
|
-
|
|
51
|
-
用 `node scripts/project-store.mjs init <项目目录> [项目元数据.json]` 初始化并执行 init 环境预检;进入媒体或剪辑阶段前再运行 `node scripts/preflight.mjs <media|editing> <项目目录>`。每阶段先用 `node scripts/module-runs.mjs required <项目目录> <阶段>` 获取 reference 模块,由 `short-drama` 主 Skill 完整执行,完成后用 `record` 绑定项目内证据;同一阶段已有证据时可用 `record-stage`。阶段检查、推进与回退使用 `workflow.mjs`;`advance` 会拒绝缺少模块凭证、真实本地产物或验收的阶段。
|
|
52
|
-
|
|
53
|
-
初始化一次性创建资产、任务、逐镜审核和模块账本。媒体 MCP 不信任聊天中的流程声明或手写 selected 文件:每次付费生成前校验当前阶段并重新检查所有上游阶段门禁;失败发生在请求快照和 Provider 访问之前。项目配置同时校验画幅—分辨率方向和 Provider 模型参数枚举。
|
|
54
|
-
|
|
55
|
-
图片、音频和视频生成成功后,必须立即用 `node scripts/asset-ledger.mjs <import|fetch|decode> ...` 把结果存入项目的 `assets/`,登记 SHA-256、文件大小、本地相对路径和 provenance,再允许选版或进入下游。独立配音先保存并选中 `audio-plan/vNNN.json`。资产生成与媒体制作阶段结束时用 `snapshot-stage-evidence.mjs` 生成不可变证据,避免后续合法修改总账导致早期凭证失效。远程 URL 只是临时传输结果,不得作为最终资产。
|
|
56
|
-
|
|
57
|
-
声音采用 `native-first`:先选同时满足画面引用和 `video.native-audio` 的 StarRouter 模型,原生生成对白、电影感旁白、环境声和动作声;BGM 走独立配乐与许可证流程。项目已确认固定 `voice_id` 时默认走原生绑定,只有实时能力明确返回不支持该 voice reference 时才停在声音方案确认并分流,不静默改用其他音色。每个原生声候选必须完成 `speech_intelligibility`、`speaker_identity`、`narration_performance`、`ambience_action_sync`、`lip_sync`、`technical_audio`、`undeclared_music` 七维审核。失败时把受控 reason 和证据写入 `native_audio_exception`;能力返回不支持的自定义音色、七维后配和口型驱动能力不得伪装成可用,也不得用旧厂商自动补做。
|
|
7
|
+
短剧插件只提供原创短剧阶段合同;参考片复刻使用 [复刻知识问答](recreation/recreation-qa.md) 中的 CLI 画布节点。旧复刻项目由插件阻止并提示迁移。
|
|
8
|
+
|
|
9
|
+
市场调研和市场灵感位于正式状态机之外,是 `analysis` 前或过程中按需使用的辅助输入,不是所有项目的必经阶段。只有用户明确选择灵感后,才把 `market-inspiration.v1` 保存为画布文档并由 Brief 引用。
|
|
10
|
+
|
|
11
|
+
## 事实来源与版本
|
|
12
|
+
|
|
13
|
+
项目、分集画布、自由画布文档、选版资产和审核记录是唯一事实来源,以 `ai-short-studio` 服务端状态为准;不要建立本地 `.short-drama/` 第二套项目状态,也不要调用或回写外部业务系统 API。
|
|
14
|
+
|
|
15
|
+
- 文本、分镜、导演本、资产计划、制作计划、连续性、视频提示词和审核记录使用 `canvas document save` 保存为 `canvas.<module>.v1` / `canvas.review.v1` 不可变版本,并用 `--input` 固化上游选版。
|
|
16
|
+
- 图片、视频、音频和媒体变换结果使用 `canvas asset upload`、`canvas asset select-version`、`canvas asset download` 管理,记录来源、版本、用途和 SHA-256。
|
|
17
|
+
- 旧版本只能追加,不覆盖;上游文档、选版或审核变化后,受影响的下游证据失效,必须重新生成并保存新版本。
|
|
18
|
+
- 所有项目遵循 [项目规范 v1](project-spec-v1.md):业务字段使用 snake_case,分集使用 `ep-001`,版本使用 `v001`,媒体资产使用类型前缀并携带 provenance。
|
|
19
|
+
|
|
20
|
+
## 阶段控制
|
|
21
|
+
|
|
22
|
+
每阶段先运行 `ai-short-studio canvas workflow status --project <projectId> --json`,再按 `module-map.json` 读取当前唯一模块。模块完成后保存新的文档版本,并用 `--input` 绑定实际输入和上游选版;阶段检查、推进与回退都以服务端状态和文档版本为准,不接受聊天中的流程声明或手工伪造的完成标记。
|
|
23
|
+
|
|
24
|
+
进入媒体或剪辑阶段前运行 `ai-short-studio preflight --json`。每次付费生成前重新核对当前阶段、全部上游门禁、模型实时能力和用户确认范围;失败发生在提交付费请求之前。
|
|
25
|
+
|
|
26
|
+
## 资产与媒体
|
|
27
|
+
|
|
28
|
+
图片、音频和视频生成成功后,必须立即下载或回读真实产物,登记为画布资产版本并记录 SHA-256、来源和任务信息,再允许选版或进入下游。远程 URL 只是临时传输结果,不得作为最终资产;未选版、未审核或带过期链接的素材不得写入下游节点。
|
|
29
|
+
|
|
30
|
+
结构化资产和分镜节点的输入来自已选版资产或结构化端口;只写 `prompt` 而让端口悬空,等同于没有引用素材。节点 `prompt` 只补充创作意图,服务端追加的语言与最终结构合同优先。
|
|
31
|
+
|
|
32
|
+
声音采用 `native-first`:先选同时满足画面引用和 `video.native-audio` 的 StarRouter 模型,原生生成对白、电影感旁白、环境声和动作声;BGM 走独立配乐与许可证流程。项目已确认固定 `voice_id` 时默认走原生绑定,只有实时能力明确返回不支持该 voice reference 时才停在声音方案确认并分流,不静默改用其他音色。每个原生声候选必须完成 `speech_intelligibility`、`speaker_identity`、`narration_performance`、`ambience_action_sync`、`lip_sync`、`technical_audio`、`undeclared_music` 七维审核;失败时把受控 reason 和证据写入 `native_audio_exception`。能力返回不支持的自定义音色、七维后配和口型驱动能力不得伪装成可用,也不得用旧厂商自动补做。
|
|
58
33
|
|
|
59
34
|
媒体能力按 `character-appeal → continuity-plan → previous-tail → native-audio → native-audio-review → licensed-music → local-media-editing → delivery` 推进。previous-tail 是有前置证据的可选节点;历史状态机中的 audio-fallback、lip-sync 和 video-upscale 节点目前禁用,不能为了填满流程伪造任务或切到旧厂商。
|
|
60
35
|
|
|
61
|
-
配乐分为 `music.generate` 与 `music.catalog
|
|
36
|
+
配乐分为 `music.generate` 与 `music.catalog`。生成曲使用 `music-generate` 画布节点;目录曲只返回已授权结果或 Pixabay、YouTube Audio Library、Uppbeat 官方搜索页,不自动登录或下载。用户试听并取得文件与许可证证据后,先写不可变许可证收据,再登记未选音频候选。audio-plan 绑定精确资产、许可证收据与项目用途,时间线再次验证选版和 allowed uses;普通视频页面、无同步权与母带权凭证的热曲不能进入资产库。
|
|
37
|
+
|
|
38
|
+
## 人物与分镜
|
|
62
39
|
|
|
63
|
-
|
|
40
|
+
剧本阶段必须绑定实际分集剧本版本;人物分析必须绑定已选人物档案。人物链路固定为:年龄证据 → `audience_appeal` 校验 → 人物定妆候选 → 人物专项审核与选版 → 分镜/白模/正式视频引用绑定 → 跨镜一致性复核。明确成年人物使用 `adult-charisma`,必须有专属 `grooming_and_makeup`、`costume_signature` 和角色级 `memory_anchors`;儿童只使用 `child-cuteness`,任何成人化或性化处理都是不可由总分抵消的硬失败。未知年龄停在人物档案阶段。正式视频人物引用还要通过档案 SHA、appearance 与可见身份约束校验。
|
|
64
41
|
|
|
65
42
|
每个镜头由 Agent 根据 `storyboard_strategy` 选择一种或多种独立参考板,分别选版并完成对应审计。原创项目默认从单幅分镜图或一种板型开始;只有复杂路线、多人交互、精确接触、轴线风险或连续运镜需要同时表达多种信息时才追加其他板型或 Blender 白模。Blender 不能替代已选择的分镜参考。
|
|
66
43
|
|
|
67
|
-
选择 Blender
|
|
44
|
+
选择 Blender 的镜头先写入白模导演合同,再生成白模参考,登记、完整观看、按七项 100 分合同验收并选版;总分低于 85 或任一单项低于 70% 时不得提交正式视频。已选分镜板和白模都不能替代正式视频所需的人物、场景和道具资产。
|
|
68
45
|
|
|
69
|
-
结构化分镜与制作计划批准后,由 `plan-shot-continuity`
|
|
46
|
+
结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总已选分镜、导演本和制作计划,生成并显式选定连续性计划新版本。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。不同组可并行、同组串行,一次只生成各组当前前沿镜头。后续已选分镜板或白模若暴露冲突,必须回退生成连续性计划新版本。previous-tail 从上一镜当前已选且已审核的视频派生下一镜首帧,正式提交前再次比对来源版本和 SHA-256。
|
|
70
47
|
|
|
71
|
-
|
|
48
|
+
资产计划中的人物、场景或道具若已有已选、未失效且来源合规的版本,可直接复用;缺失、失效或来源不足时,动态要求对应生成模块,防止未登记资产绕过阶段门禁。
|
|
72
49
|
|
|
73
|
-
|
|
50
|
+
## 提示词与校验
|
|
74
51
|
|
|
75
|
-
|
|
52
|
+
Codex 按 [Codex 原生合同](codex-contracts.md) 直接执行提示词合同,完成后保存输入与实际产物;只有 `provider_prompts` 中的模板才编译为媒体模型提示词。视频提示词先形成模型无关的镜头事实,再由同一模块编译为 `seedance2`、`h3` 或已确认的 `generic` 协议,禁止跨协议混写。
|
|
76
53
|
|
|
77
|
-
|
|
54
|
+
校验使用 `ai-short-studio canvas documents` 和 `canvas workflow status` 核对项目配置、文档版本、选版、资产 provenance、文件存在性和 SHA-256。Skill 自身完整性检查只读取随包内容,不读取外部项目仓库。
|
|
78
55
|
|
|
79
|
-
|
|
80
|
-
使用 `node scripts/validate-project.mjs <项目目录>` 校验实际项目配置、目录、命名、来源、选版、资产 provenance、文件存在性和 SHA-256。
|
|
81
|
-
# 源时间线情感配音
|
|
56
|
+
## 源时间线情感配音
|
|
82
57
|
|
|
83
|
-
独立配音固定经过
|
|
58
|
+
独立配音固定经过 `已选原声资产 → 语音时序候选 → 人工复核 timing → audio-plan 三层合同 → 最多三轮编译生成 → 最终 alignment → 八维审核选版 → 字幕/口型/剪辑同源绑定`。行级 ASR 自动通过阈值为 `0.90`,词级为 `0.80`;StarRouter 词级时间戳只接受 `verbose_json + timestamp_granularities=word`,低置信证据不得静默补造。第二轮校准语速钳制在 `0.85–1.15` 后必须实际执行;最终后处理只允许合同内停顿和 `±3%` tempo,容器时长不能替代发声边界。硬门禁比较首词起点和末词终点是否都在一帧内,内部词边界保留为节奏审计证据。换选音频会递归失效旧字幕和口型派生资产。
|
|
84
59
|
|
|
85
|
-
|
|
60
|
+
当前新制作已禁用七维后配和口型驱动;历史配音项目验收必须对一个真实镜头完整听看原声与配音,生成项目内 A/B 报告,并重新核对媒体 SHA、可解码音视频流、当前选版、已完成任务、正整数制作耗时、八维完整复听、词级误差、字幕和口型绑定。
|
|
@@ -1,78 +1,24 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
本规范是插件创建、继续、复制和校验短剧项目的唯一文件合同。文本资产由 Codex 通过 `short-drama` 主 Skill 加载当前 reference 模块后直接输出;图片、视频和音频才调用用户选择的 Provider。项目文件不得包含 API Key、Token、密码或 Authorization。
|
|
4
|
-
|
|
5
|
-
## 固定目录
|
|
6
|
-
|
|
7
|
-
```text
|
|
8
|
-
<project>/
|
|
9
|
-
├── .short-drama/
|
|
10
|
-
│ ├── project.json
|
|
11
|
-
│ ├── state.json
|
|
12
|
-
│ ├── environment.json
|
|
13
|
-
│ ├── environment/<timestamp>-<mode>.json
|
|
14
|
-
│ ├── module-runs.json
|
|
15
|
-
│ ├── RESUME.md
|
|
16
|
-
│ ├── prompt-runs/prompt-<uuid>.json
|
|
17
|
-
│ ├── evidence/<stage>-<uuid>.json
|
|
18
|
-
│ ├── requests/req-<uuid>.json
|
|
19
|
-
│ ├── uploads/upload-<uuid>.json
|
|
20
|
-
│ ├── source-analysis.json
|
|
21
|
-
│ ├── brief.json
|
|
22
|
-
│ ├── bible.json
|
|
23
|
-
│ ├── outline.json
|
|
24
|
-
│ ├── art-style.json
|
|
25
|
-
│ ├── assets.json
|
|
26
|
-
│ ├── tasks.json
|
|
27
|
-
│ └── shot-reviews.json
|
|
28
|
-
├── source/
|
|
29
|
-
│ ├── manifest.json
|
|
30
|
-
│ └── src-<name>/v001.<ext>
|
|
31
|
-
├── episodes/ep-001/
|
|
32
|
-
│ ├── episode.json
|
|
33
|
-
│ ├── scripts/v001.(md|txt|json)
|
|
34
|
-
│ ├── script-review/v001.json
|
|
35
|
-
│ ├── director-book/v001.json
|
|
36
|
-
│ ├── asset-plan/v001.json
|
|
37
|
-
│ ├── storyboard/v001.json
|
|
38
|
-
│ ├── production-plan/v001.json
|
|
39
|
-
│ ├── previz/shot-001-v001.json
|
|
40
|
-
│ ├── video-prompts/v001.json
|
|
41
|
-
│ ├── audio-plan/v001.json
|
|
42
|
-
├── assets/{characters,scenes,props,storyboards,audio,videos,other}/<asset-key>/v001.<ext>
|
|
43
|
-
├── editing/ep-001/{timeline.json,review.json}
|
|
44
|
-
└── delivery/ep-001/{final.mp4,final.srt,final.ass,manifest.json}
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
用户未明确指定其他绝对路径时,新项目统一位于 `~/darma_project/<project-key>`;Dashboard 与 `project-store.mjs init <相对项目目录>` 使用同一默认根目录。新项目还会在项目根创建 `AGENTS.md` 作为 Codex 的项目级恢复入口;若目录已有用户自己的 `AGENTS.md`,初始化不会覆盖。默认目录和自定义绝对目录在初始化完成后都会自动打开对应项目 Dashboard。更换会话时只要从项目根或其子目录打开任务,SessionStart hook 会向上定位 `.short-drama/project.json`、恢复阶段并在 startup/resume 打开对应项目路由;compact 只恢复上下文,不重复开窗。从无关目录打开时必须显式给出项目路径。不要建立跨项目全局记忆,避免旧选版、旧 Provider 或旧阶段污染当前项目。
|
|
48
|
-
|
|
49
|
-
初始化必须原子创建 `assets.json`、`tasks.json`、`shot-reviews.json` 与 `module-runs.json` 空账本。`format.resolution` 使用“宽x高”,方向必须与 `aspect_ratio` 一致;Provider、模型和 `parameters` 必须通过已注册目录校验。更新 Provider 参数时整组替换,不能残留上一模型字段。
|
|
50
|
-
|
|
51
|
-
每个版本目录通过 `selected.json` 指向当前入选版本。版本文件不可覆盖;剧本初稿、Humanizer 成稿和后续修改依次产生新版本。`script-review` 必须记录并匹配当前 selected 剧本版本,批准后才允许进入导演本。剪辑、审片和交付必须按 `ep-NNN` 分集保存,禁止多集共用 timeline 或 manifest。复制项目时保留相对路径,删除 `.short-drama/tasks.json` 中仍在运行的外部任务前必须先核对 Provider 状态。
|
|
52
|
-
|
|
53
|
-
资产计划包含人物时,必须先由 `generate-character-profiles` 生成并确认 `assets/characters/profiles.json`;计划中的每个规范人物名都必须存在于人物档案,不能用资产计划本身冒充人物档案执行证据。
|
|
54
|
-
|
|
55
|
-
`module-runs.json` 记录每个阶段实际执行的 reference 模块、模块哈希、输入、项目内证据及 `prompt-runs`。用 `module-runs.mjs required` 获取当前阶段要求,由主 Skill 完整读取对应 reference、运行 Codex 合同或 Provider 提示词并完成产物后,再用 `record` 登记。模块、输入、证据或提示词运行记录变化后必须重新执行并登记;旧 `skill-runs.json` 只能由 `module-runs.mjs migrate` 读取迁移。`workflow.mjs <check|advance|complete>` 会重新检查全部已完成阶段。
|
|
1
|
+
# 短剧项目规范 v1
|
|
56
2
|
|
|
57
|
-
|
|
3
|
+
本规范是短剧项目内容、命名、版本和校验的唯一合同。文本资产由 Codex 通过 `short-drama` 主 Skill 加载当前 reference 模块后直接输出;图片、视频和音频才调用用户选择的 Provider。项目、画布文档、资产版本和审核记录不得包含 API Key、Token、密码或 Authorization。
|
|
58
4
|
|
|
59
|
-
##
|
|
5
|
+
## 事实来源
|
|
60
6
|
|
|
61
|
-
|
|
7
|
+
AI Short Studio 项目和分集画布是唯一事实来源。不要创建本地 `.short-drama/` 第二套项目状态,也不要把本文中的 JSON 示例当成必须落盘的本地文件。
|
|
62
8
|
|
|
63
|
-
|
|
9
|
+
| 内容 | CLI 入口 |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| 项目、语言、画幅和创作配置 | `project create`、`project update`、`project get`、`canvas settings get/set` |
|
|
12
|
+
| 分集、剧本、导演本、资产计划、分镜、制作计划、连续性、视频提示词 | `canvas document save/get`、`canvas documents` |
|
|
13
|
+
| 审核记录、模块执行证据、阶段结论 | `canvas document save --schema-key canvas.review.v1` |
|
|
14
|
+
| 图片、视频、音频和媒体变换产物 | `canvas asset upload/select-version/download`、`canvas asset list/get` |
|
|
15
|
+
| 生成任务和付费请求范围 | `canvas node run`、`task list/get/wait` |
|
|
64
16
|
|
|
65
|
-
|
|
17
|
+
文档版本使用 `canvas.<module>.v1`,审核使用 `canvas.review.v1`;每次保存都追加不可变版本,并用 `--input` 固化上游选版。不要覆盖旧版本,也不要手工伪造完成标记。
|
|
66
18
|
|
|
67
|
-
|
|
19
|
+
## 项目配置合同
|
|
68
20
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
`.short-drama/tasks.json` 中每个任务必须包含 `requestPath`、`requestSha256` 和 `inputFingerprint`。生成资产只能绑定已完成任务,任务的 `outputVersionId` 必须指回该资产版本;请求、任务和 provenance 的目标、模态、Provider、模型、提示词文档、参数及视频参考素材版本必须一致。项目校验会重新核对这条完整证据链、请求文件 SHA-256 和密钥字段。API Key、Token、Authorization、密码、Secret 或超过 1MB 的内联媒体不得写入请求快照。
|
|
72
|
-
|
|
73
|
-
## `project.json`
|
|
74
|
-
|
|
75
|
-
初始化元数据和落盘配置使用相同的 snake_case 结构;`createdAt`、`updatedAt` 由脚本生成,初始化输入省略:
|
|
21
|
+
项目配置使用 snake_case 业务字段。项目 key 创建后不可变;未确认的可选值写 `null`,不删除字段,也不使用示例值代替用户决策。
|
|
76
22
|
|
|
77
23
|
```json
|
|
78
24
|
{
|
|
@@ -113,21 +59,71 @@
|
|
|
113
59
|
"default_panel_grid_size": 4,
|
|
114
60
|
"preferred_medium": "blender"
|
|
115
61
|
},
|
|
116
|
-
"
|
|
117
|
-
"
|
|
118
|
-
"
|
|
119
|
-
"
|
|
120
|
-
"
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
62
|
+
"canvas_settings": {
|
|
63
|
+
"artStyle": "system-realistic",
|
|
64
|
+
"visualBible": { "version": 1, "palette": {}, "baseline": {}, "lighting": {}, "narrative_arc": [], "motion_language": {}, "negative_constraints": [] },
|
|
65
|
+
"aspectRatio": "9:16",
|
|
66
|
+
"storyboardGridSize": 4,
|
|
67
|
+
"storyboardImageType": "grid",
|
|
68
|
+
"outputLanguage": "zh-CN",
|
|
69
|
+
"analysisModel": null,
|
|
70
|
+
"imageModel": null,
|
|
71
|
+
"imageResolution": null,
|
|
72
|
+
"imageQuality": null,
|
|
73
|
+
"editModel": null,
|
|
74
|
+
"videoModel": null,
|
|
75
|
+
"videoPromptType": null,
|
|
76
|
+
"videoResolution": null,
|
|
77
|
+
"audioModel": null,
|
|
78
|
+
"musicModel": null
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
`format.resolution` 使用“宽x高”,方向必须与 `aspect_ratio` 一致。项目配置里的 snake_case 是业务描述,真正写入服务端的是 `canvas settings set` 的 camelCase 字段:`creative.art_style.id` 对应 `artStyle`,`creative.art_style.visualBible` 对应 `visualBible`,`format.aspect_ratio` 对应 `aspectRatio`,`languages.output` 对应 `outputLanguage`,`storyboard.default_panel_grid_size` 对应 `storyboardGridSize`(可选 4/6/9/16/25)。`storyboard.type` 是制作层的逐镜板型选择(`single`、`storyboard`、`shot-board`),与设置的 `storyboardImageType`(只允许 `grid` 或 `storyboard`)不是同一枚举;设置只提供执行器默认值,具体板型仍由制作计划逐镜决定。模型字段 `analysisModel`、`imageModel`、`editModel`、`videoModel`、`audioModel`、`musicModel` 只能填写实时模型目录返回的 `modelKey`(例如 `starrouter::...`),`videoPromptType` 只能是 `h3` 或 `seedance`;模型不存在或未启用时 `canvas settings set` 直接失败。`project create` 只接受名称、描述和语言,其余设置必须在项目创建后通过 `canvas settings set` 写入。同一项目里重复出现的业务字段与设置字段只允许一份真实值,以 `canvas settings get` 回读结果为准,不得另存一套本地配置。切换模型后旧模型的参数不保留,必须重新确认完整能力参数。项目语言在创建后固定,画布只读;`--locale` 只影响界面,不改变内容语言。
|
|
84
|
+
|
|
85
|
+
`automation_mode` 控制项目后续操作的确认策略,默认值为 `true`。开启后,Codex/agent 只能在用户已确认且内容未变化的范围内自动继续选版、批量请求和重试;不得替用户确认创作配置、模型/厂商、付费请求范围、候选资产或剧情变更。仍须展示制作计划且不计算具体价格,并满足阶段门禁、权限、素材权利和安全校验。缺少这些依据时必须停下。设置为 `false` 时恢复逐项确认。
|
|
86
|
+
|
|
87
|
+
未确认的可选值写 `null`,不删除字段。新项目画风默认使用 `system-realistic` 完整预设,分镜默认使用 `shot-board`(分镜板)和 4 格;用户可在资产生成前修改。制作计划仍须逐镜在 `single`(单图)、`storyboard`(故事版)和 `shot-board`(分镜板)之间判断,项目默认值只作回退。
|
|
88
|
+
|
|
89
|
+
## 分集文档合同
|
|
90
|
+
|
|
91
|
+
分集元数据至少包含以下字段,保存为对应分集画布文档:
|
|
92
|
+
|
|
93
|
+
```json
|
|
94
|
+
{
|
|
95
|
+
"key": "ep-001",
|
|
96
|
+
"order": 1,
|
|
97
|
+
"title": "第一集",
|
|
98
|
+
"logline": null,
|
|
99
|
+
"target_duration_seconds": 90,
|
|
100
|
+
"status": "draft"
|
|
124
101
|
}
|
|
125
102
|
```
|
|
126
103
|
|
|
127
|
-
`
|
|
104
|
+
`status` 只能是 `draft`、`approved`、`in-production`、`completed`。`project.format.episode_duration_seconds` 与分集的 `target_duration_seconds` 都表示策划目标,不是要求成片精确卡秒的硬截止。默认实际成片可在目标值约 ±15% 内自然浮动;超过该范围需要记录叙事原因并重新请用户确认。平台明确规定最大时长时,以平台上限为硬约束。
|
|
105
|
+
|
|
106
|
+
资产计划包含人物时,必须先由 `generate-character-profiles` 生成并确认人物档案;计划中的每个规范人物名都必须存在于人物档案,不能用资产计划本身冒充人物档案执行证据。
|
|
107
|
+
|
|
108
|
+
选中新的来源、剧本、导演本、资产计划、分镜、制作计划、视频提示词或媒体版本,以及更新项目创作/Provider 配置、时间线或完整审片时,必须回退到最早受影响阶段,并让该阶段及之后的下游文档和审核证据失效。新文档版本及其 `--input` 必须晚于失效时间;历史版本只供审计,不能重放为当前证据。交付完成后用 `canvas workflow status` 确认终态。
|
|
109
|
+
|
|
110
|
+
## 生成请求与输入固化
|
|
111
|
+
|
|
112
|
+
文本资产不调用文本模型。Codex 按当前 reference 模块与 [Codex 原生合同](codex-contracts.md) 直接制作,完成后把合同、合同哈希、完整变量、解析后的约束、实际产物和产物哈希保存为新的文档版本。合同必须由主 Skill 在当前模块中明确选择;只有 `module-map.json` 登记的 `provider_prompts` 能编译为媒体模型提示词。
|
|
113
|
+
|
|
114
|
+
图片、音频和视频提交前必须核对:
|
|
128
115
|
|
|
116
|
+
- 目标镜号、模型/工作流、提示词正文、profile、输入模式、时长和参考素材清单;
|
|
117
|
+
- 参考资产仍是已选版本,且用途、顺序、人物身份绑定和来源哈希一致;
|
|
118
|
+
- 已选分镜、制作计划、连续性和音频计划没有未决项;
|
|
119
|
+
- Provider、模型和项目级 `parameters` 与已确认配置一致;
|
|
120
|
+
- 本次请求在用户已确认的付费范围内。
|
|
129
121
|
|
|
130
|
-
|
|
122
|
+
媒体请求保存实际提交给生成适配器的完整参数并计算稳定输入指纹;同一节点同一输入指纹只允许一个在途任务。失败或中断请求保留证据;提交超时可能表示上游已创建任务,先查询原任务,不自动重复提交。
|
|
123
|
+
|
|
124
|
+
正式生成图片分别引用当前资产计划的资产 key 或分镜的镜号,音频逐句引用当前音频计划的 `line_index`;入口在付费前核对选版、批准状态、提示词正文、逐字台词和音色绑定。仅 `other-*` 辅助图允许没有独立制作文档。
|
|
125
|
+
|
|
126
|
+
交付 manifest 除成片、SRT、ASS 的相对路径、大小与 SHA-256 外,还应固定记录时间线和已批准审片记录的路径、大小与 SHA-256。任一输入或交付文件变化都会使交付门禁失败,必须重新审片并生成新的交付版本。
|
|
131
127
|
|
|
132
128
|
## 命名
|
|
133
129
|
|
|
@@ -147,71 +143,35 @@
|
|
|
147
143
|
|
|
148
144
|
key 表示稳定身份,名称、描述和文件可以更新,key 不随版本变化。
|
|
149
145
|
|
|
150
|
-
## `episode.json`
|
|
151
|
-
|
|
152
|
-
```json
|
|
153
|
-
{
|
|
154
|
-
"key": "ep-001",
|
|
155
|
-
"order": 1,
|
|
156
|
-
"title": "第一集",
|
|
157
|
-
"logline": null,
|
|
158
|
-
"target_duration_seconds": 90,
|
|
159
|
-
"status": "draft",
|
|
160
|
-
"createdAt": "2026-01-01T00:00:00.000Z",
|
|
161
|
-
"updatedAt": "2026-01-01T00:00:00.000Z"
|
|
162
|
-
}
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
`status` 只能是 `draft`、`approved`、`in-production`、`completed`。
|
|
166
|
-
|
|
167
|
-
`project.format.episode_duration_seconds` 与 `episode.target_duration_seconds` 都表示策划目标,不是要求成片精确卡秒的硬截止。默认实际成片可在目标值约 ±15% 内自然浮动;超过该范围需要记录叙事原因并重新请用户确认。平台明确规定最大时长时,以平台上限为硬约束。
|
|
168
|
-
|
|
169
146
|
## 来源与媒体版本
|
|
170
147
|
|
|
171
|
-
|
|
148
|
+
原始资料通过 `canvas asset upload` 或项目来源文档保存,并登记来源名称、版本和 SHA-256。原创短剧文本来源支持 txt、md、json、pdf、docx、epub;参考片复刻使用 [复刻知识问答](recreation/recreation-qa.md) 中的画布节点。分析文档通过 `src-xxx@v001` 引用,不保存原机器绝对路径。
|
|
172
149
|
|
|
173
|
-
|
|
150
|
+
每个画布资产版本必须携带或可追溯。以下字段名与画布资产版本一致:`version`、`modelKey`、`sourceTaskId`、`generationParams` 由服务端保存,`media.sha256`、`media.sizeBytes` 和 `media.mimeType` 来自媒体对象:
|
|
174
151
|
|
|
175
152
|
```json
|
|
176
153
|
{
|
|
177
|
-
"
|
|
178
|
-
"
|
|
179
|
-
"
|
|
180
|
-
"
|
|
181
|
-
"
|
|
154
|
+
"version": 1,
|
|
155
|
+
"assetKey": "shot-ep001-001",
|
|
156
|
+
"modelKey": "starrouter::dreamina-seedance-2-0-260128",
|
|
157
|
+
"sourceTaskId": "remote-task-id",
|
|
158
|
+
"media": { "sha256": "...", "sizeBytes": 12345678, "mimeType": "video/mp4" },
|
|
159
|
+
"generationParams": {
|
|
182
160
|
"origin": "generated",
|
|
183
|
-
"
|
|
184
|
-
"
|
|
185
|
-
"
|
|
186
|
-
"task_id": "remote-task-id",
|
|
187
|
-
"prompt_document": { "episode_key": "ep-001", "version_id": "v001", "shot_number": 1 },
|
|
188
|
-
"source_assets": [{ "key": "board-ep001-shot001", "version_id": "v001" }],
|
|
161
|
+
"createdBy": "provider",
|
|
162
|
+
"promptDocument": { "episodeKey": "ep-001", "versionId": "v001", "shotNumber": 1 },
|
|
163
|
+
"sourceAssets": [{ "key": "board-ep001-shot001", "versionId": "v001" }],
|
|
189
164
|
"parameters": { "duration": 5, "resolution": "1080p", "ratio": "9:16" }
|
|
190
|
-
}
|
|
191
|
-
"createdAt": "2026-01-01T00:00:00.000Z"
|
|
165
|
+
}
|
|
192
166
|
}
|
|
193
167
|
```
|
|
194
168
|
|
|
195
|
-
`origin` 只能是 `imported`、`generated`、`transformed`。Provider 新生成和生成式改图分别使用 `generated`、`transformed
|
|
196
|
-
|
|
197
|
-
资产记录可包含 `staleVersionIds`。项目画风变化时,人物、场景、道具、故事板和视频的既有版本会自动加入该集合并取消选版;已失效版本不能再次选择或通过阶段门禁。重新生成或重新导入应创建新 `vNNN`,不得清除旧版本的失效事实。
|
|
169
|
+
`origin` 只能是 `imported`、`generated`、`transformed`。Provider 新生成和生成式改图分别使用 `generated`、`transformed`,两者都必须在画布资产版本上记录 `modelKey`、`sourceTaskId` 和制作文档引用;本地确定性变换使用 `transformed` + `createdBy=codex` 并记录源资产版本,不伪造远程任务。`canvas asset upload` 只上传媒体文件,不带模型信息;生成类资产版本由画布生成节点写入上述字段。所有引用都使用稳定 key 与明确版本。
|
|
198
170
|
|
|
199
|
-
|
|
171
|
+
画风变化时,人物、场景、道具、故事板和视频的既有版本必须标记失效并取消选版;已失效版本不能再次选择或通过阶段门禁。重新生成或重新导入应创建新 `vNNN`,不得清除旧版本的失效事实。
|
|
200
172
|
|
|
201
|
-
|
|
202
|
-
node scripts/project-store.mjs init <项目目录> <项目元数据.json>
|
|
203
|
-
node scripts/project-store.mjs put-source <项目目录> src-original-novel v001 <原文文件>
|
|
204
|
-
node scripts/project-store.mjs select-source <项目目录> src-original-novel v001
|
|
205
|
-
node scripts/project-store.mjs migrate-project-layout <项目目录> ep-001
|
|
206
|
-
node scripts/preflight.mjs <init|media|editing> <项目目录>
|
|
207
|
-
node scripts/render-prompt.mjs --template <合同> --vars <变量.json> --codex-output <实际产物> --project-root <项目目录>
|
|
208
|
-
node scripts/render-prompt.mjs --template <媒体模板> --vars <变量.json> --output <提示词文件> --project-root <项目目录>
|
|
209
|
-
# 已确认重渲染时可追加 --force;不会覆盖 prompt-runs 留痕
|
|
210
|
-
node scripts/snapshot-stage-evidence.mjs <项目目录> <asset-generation|media-production>
|
|
211
|
-
node scripts/validate-project.mjs <项目目录>
|
|
212
|
-
node scripts/workflow.mjs complete <项目目录>
|
|
213
|
-
```
|
|
173
|
+
## 校验
|
|
214
174
|
|
|
215
|
-
|
|
175
|
+
生成前运行 `ai-short-studio preflight --json`,按项目实际选定的 Provider 逐一检查配置和连通性,不以“任意 Provider 有凭据”代替。报告只保存布尔检查结果,不保存凭据。
|
|
216
176
|
|
|
217
|
-
|
|
177
|
+
使用 `ai-short-studio canvas documents` 和 `canvas workflow status` 校验实际项目配置、文档版本、来源、选版、资产 provenance、文件存在性和 SHA-256。旧版本地文件或无 provenance 资产不会被静默改名或伪造来源,必须人工核对后重新登记为新的画布资产版本。
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
## Workflow
|
|
4
4
|
|
|
5
5
|
1. Identify the input mode: T2VA, I2VA, FL2VA, L2VA, or full-reference Ref2VA.
|
|
6
|
-
2. For base text/keyframe modes, read
|
|
7
|
-
3. For full-reference mode, read
|
|
6
|
+
2. For base text/keyframe modes, read [H3 基础模式示例](examples/h3-base-prompt-writing.md) and follow its final prompt structure.
|
|
7
|
+
3. For full-reference mode, read [H3 全参考模式示例](examples/h3-reference-prompt-writing.md) and follow its six-section rewrite format.
|
|
8
8
|
4. Preserve the exact field names, section order, labels, and timing notation from the selected guide.
|
|
9
9
|
|
|
10
10
|
## Base Modes
|
|
@@ -14,13 +14,13 @@
|
|
|
14
14
|
- FL2VA: describe the continuous path between the first and last frames.
|
|
15
15
|
- L2VA: infer a plausible opening and converge to the supplied last frame.
|
|
16
16
|
|
|
17
|
-
Use `integrated_multimodal_description`, `overall_soundscape`, and `non_diegetic_music` in the order shown in
|
|
17
|
+
Use `integrated_multimodal_description`, `overall_soundscape`, and `non_diegetic_music` in the order shown in [H3 基础模式示例](examples/h3-base-prompt-writing.md).
|
|
18
18
|
|
|
19
19
|
## Full-Reference Mode
|
|
20
20
|
|
|
21
21
|
Ref2VA rewrites use `subject_definitions`, `summary`, `retention_analysis`, `detailed_description`, `overall_soundscape`, and `non_diegetic_music` in that order. Reference labels stay consistent across all sections.
|
|
22
22
|
|
|
23
|
-
Read
|
|
23
|
+
Read [H3 全参考模式示例](examples/h3-reference-prompt-writing.md) for label rules, retention analysis, and complete examples.
|
|
24
24
|
|
|
25
25
|
## Routing Guard
|
|
26
26
|
|