@aswless_854771076/ai_short_studio_cli 0.1.156 → 0.1.157

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (172) 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 +13 -13
  11. package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +21 -3
  12. package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/SOURCE.md +9 -0
  13. package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md +408 -5
  14. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +16 -30
  15. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +2 -2
  16. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles.md +2 -2
  17. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +3 -3
  18. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +2 -2
  19. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +2 -2
  20. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-art-styles.md +3 -3
  21. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-assets.md +4 -4
  22. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.en.txt +1 -1
  23. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.zh.txt +1 -1
  24. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.en.txt +1 -1
  25. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/plan-drama-assets.md +2 -2
  26. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +3 -3
  27. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/analyze-drama-source.md +2 -2
  28. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/define-drama-brief.md +1 -2
  29. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/design-drama-bible.md +1 -1
  30. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +4 -4
  31. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/outline-drama-series.md +1 -1
  32. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/short-drama.md +1 -1
  33. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-director-book.md +1 -2
  34. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-episode.md +1 -2
  35. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-deliver-drama.md +2 -2
  36. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +4 -5
  37. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/remotion-best-practices.md +4 -5
  38. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +8 -8
  39. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +25 -25
  40. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +5 -11
  41. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/design-drama-audio.md +4 -2
  42. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +6 -6
  43. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +4 -4
  44. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +3 -3
  45. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/monitor-drama-tasks.md +9 -7
  46. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +2 -2
  47. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +9 -8
  48. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md +8 -8
  49. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json +1 -1
  50. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md +1 -1
  51. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/README.md +59 -0
  52. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.mjs +517 -0
  53. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.test.mjs +354 -0
  54. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.mjs +188 -0
  55. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.test.mjs +218 -0
  56. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.mjs +458 -0
  57. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.test.mjs +236 -0
  58. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/report.mjs +69 -0
  59. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.mjs +341 -0
  60. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.test.mjs +302 -0
  61. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +43 -133
  62. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/music-catalog-providers.md +3 -3
  63. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/manage-drama-projects.md +5 -5
  64. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +7 -8
  65. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/recover-drama-pipeline.md +1 -1
  66. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +7 -7
  67. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +4 -6
  68. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +40 -65
  69. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +91 -131
  70. package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/h3-prompt-writing.md +4 -4
  71. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +185 -0
  72. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +64 -0
  73. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +2 -2
  74. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/recreation-qa.md +87 -0
  75. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md +2 -2
  76. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +5 -5
  77. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +1 -3
  78. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +0 -4
  79. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +1 -1
  80. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +1 -1
  81. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/generate-blender-previz.md +5 -10
  82. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +2 -6
  83. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +4 -4
  84. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +28 -70
  85. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +0 -447
  86. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/brief.md +0 -93
  87. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/project-files.md +0 -246
  88. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/reference-video.md +0 -266
  89. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/script-and-time.md +0 -253
  90. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/transformations.md +0 -141
  91. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/distribution.md +0 -176
  92. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/local-tools.md +0 -411
  93. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/model-and-provider.md +0 -275
  94. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/profile.md +0 -286
  95. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/asset-and-shot-preproduction.md +0 -193
  96. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/b-roll.md +0 -94
  97. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/caption-tracking.md +0 -125
  98. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/captions.md +0 -252
  99. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/conversation-images.md +0 -218
  100. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/image-direction.md +0 -123
  101. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/generated-dependencies.md +0 -38
  102. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/graphic-compositions.md +0 -85
  103. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/image-direction.md +0 -95
  104. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/motion-graphics.md +0 -68
  105. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/recreation-policy.md +0 -51
  106. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/screen-demonstrations.md +0 -51
  107. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/shot-production-contracts.md +0 -161
  108. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/sound-mix.md +0 -76
  109. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/video-direction.md +0 -433
  110. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-and-performance.md +0 -224
  111. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-direction.md +0 -99
  112. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/narration-led-demo.md +0 -87
  113. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/presenter-led-explainer.md +0 -160
  114. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/ranking-listicle.md +0 -71
  115. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +0 -19
  116. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama-workflow.md +0 -165
  117. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama.md +0 -88
  118. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/street-interview.md +0 -92
  119. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/talking-head.md +0 -82
  120. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/two-person-podcast.md +0 -101
  121. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/index.md +0 -77
  122. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/audio-presentation.md +0 -49
  123. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/authoring.md +0 -228
  124. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/browser-capture.md +0 -112
  125. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/builds.md +0 -330
  126. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-authoring.md +0 -156
  127. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-presentation.md +0 -66
  128. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-design.md +0 -217
  129. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-sharing.md +0 -150
  130. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-visuals.md +0 -152
  131. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/detail.svrun +0 -8
  132. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/direction.svs +0 -14
  133. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/look.svs +0 -6
  134. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/material.svrun +0 -5
  135. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svml +0 -73
  136. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svrun +0 -5
  137. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/visuals.ts +0 -62
  138. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/fonts-and-text.md +0 -138
  139. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/image-operations.md +0 -102
  140. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/index.md +0 -73
  141. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media-presentation.md +0 -111
  142. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media.md +0 -246
  143. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/performance.md +0 -114
  144. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/prompt-kits.md +0 -165
  145. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/rendering.md +0 -141
  146. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/review.md +0 -211
  147. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/runs.md +0 -151
  148. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/script-syntax.md +0 -236
  149. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/snapshots.md +0 -90
  150. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/sound.md +0 -75
  151. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/source-syntax.md +0 -163
  152. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/spatial.md +0 -189
  153. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio-companions.md +0 -186
  154. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio.md +0 -249
  155. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/system.md +0 -169
  156. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timeline.md +0 -74
  157. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timing.md +0 -96
  158. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/track-authoring.md +0 -215
  159. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/tracks.md +0 -67
  160. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/video-downloads.md +0 -47
  161. package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/vocabulary.md +0 -119
  162. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/README.md +0 -11
  163. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/comfly-provider.md +0 -12
  164. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/seedance-community-skills.md +0 -23
  165. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/publish-drama-references/litterbox.md +0 -5
  166. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/runninghub-provider.md +0 -33
  167. package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/starrouter-provider.md +0 -53
  168. package/skills/using-vvicat-ai-short-studio-cli/references/video-model-routing.md +0 -10
  169. package/skills/using-vvicat-ai-short-studio-cli/references/video-prompt-spec.md +0 -32
  170. /package/skills/using-vvicat-ai-short-studio-cli/references/{short-drama/assets/modules/humanizer → humanizer}/LICENSE +0 -0
  171. /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-base-prompt-writing.md +0 -0
  172. /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-reference-prompt-writing.md +0 -0
@@ -2,8 +2,8 @@
2
2
 
3
3
  读取项目当前画风和已有候选;创建新画风时路由到 `generate-drama-art-style`。选择画风时检查 prompt、visualBible、预览图和适用题材,风格不得包含具体人物身份、剧情事件或与场景冲突的地点事实。
4
4
 
5
- 生成预览前展示并确认模型、尺寸和候选数,不计算具体价格;使用同一中性测试内容比较候选。每个候选先具备明确的 `renderingContract`,中性测试内容分别验证媒介、渲染方法、表面材质语言和成像方式,不能只比较“好不好看”。预览图下载到本地资产库并记录 provenance,选定的结构化风格配置写入 `.short-drama/project.json` 的 `creative.art_style`。
5
+ 生成预览前展示并确认模型、尺寸和候选数,不计算具体价格;使用同一中性测试内容比较候选。每个候选先具备明确的 `renderingContract`,中性测试内容分别验证媒介、渲染方法、表面材质语言和成像方式,不能只比较“好不好看”。预览图下载并登记为画布资产版本,记录 provenance;选定的结构化风格配置写入项目 `creative.art_style`。
6
6
 
7
- 画风库由系统画风库 `manage-drama-art-styles/art-styles.json` 与统一工作区根目录下的 `art-styles.custom.json`(或 `SHORT_DRAMA_CUSTOM_ART_STYLES_FILE`)合并组成。选择或确认自定义画风后,必须保存完整 style 对象到自定义库并按 `id` upsert;系统画风只读,不得被自定义对象覆盖。自定义画风必须包含 `id`、`name`、`description`、`prompt`、完整 `renderingContract` 和完整 v1 `visualBible`,未确认或不完整的候选不得登记。旧自定义画风缺少 renderingContract 时先补齐并让用户重新确认,不从名称自动猜媒介。
7
+ 画风库由系统画风库 [`art-styles.json`](../art-styles.json) 与统一工作区根目录下的 `art-styles.custom.json`(或 `SHORT_DRAMA_CUSTOM_ART_STYLES_FILE`)合并组成。选择或确认自定义画风后,必须保存完整 style 对象到自定义库并按 `id` upsert;系统画风只读,不得被自定义对象覆盖。自定义画风必须包含 `id`、`name`、`description`、`prompt`、完整 `renderingContract` 和完整 v1 `visualBible`,未确认或不完整的候选不得登记。旧自定义画风缺少 renderingContract 时先补齐并让用户重新确认,不从名称自动猜媒介。
8
8
 
9
- `update-project` 会把既有人物、场景、道具、故事板和视频版本标记为 stale 并取消选版;重新生成使用新版本,不得清除旧版失效记录。
9
+ `project update` 会把既有人物、场景、道具、故事板和视频版本标记为 stale 并取消选版;重新生成使用新版本,不得清除旧版失效记录。
@@ -1,9 +1,9 @@
1
1
  # 管理短剧资产
2
2
 
3
- 所有媒体资产使用稳定 key、类型、输入指纹、候选版本和 `selectedVersionId`。key 必须使用 `char-`、`scene-`、`prop-`、`board-`、`shot-`、`audio-` 或 `other-` 前缀,版本使用 `v001`。先用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/asset-ledger.mjs" put <项目目录> <资产.json>` 建档;本地结果用 `import`,Provider 返回的 HTTPS URL 用 `fetch`,base64 结果文件用 `decode`。三者都会把内容保存到项目并记录本地相对路径、文件大小、SHA-256 和固定 provenance。
3
+ 所有媒体资产使用稳定 key、类型、输入指纹、候选版本和 `selectedVersionId`。key 必须使用 `char-`、`scene-`、`prop-`、`board-`、`shot-`、`audio-` 或 `other-` 前缀,版本使用 `v001`。先建立资产 key 与候选版本:本地结果用 `canvas asset upload` 登记,Provider 返回的 HTTPS URL 与 base64 结果先下载到本地文件,再按同一路径登记。登记时记录文件大小、SHA-256 和固定 provenance。
4
4
 
5
- 只读查看使用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/asset-ledger.mjs" list <项目目录> [资产 key]`;第一个参数必须是子命令,不能省略。
5
+ 只读查看使用 `canvas asset list` 或 `canvas asset get`。
6
6
 
7
- Provider 结果执行 `fetch|decode` 时必须在文件名参数后提供 provenance JSON;不自定义文件名时传 `-`。provenance 固定记录 `origin`、`created_by`、Provider、模型/工作流、任务 ID、视频提示词文档、上游资产版本和生成参数,禁止密钥。已有本地文件版本可用 `add-version` 登记,但必须携带 provenance,且 `localPath` 位于项目目录并真实存在。使用 `select`、`revert`、`list` 管理选版历史;不得直接修改 `.short-drama/assets.json`。
7
+ Provider 结果必须保存为画布资产版本,记录 provenance:`origin`、`created_by`、Provider、模型/工作流、任务 ID、视频提示词文档、上游资产版本和生成参数,禁止密钥。已有本地文件版本可用 `canvas asset upload` 登记,但必须携带 provenance 和真实文件路径。使用 `canvas asset select-version`、`canvas asset list/get` 管理选版历史;不得直接改写资产版本内容。
8
8
 
9
- 远程 URL 只是临时传输结果:文件未进入 `assets/{characters,scenes,props,storyboards,audio,videos,other}/` 并成功登记前,任务不得标记完成。选版后按 ID 回读,不按修改时间猜测成品;上游内容变化时标记真实下游 stale。
9
+ 远程 URL 只是临时传输结果:文件未登记为画布资产版本前,任务不得标记完成。选版后按 ID 回读,不按修改时间猜测成品;上游内容变化时标记真实下游 stale。
@@ -14,7 +14,7 @@ This file is read by the owning Skill to constrain Codex input, reasoning, and o
14
14
  Return strict JSON whose only top-level keys are: schema_version, report_ref, signals, hypotheses, decision, guardrails.
15
15
 
16
16
  Rules:
