@aswless_854771076/ai_short_studio_cli 0.1.156 → 0.1.158

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/README.md +1 -1
  2. package/dist/commands/canvas/document/get.js +3 -3
  3. package/dist/commands/canvas/document/save.js +8 -2
  4. package/dist/commands/canvas/documents.js +1 -1
  5. package/dist/commands/canvas/workflow/status.js +1 -1
  6. package/dist/domain/canvas-schema-key.d.ts +2 -0
  7. package/dist/domain/canvas-schema-key.js +21 -0
  8. package/dist/domain/vvicat-api.js +1 -1
  9. package/package.json +1 -1
  10. package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +24 -24
  11. package/skills/using-vvicat-ai-short-studio-cli/references/agent-recovery.md +1 -1
  12. package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +11 -0
  13. package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +25 -5
  14. package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/SOURCE.md +9 -0
  15. package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md +408 -5
  16. package/skills/using-vvicat-ai-short-studio-cli/references/project-and-canvas.md +1 -1
  17. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +17 -31
  18. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +2 -2
  19. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles.md +2 -2
  20. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +3 -3
  21. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +2 -2
  22. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +2 -2
  23. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-art-styles.md +3 -3
  24. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-assets.md +4 -4
  25. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.en.txt +1 -1
  26. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.zh.txt +1 -1
  27. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.en.txt +1 -1
  28. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/plan-drama-assets.md +2 -2
  29. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +3 -3
  30. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/analyze-drama-source.md +2 -2
  31. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/define-drama-brief.md +1 -2
  32. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/design-drama-bible.md +1 -1
  33. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +4 -4
  34. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/outline-drama-series.md +1 -1
  35. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/short-drama.md +1 -1
  36. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-director-book.md +1 -2
  37. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-episode.md +1 -2
  38. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-deliver-drama.md +2 -2
  39. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +4 -5
  40. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/remotion-best-practices.md +4 -5
  41. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +8 -8
  42. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +25 -25
  43. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +5 -11
  44. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/design-drama-audio.md +4 -2
  45. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +6 -6
  46. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +4 -4
  47. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +3 -3
  48. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/monitor-drama-tasks.md +9 -7
  49. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +2 -2
  50. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +9 -8
  51. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md +8 -8
  52. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json +1 -1
  53. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md +1 -1
  54. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/README.md +59 -0
  55. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.mjs +517 -0
  56. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.test.mjs +354 -0
  57. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.mjs +188 -0
  58. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.test.mjs +218 -0
  59. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.mjs +458 -0
  60. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.test.mjs +236 -0
  61. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/report.mjs +69 -0
  62. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.mjs +341 -0
  63. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.test.mjs +302 -0
  64. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +43 -133
  65. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/music-catalog-providers.md +3 -3
  66. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/manage-drama-projects.md +5 -5
  67. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +7 -8
  68. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/recover-drama-pipeline.md +1 -1
  69. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +7 -7
  70. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +4 -6
  71. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +40 -65
  72. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +91 -131
  73. package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/h3-prompt-writing.md +4 -4
  74. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +186 -0
  75. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +64 -0
  76. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +2 -2
  77. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/recreation-qa.md +87 -0
  78. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md +2 -2
  79. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +6 -6
  80. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +1 -3
  81. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +0 -4
  82. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +1 -1
  83. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +1 -1
  84. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/generate-blender-previz.md +5 -10
  85. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +2 -6
  86. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +4 -4
  87. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +28 -70
  88. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +0 -447
  89. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/brief.md +0 -93
  90. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/project-files.md +0 -246
  91. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/reference-video.md +0 -266
  92. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/script-and-time.md +0 -253
  93. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/transformations.md +0 -141
  94. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/distribution.md +0 -176
  95. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/local-tools.md +0 -411
  96. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/model-and-provider.md +0 -275
  97. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/profile.md +0 -286
  98. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/asset-and-shot-preproduction.md +0 -193
  99. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/b-roll.md +0 -94
  100. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/caption-tracking.md +0 -125
  101. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/captions.md +0 -252
  102. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/conversation-images.md +0 -218
  103. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/image-direction.md +0 -123
  104. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/generated-dependencies.md +0 -38
  105. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/graphic-compositions.md +0 -85
  106. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/image-direction.md +0 -95
  107. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/motion-graphics.md +0 -68
  108. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/recreation-policy.md +0 -51
  109. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/screen-demonstrations.md +0 -51
  110. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/shot-production-contracts.md +0 -161
  111. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/sound-mix.md +0 -76
  112. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/video-direction.md +0 -433
  113. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-and-performance.md +0 -224
  114. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-direction.md +0 -99
  115. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/narration-led-demo.md +0 -87
  116. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/presenter-led-explainer.md +0 -160
  117. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/ranking-listicle.md +0 -71
  118. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +0 -19
  119. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama-workflow.md +0 -165
  120. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama.md +0 -88
  121. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/street-interview.md +0 -92
  122. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/talking-head.md +0 -82
  123. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/two-person-podcast.md +0 -101
  124. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/index.md +0 -77
  125. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/audio-presentation.md +0 -49
  126. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/authoring.md +0 -228
  127. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/browser-capture.md +0 -112
  128. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/builds.md +0 -330
  129. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-authoring.md +0 -156
  130. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-presentation.md +0 -66
  131. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-design.md +0 -217
  132. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-sharing.md +0 -150
  133. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-visuals.md +0 -152
  134. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/detail.svrun +0 -8
  135. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/direction.svs +0 -14
  136. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/look.svs +0 -6
  137. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/material.svrun +0 -5
  138. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svml +0 -73
  139. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svrun +0 -5
  140. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/visuals.ts +0 -62
  141. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/fonts-and-text.md +0 -138
  142. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/image-operations.md +0 -102
  143. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/index.md +0 -73
  144. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media-presentation.md +0 -111
  145. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media.md +0 -246
  146. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/performance.md +0 -114
  147. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/prompt-kits.md +0 -165
  148. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/rendering.md +0 -141
  149. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/review.md +0 -211
  150. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/runs.md +0 -151
  151. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/script-syntax.md +0 -236
  152. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/snapshots.md +0 -90
  153. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/sound.md +0 -75
  154. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/source-syntax.md +0 -163
  155. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/spatial.md +0 -189
  156. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio-companions.md +0 -186
  157. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio.md +0 -249
  158. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/system.md +0 -169
  159. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timeline.md +0 -74
  160. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timing.md +0 -96
  161. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/track-authoring.md +0 -215
  162. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/tracks.md +0 -67
  163. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/video-downloads.md +0 -47
  164. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/vocabulary.md +0 -119
  165. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/README.md +0 -11
  166. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/comfly-provider.md +0 -12
  167. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/seedance-community-skills.md +0 -23
  168. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/publish-drama-references/litterbox.md +0 -5
  169. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/runninghub-provider.md +0 -33
  170. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/starrouter-provider.md +0 -53
  171. package/skills/using-vvicat-ai-short-studio-cli/references/video-model-routing.md +0 -10
  172. package/skills/using-vvicat-ai-short-studio-cli/references/video-prompt-spec.md +0 -32
  173. /package/skills/using-vvicat-ai-short-studio-cli/references/{short-drama/assets/modules/humanizer → humanizer}/LICENSE +0 -0
  174. /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-base-prompt-writing.md +0 -0
  175. /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
