@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
package/README.md CHANGED
@@ -219,6 +219,6 @@ npm run release:ci:test -- --version 0.1.1-beta.0
219
219
 
220
220
  Use `canvas node diagnose` to inspect inputs, selected versions, task status and recovery actions without running a model. `canvas node storyboard-draft` reads an unapproved planning draft; `--file` submits explicit edit/promote requests and `--dry-run` previews them. Content errors do not prevent draft saves. Promotion validates the complete plan; draft saves neither change the formal selection nor generate media. See the bundled Skill's `references/agent-recovery.md`. Image quality is inspected by a person or Agent; the platform checks review records and provenance, rather than detecting visual defects automatically.
221
221
 
222
- Agent 可直接在 `text-resource` 节点保存剧本、导演本和制作计划等自由画布文档(底层 schema key 保持兼容);每次保存都通过 `--input` 固化上游版本,审核使用独立 `hypit.review.v1` 文档。历史 `screenplay-resource` 和 `storyboard-draft` 只用于迁移旧项目,不得用于新项目。
222
+ Agent 可直接在 `text-resource` 节点保存剧本、导演本和制作计划等自由画布文档(文档结构由平台画布统一校验);每次保存都通过 `--input` 固化上游版本,审核使用独立 `canvas.review.v1` 文档。历史 `screenplay-resource` 和 `storyboard-draft` 只用于迁移旧项目,不得用于新项目。
223
223
 
224
224
  Agents author freeform JSON documents directly in `text-resource` nodes and preserve every source version through `--input`; legacy screenplay resources and storyboard drafts are migration-only compatibility paths.
@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
2
2
  import { BaseCommand } from '../../../base-command.js';
3
3
  import { commandApi, projectFlag } from '../../../command-helpers.js';
