@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,15 +1,15 @@
1
1
  # 规划跨镜连续性
2
2
 
3
- 读取当前 selected 且已批准的 `storyboard`、`director-book` 和 `production-plan`,并使用 `../../assets/modules/plan-shot-continuity/prompts/continuity_plan.{zh,en}.txt` 生成一份 `continuity-plan`。只采用这些结构化文档和已选资产中的证据;不得引用尚未生成、未被 `required_board_types` 选择或未审核通过的分镜板或白模,也不得推断未声明的道具、持物关系、入画边、出画边或精确米制坐标。
3
+ 读取当前 selected 且已批准的 `storyboard`、`director-book` 和 `production-plan`,并使用 `../assets/modules/plan-shot-continuity/prompts/continuity_plan.{zh,en}.txt` 生成一份 `continuity-plan`。只采用这些结构化文档和已选资产中的证据;不得引用尚未生成、未被 `required_board_types` 选择或未审核通过的分镜板或白模,也不得推断未声明的道具、持物关系、入画边、出画边或精确米制坐标。
4
4
 
5
5
  规划阶段固定使用 `coordinate_mode=semantic`,以画面左/中/右、前/中/后景、朝向、视线对象和出入画边表达语义位置;不得从结构化分镜、图片透视或经验估算三维坐标。后续 Blender 白模只能验证或暴露冲突,不能静默改写已批准连续性计划;冲突必须回退规划阶段生成新版本。
6
6
 
7
- 逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜调用 `continuity-plan.mjs` 导出的 `recommendTailLink(previous,current)`:仅同场景、同机位、同轴线且状态无未解释跳变时,才可启用 `previous-tail`;第一镜、切换机位、越轴、场景变化或有意状态跳变使用 `independent`。合法 previous-tail 必须绑定上一镜号、上一镜 `camera_setup_id` 和 `video.first-frame` 能力。
7
+ 逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜调用 连续性文档 导出的 `recommendTailLink(previous,current)`:仅同场景、同机位、同轴线且状态无未解释跳变时,才可启用 `previous-tail`;第一镜、切换机位、越轴、场景变化或有意状态跳变使用 `independent`。合法 previous-tail 必须绑定上一镜号、上一镜 `camera_setup_id` 和 `video.first-frame` 能力。
8
8
 
9
9
  任何无法由证据解释的差异都写入 `unresolved`,并令 `approved=false`;不得把猜测写进 `allowed_changes` 以绕过校验。`allowed_changes` 只记录剧本、导演本或已批准调度明确要求的变化,`evidence` 指向相应来源。
10
10
 
11
- 用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/project-store.mjs" put-episode-document <项目目录> continuity-plan <episode-key> <version> <文件>` 保存不可变版本。只有 `unresolved=[]` 且逐镜校验通过后才能写 `approved=true`,随后必须用同一脚本的 `select-episode-document` 显式选定;未选定的连续性计划不能进入视频提示词编译。
11
+ 用 `canvas document save` 保存不可变版本。只有 `unresolved=[]` 且逐镜校验通过后才能写 `approved=true`,随后必须用同一脚本的 `canvas document get` 显式选定;未选定的连续性计划不能进入视频提示词编译。
12
12
 
13
- 计划确定使用上一镜尾帧时,媒体阶段调用 `prepare_previous_tail`。上一镜视频换版后必须重新派生尾帧,不能继续使用旧文件或旧 SHA-256。
13
+ 计划确定使用上一镜尾帧时,媒体阶段调用 上一镜尾帧承接。上一镜视频换版后必须重新派生尾帧,不能继续使用旧文件或旧 SHA-256。
14
14
 
15
15
  `storyboard.shot_group` 是导演叙事分组,必须完整、连续且保持同组 type/pattern 一致;它可以包含反打、蒙太奇或其他切机位镜头,因此不能直接等同于尾帧链。执行阶段把每段连续的 `previous-tail` 链派生为一个生成镜头组:不同生成组可以并行,同组只开放一个前沿镜头。前镜候选未审核时状态为 `waiting-review`;前镜已审核选版但首帧尚未派生时为 `waiting-tail`;只有尾帧版本、来源版本和 SHA-256 全部匹配后,下一镜才可进入 `ready`。
@@ -1,107 +1,65 @@
1
- # 本地标准短剧使用手册
1
+ # 短剧使用手册
2
2
 
3
3
  原项目能力的保留、转换、排除和当前边界见 [能力审计](feature-completeness.md)。
4
4
 
5
5
  ## 制作顺序
6
6
 
7
- 参考片复刻统一使用原生 Hypit 链路;短剧插件只负责原创短剧制作。
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. **声音证据与合同**:对原声或外部音频先执行 `analyze_speech_timing`,人工复核后用当前 timing 写逐句表演合同;`compile_dubbing_request` 只预检,不产生费用。
18
- 8. **三轮生成与审核**:最多生成三轮,最终 alignment 达到一帧容差后执行八维完整听看审核;通过候选才能 selected。
19
- 9. **字幕与口型**:调用 `build_subtitles_from_audio` 从最终 selected 音频生成绑定字幕;换版后重建字幕、口型和剪辑引用。
20
- 10. **制作规划**:构建/修订结构化分镜,`plan-drama-production` 逐镜按 `storyboard_strategy` 确定所需板型、格数、按需启用的 Blender 白模、模型、`prompt_profile`、输入模式和参考顺序,只汇总任务与素材数量。
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. **剪辑**:`remotion-best-practices` 约束 Remotion 工程与帧确定实现,`edit-drama-timeline` 按本地剪辑方案完成粗剪、字幕、转场、声音和渲染。
25
- 14. **成片**:`edit-deliver-drama` 逐集完整审片并输出 `delivery/<episode-key>/`。
21
+ 13. **剪辑**:按 [剪辑与交付](../editing-delivery.md) 和 `remotion-best-practices` 完成粗剪、字幕、转场、声音和渲染。
22
+ 14. **成片**:`edit-deliver-drama` 逐集完整审片并输出交付文件和 manifest。
26
23
 