- 短剧插件只提供原创短剧状态机;参考片复刻统一使用原生 Hypit 复刻链路。旧复刻项目由插件阻止并提示迁移。
8
-
9
- 市场调研和市场灵感位于正式状态机之外,是 `analysis` 前或过程中按需使用的辅助输入,不是所有项目的必经阶段。工作区级 `.short-drama-market/` 保存公开榜单快照和 `market-report.v2`;只有用户明确选择灵感后,项目内才保存 `market-inspiration.v1` 并由 Brief 引用。
10
-
11
- 所有状态、文本、分镜和媒体都以用户指定的本地项目目录为事实来源,不调用或回写任何业务系统 API。
12
-
13
- ```text
14
- <project>/
15
- ├── .short-drama/
16
- │ ├── project.json
17
- │ ├── state.json
18
- │ ├── environment.json / RESUME.md
19
- │ ├── module-runs.json
20
- │ ├── prompt-runs/<prompt-run-id>.json
21
- │ ├── requests/<request-id>.json
22
- │ ├── uploads/<upload-receipt-id>.json
23
- │ ├── source-analysis.json / brief.json / market-inspiration.json
24
- │ ├── bible.json / outline.json
25
- │ ├── assets.json
26
- │ ├── shot-reviews.json
27
- │ └── tasks.json
28
- ├── source/
29
- │ ├── manifest.json
30
- │ └── src-<name>/v001.<ext>
31
- ├── episodes/<episode-key>/
32
- │ ├── episode.json
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`。生成曲保持现有 `generate_music` 流程;目录曲只返回本地已授权结果或 Pixabay、YouTube Audio Library、Uppbeat 官方搜索页,不自动登录或下载。用户试听并取得文件与许可证证据后,`register_licensed_music` 先写不可变收据,再登记未选音频候选。audio-plan 绑定精确资产、`license_receipt` 与项目用途,时间线再次验证选版和 allowed uses;普通视频页面、无同步权与母带权凭证的热曲不能进入资产库。
36
+ 配乐分为 `music.generate` 与 `music.catalog`。生成曲使用 `music-generate` 画布节点;目录曲只返回已授权结果或 Pixabay、YouTube Audio Library、Uppbeat 官方搜索页,不自动登录或下载。用户试听并取得文件与许可证证据后,先写不可变许可证收据,再登记未选音频候选。audio-plan 绑定精确资产、许可证收据与项目用途,时间线再次验证选版和 allowed uses;普通视频页面、无同步权与母带权凭证的热曲不能进入资产库。
37
+
38
+ ## 人物与分镜
62
39
 