17
- 1. schema_version is always market-inspiration.v1. After the user selects hypotheses, run `project-store.mjs market-report-ref <project-root> <report ID> <selected hypothesis ID>...`. Use that command's JSON output verbatim as report_ref; it may contain only report_id, snapshot_ids, generated_at, filters, sha256, and selected_hypothesis_ids. Never calculate the digest yourself, guess its algorithm, or invent fields.
17
+ 1. schema_version is always market-inspiration.v1. report_ref may contain only report_id, snapshot_ids, generated_at, filters, sha256, and selected_hypothesis_ids. Copy the first four fields verbatim from the same user-supplied `market-report.v2` file; never rewrite, fill in, or infer them. sha256 is the digest of that report file's raw bytes; obtain it with `shasum -a 256 <report-file>` or `sha256sum <report-file>` and copy only the hex digest. selected_hypothesis_ids contains only the hypothesis IDs the user explicitly selected. Never compute the digest over normalized or re-serialized JSON, and never use another algorithm.
18
18
  2. signals[].fact contains only report-backed facts. Each signal requires confidence, at least one evidence item, and at least one limitation. Preserve low confidence as low.
19
19
  3. In every hypothesis, inference is a bounded inference; creative_transformation, opening_hook, serial_engine, differentiation, and production_fit are original creative hypotheses. Cite at least one derived_signal_ids and include premises, risks, and validation_questions.
20
20
  4. Do not copy, rewrite, or combine ranking-work titles, character relationships, concrete plots, distinctive dialogue, or story structures. Do not promise revenue, media-buying results, or success probability.
@@ -14,7 +14,7 @@
14
14
  只返回严格 JSON,顶层必须且只能包含:schema_version、report_ref、signals、hypotheses、decision、guardrails。
15
15
 
16
16
  规则:
17
- 1. schema_version 固定为 market-inspiration.v1。用户选定假设后,先调用 `project-store.mjs market-report-ref <项目目录> <report ID> <已选 hypothesis ID>...`;report_ref 必须逐字段原样使用该命令的 JSON 输出,只能包含 report_id、snapshot_ids、generated_at、filters、sha256、selected_hypothesis_ids。不得自行计算摘要、猜测算法或杜撰字段。
17
+ 1. schema_version 固定为 market-inspiration.v1。report_ref 只能包含 report_id、snapshot_ids、generated_at、filters、sha256、selected_hypothesis_ids 六个字段:前四项逐字段复制自用户指定的同一份 `market-report.v2` 文件,不得改写、补齐或推断;sha256 是该报告文件的原始字节摘要,用 `shasum -a 256 <报告文件>` 或 `sha256sum <报告文件>` 取得,只复制输出的十六进制摘要;selected_hypothesis_ids 只填写用户明确选定的假设 ID。不得改用规范化 JSON、重新序列化或其它算法计算摘要。
18
18
  2. signals[].fact 只写报告可回链的事实;每项必须包含 confidence、至少一条 evidence 和至少一条 limitations。低置信度必须原样继承为 low,不得升级。
19
19
  3. hypotheses[] 中 inference 是有限推断,creative_transformation、opening_hook、serial_engine、differentiation 和 production_fit 是原创假设。每项必须引用至少一个 derived_signal_ids,并写明 premises、risks 和 validation_questions。
20
20
  4. 不得复制、改写或拼接榜单作品标题、人物关系、具体情节、独特台词或故事结构;不得承诺收益、投放或成功概率。
@@ -36,7 +36,7 @@ Rules:
36
36
  6a. Each shot's executable action must be split into singular observable beats. When one shot asks for multiple independent state changes, complex contact, prop release, reaction, and dialogue at once, split it into sequential beats or shots and explain the split in `selection_basis` and `review_checks`; never stack actions that cannot be verified together into one prompt.
37
37
  7. prompt_profile is exactly seedance2 or h3. Final generation uses the selected character images, selected storyboard boards, any required audio reference, and the video prompt. Add Blender previz only when the selected still boards cannot prove a complex route, multi-person interaction, exact contact, axis risk, or continuous camera move. Seedance 2.0 uses `full-reference`, and H3 uses `Ref2VA`. If the Provider cannot carry the inputs this shot actually requires, mark unresolved; never silently omit one.
38
38
  8. When the Provider supports MiniMax H3 native audio (video.native-audio), default audio_strategy.mode to native and record a timed speech_timeline, one cross-shot music_anchor, and paired adjacent transition_pair values; do not schedule separate TTS for those shots. When the project has confirmed `voice_consistency` with a mode other than `none`, every visible speaker must reference a confirmed voice binding; missing a real `voice_id`, source evidence, or capability check goes into `unresolved`, and prompt adjectives such as “low” or “bright” never substitute for character binding. Use post-dub/independent only when the user explicitly requests dubbing or the Provider/model is confirmed to lack native audio; do not silently fall back to dubbing just because capability is unknown. Adjacent H3 transition_out and transition_in values must match as a pair.
39
- 9. Every shot uses image_strategy.mode=generate and panel_grid_size=2..16 (default 6, adjusted to actual beats), producing only the independent storyboard assets listed in required_board_types. Standard projects default to storyboard_strategy.mode=image and previz_strategy={"mode":"none"}. Use storyboard_strategy.mode=blender with previz_strategy={"mode":"blender","purpose":"motion-reference","fps":12} only when the two boards still cannot unambiguously express a complex route, multi-person interaction, exact contact, axis risk, or continuous camera move; name that spatial risk in review_checks. Only StarRouter MiniMax-H3 currently accepts the Blender motion reference through TempFile.org hosting; otherwise mark unresolved. Do not bind future asset versions. Composition elements require source, selected-asset, or confirmed-blocking evidence; block unsupported elements in unresolved. overflow_strategy is exactly compose-assets or reject.
39
+ 9. Every shot uses image_strategy.mode=generate and panel_grid_size=2..16 (default 6, adjusted to actual beats), producing only the independent storyboard assets listed in required_board_types. Standard projects default to storyboard_strategy.mode=image and previz_strategy={"mode":"none"}. Use storyboard_strategy.mode=blender with previz_strategy={"mode":"blender","purpose":"motion-reference","fps":12} only when the two boards still cannot unambiguously express a complex route, multi-person interaction, exact contact, axis risk, or continuous camera move; name that spatial risk in review_checks. Only a confirmed MiniMax-H3 model that the realtime catalog declares as accepting a motion reference may take the Blender previz; publish the local file through the platform canvas reference-asset upload flow. If the catalog or reference-asset flow cannot carry it, mark unresolved. Do not bind future asset versions. Composition elements require source, selected-asset, or confirmed-blocking evidence; block unsupported elements in unresolved. overflow_strategy is exactly compose-assets or reject.
40
40
  9a. Before generation, realize `required_board_types`: a video shot must generate only the board types selected in its `storyboard_strategy.required_board_types`; narrative, blocking, action, choreography, comprehensive, director-track, temporal, shot-board, and previz-3d are selectable types. Add multiple types only when the production goal needs each one; `previz-3d` is an additional spatial reference when selected. Do not auto-create an unselected board type. `image_strategy.board_type=shot-board` is only a compatibility field for the executor and must not override `primary_board_type`.
41
41
  10. Tailor review_checks to actual shot risk; every item must be a concrete, named, observable phrase (e.g. "mirror reflection consistency", "contact point readable through rain") derived from the contract's ai_risks and evidence elements: dialogue checks speaker identity and every visible mouth state; group shots check headcount, order, facing, and limb ownership; prop interaction checks before/contact/after states and adjacent objects; walking or fights check foot contact, weight, direction, speed, and pose across cuts; in-frame screens check whether precise post-production graphics are required. When composition risks apply, turn each into an explicit check: mirrors/glossy water verify the reflection matches the real person and actual dressing, with no extra fingers, camera, or reflection anomaly; rain, fog, neon, and smoke/dust verify the weather and colored light are evidenced, directions are consistent, and neither buries the contact point nor identity; crowd shots verify headcount, identity, costume-color anchors, and no extra bystanders; weapons and multi-hand interaction verify prop form, holding relationship, hand count, and before/contact/after states; a narrow door gap or foreground occlusion verifies visible width, both eyes intact, and the key action uncovered; high-speed trails verify both eyes, the face, and the contact point stay sharp and the subject is not a blob; front-and-back pincer/encirclement verifies both threats' identity, distance, and facing stay readable in foreground and background; vertical shots verify faces, key props, and contact points sit in the upper-middle safe area, the bottom subtitle safe area is clear, and motion edges keep a 10% margin. Keep only the risks this shot actually has. Never copy one generic checklist onto every shot.
42
42
 
@@ -1,7 +1,7 @@
1
1
  # 规划短剧资产
2
2
 
3
- 读取已选剧本、导演本、来源分析、简报和 `assets.json`,用本 Skill 的 `../../assets/modules/plan-drama-assets/prompts/asset_analysis.{zh,en}.txt` 生成 `asset-plan.json`。只提取目标集实际出现的资产,区分年龄、服装、真假、损坏前后等连续性版本;人物别名归一,场景按 macro/micro 空间拆分,道具仅保留可移动、不可替代、跨镜持续或承担剧情功能的实体。人物年龄只能引用剧本或已批准档案的明确证据,不能从姓名、职业、关系或外表猜测;未知年龄进入 `unresolved`,不得提前安排人物定妆或正式视频。
3
+ 读取已选剧本、导演本、来源分析、简报和当前资产计划文档,用本 Skill 的 `../assets/modules/plan-drama-assets/prompts/asset_analysis.{zh,en}.txt` 生成 `asset-plan` 文档。只提取目标集实际出现的资产,区分年龄、服装、真假、损坏前后等连续性版本;人物别名归一,场景按 macro/micro 空间拆分,道具仅保留可移动、不可替代、跨镜持续或承担剧情功能的实体。人物年龄只能引用剧本或已批准档案的明确证据,不能从姓名、职业、关系或外表猜测;未知年龄进入 `unresolved`,不得提前安排人物定妆或正式视频。
4
4
 
5
- 将所有 `unresolved` 一次汇总给用户确认。未决项清零后,用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/project-store.mjs" put-episode-document <项目> asset-plan <分集 key> <版本> <asset-plan.json>` 校验并保存不可变版本,再用 `select-episode-document` 选定。该写入会校验顶层合同、资产类型、稳定 key、证据、版本、状态和分集一致性。
5
+ 将所有 `unresolved` 一次汇总给用户确认。未决项清零后,用 `canvas document save` 校验并保存不可变版本,再用 `canvas document get` 选定。该写入会校验顶层合同、资产类型、稳定 key、证据、版本、状态和分集一致性。
6
6
 
7
7
  本 Skill 只建立统一清单,不重复承担下游细化:人物事实和 `audience_appeal` 交给 `generate-character-profiles`;明确成年人物必须规划 `adult-charisma`,儿童必须规划 `child-cuteness`,妆发 `grooming_and_makeup`、服装标识 `costume_signature` 与 `memory_anchors` 由人物档案审批后传给 `generate-character-images`。场景描述交给 `generate-scene-assets`,道具描述交给 `generate-prop-assets`。缺失、歧义、错版或未选版未清零时禁止拆镜。
@@ -2,11 +2,11 @@
2
2
 
3
3
  原系统把文本制作规则包装成发给外部 LLM 的 system prompt;本插件不调用文本模型。迁移后采用以下语义:
4
4
 
5
- - `skills/short-drama/SKILL.md` 是唯一执行入口;reference 模块说明当前能力的输入、判断顺序、确认点和落盘方式。
5
+ - `references/short-drama/SKILL.md` 是唯一执行入口;reference 模块说明当前能力的输入、判断顺序、确认点和落盘方式。
6
6
  - 标有“Codex 执行合同”的模板是细化合同:其中 `{name}` 是具名输入槽,不是让 Codex 猜测的自然语言变量。Codex 从 Skill 指定的 selected 项目文件组装同名值,缺少值时停止或保留未决,不虚构。
7
7
  - 合同中的“角色”描述只是专业职责边界,不建立第二个代理,也不把内容发给外部文本模型。
8
- - Codex 完成输出后,用 `render-prompt.mjs --template <合同> --vars <输入.json> --codex-output <实际产物> --project-root <项目>` 保存合同快照、变量、解析后的合同和实际产物哈希。
9
- - `module-map.json` 的 `provider_prompts` 才是直接渲染后提交给图片模型的媒体提示词;它们使用 `--output` 生成本地提示词,再由 `drama-generation-service` 提交。
8
+ - Codex 完成输出后,用登记模板渲染并保存合同快照、变量、解析后的合同和实际产物哈希。
9
+ - `module-map.json` 的 `provider_prompts` 才是直接渲染后提交给图片模型的媒体提示词;Codex 按模板具名输入槽填值后,用 `canvas node write-video-prompt` 写入节点配置,再由画布生成节点提交,没有独立的本地渲染子命令。
10
10
  - 一个模块有多个合同时,`module-map.json.completion_prompts` 指定能证明最终资产完成的合同;局部细化、修改和推荐合同只作辅助,不能单独通过阶段门禁。