4
4
  export default class CanvasDocumentGet extends BaseCommand {
5
- static description = '读取画布 Hypit 文档当前选定版本及原始 JSON';
5
+ static description = '读取画布文档当前选定版本及原始 JSON';
6
6
  static args = { nodeId: Args.string({ required: true }) };
7
7
  static flags = { ...BaseCommand.baseFlags, project: projectFlag };
8
8
  async run() {
@@ -10,12 +10,12 @@ export default class CanvasDocumentGet extends BaseCommand {
10
10
  const { api } = await commandApi(flags);
11
11
  const node = await api.node(flags.project, args.nodeId);
12
12
  if (node.kind !== 'text-resource' || typeof node.refId !== 'string')
13
- throw new Error('节点不是已保存的 Hypit 文档');
13
+ throw new Error('节点不是已保存的画布文档');
14
14
  const assetPayload = await api.asset(flags.project, node.refId);
15
15
  const asset = assetPayload.asset && typeof assetPayload.asset === 'object' && !Array.isArray(assetPayload.asset)
16
16
  ? assetPayload.asset : null;
17
17
  if (!asset)
18
- throw new Error('Hypit 文档资产不存在');
18
+ throw new Error('画布文档资产不存在');
19
19
  const selectedVersion = asset.selectedVersion && typeof asset.selectedVersion === 'object' && !Array.isArray(asset.selectedVersion)
20
20
  ? asset.selectedVersion : null;
21
21
  this.print({ nodeId: args.nodeId, assetId: node.refId, metadata: asset.metadata ?? null,
@@ -1,6 +1,7 @@
1
1
  import { Args, Flags } from '@oclif/core';
2
2
  import { BaseCommand } from '../../../base-command.js';
3
3
  import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
4
+ import { assertCanvasSchemaKey } from '../../../domain/canvas-schema-key.js';
4
5
  export default class CanvasDocumentSave extends BaseCommand {
5
6
  static description = '将 JSON 保存为画布文本资源的不可变文档版本';
6
7
  static args = { nodeId: Args.string({ required: true }) };
@@ -9,12 +10,17 @@ export default class CanvasDocumentSave extends BaseCommand {
9
10
  project: projectFlag,
10
11
  file: Flags.string({ description: 'JSON 文档文件;省略时读取 stdin' }),
11
12
  name: Flags.string({ required: true, description: '文档名称' }),
12
- 'schema-key': Flags.string({ required: true, description: 'Hypit 文档结构版本,例如 hypit.brief.v1' }),
13
+ 'schema-key': Flags.string({ required: true, description: '画布文档结构版本,例如 canvas.brief.v1' }),
13
14
  'document-key': Flags.string({ required: true, description: '项目内稳定文档键,例如 brief 或 ep-001.script' }),
14
15
  input: Flags.string({ multiple: true, description: '依据的上游节点 ID,可重复指定' }),
15
16
  };
16
17
  async run() {
17
18
  const { args, flags } = await this.parse(CanvasDocumentSave);
19
+ // 先校验合同键再发请求:键写错时不必先完成节点与上游选版查询。
20
+ const schemaKey = assertCanvasSchemaKey(flags['schema-key']);
21
+ if (schemaKey !== flags['schema-key']) {
22
+ this.warn(`--schema-key 的旧前缀已归一化为 ${schemaKey},请改用 canvas.* 合同键。`);
23
+ }
18
24
  const content = await readJsonInput(flags.file);
19
25
  const { api } = await commandApi(flags);
20
26
  const node = await api.node(flags.project, args.nodeId);
@@ -37,7 +43,7 @@ export default class CanvasDocumentSave extends BaseCommand {
37
43
  }));
38
44
  this.print(await api.saveCanvasDocument(flags.project, args.nodeId, {
39
45
  name: flags.name,
40
- schemaKey: flags['schema-key'],
46
+ schemaKey,
41
47
  documentKey: flags['document-key'],
42
48
  expectedVersionId: typeof selectedVersionId === 'string' ? selectedVersionId : null,
43
49
  content,
@@ -1,7 +1,7 @@
1
1
  import { BaseCommand } from '../../base-command.js';
2
2
  import { commandApi, projectFlag } from '../../command-helpers.js';
3
3
  export default class CanvasDocuments extends BaseCommand {
4
- static description = '聚合读取 Hypit 文档、版本依赖和当前阻塞原因';
4
+ static description = '聚合读取画布文档、版本依赖和当前阻塞原因';
5
5
  static flags = { ...BaseCommand.baseFlags, project: projectFlag };
6
6
  async run() {
7
7
  const { flags } = await this.parse(CanvasDocuments);
@@ -1,7 +1,7 @@
1
1
  import { BaseCommand } from '../../../base-command.js';
2
2
  import { commandApi, projectFlag } from '../../../command-helpers.js';
3
3
  export default class CanvasWorkflowStatus extends BaseCommand {
4
- static description = '读取 Hypit 自由画布当前阶段、所需模块和阻塞原因';
4
+ static description = '读取自由画布当前阶段、所需模块和阻塞原因';
5
5
  static flags = { ...BaseCommand.baseFlags, project: projectFlag };
6
6
  async run() {
7
7
  const { flags } = await this.parse(CanvasWorkflowStatus);
@@ -0,0 +1,2 @@
1
+ export declare function normalizeCanvasSchemaKey(value: string): string;
2
+ export declare function assertCanvasSchemaKey(value: string): string;
@@ -0,0 +1,21 @@
1
+ /**
2
+ * 画布文档合同键的本地归一化与校验。
3
+ *
4
+ * 服务端已把历史 `hypit.*` 合同键统一归一化为 `canvas.*`(旧键仍可提交并会被改写),
5
+ * CLI 在发送前做同一件事:既让老脚本继续可用,也避免 `--schema-key` 拼错时先发起
6
+ * 一连串节点/资产请求才在服务端报错。归一化后一定要用同一个正则校验,保证 CLI 与
7
+ * 服务端接受集合完全一致。
8
+ */
9
+ const LEGACY_PREFIX = 'hypit.';
10
+ const CANVAS_PREFIX = 'canvas.';
11
+ const CANVAS_SCHEMA_KEY_PATTERN = /^canvas\.[a-z0-9.-]+\.v[1-9]\d*$/;
12
+ export function normalizeCanvasSchemaKey(value) {
13
+ return value.startsWith(LEGACY_PREFIX) ? `${CANVAS_PREFIX}${value.slice(LEGACY_PREFIX.length)}` : value;
14
+ }
15
+ export function assertCanvasSchemaKey(value) {
16
+ const normalized = normalizeCanvasSchemaKey(value);
17
+ if (!CANVAS_SCHEMA_KEY_PATTERN.test(normalized)) {
18
+ throw new Error(`--schema-key 必须是 canvas.<小节>.v<版本>,例如 canvas.script.v1;收到:${value}`);
19
+ }
20
+ return normalized;
21
+ }
@@ -211,7 +211,7 @@ export class VvicatApi {
211
211
  const workflow = response && typeof response === 'object' && !Array.isArray(response)
212
212
  ? response.workflow : undefined;
213
213
  if (!workflow || typeof workflow !== 'object' || Array.isArray(workflow)) {
214
- throw new Error('服务端未返回 Hypit 工作流状态');
214
+ throw new Error('服务端未返回画布工作流状态');
215
215
  }
216
216
  return workflow;
217
217
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.156",
3
+ "version": "0.1.157",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -18,8 +18,8 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
18
18
  - 字幕、镜头衔接、声音平衡、时间线、渲染与剪辑验收:[references/editing-delivery.md](references/editing-delivery.md)
19
19
  - 专业剧本、TTS 独立音频、Remotion 等专项流程:[references/special-workflows.md](references/special-workflows.md)
20
20
  - 精确参数和命令示例:[references/commands.md](references/commands.md) 或 `ai-short-studio <topic> --help`
21
- - 参考视频复刻、去字幕和深度预处理:[references/hypit/playbooks/formats/reference-recreation-canvas.md](references/hypit/playbooks/formats/reference-recreation-canvas.md)
22
- - 已知错误、恢复边界和历史兼容问题:[references/troubleshooting.md](references/troubleshooting.md)
21
+ - 参考视频复刻、去字幕、深度预处理和参考对白转写:[references/short-drama/recreation/recreation-qa.md](references/short-drama/recreation/recreation-qa.md)
22
+ - 已知错误、恢复边界和历史兼容问题:[references/troubleshooting.md](references/troubleshooting.md);图片/视频/音频提示词的通用结构与质量分级:[references/short-drama/prompt/prompt-craft.md](references/short-drama/prompt/prompt-craft.md);H3 与 Seedance 提示词结构:[references/short-drama/prompt/h3-prompt-writing.md](references/short-drama/prompt/h3-prompt-writing.md)、[references/short-drama/prompt/seedance-prompting.md](references/short-drama/prompt/seedance-prompting.md)
23
23
 
24
24
  ## 场景路由:先判断再读取
25
25
 
@@ -29,17 +29,17 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
29
29
  | --- | --- | --- |
30
30
  | 原创短剧、小说改编、来源材料、市场灵感 | `references/short-drama/operations/short-drama-skill-index.md`、`references/short-drama/creation/analyze-drama-source.md`、`references/short-drama/creation/define-drama-brief.md` | 依次运行 `drama-source-analysis → drama-brief`;来源覆盖、改编边界或用户决定缺失时停在 `open_questions`,不写剧本 |
31
31
  | 故事设定、人物弧线、分集规划 | `references/short-drama/creation/design-drama-bible.md`、`references/short-drama/creation/outline-drama-series.md` | 先确认 Brief,再运行 `drama-bible → drama-outline`;未确认集数、时长或结局不得自动补齐 |
32
- | 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/short-drama/creation/humanizer.md` | 已有专业剧本时先复用并审核,不得重复执行 `novel-to-script`;改编先保留原文事实和对白,再做人味优化;必须回到 `drama-script-review`,P0/P1 未清零不得进入导演阶段 |
33
- | 人物、场景、道具和资产版本 | `references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
32
+ | 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/humanizer/humanizer.md`、`references/short-drama/creation/humanizer.md` | 已有专业剧本时先复用并审核,不得重复执行 `novel-to-script`;改编先保留原文事实和对白,再按官方 Humanizer 快照做自然化,短剧适配层只补充事实保留和表演边界;必须回到 `drama-script-review`,P0/P1 未清零不得进入导演阶段 |
33
+ | 人物、场景、道具和资产版本 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
34
34
  | 导演手册、摄影、表演、分镜和镜头变体 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/director-composition.md` | `drama-director-book → storyboard-breakdown → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,读取构图受控词表,证据不足时降级构图,不补陈设或天气 |
35
35
  | 逐镜制作、跨镜连续性、previous-tail | `references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | 先生成 `drama-production-plan`,再生成 `drama-continuity-plan`;只有前镜已审核且选版时允许 previous-tail |
36
- | 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/generation/seedance-community-skills.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存 自由画布文档;按实时 Provider schema 选择协议并审计后提交视频 |
37
- | 背景音乐、主题曲、纯音乐 | `references/short-drama/generation/design-drama-audio.md`、`references/short-drama/starrouter-provider.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
38
- | 去字幕、参考视频复刻、深度视频 | `references/hypit/playbooks/formats/reference-recreation-canvas.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → recreation-depth-preprocess/depth-video → video-generate`;不得把参考板或字幕带入成片 |
39
- | 参考对白转写、剪辑、字幕和多图模板 | `references/hypit/SKILL.md`、`references/hypit/environment/local-tools.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
36
+ | 视频提示词、H3、Seedance、原生音频 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/prompt/h3-prompt-writing.md`、`references/short-drama/prompt/seedance-prompting.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存自由画布文档;先按通用规范确定类型与维度,再按实时 Provider schema 选择协议并审计后提交视频 |
37
+ | 背景音乐、主题曲、纯音乐 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/generation/design-drama-audio.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
38
+ | 去字幕、参考视频复刻、深度视频 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → recreation-depth-preprocess/depth-video → video-generate`;不得把参考板或字幕带入成片 |
39
+ | 参考对白转写、剪辑、字幕和多图模板 | `references/short-drama/recreation/recreation-qa.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
40
40
  | 逐镜审计、剪辑、字幕、声音平衡、成片交付 | `references/short-drama/review/review-drama-shots.md`、`references/short-drama/editing/edit-drama-timeline.md`、`references/short-drama/editing/edit-deliver-drama.md` | `drama-shot-review → drama-edit-plan → drama-delivery-review`;未通过的镜头、无 provenance 或未完整观看不得交付 |
41
41
 
42
- 自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `hypit.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
42
+ 自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
43
43
 
44
44
  新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的 自由画布文档和选定媒体版本。
45
45
 
@@ -56,12 +56,12 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
56
56
 
57
57
  1. **预检与恢复**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`。只有历史项目需要新增媒体节点时才读取实时 `canvas node types`。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
58
58
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
59
- 3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、声音一致性方式、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后再用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
60
- 4. **自由画布文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `hypit.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `hypit.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
59
+ 3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、声音一致性方式、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后,再按标准创作门禁用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
60
+ 4. **自由画布文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `canvas.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `canvas.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再完整读取 [官方 Humanizer 快照](references/humanizer/humanizer.md)(来源见 [快照说明](references/humanizer/SOURCE.md))和 [短剧适配层](references/short-drama/creation/humanizer.md) 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
61
61
  5. **资产门禁**:先完成人物、场景、道具及其派生版本。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
62
  6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
63
63
  7. **视频规划**:视频生成前依次完成素材连线、镜头逻辑和上下镜连续性审计。读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。
64
- 8. **H3 生成门禁**:`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值;旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/hypit/playbooks/craft/h3-prompt-writing.md`;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
64
+ 8. **H3 生成门禁**:`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值;旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/short-drama/prompt/h3-prompt-writing.md`;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
65
65
  9. **逐镜后验**:每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
66
66
  10. **成片和交付**:剪辑只使用通过验收的 selected 版本,并完整执行 [剪辑与交付](references/editing-delivery.md)。默认对白/旁白字幕进入成片,人物与场景介绍仅在首次出现时显示短暂角标,同时输出独立 SRT/ASS。根据叙事动机选择硬切、动作切、J/L-cut、遮挡匹配或短淡化,不给所有镜头机械套淡入淡出。完成节奏裁切、声音平衡、画面统一、字幕和必要技术处理后,从头到尾观看成片并执行完整成片验收;未通过不得声称完成。原始视频按 `selectedOutputVersionId` 下载,字幕独立保存,`manifest` 记录镜号、节点、任务、资产、版本、时间线和文件名。
67
67
 
@@ -69,7 +69,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
69
69
 
70
70
  - H3 成片默认使用 H3 原生对白、旁白、环境音和动作声,并默认支持当前已确认的 `voice_id`/voice reference;只有实时能力明确返回不支持时,才让用户在支持该音色的 Provider、独立后配音或放弃固定音色之间选择。不得用 `voice-design`、`voice-clone` 或外部 TTS 静默覆盖 H3 原生音轨。
71
71
  - 独立交付的背景音乐、主题曲或纯音乐使用 `music-generate`,不要用 TTS 模型模拟。默认模型键为 `starrouter::suno_music`;运行前以 `canvas settings get` 和实时节点 schema 为准。
72
- - 涉及剪辑、字幕、转场、音频编排或渲染时,读取 `references/hypit/` 中对应的制作规则。
72
+ - 涉及剪辑、字幕、转场、音频编排或渲染时,读取 [剪辑与交付](references/editing-delivery.md) 和 `references/short-drama/editing-workflow.md` 中的对应规则。
73
73
  - 专业拆镜出现软提示时,可按 [增量修订流程](references/assets-and-storyboard.md#专业拆镜软提示与增量修订) 使用 `canvas node revise-storyboard` 读取诊断、预览并保存局部补丁;冲突不得盲目重试。普通编辑镜头用 `canvas node edit-shot`,编辑结构化资源用 `canvas node edit-resource`,均追加不可变版本。项目 `outputLanguage` 在创建后固定,画布只读;手工首尾帧使用 `video-frame-extract`。
74
74
 
75
75
  ## 安全与完成条件
@@ -19,7 +19,7 @@ ai-short-studio canvas documents --project <projectId> --json
19
19
  ai-short-studio canvas workflow status --project <projectId> --json
20
20
  ```
21
21
 
22
- 按返回的 `currentStage`、`checks` 和条件模块,在 `text-resource` 节点用 `canvas document save` 写入 `hypit.<module>.v1`。每个版本必须使用 `--input` 绑定上游选版;审核单独保存为 `hypit.review.v1`。保存后重新运行 `canvas documents`,直到阶段状态和审核证据一致。
22
+ 按返回的 `currentStage`、`checks` 和条件模块,在 `text-resource` 节点用 `canvas document save` 写入 `canvas.<module>.v1`。每个版本必须使用 `--input` 绑定上游选版;审核单独保存为 `canvas.review.v1`。保存后重新运行 `canvas documents`,直到阶段状态和审核证据一致。
23
23
 
24
24
  ## 历史节点兼容
25
25
 
@@ -45,15 +45,17 @@ ai-short-studio canvas node delete <nodeId> --project <projectId> --yes --json
45
45
 
46
46
  自由画布 JSON 产物保存到 `text-resource` 节点;每次保存追加版本,`--input` 记录上游节点当前资产选版。续写前先读状态,`ready: false` 时根据 `staleInputs` 重做受影响产物,不能沿用旧审核。
47
47
 
48
+ `--schema-key` 使用 `canvas.<小节>.v<版本>`,例如 `canvas.script.v1`。CLI 在发起请求前本地校验该格式;旧前缀 `hypit.*` 仍被接受,但会归一化为 `canvas.*` 后再提交并给出迁移提示,服务端也只保存 `canvas.*`。
49
+
48
50
  ```bash
49
51
  ai-short-studio canvas document get <scriptNodeId> --project <projectId> --json
50
- ai-short-studio canvas document save <scriptNodeId> --project <projectId> --name 剧本 --schema-key hypit.script.v1 --document-key ep-001.script --input <briefNodeId> --file script.json --json
52
+ ai-short-studio canvas document save <scriptNodeId> --project <projectId> --name 剧本 --schema-key canvas.script.v1 --document-key ep-001.script --input <briefNodeId> --file script.json --json
51
53
  ai-short-studio canvas document status <scriptNodeId> --project <projectId> --json
52
54
  ai-short-studio canvas documents --project <projectId> --json
53
55
  ai-short-studio canvas workflow status --project <projectId> --json
54
56
  ```
55
57
 
56
- 审核报告也保存为独立 `text-resource` 文档:`--schema-key hypit.review.v1`、`--input <被审核节点ID>`,JSON 至少包含 `decision: "approved" | "rejected"` 与 `issues: [{"severity":"P0|P1|P2","description":"..."}]`。P0/P1 未清零不能标记通过;后续产物把审核节点也作为 `--input`,审核拒绝或被审核版本变化时,`document status` 会返回失效。审核应基于真实内容和证据,不能为了通过门禁填写空问题清单。
58
+ 审核报告也保存为独立 `text-resource` 文档:`--schema-key canvas.review.v1`、`--input <被审核节点ID>`,JSON 至少包含 `decision: "approved" | "rejected"` 与 `issues: [{"severity":"P0|P1|P2","description":"..."}]`。P0/P1 未清零不能标记通过;后续产物把审核节点也作为 `--input`,审核拒绝或被审核版本变化时,`document status` 会返回失效。审核应基于真实内容和证据,不能为了通过门禁填写空问题清单。
57
59
 
58
60
  音乐节点使用 `music-generate`,输出 AUDIO。`prompt` 必填,可配置 `model`、`title`、`tags`、`lyrics` 和 `makeInstrumental`;`lyrics` 与 `makeInstrumental: true` 不能同时提交。`--config` 读取 JSON 文件,不接受内联 JSON 字符串。
59
61
 
@@ -86,6 +88,22 @@ H3 批量启用原生音频的 `updates.json`:
86
88
 
87
89
  提交前以实时命令 schema 为准,提交后逐节点 `get` 回读。
88
90
 
91
+ ## 声音库与角色音色绑定
92
+
93
+ ```bash
94
+ ai-short-studio canvas voice list --json
95
+ ai-short-studio canvas voice upload ./voice/linwan.mp3 --name "林晚-冷静女声" --description "都市情感,克制" --json
96
+ ai-short-studio canvas voice bind <characterId> --project <projectId> --voice <globalVoiceId> --json
97
+ ai-short-studio canvas voice unbind <characterId> --project <projectId> --json
98
+ ```
99
+
100
+ - `voice list` 返回当前账户声音库的跨项目音色条目;`item.voiceId` 才是提交给 Provider 的真实音色标识,`globalVoiceId` 只是声音库记录 ID。
101
+ - `voice upload` 只接受 `mp3`、`wav`、`m4a`、`aac`、`ogg`,注册为声音库条目,不上传画布资产,也不自动绑定角色。上传后先用 `voice list` 回读确认条目可用。
102
+ - `voice bind` 写入的是小说推广项目角色(`novelPromotionCharacter`)的音色字段,不是自由画布节点。该角色若来自全局人物库,绑定会同时改写全局人物(`globalCharacter`)的音色,影响引用同一人物的其他项目;绑定前必须确认影响范围。绑定后回读 `GET /api/novel-promotion/<projectId>/character/<characterId>/voice` 核对 `voiceId`、`voiceType` 和 `customVoiceUrl` 实际值。
103
+ - `voice unbind` 只清空上述音色字段,不删除声音库条目。
104
+
105
+ 自由画布的短剧配音不使用这四个命令:音色写入 `audio-plan` 的 `voiceBindings` 与 `tts.voice` 节点配置,并由 `drama-audio-plan`、`voice-design`、`voice-clone` 节点执行,见 [声音与音频设计](../short-drama/generation/design-drama-audio.md)。
106
+
89
107
  ## 连线与连续性
90
108
 
91
109
  ```bash
@@ -0,0 +1,9 @@
1
+ # Humanizer 快照来源
2
+
3
+ - 上游仓库:https://github.com/blader/humanizer
4
+ - Skill 版本:2.9.1
5
+ - 上游提交:`523374dee72d67c7b2b5f858ea0094ffda49c3ac`(tag `v2.9.1`)
6
+ - 快照日期:2026-10-28
7
+ - 许可证:MIT,见同目录 `LICENSE`
8
+ - 一致性:`humanizer.md` 与上游该提交的 `SKILL.md` 逐字节一致,`LICENSE` 同样一致,未做删改;短剧专用约束放在 `../short-drama/creation/humanizer.md` 适配层,避免改写官方规则。
9
+ - 更新方式:重新 clone 目标 tag、替换 `humanizer.md` 与 `LICENSE`,更新本文件的版本与提交号,并运行 `npm test` 确认 `test/package.test.ts` 的来源断言仍然匹配。2026-10-28 复核时上游已发布 v3.1.0,升级属于独立任务,需重新核对规则差异后整体替换。