63
- 剧本阶段的 `short-drama` 必须绑定实际分集剧本版本;人物分析必须绑定 `assets/characters/profiles.json`。人物链路固定为:年龄证据 → `audience_appeal` 校验 → 人物定妆候选 → 人物专项审核与选版 → 分镜/白模/正式视频引用绑定 → 跨镜一致性复核。明确成年人物使用 `adult-charisma`,必须有专属 `grooming_and_makeup`、`costume_signature` 和角色级 `memory_anchors`;儿童只使用 `child-cuteness`,任何成人化或性化处理都是不可由总分抵消的硬失败。未知年龄停在人物档案阶段。新生成角色候选只能经 `validateCharacterAppealReview` 和 `review-character` 选版,正式视频人物引用还要通过 `assertCharacterReadyForVisuals` 及档案 SHA、appearance 与可见身份约束校验。
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 的镜头先由 `direct-blender-previz` 写入 `episodes/<episode>/previz/shot-NNN-vNNN.json` 导演合同,再由 `generate-blender-previz` 渲染为 `other-previz-epNNN-NNN`,登记、完整观看、按七项 100 分合同验收并选版;总分低于 85 或任一单项低于 70% 时不得提交正式视频。已选分镜板和白模都不能替代正式视频所需的人物、场景和道具资产。
44
+ 选择 Blender 的镜头先写入白模导演合同,再生成白模参考,登记、完整观看、按七项 100 分合同验收并选版;总分低于 85 或任一单项低于 70% 时不得提交正式视频。已选分镜板和白模都不能替代正式视频所需的人物、场景和道具资产。
68
45
 
69
- 结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总 selected 分镜、导演本和制作计划,生成并显式选定 `continuity-plan/vNNN.json`。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。Runtime 把连续 previous-tail 链派生为生成镜头组:不同组并行、同组串行,一次只生成各组当前前沿镜头。后续已选分镜板或白模若暴露冲突,必须回退生成连续性计划新版本。媒体阶段用 `prepare_previous_tail` 从上一镜当前 selected 且已审核的视频派生下一镜首帧,正式提交前再次比对来源版本和 SHA-256。
46
+ 结构化分镜与制作计划批准后,由 `plan-shot-continuity` 汇总已选分镜、导演本和制作计划,生成并显式选定连续性计划新版本。分镜 `shot_group` 表达叙事组;计划逐镜固定机位、轴线、人物/道具起止状态与转场方式,只有同场景同机位且状态连续时才允许 previous-tail。不同组可并行、同组串行,一次只生成各组当前前沿镜头。后续已选分镜板或白模若暴露冲突,必须回退生成连续性计划新版本。previous-tail 从上一镜当前已选且已审核的视频派生下一镜首帧,正式提交前再次比对来源版本和 SHA-256。
70
47
 
71
- 资产计划中的人物、场景或道具若已有 selected、未失效且不是 Provider 产出的本地版本,可直接复用;缺失、失效或由 Provider 生成/变换时,动态要求对应生成 Skill 与 `drama-generation-service`,防止 Provider 变换资产绕过执行凭证。
48
+ 资产计划中的人物、场景或道具若已有已选、未失效且来源合规的版本,可直接复用;缺失、失效或来源不足时,动态要求对应生成模块,防止未登记资产绕过阶段门禁。
72
49
 