11
11
 
12
12
  文本合同与媒体提示词都必须留在所属模块,避免一个全局长提示词同时承担分析、剧本、分镜和生成。阶段编排只加载当前 reference,所以 Codex 不需要一次理解全部模板。
@@ -1,7 +1,7 @@
1
1
  # 分析短剧原始材料
2
2
 
3
- 先读取 `source/manifest.json` 中已选的本地 `src-xxx@v001` 小说、梗概、参考资料和 `.short-drama/project.json`,由 Codex 使用 `../../assets/modules/analyze-drama-source/prompts/source_analysis.{zh,en}.txt` 直接生成 `source-analysis.json`,记录来源版本、剧情时间线、冲突与主题、出场人物、场景、关键道具、可视化难点、内容边界、用户要求、事实证据位置和未决问题。不得调用外部文本模型。
3
+ 先读取已选来源资产 `src-xxx@v001`、项目配置和参考资料,由 Codex 使用 `../assets/modules/analyze-drama-source/prompts/source_analysis.{zh,en}.txt` 直接生成 `source-analysis` 文档,记录来源版本、剧情时间线、冲突与主题、出场人物、场景、关键道具、可视化难点、内容边界、用户要求、事实证据位置和未决问题。不得调用外部文本模型。
4
4
 
5
5
  分析只提取和判断,不擅自改编。原文事实、用户明确要求和创作建议分栏保存;冲突时列出差异并请求确认。长篇小说按章节分块分析后再合并稳定身份与时间线,不能用抽样代替全量覆盖。
6
6
 
7
- 结果用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/project-store.mjs" put-document <项目目录> source-analysis <文件>` 落盘。需要改变集数、结局、人物关系、时代、平台、画幅、语言或内容分级时必须先让用户确认,再进入简报和剧本。
7
+ 结果用 `canvas document save` 落盘。需要改变集数、结局、人物关系、时代、平台、画幅、语言或内容分级时必须先让用户确认,再进入简报和剧本。
@@ -1,7 +1,6 @@
1
1
  # 定义短剧简报
2
2
 
3
-
4
- 合并询问缺失且会改变创作结果的最少问题,不替用户选择题材或平台。由 Codex 使用 `../../assets/modules/define-drama-brief/prompts/drama_brief.{zh,en}.txt` 直接输出结构化 `brief.json`,至少包含:一句话目标、题材/受众/基调、核心冲突、交付语言、画幅、集数、单集目标时长、内容分级、已有素材、明确禁区;确认后用 `project-store.mjs put-document <项目目录> brief <文件>` 保存,并用 `update-project` 同步 `format`、`languages` 和 `creative` 中对应的项目级事实。`episode_duration_seconds` 表示策划目标而非必须精确命中的硬截止;除非平台明确限长,后续优先保证动作完成、对白可读和结尾呼吸。
3
+ 合并询问缺失且会改变创作结果的最少问题,不替用户选择题材或平台。由 Codex 使用 `../assets/modules/define-drama-brief/prompts/drama_brief.{zh,en}.txt` 直接输出结构化 `brief.json`,至少包含:一句话目标、题材/受众/基调、核心冲突、交付语言、画幅、集数、单集目标时长、内容分级、已有素材、明确禁区;确认后用 `canvas document save` 保存,并用 `project update` 同步 `format`、`languages` 和 `creative` 中对应的项目级事实。`episode_duration_seconds` 表示策划目标而非必须精确命中的硬截止;除非平台明确限长,后续优先保证动作完成、对白可读和结尾呼吸。
5
4
 
6
5
  题材决策时按需读取 [题材指南](../writing/genre-guide.md)。用户确认前不进入故事圣经。文本始终由 Codex 输出,不调用外部文本模型。
7
6
 
@@ -1,5 +1,5 @@
1
1
  # 设计故事圣经
2
2
 
3
- 读取本地 `brief.json`,原创扩写时使用本 Skill 的 `../../assets/modules/design-drama-bible/prompts/ai_story_expand.{zh,en}.txt`,并按需读取 [开场规则](../writing/opening-rules.md)、[节奏曲线](../writing/rhythm-curve.md)、[满足矩阵](../writing/satisfaction-matrix.md)、[反派设计](../writing/villain-design.md) 和 [卡点设计](../writing/paywall-design.md)。输出 `bible.json`:故事规则、三幕结构、主配角外观与动机、关系、角色弧、冲突阶梯、伏笔回收、付费卡点和结局;用 `project-store.mjs put-document` 保存。
3
+ 读取本地 `brief.json`,原创扩写时使用本 Skill 的 `../assets/modules/design-drama-bible/prompts/ai_story_expand.{zh,en}.txt`,并按需读取 [开场规则](../writing/opening-rules.md)、[节奏曲线](../writing/rhythm-curve.md)、[满足矩阵](../writing/satisfaction-matrix.md)、[反派设计](../writing/villain-design.md) 和 [卡点设计](../writing/paywall-design.md)。输出 `bible.json`:故事规则、三幕结构、主配角外观与动机、关系、角色弧、冲突阶梯、伏笔回收、付费卡点和结局;用 `canvas document save` 保存。
4
4
 
5
5
  不得改变已确认的题材、语言和结局类型。这里只定义人物的剧情事实与弧线;结构化人物档案交给 `generate-character-profiles`,视觉候选交给 `generate-character-images`。
@@ -1,9 +1,9 @@
1
1
  # 自然化短剧剧本
2
2
 
3
- 读取已选剧本、brief、bible、outline、source-analysis,以及用户明确提供的语言样本。只处理表达与可表演性,不新增事实,不改人物身份、关系、关键动作、场次顺序、伏笔兑现、时长目标或已确认台词含义。忠实改编不得用“更自然”为理由改写原作事实。
3
+ 本模块是剧本阶段的 Humanizer 适配层。执行前必须完整读取随包官方快照 [Humanizer](../../humanizer/humanizer.md)(来源与版本见 [快照说明](../../humanizer/SOURCE.md)),按官方的模式识别、事实保留和语气匹配流程改写;本文件只补充短剧约束,不复制官方规则。
4
4
 
5
- 逐场检查并修正:角色都说同一种话、台词解释动机、连续完整句缺少打断与潜台词、旁白重复画面、舞台说明像散文、机械三段式、泛滥的转折词和总结句、口号式金句、同义反复、刻意悬念、过量标题与括号。让每个角色的词汇、句长、回避方式和情绪泄露符合人物档案;保留必要停顿、沉默、抢话和未说完的话,但不为“人味”堆口头禅。
5
+ 读取已选剧本、brief、bible、outline、source-analysis,以及用户明确提供的语言样本。只处理表达与可表演性,不新增事实,不改人物身份、关系、关键动作、场次顺序、伏笔兑现、时长目标或已确认台词含义。忠实改编不得用“更自然”为理由改写原作事实。
6
6
 
7
- 输出完整剧本新版本,不输出修改建议代替成稿。用 `project-store.mjs put-script` 写入下一个不可变版本并 `select-script`,禁止覆盖原稿;随后必须执行 `review-drama-script`。用户语言样本只作为风格参考,不能复制其中的个人信息或无关事实。
7
+ 短剧额外检查:角色都说同一种话、台词解释动机、连续完整句缺少打断与潜台词、旁白重复画面、舞台说明像散文、机械三段式、泛滥的转折词和总结句、口号式金句、同义反复、刻意悬念、过量标题与括号。让每个角色的词汇、句长、回避方式和情绪泄露符合人物档案;保留必要停顿、沉默、抢话和未说完的话,但不为“人味”堆口头禅。官方 Humanizer 的百科、脚注和引用规则不适用于剧本对白;不得为了去 AI 味删掉表演所必需的停顿或舞台事实。
8
8
 
9
- 本 Skill 是插件内的短剧专用 Humanizer,吸收通用 Humanizer 的反模板化原则,但不套用百科写作规则,也不依赖外部 Skill。
9
+ 输出完整剧本新版本,不输出修改建议代替成稿。用 `canvas document save` 写入下一个不可变版本并 `canvas document get`,禁止覆盖原稿;随后必须执行 `review-drama-script`。用户语言样本只作为风格参考,不能复制其中的个人信息或无关事实。
@@ -1,5 +1,5 @@
1
1
  # 规划分集目录
2
2
 
3
- 读取本地 `brief.json`、`bible.json`,按需读取 [节奏曲线](../writing/rhythm-curve.md)、[满足矩阵](../writing/satisfaction-matrix.md) 和 [卡点设计](../writing/paywall-design.md),用 `episode_split` 模板生成 `outline.json`。每集记录稳定 key、标题、核心事件、爽点/信息增量、开场承接、结尾钩子、关键资产和预计时长;预计时长是策划中心值而非精确截止,默认允许约 ±15% 自然浮动,超出时记录叙事原因并请用户重新确认。用 `project-store.mjs put-document` 保存,并逐集 `put-episode` 建档。
3
+ 读取本地 `brief.json`、`bible.json`,按需读取 [节奏曲线](../writing/rhythm-curve.md)、[满足矩阵](../writing/satisfaction-matrix.md) 和 [卡点设计](../writing/paywall-design.md),用 `episode_split` 模板生成 `outline.json`。每集记录稳定 key、标题、核心事件、爽点/信息增量、开场承接、结尾钩子、关键资产和预计时长;预计时长是策划中心值而非精确截止,默认允许约 ±15% 自然浮动,超出时记录叙事原因并请用户重新确认。用 `canvas document save` 保存,并逐集 `canvas document save` 建档。
4
4
 
5
5
  检查总集数、三幕配额、伏笔回收、连续重复与无推进集。用户通读确认完整目录前,不批量写单集剧本。
@@ -1,6 +1,6 @@
1
1
  # 短剧剧本方法论
2
2
 
3
- 本 Skill 是剧本阶段的必经方法层,产物仍由 `write-drama-episode`、`humanizer` 和 `review-drama-script` 落盘与验收。先读取项目已确认的 source-analysis、brief、bible、outline 和目标分集;不得另建 `.drama-state.json`,不得绕过本地项目状态机。
3
+ 本 Skill 是剧本阶段的必经方法层,产物仍由 `write-drama-episode`、`humanizer` 和 `review-drama-script` 保存与验收。先读取项目已确认的 source-analysis、brief、bible、outline 和目标分集;不得另建本地状态文件,不得绕过阶段门禁。
4
4
 
5
5
  原创或授权改编按当前阶段读取:[题材指南](../writing/genre-guide.md)、[开场规则](../writing/opening-rules.md)、[节奏曲线](../writing/rhythm-curve.md)、[爽点矩阵](../writing/satisfaction-matrix.md)、[钩子设计](../writing/hook-design.md)、[付费卡点](../writing/paywall-design.md)、[反派设计](../writing/villain-design.md) 和 [合规清单](../writing/compliance-checklist.md)。不为凑方法论指标篡改忠实改编事实;集数、平台和付费策略未确认时保持未决。
6
6
 
@@ -1,6 +1,5 @@
1
1
  # 编写短剧导演本
2
2
 
3
-
4
3
  导演本不能添加未获授权的剧情事实,也不能提前生成最终镜号或模型参数。它描述“这一场为什么这样拍”,后续 `build-drama-storyboard` 才把意图拆成可生成镜头。
5
4
 
6
- 使用 `../../assets/modules/write-drama-director-book/prompts/director_book.{zh,en}.txt` 生成导演本。输出严格 JSON,用 `project-store.mjs put-episode-document <项目目录> director-book <episode-key> <version> <文件>` 保存不可变版本,并用 `select-episode-document` 选定。涉及剧情重写、人物关系、台词含义或声音策略改变时必须让用户确认。
5
+ 使用 `../assets/modules/write-drama-director-book/prompts/director_book.{zh,en}.txt` 生成导演本。输出严格 JSON,用 `canvas document save` 保存不可变版本,并用 `canvas document get` 选定。涉及剧情重写、人物关系、台词含义或声音策略改变时必须让用户确认。
@@ -1,6 +1,5 @@
1
1
  # 编写单集剧本
2
2
 
3
-
4
3
  本阶段必须先执行插件内置 `short-drama` 方法论,再由本 Skill 完成单集格式化。已有专业剧本直接复用。长篇改编先用 `agent_clip` 按真实剧情边界连续分段,再用 `screenplay_conversion` 逐段忠实转换;两者都显式传 output_language,原文、对白和旁白仍逐字保留来源语言。只转换原文明确存在的场景、动作、对白和旁白,不擅自扩写。原创时读取 [开场规则](../writing/opening-rules.md)、[节奏曲线](../writing/rhythm-curve.md) 和 [钩子设计](../writing/hook-design.md),遵守本地简报、故事圣经和分集目录的剧情事实。