27
24
  文本资产默认由 Codex 直接生成,不使用外部文本模型。图片、视频、音频才进入生成 Provider 路由。
28
25
 
29
- 制作计划确认只授权所列 Provider 请求,不改变阶段,也不计算具体价格。Runtime 与仍保留的生成 MCP 都会在请求落盘前检查当前阶段和全部上游门禁;直接编辑 `selected.json`、项目配置或占位文档不能使越级调用通过。
26
+ 制作计划确认只授权所列 Provider 请求,不改变阶段,也不计算具体价格。每次付费提交前都会检查当前阶段和全部上游门禁;直接修改选版、项目配置或占位文档不能使越级调用通过。
30
27
 
31
- 全流程只调用 `short-drama` 主 Skill。进入阶段后运行 `node scripts/module-runs.mjs required <项目目录> <阶段>`,主 Skill 完整读取并执行返回的 reference 模块,再用 `record` 关联实际项目产物。`workflow.mjs advance` 会拒绝没有模块执行凭证的结果。
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
- | `manage-drama-projects` | 按规范 v1 初始化和校验本地项目、来源、分集、剧本、导演本、制作计划与分镜版本 | 全流程控制面;第一步 | 项目目录、名称、语言、画幅、集数;旧配置迁移、覆盖/重命名 |
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
- 显式执行 `node scripts/market-research.mjs refresh /absolute/workspace` 才会联网刷新公开榜单。`list` 查看快照与报告历史,`report` 读取最新报告,`analyze /absolute/workspace <snapshot-id>` 重算指定历史快照;Studio 使用全局 `#/market`。报告持续标注公开 Top 30 样本边界,不作为收益承诺。
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` 或 Studio 灵感板从信号提出的原创切口,仍需验证,不能复制榜单作品标题、人物关系或具体情节。
87
- 4. **用户决定**:用户明确选择候选并登记后,才写入 `market-inspiration.v1` 和 Brief 的 `market_inspiration_ref`。
44
+ 3. **创作假设**:`ideate-drama-from-market` 从信号提出的原创切口,仍需验证,不能复制榜单作品标题、人物关系或具体情节。
45
+ 4. **用户决定**:用户明确选择候选并登记后,才把 `market-inspiration.v1` 保存为画布文档,并让 Brief 的 `market_inspiration_ref` 引用它。
88
46
 
89
47
  推荐使用路径:
90
48
 
91
- 1. 可选执行 `refresh`;不刷新时只读已有 `.short-drama-market/reports/*.json`。
92
- 2. 在 Studio `#/market` 选择报告周期和筛选范围,查看题材 × 榜单热度、证据和限制。
93
- 3. 在灵感板选择 1–3 个题材并生成本地候选,逐项核对事实、推断、假设和低置信风险。
94
- 4. 选择一个候选和目标项目,点击“登记已选候选”。该动作只登记 `.short-drama/market-inspiration.json` 并更新 `.short-drama/brief.json` 的引用,不改变项目题材或 Brief 平台。
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`。命令行工作流先用 `node scripts/project-store.mjs market-report-ref <项目目录> <report-id> <hypothesis-id...>` 生成可校验报告引用,再按 Skill 合同生成并登记灵感;普通创作不强制经过市场步骤。运行 `node scripts/market-inspiration-offline-smoke.mjs` 可在临时工作区验证全程不刷新网络的闭环。
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
- - 多集项目仍按全局阶段推进;分集级 Skill 必须为每个已建 `ep-NNN` 同时登记独立产物,Codex 合同运行记录必须逐一绑定对应分集证据,不能用某一集替其他集背书。
105
- - Provider 返回成功不等于完成;本地文件、哈希、provenance、账本和验收缺一不可。
106
- - 源时间线情感配音发布验收还必须指定 `DUBBING_EVIDENCE_PROJECT` 与 `DUBBING_EVIDENCE_REPORT`;报告必须来自真实镜头 A/B,并绑定完整复听、制作耗时、实际 Provider 任务、字幕和口型证据。
62
+ - 多集项目仍按全局阶段推进;分集级模块必须为每个已建 `ep-NNN` 同时保存独立产物,Codex 合同运行记录必须逐一绑定对应分集证据,不能用某一集替其他集背书。
63
+ - Provider 返回成功不等于完成;真实产物、哈希、provenance、资产版本和验收缺一不可。
64
+ - 源时间线情感配音发布验收必须对一个真实镜头完整听看原声与配音,报告绑定完整复听、制作耗时、实际 Provider 任务、字幕和口型证据。
107
65
  - 用户未确认的参数保持未决,不用示例值或所谓“最佳实践”替用户决定。