73
- 生成工具必须携带 `project_root`、`target` 和模态对应的 `prompt_document`。MCP 先核对项目已确认的 StarRouter 模型与 Runtime;视频由 Hypit `production plan/build` 核对当前 selected 视频提示词,图片绑定当前资产计划/分镜和 Provider 提示词记录,音频绑定当前配音计划。通过本地合同校验后,在访问 Provider 前保存实际调用参数到 `.short-drama/requests/` 并原子登记 `submitting`;同目标同输入已有在途任务时不会再次付费。TempFile.org URL 绑定提交时有效的本地收据。快照禁止密钥和内联媒体,不能手工覆盖。
50
+ ## 提示词与校验
74
51
 
75
- 只接受公网 URL 的 StarRouter 模型使用 TempFile.org 临时发布参考素材;上传写入 `.short-drama/uploads/` 收据并要求权利、公开风险及用途许可确认。同资产版本默认复用有效收据,剩余时效不足时才经确认重传;过期 URL 和上传收据都不能替代本地资产。
52
+ Codex 按 [Codex 原生合同](codex-contracts.md) 直接执行提示词合同,完成后保存输入与实际产物;只有 `provider_prompts` 中的模板才编译为媒体模型提示词。视频提示词先形成模型无关的镜头事实,再由同一模块编译为 `seedance2`、`h3` 或已确认的 `generic` 协议,禁止跨协议混写。
76
53
 
77
- 原系统的 LLM 提示词已按 [Codex 原生合同](codex-contracts.md) 固化在所属 Skill:Codex 直接执行合同,完成后用 `render-prompt.mjs --codex-output` 保存输入与实际产物;只有 `provider_prompts` 用 `--output` 渲染为媒体模型提示词。项目内所有 JSON 写入采用原子替换;新导演本、资产计划、制作计划、分镜、视频提示词、剧本和媒体版本不得覆盖旧版本。视频提示词先形成模型无关的镜头事实,再由同一 Skill 编译为 `seedance2`、`h3` 或已确认的 `generic` 协议,禁止跨协议混写。
54
+ 校验使用 `ai-short-studio canvas documents` 和 `canvas workflow status` 核对项目配置、文档版本、选版、资产 provenance、文件存在性和 SHA-256。Skill 自身完整性检查只读取随包内容,不读取外部项目仓库。
78
55
 
79
- 使用 `node scripts/audit-plugin.mjs` 验证 Skill、提示词、人工索引与脚本引用。该检查不读取外部项目仓库。
80
- 使用 `node scripts/validate-project.mjs <项目目录>` 校验实际项目配置、目录、命名、来源、选版、资产 provenance、文件存在性和 SHA-256。
81
- # 源时间线情感配音
56
+ ## 源时间线情感配音
82
57
 
83
- 独立配音固定经过 `selected 原声资产 → speech-timing 候选 → 人工复核 timing → audio-plan 三层合同 → 最多三轮编译生成 → 最终 alignment → 八维审核选版 → 字幕/口型/剪辑同源绑定`。行级 ASR 自动通过阈值为 `0.90`,词级为 `0.80`;StarRouter 词级时间戳只接受 `verbose_json + timestamp_granularities=word`,低置信证据不得静默补造。第二轮校准语速钳制在 `0.85–1.15` 后必须实际执行;最终后处理只允许合同内停顿和 `±3%` tempo,容器时长不能替代发声边界。硬门禁比较首词起点和末词终点是否都在一帧内,内部词边界保留为节奏审计证据。换选音频会递归失效旧字幕和口型派生资产。
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
- 历史源时间线第三方配音项目若要验收,须对一个真实镜头完整听看原声与配音,运行 `dubbing-live-acceptance.mjs` 生成项目内 A/B 报告,再以 `DUBBING_EVIDENCE_PROJECT=<项目目录>`、`DUBBING_EVIDENCE_REPORT=<项目内报告路径>` 运行 `next-version-acceptance.mjs`。门禁会重新核对媒体 SHA、可解码音视频流、当前选版、已完成任务、正整数制作耗时、八维完整复听、词级误差、字幕和口型绑定。当前新制作已禁用七维后配和口型驱动,未选择该历史路线的版本验收只检查合同与停用门禁,不要求制造一份无法合法生成的第三方配音证据。
60
+ 当前新制作已禁用七维后配和口型驱动;历史配音项目验收必须对一个真实镜头完整听看原声与配音,生成项目内 A/B 报告,并重新核对媒体 SHA、可解码音视频流、当前选版、已完成任务、正整数制作耗时、八维完整复听、词级误差、字幕和口型绑定。
@@ -1,78 +1,24 @@
1
- # 短剧本地项目规范 v1
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
- 选中新的来源、剧本、导演本、资产计划、分镜、制作计划、视频提示词或媒体版本,以及更新项目创作/Provider 配置、时间线或完整审片时,脚本会自动回退到最早受影响阶段并清除该阶段及之后的模块凭证;`state.json.invalidatedAt` 保存各受影响阶段的最近失效时间。新模块记录及其提示词运行必须晚于该时间,历史 `prompt-runs` 只供审计,不能重放为当前凭证。交付完成后执行 `workflow.mjs complete`,在 `state.json.finishedAt` 固化终态。
3
+ 本规范是短剧项目内容、命名、版本和校验的唯一合同。文本资产由 Codex 通过 `short-drama` 主 Skill 加载当前 reference 模块后直接输出;图片、视频和音频才调用用户选择的 Provider。项目、画布文档、资产版本和审核记录不得包含 API Key、Token、密码或 Authorization。
58
4
 