5
4
 
6
- 输出 JSON、Markdown 或纯文本剧本,包含规范场景头、可见动作、逐字对白/旁白、出场人物与道具。校验后用 `project-store.mjs put-script` 保存不可变初稿;随后必须由 `humanizer` 产生新版本并由 `review-drama-script` 批准,才能进入导演本。
5
+ 输出 JSON、Markdown 或纯文本剧本,包含规范场景头、可见动作、逐字对白/旁白、出场人物与道具。校验后用 `canvas document save` 保存不可变初稿;随后必须由 `humanizer` 产生新版本并由 `review-drama-script` 批准,才能进入导演本。
@@ -1,7 +1,7 @@
1
1
  # 验收与交付
2
2
 
3
- 只接收 `edit-drama-timeline` 按 [本地 Remotion 剪辑方案](../editing-workflow.md) 完成并通过审片的渲染版本。用 `media-tools.mjs qc` 核对分辨率、画幅、帧率、实际时长、编码、采样率、声道、响度和黑帧/冻结/静音事件;目标时长不要求逐秒命中,默认约 ±15% 的自然偏差不作为失败,超出时核对叙事理由和用户确认。从头到尾观看并听完,复核叙事、画面、声音、全部切点、字幕和片尾。交付前必须特别确认字幕不是默认黑底贴纸、说话人层级清楚、文字处于安全区;逐切点检查动作方向、视线、环境声和空间轴是否连续,并抽检淡化精确起始帧,避免仅靠长黑帧检测漏掉单帧黑闪。任何关键动作仅靠生成模型“应该会发生”而未在画面中实际成立,均不得标记为通过。
3
+ 只接收 `edit-drama-timeline` 按 [剪辑方案](../editing-workflow.md) 完成并通过审片的渲染版本。用媒体探测核对分辨率、画幅、帧率、实际时长、编码、采样率、声道、响度和黑帧/冻结/静音事件;目标时长不要求逐秒命中,默认约 ±15% 的自然偏差不作为失败,超出时核对叙事理由和用户确认。从头到尾观看并听完,复核叙事、画面、声音、全部切点、字幕和片尾。交付前必须特别确认字幕不是默认黑底贴纸、说话人层级清楚、文字处于安全区;逐切点检查动作方向、视线、环境声和空间轴是否连续,并抽检淡化精确起始帧,避免仅靠长黑帧检测漏掉单帧黑闪。任何关键动作仅靠生成模型“应该会发生”而未在画面中实际成立,均不得标记为通过。
4
4
 
5
- 批准版视频、UTF-8 SRT 和 ASS 放入 `delivery/<episode-key>/` 后,运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/editing-store.mjs" manifest <项目> <episode-key> <成片> <SRT> <ASS>`;脚本会重新校验该集时间线与完整审片记录,计算文件哈希,并以独占方式建立 `delivery/<episode-key>/manifest.json`。所有选中剧集均登记本 Skill 的 manifest 证据并通过 delivery 门禁后,执行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/workflow.mjs" complete <项目>` 固化项目终态。交付不得夹带临时缓存、未批准候选或覆盖既有 manifest。
5
+ 批准版视频、UTF-8 SRT 和 ASS 放入 `delivery/<episode-key>/` 后,重新校验该集时间线与完整审片记录,计算文件哈希,并以独占方式建立 `delivery/<episode-key>/manifest.json`。所有选中剧集均登记 manifest 证据并通过交付门禁后,执行 `canvas workflow status` 固化项目终态。交付不得夹带临时缓存、未批准候选或覆盖既有 manifest。
6
6
 
7
7
  如果平台、对象存储或分享流程另行上传交付文件,上传完成后必须把实际远端文件重新下载或读取服务端元数据,核对文件大小、SHA-256、时长、音视频流、字幕版本和分辨率;远端副本与本地 manifest 不一致时不得标记交付完成,也不能用压缩副本替代母版而不记录新的交付版本。
@@ -1,15 +1,14 @@
1
1
  # 使用 Remotion 编辑短剧时间线
2
2
 
3
+ 先运行 `ai-short-studio preflight`,读取 [剪辑方案](../editing-workflow.md) 和 [Remotion 剪辑规范](remotion-best-practices.md)。剪辑门禁沿用成熟 CLI 方案:只导入逐镜四项验收通过的已选视频及其音轨,在项目 `editing/<episode-key>/` 中建立候选 `timeline.json`;按 `episode_key` 校验每段选版、验收、路径、切点、转场和字幕后保存,不覆盖源素材。`editing/<episode-key>/` 只是本地渲染工作区,不是第二套项目状态;选版、审核和交付仍以画布资产版本和文档为准,工作区文件必须能追溯到对应 `asset@version`。
3
4
 
4
- 先运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/preflight.mjs" editing <项目目录>`,完整执行插件内置 `remotion-best-practices`,再读取 [本地剪辑方案](../editing-workflow.md)。剪辑门禁沿用成熟 CLI 方案:只导入逐镜四项验收通过的 selected 视频及其音轨,在项目 `editing/<episode-key>/` 中建立候选 `timeline.json`;用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/editing-store.mjs" put-timeline <项目> <timeline.json>` 按 `episode_key` 校验每段选版、验收、路径、切点、转场和字幕后落盘,不覆盖源素材。
5
+ 需要裁剪、换声、稳定、降噪、调色、局部修复、补帧、对口型或超分时,先切换到 `transform-drama-media` 执行统一媒体操作;时间线不得直接引用刚生成的候选。候选必须完成对应专项观察、结构化 QC 与完整观看,并通过画布审核记录批准成为已选版本后才可导入。`dialogue_sync=lip-synced` 必须指向 provenance 为 `operation=lip-sync` 的同一已选版本,且该精确 `asset@version` 必须有已批准的 `review_type=media-operation`、`operation=lip-sync` 审核记录;不能用原镜普通验收或另一版口型报告代替。对口型专项审核未通过时不得标记 `lip-synced`;超分专项审核未验证分辨率、时长帧率、音轨、脸手文字和运动伪影时,不得把高分辨率文件当成正式镜头。
5
6
 
6
- 需要裁剪、换声、稳定、降噪、调色、局部修复、补帧、对口型或超分时,先切换到 `transform-drama-media` 执行统一媒体操作;时间线不得直接引用刚生成的候选。候选必须完成对应专项观察、结构化 QC 与完整观看,并由 `review_media_operation` 批准成为 selected 后才可导入。`dialogue_sync=lip-synced` 必须指向 provenance 为 `operation=lip-sync` 的同一 selected 版本,且 `.short-drama/shot-reviews.json` 中该精确 `asset@version` 必须是已批准的 `review_type=media-operation`、`operation=lip-sync` 记录;不能用原镜普通验收或另一版口型报告代替。对口型专项审核未通过时不得标记 `lip-synced`;超分专项审核未验证分辨率、时长帧率、音轨、脸手文字和运动伪影时,不得把高分辨率文件当成正式镜头。
7
-
8
- 字幕必须来自实际音轨转写并人工复核,不能用提示词冒充;有字幕时 timeline 必须写 `subtitle_source:{method:"asr"|"manual-transcription",reviewed:true,source_assets:[...]}` 并绑定 selected 实际音轨。模型提示词刻意禁字、但剧情依赖手机界面、倒计时、消息、地点或时间信息时,必须把这些内容作为确定性的 Remotion 图形层纳入时间线与完整审片。任何镜头的源区间与时间线区间相差超过 ±10% 时必须写 `retime_exception:{confirmed:true,reason}`;对白覆盖的镜头必须写 `dialogue_sync` 为 `native`、`lip-synced`、`offscreen` 或 `no-visible-speech`。超过 5 秒无任何音轨的区间必须补声音或写 `silence_exceptions`;只有对白/旁白而没有环境、音乐、音效或原生声轨时必须补声音设计或写 `sound_design_exception`。实际总时长超过目标 ±15% 必须写用户确认的 `duration_exception:{user_confirmed:true,reason}`。时间线按 [剪辑合同](../editing-workflow.md) 保存并由 `editing-store.mjs put-timeline` 硬校验。用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/render-edit.mjs" scaffold <项目> <episode-key>` 生成确定性 Remotion 工程并物化渲染时间线后,每次渲染候选前执行 `freeze-edit-candidate.mjs create`(timeline 参数取 scaffold 生成的 `editing/<episode-key>/remotion/public/timeline.json`,remotion 目录取 `editing/<episode-key>/remotion`);先渲染审片版,用 `media-tools.mjs qc <文件>` 生成结构化报告,将完整 JSON 放进审片记录 `qc`,再完整观看和听完后 `put-review`。只有 `qc.passed=true` 且六维审片通过才可交付。
7
+ 字幕必须来自实际音轨转写并人工复核,不能用提示词冒充;有字幕时 timeline 必须写 `subtitle_source:{method:"asr"|"manual-transcription",reviewed:true,source_assets:[...]}` 并绑定 selected 实际音轨。模型提示词刻意禁字、但剧情依赖手机界面、倒计时、消息、地点或时间信息时,必须把这些内容作为确定性的 Remotion 图形层纳入时间线与完整审片。任何镜头的源区间与时间线区间相差超过 ±10% 时必须写 `retime_exception:{confirmed:true,reason}`;对白覆盖的镜头必须写 `dialogue_sync` 为 `native`、`lip-synced`、`offscreen` 或 `no-visible-speech`。超过 5 秒无任何音轨的区间必须补声音或写 `silence_exceptions`;只有对白/旁白而没有环境、音乐、音效或原生声轨时必须补声音设计或写 `sound_design_exception`。实际总时长超过目标 ±15% 必须写用户确认的 `duration_exception:{user_confirmed:true,reason}`。时间线按 [剪辑合同](../editing-workflow.md) 保存并硬校验。每次渲染候选前先冻结 timeline、Remotion 源码/依赖清单和全部引用媒体哈希(timeline 取 `editing/<episode-key>/remotion/public/timeline.json`,remotion 目录取 `editing/<episode-key>/remotion`);先渲染审片版,用媒体探测生成结构化报告,将完整 JSON 放进审片记录 `qc`,再完整观看和听完后写入审核结论。只有 `qc.passed=true` 且六维审片通过才可交付。
9
8
 
10
9
  第三方配音字幕必须由最终 selected 音频的词级 alignment 构建,每条写入 `audio_binding={asset_key,version_id,sha256,line_index,speech_timing_version,dubbing_contract_version}`;`subtitle_source.audio_bindings`、dialogue/voiceover 音轨和 lip-sync provenance 必须逐字段一致。配音重生或换版后,旧字幕和旧口型即使文件仍存在也视为 stale,必须重新对齐、重建字幕、重做口型并复审,禁止通过改文件名继续沿用。
11
10
 
12
- 字幕按正常电影样式制作,不做综艺/新闻花字:每条字幕保留 `speaker`(或双人对白的 `speakers`)供 SRT 元数据与审片使用,但默认 `show_speaker: false` 不在画面上显示说话人;只有画外音、电话等需要辨识声源的镜头才对该条设 `show_speaker: true`,双人对白带“- ”前缀。正文单一白色高对比字色、细黑描边加轻投影,不使用全片统一厚重黑色圆角贴纸或不透明底盒;下三分之一安全区不得遮挡脸、手和关键道具。每条最多 2 行,长句必须由时间线显式写入语义换行,Remotion 使用 `whiteSpace: pre-line` 保留,禁止自动换行产生单字/短词孤行;不要写句末 `。`/`.`(导出也会自动省略)。中文常规阅读速度控制在约 6–12 字/秒,停留不短于 700ms,快速回声可在不改变事实与语气的前提下压缩为等义短句。字幕入出点对齐帧栅格、按语音起止留 2–4 帧余量,连续对白按说话人切换而不是固定时长。候选冻结后用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/export-edit-subtitles.mjs" export <冻结timeline> <候选.srt> <候选.ass>` 生成同版本外置字幕;导出逐条校验,任一不通过即整体拒绝并列出每条错误(超长、超字/秒、停留过短、重叠、越界等),修正时间线后重新导出,禁止手改 SRT/ASS 或复用旧候选文件。镜头衔接审查必须逐切点记录“上一镜动作/视线/声音如何把下一镜带入”;若计划写了转场但实现仍为硬切,必须修改时间线或计划,不能仅保留名义字段。涉及后期补画的剧情动作,必须在时间线记录 `effect`/`graphics`,并在全片审片中单独验证其空间方向、接触关系和遮挡边界。
11
+ 字幕按正常电影样式制作,不做综艺/新闻花字:每条字幕保留 `speaker`(或双人对白的 `speakers`)供 SRT 元数据与审片使用,但默认 `show_speaker: false` 不在画面上显示说话人;只有画外音、电话等需要辨识声源的镜头才对该条设 `show_speaker: true`,双人对白带“- ”前缀。正文单一白色高对比字色、细黑描边加轻投影,不使用全片统一厚重黑色圆角贴纸或不透明底盒;下三分之一安全区不得遮挡脸、手和关键道具。每条最多 2 行,长句必须由时间线显式写入语义换行,Remotion 使用 `whiteSpace: pre-line` 保留,禁止自动换行产生单字/短词孤行;不要写句末 `。`/`.`(导出也会自动省略)。中文常规阅读速度控制在约 6–12 字/秒,停留不短于 700ms,快速回声可在不改变事实与语气的前提下压缩为等义短句。字幕入出点对齐帧栅格、按语音起止留 2–4 帧余量,连续对白按说话人切换而不是固定时长。候选冻结后从该候选的冻结 timeline 生成同版本外置字幕;导出校验逐条检查,任一不通过即整体拒绝并列出每条错误(超长、超字/秒、停留过短、重叠、越界等),修正时间线后重新导出,禁止手改 SRT/ASS 或复用旧候选文件。镜头衔接审查必须逐切点记录“上一镜动作/视线/声音如何把下一镜带入”;若计划写了转场但实现仍为硬切,必须修改时间线或计划,不能仅保留名义字段。涉及后期补画的剧情动作,必须在时间线记录 `effect`/`graphics`,并在全片审片中单独验证其空间方向、接触关系和遮挡边界。
13
12
 