59
- ## 生成请求快照
5
+ ## 事实来源
60
6
 
61
- 文本资产不调用文本模型。Codex 按当前 reference 模块与 [Codex 原生合同](codex-contracts.md) 直接制作;完成后 `render-prompt.mjs --codex-output` 将合同、合同哈希、完整变量、解析后的约束、实际产物和产物哈希保存为不可变 `.short-drama/prompt-runs/prompt-<uuid>.json`。合同必须由主 Skill 在当前模块中明确选择。只有 `module-map.json` 登记的 `provider_prompts` 能使用 `--output`;脚本会拒绝 Codex 合同与 Provider 提示词混用。
7
+ AI Short Studio 项目和分集画布是唯一事实来源。不要创建本地 `.short-drama/` 第二套项目状态,也不要把本文中的 JSON 示例当成必须落盘的本地文件。
62
8
 
63
- 图片、音频 MCP 调用前会自动生成 `.short-drama/requests/req-<uuid>.json`,并在访问 StarRouter 前以请求 ID 登记 `submitting` 任务;视频通过 Hypit `production plan/build` 提交并保留审批与 Build 证据。本地参考文件必须位于当前项目 `assets/` 且逐项等于清单版本的真实路径;TempFile.org URL 必须绑定提交时间点有效的同版本收据。视频必须引用明确的 `{episode_key,version_id,shot_number}` 提示词文档。快照保存实际提交给生成适配器的完整参数并计算稳定输入指纹;快照使用独占创建,不覆盖旧请求,失败和中断请求同样保留。
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
- 正式生成图片分别引用当前 `asset-plan` 的资产 key 或 `storyboard` 的镜号,音频逐句引用当前 `audio-plan` 的 `line_index`;入口在付费前核对选版、批准状态、提示词正文、逐字台词和音色绑定。仅 `other-*` 辅助图允许没有独立制作文档。临时发布到 TempFile.org 的参考图另写 `.short-drama/uploads/upload-<uuid>.json`,记录本地资产版本、哈希、公开 URL 与到期时间;`list_reference_uploads` 可跨会话查询有效或过期收据。有效同版本收据默认复用,`force_reupload` 只在用户再次确认延长时效后使用。
17
+ 文档版本使用 `canvas.<module>.v1`,审核使用 `canvas.review.v1`;每次保存都追加不可变版本,并用 `--input` 固化上游选版。不要覆盖旧版本,也不要手工伪造完成标记。
66
18
 
67
- 生成 Provider、模型及项目级 `parameters` 必须与 `project.json.providers` 的已确认选择一致;调用未显式传参数时使用这里保存的默认值,显式传入不同值时在付费前拒绝。视频提交还会读取当前 selected、approved 且无未决项的 `video-prompts`,逐项核对目标镜号、模型/工作流、提示词正文、profile、输入模式、时长和参考素材清单;账本中的参考资产必须仍是 selected 版本。该校验发生在付费请求之前。
19
+ ## 项目配置合同
68
20
 
69
- 交付 `manifest.json` 当前为 v2:除成片、SRT、ASS 的相对路径、大小与 SHA-256 外,还固定记录 `editing/<episode>/timeline.json` 和已批准 `review.json` 的相对路径、大小与 SHA-256。任一输入或交付文件变化都会使交付门禁失败,必须重新审片并生成新的交付版本。
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
- "providers": {
117
- "image": { "provider": "starrouter", "model_or_workflow": "gpt-image-2", "prompt_profile": null, "parameters": { "resolution": "1K", "aspect_ratio": "1:1", "n": 1, "quality": "auto" } },
118
- "video": { "provider": "starrouter", "model_or_workflow": "dreamina-seedance-2-0-260128", "prompt_profile": "seedance2", "parameters": { "duration": 5, "resolution": "720p", "ratio": "9:16", "generate_audio": false, "watermark": false } },
119
- "audio": { "provider": null, "model_or_workflow": null, "prompt_profile": null, "parameters": {} },
120
- "music": { "provider": "starrouter", "model_or_workflow": "suno_music", "prompt_profile": null, "parameters": { "make_instrumental": false } }
121
- },
122
- "createdAt": "2026-01-01T00:00:00.000Z",
123
- "updatedAt": "2026-01-01T00:00:00.000Z"
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
- `automation_mode` 控制项目后续操作的确认策略,默认值为 `true`。开启后,Codex/agent 只能在用户已确认且内容未变化的范围内自动继续选版、批量请求和重试;不得替用户确认创作配置、模型/厂商、付费请求范围、候选资产或剧情变更。仍须展示制作计划且不计算具体价格,并满足阶段门禁、权限/素材权利事实和安全校验。缺少这些依据时必须停下。设置为 `false` 时恢复逐项确认。
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
- 未确认的可选值写 `null`,不删除字段,也不使用示例值代替用户决策。例外是新项目画风默认使用 `system-realistic` 完整预设,分镜默认使用 `shot-board`(分镜板)和 4 格;用户可在资产生成前修改。制作计划仍须逐镜在 `single`(单图)、`storyboard`(故事版)和 `shot-board`(分镜板)之间判断,项目默认值只作回退。项目 key 创建后不可变。
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
- 原始资料使用 `project-store.mjs put-source|select-source` 复制到 `source/`,并登记相对路径、文件大小和 SHA-256。原创短剧文本来源支持 txt、md、json、pdf、docx、epub;参考视频复刻统一使用原生 Hypit。分析文档通过 `src-xxx@v001` 引用,不保存原机器绝对路径。
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
- "id": "v001",
178
- "localPath": "assets/videos/shot-ep001-001/v001.mp4",
179
- "sizeBytes": 12345678,
180
- "sha256": "...",
181
- "provenance": {
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
- "created_by": "provider",
184
- "provider": "starrouter",
185
- "model_or_workflow": "dreamina-seedance-2-0-260128",
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`,两者都必须记录 Provider、模型/工作流、任务 ID 和制作文档引用;本地确定性变换使用 `transformed` + `created_by=codex` 并记录源资产版本,不伪造远程任务。所有引用都使用稳定 key 与明确版本。
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
- ```bash
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
- `preflight media` 按 `project.json.providers` 中实际选定的 Provider 逐一检查对应环境变量,不以“任意 Provider 有凭据”代替。每次预检除刷新当前 `environment.json` 外,还会保留带时间戳的历史报告;报告只保存布尔检查结果,不保存凭据。
175
+ 生成前运行 `ai-short-studio preflight --json`,按项目实际选定的 Provider 逐一检查配置和连通性,不以“任意 Provider 有凭据”代替。报告只保存布尔检查结果,不保存凭据。
216
176
 
217
- 旧项目只迁移配置时执行 `migrate-project-config`;脚本会先写入 `.short-drama/project.legacy.<timestamp>.json`。旧项目若仍把时间线、审片或成片直接放在 `editing/`、`delivery/` 根目录,执行 `migrate-project-layout <项目> <episode-key>`;脚本只移动不存在冲突的已知文件,并把旧 manifest 保留为 `manifest.legacy.<timestamp>.json`,随后必须重新审片并生成 manifest v2。旧版 `v1` 文件和无 provenance 资产不会被静默改名或伪造来源,必须人工核对后以 `v001` 重新登记。
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 `examples/h3-base-prompt-writing.md` and follow its final prompt structure.
7
- 3. For full-reference mode, read `examples/h3-reference-prompt-writing.md` and follow its six-section rewrite format.
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 `examples/h3-base-prompt-writing.md`.
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 `examples/h3-reference-prompt-writing.md` for label rules, retention analysis, and complete examples.
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