14
13
  导入时间线前检查所有候选镜头的分辨率、帧率、色彩空间和像素长宽比;低分辨率修复镜头先以可追溯的本地转码副本统一到成片规格,允许轻量 Lanczos 放大、锐化和色彩匹配,但不得覆盖资产库原文件。转码参数和来源版本必须进入剪辑记录,避免在 Remotion 渲染时临时、不可复现地处理。
15
14
 
@@ -1,12 +1,11 @@
1
1
  # Remotion 短剧剪辑规范
2
2
 
3
+ 本模块是剪辑阶段的实现参考。先运行 `ai-short-studio preflight`,再读取 [剪辑与交付](../../editing-delivery.md) 和 [剪辑规范](../editing-workflow.md)。只接收逐镜四项验收通过且已选版的画布资产;保留源文件,时间线以画布剪辑计划文档为准。
3
4
 
4
- 本 Skill 是剪辑阶段的必经实现层。先运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/preflight.mjs" editing <项目目录>`,再读取 [本地剪辑与交付规范](../editing-workflow.md)。只接收逐镜四项验收通过且已 selected 的本地资产;保留源文件,每集时间线由 `editing/<episode-key>/timeline.json` 驱动并由 `editing-store.mjs` 校验。
5
-
6
- 没有 Remotion 工程时,用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/render-edit.mjs" scaffold <项目目录> <episode-key>` 从插件内置模板(`assets/remotion-template/`)生成确定性工程到 `editing/<episode-key>/remotion/`:自动把 selected 媒体复制进 `public/media/`、生成带 `file` 字段与 `subtitle_layout` 的 `public/timeline.json` 和可打包的 `src/timeline.generated.ts`;已有工程直接复用。禁止手搓 `npx create-video` 或绕过内置模板散落硬编码。素材放入工程 `public/`,用 `staticFile()` 引用;视频用 `OffthreadVideo`、音频用 `Audio`(均从 `remotion` 引入,时间裁切用 `trimBefore`/`trimAfter` 帧字段),图片使用 `<Img>`。依赖版本由模板 `package.json` 固定,`render-edit.mjs render` 首次自动 `npm install`,不要在工程内 `npx remotion add` 漂移版本。composition 的 `durationInFrames` 必须从 timeline 实际尾点计算,不能把“一分钟短剧”硬编码为 60 秒;目标时长默认允许约 ±15% 自然浮动,平台明确限长除外。
5
+ 若项目已有 Remotion 工程,直接复用其确定性模板;不要另建工程或把素材路径、入出点散落成硬编码。工程应把已选媒体放入 `public/media/`,生成带 `file` 字段与 `subtitle_layout` 的 `public/timeline.json` 和可打包的 `src/timeline.generated.ts`。素材放入工程 `public/`,用 `staticFile()` 引用;视频用 `OffthreadVideo`、音频用 `Audio`(均从 `remotion` 引入,时间裁切用 `trimBefore`/`trimAfter` 帧字段),图片使用 `<Img>`。依赖版本由工程锁定,不要临时添加包导致版本漂移。composition 的 `durationInFrames` 必须从 timeline 实际尾点计算,不能把“一分钟短剧”硬编码为 60 秒;目标时长默认允许约 ±15% 自然浮动,平台明确限长除外。
7
6
 
8
7
  所有动画和时间逻辑必须帧确定:使用 `useCurrentFrame()`、`useVideoConfig()`、`interpolate()`、`Easing` 和 `<Sequence>`;禁止 CSS transition、CSS animation 与 Tailwind 动画类。素材路径、入出点、音量、字幕和转场参数集中来自 timeline,不散落硬编码。剧情依赖而生成模型禁止或无法可靠绘制的手机 UI、倒计时、消息、地点和时间信息,必须由 timeline 驱动的 Remotion 图形层补齐并在完整审片中逐项核对;图形按语义分层,来电/倒计时使用不遮挡主体的顶部或侧边 HUD;回传信息若与对白字幕同时出现,只显示“目标/状态”等非重复信息的状态 HUD,只有独立无对白插入镜头才使用完整叙事卡片。图形优先锚定剧情载体附近的非人脸区域,但不得遮挡载体本身,不能所有类型套同一个居中大黑卡。`segments[]` 驱动画面;多镜时间线设 `audio_tracks_complete:true` 后视频组件静音,`audio_tracks[]` 独立驱动全部声音、可重叠 J/L-cut、constant-power 淡化与 BGM ducking,旧单镜未迁移时间线仍保留内嵌声音。`edit_points[]` 绑定每个切点的声音/动作/气氛/节拍依据,`labels[]` 驱动角标和标题。转场保存为 `{type,duration_frames}`;以硬切、动作切、视线切、构图匹配和 J/L-cut 为主,常规淡化只在明确语义下使用 6–12 帧,并用帧确定曲线避免机械线性闪变。实现交叉溶解时,前一画面最后一帧冻结在上层并完整淡出,露出下方不透明的下一镜,禁止重播尾部动作或让新旧两镜同时对黑底淡化;对应原生环境声必须真实重叠并做等长恒功率淡出/淡入。每个切点先判断叙事因果、动作峰值、对白落点、声音瞬态和气氛变化,再决定切点与声音桥;不得靠连续淡化掩盖素材逻辑断裂。画面统一只允许可追溯的轻量色彩匹配,参数必须进入 timeline 或剪辑记录。
9
8
 
10
- 字幕必须从实际成片音轨转写并人工复核,内部统一使用 Remotion `Caption` JSON:`text`、`startMs`、`endMs`、`timestampMs`、`confidence`,可附 `speaker` 和样式;同时输出烧录字幕、UTF-8 SRT 和 ASS。字幕走正常电影样式,不做综艺/新闻花字:默认不显示说话人(只有画外音、电话等需要辨识声源的镜头在 Caption 上设 `show_speaker: true`),说话人名条用小号浅灰次级文字;双人对白用 `speakers: ["甲","乙"]`,每行以“- ”开头且不叠名条。烧录样式必须与 `export-edit-subtitles.mjs` 生成的 ASS 完全一致:PlayRes 取成片宽高,字号约画面高 1/28(1080×1920 为 69px、名条 39px),左右下外边距约 8%,白色正文加细黑描边(约 2px)和 1px 轻投影,不要任何不透明底盒或黑色圆角贴纸;名条描边 1px、无投影。每条最多 2 行、单行容量按分辨率换算(1080×1920 约 13 字),时间线中的语义换行用 `whiteSpace: pre-line` 保留,不能把长句交给浏览器自动折行而产生孤字;句末不显示 `。`/`.`。中文常规阅读速度约 6–12 字/秒,导出器拦截超过 12 字/秒和短于 700ms 的停留,短时回声只能等义压缩,不能为了塞入时间码改写剧情事实;入出点对齐帧栅格、相对语音留 2–4 帧余量。字幕不能遮脸、手、关键道具或画内文字,必须在缩小预览和安全区内复核。每条独立音轨记录 selected 资产版本、源/时间线范围、角色和 `volume_envelope`;混音固定 `target_lufs` 与 `true_peak_dbtp`。H3 原生整轨只允许轻量、可逆的增益、EQ、降噪、压缩、限幅与短交叉淡化,不得用外部 TTS/BGM 覆盖失败。
9
+ 字幕必须从实际成片音轨转写并人工复核,内部统一使用 Remotion `Caption` JSON:`text`、`startMs`、`endMs`、`timestampMs`、`confidence`,可附 `speaker` 和样式;同时输出烧录字幕、UTF-8 SRT 和 ASS。字幕走正常电影样式,不做综艺/新闻花字:默认不显示说话人(只有画外音、电话等需要辨识声源的镜头在 Caption 上设 `show_speaker: true`),说话人名条用小号浅灰次级文字;双人对白用 `speakers: ["甲","乙"]`,每行以“- ”开头且不叠名条。烧录样式必须与同版本 ASS 完全一致:PlayRes 取成片宽高,字号约画面高 1/28(1080×1920 为 69px、名条 39px),左右下外边距约 8%,白色正文加细黑描边(约 2px)和 1px 轻投影,不要任何不透明底盒或黑色圆角贴纸;名条描边 1px、无投影。每条最多 2 行、单行容量按分辨率换算(1080×1920 约 13 字),时间线中的语义换行用 `whiteSpace: pre-line` 保留,不能把长句交给浏览器自动折行而产生孤字;句末不显示 `。`/`.`。中文常规阅读速度约 6–12 字/秒,导出校验拦截超过 12 字/秒和短于 700ms 的停留,短时回声只能等义压缩,不能为了塞入时间码改写剧情事实;入出点对齐帧栅格、相对语音留 2–4 帧余量。字幕不能遮脸、手、关键道具或画内文字,必须在缩小预览和安全区内复核。每条独立音轨记录 selected 资产版本、源/时间线范围、角色和 `volume_envelope`;混音固定 `target_lufs` 与 `true_peak_dbtp`。H3 原生整轨只允许轻量、可逆的增益、EQ、降噪、压缩、限幅与短交叉淡化,不得用外部 TTS/BGM 覆盖失败。
11
10
 
12
- 预览用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/render-edit.mjs" render <项目目录> <episode-key> --preview`(底层 `remotion studio --no-open`),审片版与交付版统一用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/render-edit.mjs" render <项目目录> <episode-key> [--out <path>]`(底层 `npx remotion render` 出片,默认 `delivery/<episode-key>/final.mp4`);QC 响度不达标时用 `render-edit.mjs loudness` 做 loudnorm 后处理。完整观看和听完、保存六项审片结论后才渲染交付版。成片目标与转场、响度、角标、画面连续性和交付清单以 `editing-workflow.md` 为准。
11
+ 预览和交付渲染使用项目现有 Remotion 工程;响度不达标时在工程内做 loudnorm 后处理。完整观看和听完、保存六项审片结论后才渲染交付版。成片目标与转场、响度、角标、画面连续性和交付清单以 `editing-workflow.md` 和 `editing-delivery.md` 为准。
@@ -1,22 +1,22 @@
1
1
  # 本地 Remotion 剪辑与交付
2
2
 
3
- 本方案保留成熟 CLI 流程的 selected 版本、逐镜四项验收、独立字幕、声音平衡、时间线 manifest 和全片验收门禁;执行层改为本地 Remotion。剪辑只读取本地 `assets.json` 中已选且通过逐镜验收的视频、音频和图片版本。涉及 Remotion 工程、React 标记、字幕或渲染时先使用 `remotion-best-practices`,按需读取其中 create、markup、captions 和 render 指南。
3
+ 本方案保留已选版本、逐镜四项验收、独立字幕、声音平衡、时间线 manifest 和全片验收门禁;执行层使用项目现有的本地 Remotion 工程。剪辑只读取画布中已选且通过逐镜验收的视频、音频和图片版本。涉及 Remotion 工程、React 标记、字幕或渲染时先使用 `remotion-best-practices`,按本文与 `editing-delivery.md` 核对工程、标记、字幕和渲染约束。
4
4
 
5
5
  ## 1. 入库与时间线
6
6
 
7
7
  - 保留源文件,不原地修改。
8
8
  - 项目中的单集时长是策划目标而非精确截止;默认允许实际成片约 ±15% 自然浮动,超出时记录叙事理由并重新确认。Remotion composition 必须读取时间线实际总时长,不能硬编码 60 秒;动作完成、对白可读和结尾呼吸优先于机械卡点。
9
- - 用 `media-tools.mjs probe` 记录分辨率、帧率、时长、编码、采样率与声道。
10
- - 在项目 `editing/<episode-key>/` 下维护该集候选 `timeline.json`;`segments[]` 记录镜头选版、入出点和 `{type,duration_frames}` 转场,`edit_points[]` 为每个相邻镜头边界记录卡点依据、转场理由和声音桥,`audio_tracks[]` 独立记录对白/旁白/环境/BGM/SFX/原生声轨、音量包络与淡化,`subtitles[]` 使用 Caption 合同,`labels[]` 记录人物角标、标题与片尾,`graphics[]` 记录必须由后期补齐的 phone-call/countdown/message 剧情图形层,`mix` 固化目标响度和 BGM ducking。多镜时间线必须设 `audio_tracks_complete:true` 且独立音轨无缝覆盖全片,只有此时渲染器才静音镜头内嵌声音;旧单镜时间线不声明该字段时仍保留内嵌声音。用 `node scripts/editing-store.mjs put-timeline <项目> <timeline.json>` 按 `episode_key` 统一校验并落盘。
9
+ - 用媒体探测记录分辨率、帧率、时长、编码、采样率与声道。
10
+ - 在项目 `editing/<episode-key>/` 下维护该集候选 `timeline.json`;它只是本地渲染工作区,不是第二套项目状态:镜头选版、审核批准和最终交付仍以画布资产版本与文档为唯一来源,工作区文件必须能追溯到这些版本。`segments[]` 记录镜头选版、入出点和 `{type,duration_frames}` 转场,`edit_points[]` 为每个相邻镜头边界记录卡点依据、转场理由和声音桥,`audio_tracks[]` 独立记录对白/旁白/环境/BGM/SFX/原生声轨、音量包络与淡化,`subtitles[]` 使用 Caption 合同,`labels[]` 记录人物角标、标题与片尾,`graphics[]` 记录必须由后期补齐的 phone-call/countdown/message 剧情图形层,`mix` 固化目标响度和 BGM ducking。多镜时间线必须设 `audio_tracks_complete:true` 且独立音轨无缝覆盖全片,只有此时渲染器才静音镜头内嵌声音;旧单镜时间线不声明该字段时仍保留内嵌声音。时间线保存为项目内可回读的 JSON,并按 `episode_key` 校验每段选版、验收、路径、切点、转场和字幕。
11
11
  - `segments[]` 的 `shot_key` 与视频 `asset_key` 都必须使用 `shot-epNNN-NNN`;进入交付前必须按当前已选制作计划的镜号和顺序完整覆盖,不能漏镜、增镜或重排。
12
12
  - Remotion 素材复制或链接到工程 `public/`,使用 `staticFile()`;视频用 `OffthreadVideo`、音频用 `Audio`(均从 `remotion` 引入,时间裁切用 `trimBefore`/`trimAfter` 帧字段),图片使用 `<Img>`。
13
- - 候选渲染前用 `freeze-edit-candidate.mjs create` 在 `editing/<episode-key>/candidates/<candidate-key>/` 冻结 timeline、Remotion 源码/依赖清单和全部引用媒体哈希;历史 manifest 只能指向该冻结快照,不能指向持续修改的工作时间线。
13
+ - 候选渲染前在 `editing/<episode-key>/candidates/<candidate-key>/` 冻结 timeline、Remotion 源码/依赖清单和全部引用媒体哈希;历史 manifest 只能指向该冻结快照,不能指向持续修改的工作时间线。
14
14
 
15
15
  ## 2. 粗剪、字幕与转场
16
16
 
17
17
  - 先按叙事因果建立粗剪,再裁掉无效开头、重复动作、动作回弹和空白尾帧;不得截断对白、呼吸、拟音或转场余量。
18
18
  - 优先在动作峰值、视线落点、对白意群结束、声音瞬态或构图匹配点切换。action-cut 必须同时连续承接动作方向、主体姿态、空间位置和道具状态;同一造型人物跨地点或道具突变时补建立镜头、重排或使用有明确时空含义的短淡化。J/L-cut 必须保持说话者清晰、口型不冲突。
19
- - 字幕以实际音轨转写并人工复核,使用 Remotion `Caption` JSON:`text`、`startMs`、`endMs`、`timestampMs`、`confidence`,可附 `speaker`(字符串)、`speakers`(1–2 人,双人对白)和 `show_speaker`(布尔,默认 false)。候选冻结后用 `export-edit-subtitles.mjs` 从该候选的冻结 timeline 同步生成 UTF-8 SRT 和 ASS,禁止复用其他版本文件;导出逐条校验,任一字幕不通过就整体拒绝并返回每条的错误码,不生成半截文件。
19
+ - 字幕以实际音轨转写并人工复核,使用 Remotion `Caption` JSON:`text`、`startMs`、`endMs`、`timestampMs`、`confidence`,可附 `speaker`(字符串)、`speakers`(1–2 人,双人对白)和 `show_speaker`(布尔,默认 false)。候选冻结后从该候选的冻结 timeline 同步生成 UTF-8 SRT 和 ASS,禁止复用其他版本文件;导出逐条校验,任一字幕不通过就整体拒绝并返回每条的错误码,不生成半截文件。
20
20
  - 电影字幕基线:默认不显示说话人(`show_speaker` 仅用于画外音、电话等需要辨识声源的镜头);SRT 始终保留说话人元数据行,ASS 烧录默认隐藏。双人对白每条物理行前加“- ”且不叠名条。ASS 布局按时间线实际分辨率生成:PlayResX/Y 等于成片宽高,字号约画面高 1/28,左右下外边距约 8%;正文白色、细黑描边、轻投影(BorderStyle 1,无底盒),禁用厚重黑色圆角贴纸。每条最多 2 行,单行容量按分辨率换算(1080×1920 约 13 字),长句必须在时间线显式语义断行并由 Remotion `whiteSpace: pre-line` 保留,禁止自动折行产生孤字;导出自动省略每行句末的 `。`/`.`。中文常规阅读速度约 6–12 字/秒,导出拦截超过 12 字/秒和短于 700ms 的停留,快速回声只能等义压缩;入出点对齐帧栅格并相对语音留 2–4 帧余量(不对齐出警告,由人工修时间线)。字幕放在下三分之一安全区,不能遮住脸、手、关键道具或画内文字。
21
21
  - 剧情图形按语义选择布局:来电人与倒计时使用顶部/侧边安全区 HUD;回传信息与对白字幕并存时只显示“目标/状态”等非重复信息,独立无对白插入镜头才用完整叙事卡片。图形可锚定手机、屏幕等剧情载体附近的非人脸区域,但不能遮住载体本身;不得所有 phone-call/countdown/message 图形共用居中大黑卡遮挡人物或关键道具。
22
22
  - 硬切、动作/视线/构图匹配优先;短淡化只用于时间、地点或情绪变化。常规淡化约 6–12 帧,使用帧确定的缓出曲线,不给所有镜头统一套转场;剪辑前先确认动作因果和视线落点,不能用淡化掩盖生成镜头的逻辑断裂。
@@ -31,15 +31,15 @@
31
31
  - 无平台专门标准时,全片参考 -14 至 -16 LUFS,true peak 不高于 -1 dBTP,最终以完整试听无削波、泵动和人声遮盖为准。
32
32
  - 统一画幅、帧率、色彩空间和像素长宽比;裁切不得伤及脸、手、关键道具、画内文字和字幕安全区。全片轻量色彩匹配参数必须写入 timeline 或剪辑记录,不能只硬编码在 Remotion 组件中。
33
33
  - 低分辨率候选镜头先生成可追溯的本地规范化副本,再进入 Remotion;可使用 Lanczos 放大、轻微锐化和色彩匹配,不覆盖资产账本中的原始媒体,并记录输入版本与转码参数。
34
- - 所有镜头级变换统一走 `submit_media_operation`,结果先作为未选候选保存。裁剪审核记录范围内、范围外、时长和音轨;替换音轨记录范围内、范围外、同步、声纹和时长;稳定、降噪、调色、遮罩模糊、补帧与局部重绘记录范围内、范围外、身份和时序连续;对口型记录同步时点、身份、口腔伪影、非目标脸和时长;超分记录分辨率、时长帧率、音轨、脸手文字、运动伪影和色彩裁切。每类操作都先保存 `media-tools.mjs qc` 完整输出并完整观看,再由 `review_media_operation` 选版;不得仅因任务成功或文件分辨率变大就导入时间线。
34
+ - 所有镜头级变换统一走 `canvas node run`,结果先作为未选候选保存。裁剪审核记录范围内、范围外、时长和音轨;替换音轨记录范围内、范围外、同步、声纹和时长;稳定、降噪、调色、遮罩模糊、补帧与局部重绘记录范围内、范围外、身份和时序连续;对口型记录同步时点、身份、口腔伪影、非目标脸和时长;超分记录分辨率、时长帧率、音轨、脸手文字、运动伪影和色彩裁切。每类操作都先保存媒体探测完整报告并完整观看,再写入审核记录后选版;不得仅因任务成功或文件分辨率变大就导入时间线。
35
35
  - 同角色的未来来电与当前对白共享同一基础声纹;电话感只用约 300–3400 Hz 窄带、轻压缩/限幅和短淡入淡出表达。替换电话音轨时必须静音原生对白的同一区间,记录来源和区间,并逐角色 A/B 验证。
36
36
 
37
37
  ## 4. Remotion 实现与交付
38
38
 
39
39
  - 动画使用 `useCurrentFrame()` 与 `interpolate()`;禁止 CSS transition、CSS animation 和 Tailwind 动画类。
40
40
  - 片段用 `<Sequence>` 表达帧起止,时间线参数集中由 `timeline.json` 驱动,不能把素材路径和切点散落在组件中。
41
- - 预览用 `node scripts/render-edit.mjs render <项目> <episode-key> --preview`(底层 `remotion studio --no-open`),审片版与交付版统一用 `node scripts/render-edit.mjs render <项目> <episode-key> [--out <path>]`(底层 `npx remotion render`);不要绕过脚手架手搓裸 `npx remotion render` 或 `npx create-video`。
42
- - 完整观看并听完最终文件,先把 `node scripts/media-tools.mjs qc <成片>` 的完整 JSON 原样写入审片记录 `qc`,再用 `node scripts/editing-store.mjs put-review <项目> <episode-key> <审片.json>` 保存六项结论。QC 硬检音视频流、黑帧、长静音、长冻结、BT.709、响度和真峰值;批准记录必须 `qc.passed=true`。最后用 `node scripts/editing-store.mjs manifest <项目> <episode-key> <成片> <SRT> <ASS>` 生成不可覆盖 manifest;脚本核对 QC 成片哈希、分辨率和时长。后续审计发现 P0/P1 时必须再次 `put-review` 写入失败结论,使旧 manifest 因 review 哈希变化而失效。
41
+ - 预览和交付渲染使用项目现有 Remotion 工程;不要绕过工程手搓裸渲染命令,也不要另建视频工程。
42
+ - 完整观看并听完最终文件,先把媒体探测的完整 JSON 原样写入审片记录 `qc`,再保存六项结论。QC 硬检音视频流、黑帧、长静音、长冻结、BT.709、响度和真峰值;批准记录必须 `qc.passed=true`。最后生成不可覆盖的 `manifest.json`,核对 QC 成片哈希、分辨率和时长。后续审计发现 P0/P1 时必须再次写入失败结论,使旧 manifest 因 review 哈希变化而失效。
43
43
 
44
44
  最小时间线骨架:
45
45
 
@@ -1,6 +1,6 @@
1
1
  # 独立短剧插件能力审计
2
2
 
3
- 当前制作仅使用 Hypit Runtime 中的 StarRouter;公网参考素材统一走 TempFile.org。下文保留的历史设计合同不表示已停用的远端能力仍可提交。
3
+ 当前制作通过平台画布生成节点执行,模型和供应商以实时目录为准(默认聚合供应商为 StarRouter,也支持平台已启用的百炼、RunningHub、Comfly 等模型)。需要公网参考素材时使用平台画布的参考素材上传流程,并在上传前确认权利和公开范围。本文是能力审计,用来说明保留与裁剪范围,不代表 CLI 当前执行入口;真实入口以 `canvas workflow status` 和 `canvas node types` 为准。下文保留的历史设计合同不表示已停用的远端能力仍可提交。
4
4
 
5
5
  审计基线为原项目的标准短剧制作链、内置短剧提示词和相关资产/任务流程。原项目当前包含 284 个 API route,其中大量属于账号、团队、管理后台、支付、积分、云存储和在线资产库;这些不是本地短剧制作能力,不移植。
6
6
 
@@ -8,42 +8,42 @@
8
8
 
9
9
  | 制作能力 | 插件实现 | 结论 |
10
10
  |---|---|---|
11
- | 源时间线情感配音 | `speech-timing.mjs`、`dubbing-compiler.mjs`、`dubbing-fit.mjs`、`dubbing-performance-review.mjs`、`subtitles-from-audio.mjs` | 原声证据、完整表演合同、三轮上限、八维审核和字幕/口型同源性均为硬门禁 |
12
- | 项目、分集与版本 | `manage-drama-projects`、`project-store.mjs`、`project-spec-v1.md` | 固定目录、统一配置、来源归档、不可变版本、显式选版 |
11
+ | 源时间线情感配音 | 语音时序、配音合同、配音适配检查、配音表演审核、字幕生成 | 原声证据、完整表演合同、三轮上限、八维审核和字幕/口型同源性均为硬门禁 |
12
+ | 项目、分集与版本 | `manage-drama-projects`、`canvas document save`、`project-spec-v1.md` | 统一配置、来源归档、不可变版本、显式选版 |
13
13
  | 小说/要求分析到剧本 | analysis、brief、bible、outline、`short-drama`、episode Skills | 文本由 Codex 完成;剧本强制经过短剧方法论、Humanizer 与复核 |
14
14
  | 导演本 | `write-drama-director-book` | 场次导演合同单独保存 |
15
15
  | 剧本自然化与复核 | `humanizer`、`review-drama-script` | 新版本落盘,复核版本必须匹配所选剧本;合规清单形成硬门禁 |
16
16
  | 人物、场景、道具分析 | `plan-drama-assets`、三类资产 Skills | 证据化提取、版本和未决项门禁 |
17
- | 人物/场景/道具设定板 | 各资产生成 Skill、`character-appeal.mjs`、`character-appeal-review.mjs` | 人物含脸部、三主视图与辅助设定;成年魅力、儿童可爱保护、专属妆造和记忆锚点使用不可互相补偿的生成与选版门禁;场景含九视角、平面/轴测;道具含主视图、三视图与结构细节 |
17
+ | 人物/场景/道具设定板 | 各资产生成 Skill、人物吸引力审核、人物吸引力审核 | 人物含脸部、三主视图与辅助设定;成年魅力、儿童可爱保护、专属妆造和记忆锚点使用不可互相补偿的生成与选版门禁;场景含九视角、平面/轴测;道具含主视图、三视图与结构细节 |
18
18
  | 分镜与镜头修订 | storyboard/revision Skills | 资产白名单、来源覆盖、连续性与版本化 |
19
- | 镜头组、跨镜空间与尾帧承接 | `shot_group`、`plan-shot-continuity`、`hypit-runtime.mjs`、`prepare_previous_tail` | 校验叙事组连续性;按 previous-tail 链派生生成组,不同组并行、同组串行;只从已审核 selected 上一镜派生带 SHA-256 来源链的首帧 |
19
+ | 镜头组、跨镜空间与尾帧承接 | `shot_group`、`plan-shot-continuity`、上一镜尾帧承接、上一镜尾帧承接 | 校验叙事组连续性;按 previous-tail 链派生生成组,不同组并行、同组串行;只从已审核 selected 上一镜派生带 SHA-256 来源链的首帧 |
20
20
  | 分镜图、视频提示词、镜头视频 | storyboard image/video Skills | 视频提示词按 Seedance 2.0、MiniMax H3 或已确认通用协议编译并本地版本化;由 Provider 实时能力控制参数 |
21
- | 原生声音与外部音频 | `design-drama-audio`、`native-audio-audit.mjs` | native-first 路由、电影感旁白、CosyVoice 声音设计/克隆、七维复听和已授权外部音频;七维后配兜底和口型驱动仍停用 |
22
- | 授权配乐目录 | `music-catalog`、`music-license-ledger.mjs`、`register_licensed_music` | 剧情条件编译、官方入口、本地试听下载边界、不可变许可证收据与时间线用途校验 |
23
- | 生成服务 | `drama-generation-service`、Hypit Runtime | StarRouter 图片、视频、语音、音乐与转写;模型和参数由项目确认,媒体版本保留 provenance |
24
- | 临时参考素材发布 | `publish-drama-references`、TempFile.org 适配器 | 公网 HTTPS URL、逐项确认、哈希绑定、本地上传收据、有效收据复用和跨会话查询;不作为资产库 |
25
- | 异步任务与恢复 | task ledger、monitor/recover Skills | 跨进程安全账本、输入去重、统一输出和结果对账 |
26
- | 剪辑与交付 | `remotion-best-practices`、timeline/delivery Skills | 吸收成熟 CLI 的选镜、切点、字幕、角标、转场、响度与完整审片规则,并用 Remotion 实现 |
27
- | 媒体能力主编排 | `workflow-stages.mjs`、`orchestrate-short-drama` | 明确人物门禁、连续性/尾帧、原生声音、授权音乐、本地媒体修复和交付顺序;旧兜底、口型与远端超分节点已禁用 |
28
- | 跨会话恢复与环境 | SessionStart hook、`RESUME.md`、`AGENTS.md`、`preflight.mjs` | 项目内恢复当前阶段、选版和任务;初始化及媒体/剪辑阶段留下无密钥环境报告 |
21
+ | 原生声音与外部音频 | `design-drama-audio`、原生音频审核步骤 | native-first 路由、电影感旁白、受控 TTS(以实时目录为准,百炼 CosyVoice 可用时可用于设计/克隆音色)、七维复听和已授权外部音频;七维后配兜底和口型驱动仍停用 |
22
+ | 授权配乐目录 | [授权音乐目录与导入边界](music-catalog-providers.md)、音乐授权记录、`music-generate` 节点 | 剧情条件编译、官方入口、本地试听下载边界、不可变许可证收据与时间线用途校验 |
23
+ | 生成服务 | `drama-generation-service`、画布生成节点 | 实时目录中的图片、视频、语音、音乐与转写模型;模型和参数由项目确认,媒体版本保留 modelKey、sourceTaskId 等 provenance |
24
+ | 临时参考素材发布 | 画布参考素材上传 | 平台临时公开地址、逐项确认、哈希绑定、复用和跨会话查询;不作为资产库 |
25
+ | 异步任务与恢复 | `task list/get/wait`、monitor/recover Skills | 任务查询、输入去重、统一输出和结果对账 |
26
+ | 剪辑与交付 | `remotion-best-practices`、timeline/delivery Skills | 吸收成熟 CLI 的选镜、切点、字幕、角标、转场、响度与完整审片规则,并用项目已有 Remotion 工程实现 |
27
+ | 媒体能力主编排 | `canvas workflow status`、`orchestrate-short-drama` | 明确人物门禁、连续性/尾帧、原生声音、授权音乐、本地媒体修复和交付顺序;旧兜底、口型与远端超分节点已禁用 |
28
+ | 跨会话恢复与环境 | `canvas workflow status`、`ai-short-studio preflight` | 项目内恢复当前阶段、选版和任务;初始化及媒体/剪辑阶段留下无密钥环境报告 |
29
29
 
30
30
  ## 从原系统能力转换而来
31
31
 
32
- - 数据库项目、剧集、分镜和资产表转换为项目目录、JSON 版本和 SHA-256 资产账本。
33
- - 在线任务服务转换为本地任务账本;Provider 任务 ID 只作为外部回执,不是资产。
32
+ - 数据库项目、剧集、分镜和资产表转换为画布项目、文档版本和 SHA-256 资产版本。
33
+ - 在线任务服务转换为画布任务记录;Provider 任务 ID 只作为外部回执,不是资产。
34
34
  - 提示词数据库与 seed 转换为各原子 Skill 自带的中英文模板;固定词表集中在 `controlled-vocabulary.json`,动态项目上下文在调用时生成。
35
- - 原项目 Provider 调用转换为独立 MCP 生成服务;文本不再绕到外部文本模型。
36
- - 原 CLI 的 selected 版本、逐镜验收、字幕、声音平衡、时间线 manifest 和全片验收门禁保留,执行层使用本地 Remotion。
35
+ - 原项目 Provider 调用转换为画布生成节点;文本不再绕到外部文本模型。
36
+ - 原 CLI 的 selected 版本、逐镜验收、字幕、声音平衡、时间线 manifest 和全片验收门禁保留,执行层复用项目已有 Remotion 工程,简单连续直切可使用 `drama-edit-render` 节点。
37
37
 
38
38
  ## 明确不保留
39
39
 
40
40
  - 登录、用户、团队、邀请、权限、管理员后台。
41
41
  - 支付、积分、套餐、价格发布和用量计费。
42
- - 永久云对象存储、在线素材市场、全局共享资产库和业务数据库同步。只保留为模型传输服务的可选临时参考图发布。
42
+ - 永久云对象存储、在线素材市场、全局共享资产库和业务数据库同步。只保留平台画布的参考素材上传。
43
43
  - 在线模板 CRUD、提示词管理后台、通知、SSE 和 Web 页面状态。
44
- - 无限画布、节点编辑器及其节点 ID 合同。
44
+ - 旧版固定功能节点链和本地 module-run 执行器。
45
45
 
46
- 原项目四组制作提示词共有 45 个唯一 stem:38 个按原能力映射,`character_reference_to_sheet` 合并优化为人物完整 `character_asset_sheet`,`panel_h3_video` 重构为独立于画布的 `h3_video`;`character_voice_recommend_cosy` 已去除单一供应商耦合并吸收到通用 `character_voice_recommend`,而 `director_snapshot_render`、`project_cover_generation` 仍不进入标准短剧插件。插件另补 source analysis、brief、director book、production plan、script review、画风/资产完整设定板和 Seedance 2.0 等标准制作模板,当前合计 52 组中英文模板。
46
+ 原项目四组制作提示词共有 45 个唯一 stem:38 个按原能力映射,`character_reference_to_sheet` 合并优化为人物完整 `character_asset_sheet`,`panel_h3_video` 重构为独立于画布的 `h3_video`;`character_voice_recommend_cosy` 已去除单一供应商耦合并吸收到通用 `character_voice_recommend`,而 `director_snapshot_render`、`project_cover_generation` 仍不进入标准短剧插件。插件另补 source analysis、brief、director book、production plan、script review、画风/资产完整设定板和 Seedance 2.0 等标准制作模板,当前合计 53 组中英文模板。
47
47
 
48
48
  人物视觉不是普通美观评分:`audience_appeal` 先从明确年龄证据区分 `adult-charisma` 与 `child-cuteness`;定妆图逐项审查年龄、身份、妆造服装、`memory_anchors`、观众吸引力及保护标记。任何一项失败都禁止选版。跨镜引用用档案 SHA、`appearance_id` 和 `identity_constraints` 绑定,连续性计划用 `visual_identity` 阻止无剧情证据的换脸、换妆造或换装。
49
49
 
@@ -52,10 +52,10 @@
52
52
  ## 当前边界
53
53
 
54
54
  - StarRouter 当前声明图片、视频、同步语音、音乐、语音转写和翻译能力;长文本异步语音返回 TAR,尚未开放为可直接剪辑的音频资产。
55
- - CosyVoice 自定义音色设计/克隆只在当前目标模型明确支持 voice reference 时使用,必须使用真实音色 ID 并通过试听和审核;不支持时不得声称 H3 原生对白已固定。七维后配兜底、SeedVR2.5 超分及 MuseTalk 口型驱动仍缺少已验证的统一生产入口,当前明确禁用。
55
+ - 百炼 CosyVoice 的自定义音色设计/克隆只在实时模型目录返回该能力时使用,必须使用真实音色 ID 并通过试听和审核;StarRouter 当前未提供等价能力,不支持时不得声称 H3 原生对白已固定。七维后配兜底、SeedVR2.5 超分及 MuseTalk 口型驱动仍缺少已验证的统一生产入口,当前明确禁用。
56
56
  - 音乐目录不提供抓站下载器。在线结果只打开官方搜索入口,登录、试听、下载和当次许可证判断由用户在站点完成;插件只接收本地文件与证据,并在 audio-plan 和时间线两次核对用途。
57
57
  - 插件不内置大型模型价格表或替用户估价;生成前读取实时 Provider 目录并要求用户确认完整制作计划。
58
- - TempFile.org 临时参考地址对持有链接者公开,有效期按上传收据核对;不保证长期可用,也不替代本地资产。
58
+ - 画布参考素材的临时公开地址对持有链接者公开,使用前核对权利、公开范围和有效期;不保证长期可用,也不替代本地资产。
59
59
  - Remotion 工程按项目创建,不在插件里复制固定业务工程;这样可保持素材路径、画幅、字幕和交付规格可追溯。
60
60
 
61
61
  ## 外部项目对照审计
@@ -85,8 +85,8 @@
85
85
  | 剧本文本的确定性字段解析 | 暂不引入 | 当前剧本合同允许 JSON、Markdown 和纯文本;若未来统一为结构化剧本,再增加逐行时长和角色引用硬门禁 |
86
86
  | Higgsfield 模型目录、价格、过滤词和 CLI | 明确拒绝 | 与当前 Provider 不同且易过期;实时能力目录、请求快照和本地账本是唯一事实来源 |
87
87
  | Shuohao 独立 HTML 报告与 Higgsfield 记忆数据库 | 明确拒绝 | Studio 和项目内请求、任务、提示词、资产账本已覆盖,复制会形成第二事实来源 |
88
- | 每个工具的可执行自检 | 已吸收为集中入口 | 保留现有最小自检,由 `integration-self-check.mjs --self-check` 统一执行,不复制一套测试框架 |
89
- | 营销工作室、无限画布和平台专属应用 | 范围外 | 不属于“本地素材到本地短剧成片”的标准制作链 |
88
+ | 每个工具的可执行自检 | 已吸收为集中入口 | 保留现有最小自检,由 集成自检 统一执行,不复制一套测试框架 |
89
+ | 营销工作室、原在线模板后台和平台专属应用 | 范围外 | 不属于“本地素材到本地短剧成片”的标准制作链 |
90
90
 
91
91
  ### 三轮专业知识审计
92
92
 
@@ -108,4 +108,4 @@
108
108
 
109
109
  ## 验证口径
110
110
 
111
- `node scripts/audit-plugin.mjs` 必须同时验证 Skill 归属、全部中英文模板、变量对称、系统变量注入、无未替换变量、项目规范、Seedance/H3 专属合同、UI 元数据和原系统字段隔离。`node scripts/integration-self-check.mjs --self-check` 必须先执行全部脚本与 Provider 合同自检,再跑通九阶段门禁、来源归档、并发任务账本、资产 provenance 与选版、视频提示词版本、逐镜验收、时间线、完整审片、交付 manifest 和全项目校验;插件与每个 Skill 必须通过官方结构校验。
111
+ `ai-short-studio skill status` 只验证 Skill 归属、安装校验和与包版本;中英文模板配对、变量槽对称、`module-map.json` 路径和人工索引一致性由 CLI 包测试 `test/skill-content.test.ts`(`npm test`)在打包前校验。`ai-short-studio preflight` 只检查 CLI 版本、服务连接、认证和模型配置;阶段门禁、来源归档、并发任务、资产 provenance 与选版、视频提示词版本、逐镜验收、时间线、完整审片和交付 manifest 分别由 `canvas document save`、`canvas workflow status`、`canvas asset review` 和交付审核入口校验。
@@ -1,19 +1,13 @@
1
1
  # 配置生成模型
2
2
 
3
- 原创短剧与原生复刻是两条链路。短剧只使用 Hypit Runtime 的 StarRouter 配置;参考片复刻请使用原生 `hypit recreate`。制作开始前由用户确认图片、视频、语音、音乐的模型和关键参数,不替用户决定付费模型。
3
+ 原创短剧与参考片复刻是两条链路。短剧使用项目已确认的 StarRouter 模型配置;参考片复刻读取 [复刻知识问答](../recreation/recreation-qa.md) 中的画布节点。制作开始前由用户确认图片、视频、语音、音乐的模型和关键参数,不替用户决定付费模型。
4
4
 
5
- `hypit short-drama init` 会在项目内生成并选中 `hypit.runtime.json`:`starrouter.video` 使用 `@hypit/provider-starrouter`、`platform` 凭据和 `publicHosting: "tempfile"`。旧项目缺少该文件时运行 `hypit runtime init --workspace <项目目录>`;已存在的 Runtime 不会被初始化命令覆盖。凭据通过 Hypit 安装主机的 Runtime Store 管理,运行 `hypit auth login starrouter.video --workspace <项目目录>`;短剧插件、Dashboard 和项目文件都不保存 API Key。公网素材统一使用 tempfile.org,上传前仍须确认素材权利和公开风险。
5
+ 先运行 `ai-short-studio canvas settings get --project <projectId> --json` 和 `canvas node types --json`,读取可选的模型、输入端口、参数和实时能力。使用 `canvas settings set --file settings.json --expected-version <version>` 原子写入图片、视频、音频、音乐模型及参数,并回读确认 `currentValue`、`effectiveValue` 和 `source`。项目、日志和文档都不保存 API Key;密钥由用户自行配置。
6
6
 
7
- 在 Dashboard 选择模型与参数,或使用 `project-store.mjs update-project` 保存不含密钥的配置。图片、视频、语音及音乐都选 `starrouter`;模型必须属于 `list_generation_providers` 当前目录。随后运行:
8
-
9
- ```bash
10
- node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/provider-setup.mjs" <项目目录>
11
- ```
12
-
13
- 命令只做非付费连接探测,写入 `.short-drama/provider-setup.json`,并绑定项目模型、参数和 Runtime 文件哈希。更改模型、参数或 Runtime 后重新探测。旧项目中的 RunningHub、Comfly 直连、百炼、MuseTalk 及自定义远端厂商配置不得继续制作,先改为 StarRouter 并重新确认。
7
+ 图片、视频、语音及音乐都选择 `starrouter` 模型,模型必须属于 `canvas node types` 当前目录。切换模型时整组替换参数,不能残留上一模型字段。参考素材需要公网 URL 时,先确认素材权利、公开暴露和用途许可;上传或临时发布凭据不得写入文档或日志。
14
8
 
15
9
  StarRouter 已列出的主要模型包括图片 `gpt-image-2`,视频 `MiniMax-H3`、`MiniMax-H3-Max` 与 Seedance,语音 `speech-2.8-hd`、`speech-2.8-turbo`,音乐 `suno_music`,以及默认转写/翻译 `whisper-1`。`qwen3-asr-flash` 已从默认目录移除并禁用,其 transcription/translation 实测均返回上游 404;渠道恢复前不要选用。
16
10
 
17
- 无限画布使用音乐时,模型键为 `starrouter::suno_music`,节点 kind 为 `music-generate`,输出 AUDIO。节点 config 使用 `prompt`、`title`、`tags`、`lyrics` 和 `makeInstrumental`;`prompt` 必填,`lyrics` 与 `makeInstrumental: true` 互斥。提交使用 `/suno/submit/MUSIC`,结果通过 `/suno/fetch/{task_id}` 轮询,成功结果只登记实际音频而非封面或视频。
11
+ 无限画布使用音乐时,模型键为 `starrouter::suno_music`,节点 kind 为 `music-generate`,输出 AUDIO。节点 config 使用 `prompt`、`title`、`tags`、`lyrics` 和 `makeInstrumental`;`prompt` 必填,`lyrics` 与 `makeInstrumental: true` 互斥。成功结果只登记实际音频而非封面或视频。
18
12
 
19
- StarRouter 当前未验证 CosyVoice 自定义音色设计/克隆、SeedVR2.5 超分和 MuseTalk 口型驱动的等价能力;相关操作须先核对实时能力,未验证时停下并提示用户选择其他已支持方案。短剧最终视频统一通过 `hypit short-drama production plan/build` 执行现有审核与付费门禁。
13
+ StarRouter 不提供 CosyVoice 自定义音色设计/克隆、SeedVR2.5 超分和 MuseTalk 口型驱动;百炼 CosyVoice 由平台实时目录注册,只有 `canvas node types` 返回对应节点和音色能力、且用户确认后才能使用。相关操作须先核对实时能力,未验证时停下并提示用户选择其他已支持方案。短剧最终视频通过 `video-generate` 节点执行,并继续遵循制作计划、审核与付费门禁。
@@ -1,13 +1,15 @@
1
1
  # 短剧声音设计
2
2
 
3
+ 编写配音、音色或音乐提示词时,先按 [通用提示词规范](../prompt/prompt-craft.md) 的音频/音乐维度裁剪:对白写说话人、音色、语言、情绪、停顿和试听来源,音乐写结构、段落、节拍、情绪、歌词或纯音乐及混音限制;不要把视频的镜头维度套到音频节点。
4
+
3
5
  优先在视频模型支持时保留原生对白、环境声和动作声。逐镜审核语言、说话者、文本、可懂度、时间同步、环境动作声和未声明音乐。失败时记录实际区间与原因;合格部分不重复生成。
4
6
 
5
7
  独立语音先用 `voice_analysis` 分离说话人与台词,再按项目初始化时确认的 `audio-plan.voice_consistency` 绑定声音。默认 `first_appearance_sample` 只从人物第一次出场且有清晰对白的已有视频或原声截取实际说话区间,保存来源镜头、起止时间、SHA-256 并先展示试听;样本不是 `voice_id`,用户确认后才调用当前 Provider 的 `voice-clone` 创建真实音色 ID,再试听、审核并绑定。没有已有来源音频时不得用尚未生成的首镜反推音色,必须让用户上传样本或选择 Provider voice。`user_upload` 使用用户上传且已确认有权使用的样本,`global_asset` 使用全局资产库已审核 voice ID,`provider_voice_id` 使用实时 Provider 目录声音,`none` 不建立跨镜绑定。当前 Provider 默认支持已确认 voice ID,只有实时能力明确返回不支持时,才切换支持的 Provider voice、后配音或明确放弃固定音色;不能把未收到不支持结果的 H3 原生音频判为未固定。生成前核对逐字文本和使用权,输出作为未选候选逐条试听、审核后再选版。
6
8
 
7
- CosyVoice 自定义音色设计/克隆只有在实时能力明确支持且目标模型匹配时,才可在独立 TTS 流程中使用真实音色 ID,并经过试听和审核;它不能静默覆盖 H3 原生对白。MuseTalk 与旧 RunningHub 口型驱动仍暂时禁用。旧 audio-plan 中的失效配置不得继续提交付费任务;向用户说明缺失能力,并先重新确认当前可用模型和制作方案。不得把临时音色或未通过审核的配音默认为正式结果。
9
+ CosyVoice 自定义音色设计/克隆只在目标为百炼 CosyVoice、实时模型目录返回该能力且用户确认时,才可在独立 TTS 流程中使用真实音色 ID,并经过试听和审核;它不能静默覆盖 H3 原生对白。StarRouter 没有等价能力;MuseTalk 与旧 RunningHub 口型驱动仍暂时禁用。旧 audio-plan 中的失效配置不得继续提交付费任务;向用户说明缺失能力,并先重新确认当前可用模型和制作方案。不得把临时音色或未通过审核的配音默认为正式结果。
8
10
 
9
11
  现有 `cinematic-tts` 和 `generate_audio_fallback` 合同暂存以读取旧项目,但因自定义音色能力未验证,调用会明确拒绝。重新设计时先从当前 selected 原声资产建立对齐证据;最多三轮,每轮必须经八维审核并绑定最终 selected 音频,禁止自动追加第四次。
10
12
 
11
13
  `character_voice_recommend`、`character_voice_description` 可辅助写人物声音档案,`music_track_design` 用于音乐计划;这些文本提示词不构成已验证的自定义音色生成能力。
12
14
 
13
- 需要实际生成背景音乐、主题曲或纯音乐时,把审核后的曲目计划写入无限画布 `music-generate` 节点。使用 `starrouter::suno_music` 时,`prompt` 必填,`title`、`tags`、`lyrics` 和 `makeInstrumental` 非空时才提交;纯音乐不能同时提供歌词。生成成功后必须回读 AUDIO 资产版本并试听,确认时长、响度、风格、歌词与画面节奏后再选版,不能把音乐计划文本当作已生成音频。
15
+ 需要实际生成背景音乐、主题曲或纯音乐时,把审核后的曲目计划写入无限画布 `music-generate` 节点。使用 `starrouter::suno_music` 时,`prompt` 必填,`title`、`tags`、`lyrics` 和 `makeInstrumental` 非空时才提交;纯音乐不能同时提供歌词。生成成功后必须回读 AUDIO 资产版本并试听,确认时长、响度、风格、歌词与画面节奏后再选版,不能把音乐计划文本当作已生成音频。需要从已有授权曲库选曲或核对许可证收据时,读取 [授权音乐目录与导入边界](../music-catalog-providers.md)。