@aswless_854771076/ai_short_studio_cli 0.1.156 → 0.1.158
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/commands/canvas/document/get.js +3 -3
- package/dist/commands/canvas/document/save.js +8 -2
- package/dist/commands/canvas/documents.js +1 -1
- package/dist/commands/canvas/workflow/status.js +1 -1
- package/dist/domain/canvas-schema-key.d.ts +2 -0
- package/dist/domain/canvas-schema-key.js +21 -0
- package/dist/domain/vvicat-api.js +1 -1
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +24 -24
- package/skills/using-vvicat-ai-short-studio-cli/references/agent-recovery.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +11 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +25 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/SOURCE.md +9 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md +408 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/project-and-canvas.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +17 -31
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-images.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-character-profiles.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-drama-art-style.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-prop-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/generate-scene-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-art-styles.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/manage-drama-assets.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.en.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/ideate-drama-from-market/prompts/market_inspiration.zh.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/plan-drama-production/prompts/production_plan.en.txt +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/plan-drama-assets.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/codex-contracts.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/analyze-drama-source.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/define-drama-brief.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/design-drama-bible.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/humanizer.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/outline-drama-series.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/short-drama.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-director-book.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/creation/write-drama-episode.md +1 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-deliver-drama.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/edit-drama-timeline.md +4 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing/remotion-best-practices.md +4 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/editing-workflow.md +8 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +25 -25
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/configure-generation-providers.md +5 -11
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/design-drama-audio.md +4 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/drama-generation-service.md +6 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-drama-videos.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/generate-storyboard-images.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/monitor-drama-tasks.md +9 -7
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/transform-drama-media.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +9 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md +8 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/README.md +59 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.mjs +517 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/analyze.test.mjs +354 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.mjs +188 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/juchacha-client.test.mjs +218 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.mjs +458 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/normalize.test.mjs +236 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/report.mjs +69 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.mjs +341 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/store.test.mjs +302 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +43 -133
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/music-catalog-providers.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/manage-drama-projects.md +5 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +7 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/recover-drama-pipeline.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/short-drama-skill-index.md +7 -7
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +4 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +40 -65
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +91 -131
- package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/h3-prompt-writing.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/prompt-craft.md +186 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +64 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt-skill-index.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/recreation-qa.md +87 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-script.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +6 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/build-drama-storyboard.md +1 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/design-fight-video.md +0 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz/direction-contract.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/direct-blender-previz.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/generate-blender-previz.md +5 -10
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-drama-production.md +2 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +4 -4
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +28 -70
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/SKILL.md +0 -447
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/brief.md +0 -93
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/project-files.md +0 -246
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/reference-video.md +0 -266
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/script-and-time.md +0 -253
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/creation/transformations.md +0 -141
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/distribution.md +0 -176
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/local-tools.md +0 -411
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/model-and-provider.md +0 -275
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/environment/profile.md +0 -286
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/asset-and-shot-preproduction.md +0 -193
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/b-roll.md +0 -94
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/caption-tracking.md +0 -125
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/captions.md +0 -252
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/conversation-images.md +0 -218
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/examples/image-direction.md +0 -123
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/generated-dependencies.md +0 -38
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/graphic-compositions.md +0 -85
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/image-direction.md +0 -95
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/motion-graphics.md +0 -68
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/recreation-policy.md +0 -51
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/screen-demonstrations.md +0 -51
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/shot-production-contracts.md +0 -161
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/sound-mix.md +0 -76
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/video-direction.md +0 -433
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-and-performance.md +0 -224
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/craft/voice-direction.md +0 -99
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/narration-led-demo.md +0 -87
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/presenter-led-explainer.md +0 -160
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/ranking-listicle.md +0 -71
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/reference-recreation-canvas.md +0 -19
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama-workflow.md +0 -165
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/short-drama.md +0 -88
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/street-interview.md +0 -92
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/talking-head.md +0 -82
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/formats/two-person-podcast.md +0 -101
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/playbooks/index.md +0 -77
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/audio-presentation.md +0 -49
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/authoring.md +0 -228
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/browser-capture.md +0 -112
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/builds.md +0 -330
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-authoring.md +0 -156
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/caption-presentation.md +0 -66
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-design.md +0 -217
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-sharing.md +0 -150
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/component-visuals.md +0 -152
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/detail.svrun +0 -8
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/direction.svs +0 -14
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/look.svs +0 -6
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/material.svrun +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svml +0 -73
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/production.svrun +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/examples/visuals.ts +0 -62
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/fonts-and-text.md +0 -138
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/image-operations.md +0 -102
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/index.md +0 -73
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media-presentation.md +0 -111
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/media.md +0 -246
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/performance.md +0 -114
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/prompt-kits.md +0 -165
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/rendering.md +0 -141
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/review.md +0 -211
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/runs.md +0 -151
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/script-syntax.md +0 -236
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/snapshots.md +0 -90
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/sound.md +0 -75
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/source-syntax.md +0 -163
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/spatial.md +0 -189
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio-companions.md +0 -186
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/studio.md +0 -249
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/system.md +0 -169
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timeline.md +0 -74
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/timing.md +0 -96
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/track-authoring.md +0 -215
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/tracks.md +0 -67
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/video-downloads.md +0 -47
- package/skills/using-vvicat-ai-short-studio-cli/references/hypit/production/vocabulary.md +0 -119
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/README.md +0 -11
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/comfly-provider.md +0 -12
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/seedance-community-skills.md +0 -23
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/recreation/publish-drama-references/litterbox.md +0 -5
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/runninghub-provider.md +0 -33
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/starrouter-provider.md +0 -53
- package/skills/using-vvicat-ai-short-studio-cli/references/video-model-routing.md +0 -10
- package/skills/using-vvicat-ai-short-studio-cli/references/video-prompt-spec.md +0 -32
- /package/skills/using-vvicat-ai-short-studio-cli/references/{short-drama/assets/modules/humanizer → humanizer}/LICENSE +0 -0
- /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-base-prompt-writing.md +0 -0
- /package/skills/using-vvicat-ai-short-studio-cli/references/{hypit/playbooks/craft → short-drama/prompt}/examples/h3-reference-prompt-writing.md +0 -0
|
@@ -1,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
|
|
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)。
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# 短剧媒体生成入口
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
原创短剧的远端媒体生成统一使用项目已确认的 StarRouter 模型和画布生成节点。项目开始时先让用户确认厂商、模型、关键参数和预计付费任务;每次提交仍遵循制作计划与现有审核门禁。复刻请读取 [复刻知识问答](../recreation/recreation-qa.md),不进入短剧原创模块。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
图片、语音、音乐和转写使用对应的画布节点;视频使用 `video-generate`。每次运行前读取 `canvas node types` 和 `canvas settings get`,核对模型、输入端口、参数和实时能力。最终视频只使用已批准的制作计划、已选人物/场景/道具/分镜/主运动参考和已确认的音色绑定。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
参考素材只取当前已选且未失效的资产版本。需要公网 URL 时,先确认素材权利、公开暴露和使用范围。任务记录保存模型、参数、文档引用、资产版本和任务 ID,禁止记录密钥。一次提交结果未知时先核对原任务,不自动重试;失败镜头可在重新确认后单独重跑。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
同一依赖层的图片目标可批量提交;派生资产等母资产审核选版后进入下一层。并发由平台任务门禁控制,不通过切换厂商绕开限流。模型目录以实时 `canvas node types` 为准,当前主要包括 `gpt-image-2`、`MiniMax-H3`、Seedance、`speech-2.8-hd`、`speech-2.8-turbo`、`suno_music` 和默认转写 `whisper-1`。
|
|
10
10
|
|
|
11
|
-
StarRouter
|
|
11
|
+
StarRouter 不提供 CosyVoice 自定义音色设计/克隆、SeedVR2.5 超分和 MuseTalk 口型驱动。百炼 CosyVoice 由平台实时目录动态注册,只有 `canvas node types` 返回对应节点和音色能力、用户确认后,才能用于音色设计;不得因为旧项目保存过配置就提交。RunningHub、Comfly 直连和 MuseTalk 的旧配置不能继续提交付费任务,需先改为实时目录中的模型并重新确认计划。调用前必须核对实时能力,缺失时明确停下并报告缺口。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
画布节点缺失、端口不匹配或 schema 不完整时停止提交并修复配置;不得绕过画布直接调用旧插件适配器。
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# 生成原创短剧视频
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
只对审核通过的原创短剧镜头执行正式视频生成。先读取制作计划文档和 `canvas node types`,检查每镜的 StarRouter 模型、画幅、时长、分辨率、提示词文档和参考资产版本。用户确认计划后,才创建或运行 `video-generate` 节点。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
视频节点使用当前已选的人物、场景、道具、分镜和主运动参考资产,并通过端口连接已选版本;不得静默丢弃参考,也不得用原片关键帧替换已批准资产。需要公网参考时,先确认素材权利和公开暴露范围。`MiniMax-H3` 可承载经批准的 Ref2VA 运动参考;H3-Max 与多格分镜板的能力边界仍按模型合同校验。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
同一输入指纹只允许一个在途任务。提交结果未知时先查询原任务,不自动重试。成功输出登记为未选候选版本,逐镜完整观看并通过画面、声音和连续性审核后才选版;失败镜头定位原因后单独重跑。旧项目中保存的 RunningHub、Comfly 直连等配置不能继续提交付费任务,必须先按当前项目重新确认模型、参数和能力。
|
|
8
8
|
|
|
9
|
-
主运动参考在合同中记作 `reference_video
|
|
9
|
+
主运动参考在合同中记作 `reference_video`,必须绑定当前已选版本;生成前再次核对端口、版本和 SHA-256。
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# 生成分镜图片
|
|
2
2
|
|
|
3
|
-
处理制作计划中的全部镜头,包括另有 Blender 白模的镜头。先读取每镜 `storyboard_strategy.primary_board_type`、`required_board_types` 和 `selection_basis`,只生成合同声明的板型;`selection_basis` 缺失、主类型不在 `required_board_types` 或证据不足时退回 production-plan,不得直接出图。视频镜头根据 required_board_types 生成实际选择的独立参考板:`board-epNNN-temporal-NNN` 使用 `panel_grid_image`,按时间顺序固定动作阶段与精确状态;`board-epNNN-shot-NNN` 使用 `panel_storyboard_image`,按叙事节拍固定景别、调度、轴线和构图。若 `required_board_types` 额外包含 `narrative`、`blocking`、`action`、`choreography`、`comprehensive` 或 `director-track`,使用
|
|
3
|
+
处理制作计划中的全部镜头,包括另有 Blender 白模的镜头。先读取每镜 `storyboard_strategy.primary_board_type`、`required_board_types` 和 `selection_basis`,只生成合同声明的板型;`selection_basis` 缺失、主类型不在 `required_board_types` 或证据不足时退回 production-plan,不得直接出图。视频镜头根据 required_board_types 生成实际选择的独立参考板:`board-epNNN-temporal-NNN` 使用 `panel_grid_image`,按时间顺序固定动作阶段与精确状态;`board-epNNN-shot-NNN` 使用 `panel_storyboard_image`,按叙事节拍固定景别、调度、轴线和构图。若 `required_board_types` 额外包含 `narrative`、`blocking`、`action`、`choreography`、`comprehensive` 或 `director-track`,使用 `storyboard-image` 节点按该镜 `storyboard_strategy` 声明的主类型生成独立资产版本,并以 `board-epNNN-{type}-NNN` 登记;`previz-3d` 仍由 Blender 模块生成。所有已选择的视频板均使用 `image_strategy.panel_grid_size`,默认 6 格,Codex 可按不可合并的动作或叙事节拍选择 2–16 格;不得用同一图片或同一资产版本冒充不同板型。Blender 是按需追加的空间和运动预演,不替代已选择的分镜参考。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
分镜图提示词遵循 [通用提示词规范](../prompt/prompt-craft.md) 的结构与质量分级,并严格填充 [提示词索引](../prompt-skill-index.md) 的变量;`style` 必须传项目当前完整 `creative.art_style` 对象,按登记模板编译 renderingContract,不得只传画风名或一句风格短语。多格图根据计划中的 `panel_grid_size` 选择可读布局并同时提供 `grid_layout`,不得减少、留空、重复格子或把相邻镜头剧情画进当前镜头。宫格切单格后只允许用 `panel_grid_enhance` 保真高清化,不得重构图。
|
|
6
6
|
|
|
7
7
|
分镜构图合同的 code 必须先编译成可见几何再出图:图片提示词只写主体位置、视线留白、前中后景、光源方向与剧内来源、遮挡、动作方向与镜尾状态,不罗列构图 code 或模式目录;拿不准 code 的画面结构、证据门槛或 ai_risks 防控时按需查阅 [导演构图模式参考](../director-composition.md)。evidence 需要 set_dressing/weather_atmosphere/action_blocking(含 `+` 复合证据,逐组件成立)时,set_dressing/weather_atmosphere 元素必须有原文或已选资产支撑,action_blocking 还可由已确认调度事实支撑,但调度事实不能替代天气/陈设证据;均无据的元素是阻塞性冲突:不调用出图,按模板把缺失证据写入 unresolved 并退回分镜,不得让模型自补雨、雪、雾、霓虹、镜面、烟尘、门窗廊柱、武器或多余人物。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
整集所有门禁已通过的镜头只提交已选择板型对应的画布生图节点:`temporal` 用 `storyboard-grid-image`(默认模板 `panel_grid_image`),`shot-board` 用 `storyboard-board-image`(默认模板 `panel_storyboard_image`),其余已选择主类型用 `storyboard-image`。`prompt` 端口连接本镜结构化分镜(及人物、场景、道具设定),`reference` 端口连接已选设定图与已选板型参考;config 只写实时 schema 允许的板型参数(`gridSize`、`count`、`aspectRatio`,`storyboard-image` 另有 `imageLayout`)和模型参数,实际值与制作计划不一致时先改计划,不靠改节点配置掩盖选择。实际 prompt 必须等于本阶段已留痕的 Provider 提示词输出;本列表不得改用 `image-generate`,它不追加分镜板合同。参考图只通过节点 `reference` 端口连接已选设定图和已选板型,由服务端按实际连线、节点选版与文件摘要复核,不手写参考清单或临时路径。参考资产的画风审核哈希必须与当前 renderingContract 一致;旧画风资产先失效重做,不让新提示词与旧媒介参考互相拉扯。提交前只展示模型、数量、尺寸、参考用途与制作计划,不计算具体价格。所有已生成板型分别完成对应审核并选版后,才进入视频提示词与生成。
|
|
10
10
|
|
|
11
11
|
使用 StarRouter 时明确从以下枚举取值:`model=gpt-image-2`;`resolution ∈ {1K,2K,4K}`;`aspect_ratio ∈ {1:1,16:9,9:16,4:3,3:4}`;`quality ∈ {auto,low,medium,high}`;`background ∈ {auto,opaque,transparent}`;`moderation ∈ {auto,low}`;`output_format ∈ {png,jpeg,webp}`;`n=1..4`。
|
|
@@ -1,15 +1,17 @@
|
|
|
1
1
|
# 监控短剧任务
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
每个任务至少记录任务 ID、目标 key、type、Provider、输入指纹、模型、提交时间、状态和输出资产版本;type 只能是 image、video、audio。付费调用前先确认当前阶段和上游门禁,同一节点同一输入指纹已有 queued/running 任务时禁止重提。“已提交”与“Provider 完成”都不等于本地资产已就绪。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
使用 `ai-short-studio task list --project <projectId> --json` 查询任务,使用 `task get <taskId>` 读取单个任务详情。任务完成后必须回读节点输出和画布资产版本,再下载或查看真实产物;不能只凭任务成功状态判断完成。任务可能仍在远端执行时,用 `task wait <taskId>` 或再次 `task get` 查询,不因一次超时或状态无变化就重新提交。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
`automation_mode=true` 时,可以继续查询同一任务直到终态,但不能把超时当作任务结束,也不能向用户重复询问已确认范围;关闭全托管时返回等待状态。轮询瞬断不判失败,短暂网络异常最多重试原目标三次;401/403、余额、审核、schema、模型能力和语言门禁错误立即停下。
|
|
8
8
|
|
|
9
|
-
Provider
|
|
9
|
+
`submitting` 表示进程可能在远端调用期间中断,必须人工核对 Provider 后再标记失败,不能直接重提。取消任务先停止调度,再取消明确的 queued/running task ID,并回读到零;不得取消已被其他流程接管的旧任务。
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Provider 状态与画布资产版本不一致时,按任务 ID、输入指纹和资产 SHA-256 对账;不能靠时间顺序猜测,也不能用重复提交修复状态。远端完成但产物尚未登记为画布资产时保持运行中,不得记为完成。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
制作计划中的 `generation_groups.status` 为 `waiting-review` 时转入候选验收,`waiting-tail` 时准备上一镜当前已选尾帧,`ready` 时才提交该组前沿镜头,`complete` 时进入阶段检查。没有节点、任务、审核或资产变化时保持安静,不重复报告同一终态。
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
需要定位制作耗时时,只读汇总逐镜、逐类型、逐目标的尝试次数、失败阶段与 P50/P95 耗时;缺少时间事件时对应阶段记为 `null`。远端排队和生成时长取自轮询观察,包含轮询间隔;下载完成到登记审核的区间不代表人工实际观看时长。
|
|
16
|
+
|
|
17
|
+
参考片复刻使用 [复刻知识问答](../recreation/recreation-qa.md) 中的画布节点;本模块的任务统计只覆盖原创短剧项目。
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
本地剪裁、换音轨、稳定、降噪和调色仍按项目媒体操作合同执行:只处理当前 selected 资产,保留来源、范围、参数和候选版本,审核通过后才选版。
|
|
4
4
|
|
|
5
|
-
远端 SeedVR2.5 超分、MuseTalk/PainterAV2V 口型驱动及其他依赖旧厂商的媒体变换暂时禁用。StarRouter 当前目录没有已验证的等价能力;即使旧项目保存了 RunningHub 或 MuseTalk
|
|
5
|
+
远端 SeedVR2.5 超分、MuseTalk/PainterAV2V 口型驱动及其他依赖旧厂商的媒体变换暂时禁用。StarRouter 当前目录没有已验证的等价能力;即使旧项目保存了 RunningHub 或 MuseTalk 配置,也不能继续提交。画布节点注册表里没有这些节点,`canvas node run` 会以未知节点失败;必须先运行 `canvas node types` 确认没有可用节点,不要尝试绕过或伪造成功。
|
|
6
6
|
|
|
7
|
-
如果用户需要这些效果,先确认 StarRouter
|
|
7
|
+
如果用户需要这些效果,先确认 StarRouter 上可用的准确模型、接口能力和参数,再更新制作计划与画布节点配置,完成针对该模型的真实验收后恢复能力。不得用本地修饰或未审核运算结果冒充已通过的正式镜头。
|
|
8
8
|
|
|
9
9
|
旧提示词模板 `2d_to_live_action` 和 `image_prompt_modify` 保留作历史项目读取,不授予远端生成权限。
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# 编写视频提示词
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
先按 [通用提示词规范](../prompt/prompt-craft.md) 确定本镜的类型、覆盖维度、场景规则和质量分级,再按本文件编译 H3/Seedance 正式格式。
|
|
4
|
+
|
|
5
|
+
编写顺序固定为:选择场景类型 → 建立通用导演中间层 → 写 `performance_contract` → 检查镜头可见性和动作归因 → 编译 H3/Seedance 正式格式 → 保存并回读。表演细节按景别裁剪,不能把近景微表情写到远景,也不能用抽象情绪词替代可观察行为。
|
|
6
|
+
|
|
7
|
+
Seedance 的逐镜检查按 [Seedance 2.0 逐镜提示词规范](../prompt/seedance-prompting.md) 执行;素材上限、输入模式和参数以 `seedance2_video` 正式模板与实时 Provider 能力为准。
|
|
4
8
|
|
|
5
9
|
## 无限画布 Agent 写入路径
|
|
6
10
|
|
|
@@ -8,8 +12,7 @@ Seedance 的逐镜检查可按 [社区 Skill 参考](seedance-community-skills.m
|
|
|
8
12
|
|
|
9
13
|
H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider 的文本不得超过 7000 字符。Seedance 使用中文“本镜元数据与实际素材用途 → 画面和表演 → 镜尾”;对白保持原文。每个可见人物只写本镜可读的动作、注意对象、反应触发和结果,听者与说话者在同一段交叠表演。提示词长度由必要信息决定,不按任意字数填充;先删重复画质词和已由参考图表达的背景,再考虑调整动作密度。
|
|
10
14
|
|
|
11
|
-
|
|
12
|
-
|
|
15
|
+
以下模板编译规则适用于历史项目文档或旧生成节点的回读,不代替无限画布的 Agent 写入选版。
|
|
13
16
|
|
|
14
17
|
先读取已批准制作计划和 Provider 实时能力,按“节点/镜头显式覆盖 → 制作计划 `prompt_profile` → 模型识别”确定唯一编译路径:
|
|
15
18
|
|
|
@@ -17,17 +20,15 @@ H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider
|
|
|
17
20
|
- StarRouter `MiniMax-H3` 使用 `h3_video`;H3-Max 无法承载完整参考包,不得进入正式制作计划。
|
|
18
21
|
- 其他已确认模型才按参考图类型使用 `panel_grid_video` 或 `panel_storyboard_video`;无法确认提示词协议时停止,不把通用模板冒充模型专属模板。
|
|
19
22
|
|
|
20
|
-
所有模板都填充 `base_prompt`、`storyboard_context_json`、`grid_layout`、`panel_grid_size`、`camera_move`、`shot_type`、`style`、`duration_constraints` 和 `reference_manifest_json`。`style` 必须是项目当前完整 `creative.art_style`
|
|
23
|
+
所有模板都填充 `base_prompt`、`storyboard_context_json`、`grid_layout`、`panel_grid_size`、`camera_move`、`shot_type`、`style`、`duration_constraints` 和 `reference_manifest_json`。`style` 必须是项目当前完整 `creative.art_style` 对象,按登记的提示词模板编译为包含 medium、rendering_method、surface_language、image_formation 与 forbidden_substitutions 的 renderingContract;禁止只传画风名、一行 prompt 或从参考图猜媒介。引用清单只包含已选本地资产、版本、用途及提交顺序,不包含密钥或临时 URL。Seedance 的每个图片/视频引用还必须按素材实际内容声明 `person_reference: true|false`;音频不得声明,画布节点不按用途猜测。
|
|
21
24
|
|
|
22
25
|
每个 `char-*` 引用必须带 `identity_binding:{profile_name,profile_sha256,appearance_id}` 和 `identity_constraints:{age_class,grooming_and_makeup,costume_signature,memory_anchors}`。提交前执行 `assertCharacterReadyForVisuals` 并精确核对人物档案 SHA、规范名、appearance 与全部可见约束,不得从 asset key 猜人物。模板只把妆发、服装标识和记忆锚点编译进可见描述,不暴露绑定元数据;连续性 `visual_identity` 有冲突或换装缺少剧情证据时写入 errors。
|
|
23
26
|
|
|
24
|
-
|
|
25
27
|
每镜引用清单必须包含实际 `storyboard_strategy.required_board_types` 对应的已审核分镜板;只有选择了 `temporal` 或 `shot-board` 才分别加入 `image/temporal_storyboard` 或 `image/shot_board`,不能因为执行器兼容字段自动补板。需要对白、旁白或声音连续性证据时,才加入当前镜头时间范围对应的 `audio/audio_reference`,不得用整集音轨或其他镜头音频代替。人物参考按可见人物和当前 Provider 能力加入;人物、场景、道具设定板按风险以 `image/asset_board` 追加。任一已选择板型或合同要求的参考缺失都不得批准提示词或提交视频。
|
|
26
28
|
|
|
27
|
-
|
|
28
29
|
每次模板编译统一输出严格 JSON `{prompt_profile,input_mode,prompt,duration,references,continuity,audio_policy,errors}`。Seedance 2.0 固定 `full-reference`,`prompt` 必须为中文自然语言,并让 `@图片N/@视频N/@音频N` 与引用清单及提交数组一一对应;总素材不超过 12 个,图片≤9、视频≤3且合计2–15秒、音频≤3且合计≤15秒,时长4–15秒。H3 固定 `Ref2VA`,英文六段必须严格按 `subject_definitions → summary → retention_analysis → detailed_description → overall_soundscape → non_diegetic_music` 排列,仅对白、歌词和画内文字保留原语言。不得混用两套语法。
|
|
29
30
|
|
|
30
|
-
`continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由
|
|
31
|
+
`continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由 上一镜尾帧承接 生成的 `other-transition-*` 作为第一个 `image/first_frame` 语义连续性锚点,其余人物、实际选择的分镜板和音频参考不得省略。编译前核对其来源版本与 SHA-256 仍对应上一镜当前 selected 视频;来源镜换版后必须重新派生尾帧。
|
|
31
32
|
|
|
32
33
|
保存前把逐镜编译结果包装为顶层严格合同 `{episode_key,source_versions,shots,unresolved,approved}`;每个 `shots` 项在上述八个模板字段外,必须从已选制作计划原样补入 `shot_number`、`production_plan_version`、`storyboard_version`、`provider` 和 `model_or_workflow`。任一镜 `errors` 非空时同步写入 `unresolved` 且 `approved=false`,禁止省略 `errors`、伪造空数组或手写占位文档。
|
|
33
34
|
|
|
@@ -57,4 +58,4 @@ H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider
|
|
|
57
58
|
|
|
58
59
|
同一角色跨当前/未来时空的对白必须共享音色身份合同。若视频模型不能保证跨镜声纹一致,提示词仍保留说话人身份,但制作计划必须标记 `post-dub` 或可审计的后期电话处理,不能让每镜原生音频各自随机生成后再假定为同一角色。
|
|
59
60
|
|
|
60
|
-
不得把故事板的铅笔、炭笔、单色、纸张质感、分格、箭头、编号、水印或 UI 生成进成片;故事板只传递构图、轴线和动作顺序,提示词必须重申项目成片媒介。每个无错镜头的 `prompt` 必须原样包含模板规定的固定反宫格声明和固定禁生成文字声明(中文模板用中文句、H3 用英文句,按模板要求放置);禁止模型在源视频中生成字幕、标题、标签、Logo、水印、UI 文字或其他可读文字,获批文字统一交给后期图形层。`
|
|
61
|
+
不得把故事板的铅笔、炭笔、单色、纸张质感、分格、箭头、编号、水印或 UI 生成进成片;故事板只传递构图、轴线和动作顺序,提示词必须重申项目成片媒介。每个无错镜头的 `prompt` 必须原样包含模板规定的固定反宫格声明和固定禁生成文字声明(中文模板用中文句、H3 用英文句,按模板要求放置);禁止模型在源视频中生成字幕、标题、标签、Logo、水印、UI 文字或其他可读文字,获批文字统一交给后期图形层。`canvas document save` 会逐镜校验,缺失即校验失败,不得改写或用近义句替代。多格分镜板(`panel_grid_size > 1`)整张作为语义参考引用时,prompt 还必须原样包含模板中的分镜板时间顺序条款(画格只表示动作时间顺序,禁止画格边框/分割线/编号/多格并排),画布提交前逐镜校验;多格板只能配 `full-reference`/`Ref2VA`/`reference_image`,禁止配首帧/尾帧像素模式。用 `canvas document save` 保存不可变版本,再显式选定;每镜记录制作计划版本、分镜版本、模型、提示词协议、引用资产版本和最终 prompt。修改任一上游版本必须生成新版本,不覆盖旧提示词。
|
|
@@ -2,17 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
用于用户询问近期短剧题材趋势、平台榜单、市场机会、竞争格局或要求市场报告。不得用于分析单部小说或剧本、预测投资收益,或绕过付费或登录权限获取数据。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
先确认用户指定的报告文件存在且可访问,再读取本 Skill 的 [方法说明](analyze-drama-market/methodology.md) 解读指标,并用 [报告合同](analyze-drama-market/market-report.schema.json) 校验结构。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
本 Skill 只消费用户提供的已保存 `market-report.v2` 文件,不采集榜单、不刷新快照,也不生成新报告。CLI 没有 `refresh`、`analyze`、`report`、`list` 或 `--self-check` 这类市场子命令;需要新报告时,必须由用户自行提供符合报告合同的文件,不得声称已联网刷取。不要把“近期”“最新”自行解释为刷新授权。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
如果用户要自己重新生成报告,`scripts/` 目录提供可选的离线维护脚本(抓取、归一化、指标分析、快照存储);它们不是 CLI 入口,执行属于用户自己的数据准备,见 [市场报告脚本](scripts/README.md)。本 Skill 不执行这些脚本,也不因它们存在而获得联网授权。
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
- `
|
|
14
|
-
- `
|
|
15
|
-
-
|
|
11
|
+
校验与引用:
|
|
12
|
+
|
|
13
|
+
- 用报告合同校验 JSON;`schema_version` 必须是 `market-report.v2`。
|
|
14
|
+
- 用 `shasum -a 256 <报告文件>` 或 `sha256sum <报告文件>` 取得原始字节摘要,并在引用时说明 `report_id` 与摘要前 12 位。
|
|
15
|
+
- 只解读报告中实际存在的字段;缺失字段保持缺失,不用推测补齐。
|
|
16
16
|
|
|
17
17
|
引用量化结论时说明 `report_id` 及对应 evidence 条目;标题关键词推断仅是低置信度线索,不得叙述为确定事实。持续展示并重复适用边界:数据仅覆盖剧查查公开 Top 30 榜单样本,不代表全量市场,也不构成收入、投资或投放承诺。
|
|
18
18
|
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
"snapshot_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/marketId"}},
|
|
39
39
|
"generated_at": {"$ref": "#/$defs/rfc3339DateTime"},
|
|
40
40
|
"filters": {"$ref": "#/$defs/filters"},
|
|
41
|
-
"sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
|
|
41
|
+
"sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$", "description": "所引用 market-report.v2 文件原始字节的 SHA-256,十六进制小写;不得对规范化或重新序列化的 JSON 计算。"},
|
|
42
42
|
"selected_hypothesis_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/localId"}}
|
|
43
43
|
}
|
|
44
44
|
},
|
|
@@ -10,6 +10,6 @@
|
|
|
10
10
|
|
|
11
11
|
不得复用或改写榜单作品标题、人物关系、具体情节、独特台词或故事结构;不得承诺收入、投放效果或市场必然成功。差异化字段应明确原创变换,风险和验证问题不得省略。
|
|
12
12
|
|
|
13
|
-
使用
|
|
13
|
+
使用 `../assets/modules/ideate-drama-from-market/prompts/market_inspiration.{zh,en}.txt` 生成严格 JSON。`report_ref` 的 `report_id`、`snapshot_ids`、`generated_at`、`filters` 必须逐字段复制自用户指定的同一份 `market-report.v2` 文件;`sha256` 是该文件原始字节的 SHA-256,用 `shasum -a 256 <报告文件>` 或 `sha256sum <报告文件>` 取得,不得改用规范化 JSON、重新序列化或自行猜测的算法;`selected_hypothesis_ids` 只写用户明确选定的假设 ID。`decision.selected_hypothesis_ids` 必须与 `report_ref` 完全一致。CLI 没有生成 `report_ref` 的专用命令,`canvas document save` 只返回资产和版本 ID,不能代替引用字段。用户确认后,可用 `canvas document save` 保存这份 JSON。
|
|
14
14
|
|
|
15
15
|
保存到项目不是默认动作:只有用户明确要求将市场灵感用于该项目时,才写入 `market-inspiration.json`,并在 Brief 的 `market_inspiration_ref` 中写入相同的完整 `report_ref`。不得自动改写项目题材、平台、来源事实、合规约束或用户已确认的创意决定。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/scripts/README.md
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# 市场报告脚本
|
|
2
|
+
|
|
3
|
+
这里是一组**离线维护工具**,用于把公开榜单快照整理成 `market-report.v2` 文件:抓取 → 归一化 → 指标分析 → 落盘与渲染 Markdown。它们不是 CLI 子命令,也没有运行时入口;`ai-short-studio` 不会调用这里的任何文件。
|
|
4
|
+
|
|
5
|
+
## 什么时候用
|
|
6
|
+
|
|
7
|
+
- 需要为本机重新生成一份 `market-report.v2`,交给 [分析短剧市场](../analyze-drama-market.md) 和 [从市场构思短剧](../ideate-drama-from-market.md) 消费。
|
|
8
|
+
- 需要复核已有报告的指标算法、快照对比或公司集中度计算。
|
|
9
|
+
|
|
10
|
+
Skill 本身只读取用户提供的报告文件,不联网、不刷新快照;下面的抓取步骤属于操作者自己的数据准备,执行前必须确认自己对目标站点有访问授权,并遵守站点条款。脚本不携带任何密钥或账号 token,也不会绕过登录或付费墙。
|
|
11
|
+
|
|
12
|
+
## 模块
|
|
13
|
+
|
|
14
|
+
| 文件 | 职责 |
|
|
15
|
+
| --- | --- |
|
|
16
|
+
| `juchacha-client.mjs` | 剧查查公开榜单的最小只读客户端;提供榜单定义、日期签名和超时/HTTP 错误分类 |
|
|
17
|
+
| `normalize.mjs` | 把原始榜单条目归一化为统一结构,合并同一作品的多次观测 |
|
|
18
|
+
| `analyze.mjs` | 题材机会分、平台矩阵、公司集中度、快照对比 |
|
|
19
|
+
| `store.mjs` | 工作区快照存储:不可变写入、最新指针、并发协调、损坏索引恢复 |
|
|
20
|
+
| `report.mjs` | 把报告对象渲染为 Markdown |
|
|
21
|
+
|
|
22
|
+
`store.mjs` 只接受规范工作区路径,拒绝符号链接逃逸;写入使用临时文件 + rename,失败不会留下半成品快照。
|
|
23
|
+
|
|
24
|
+
## 用法
|
|
25
|
+
|
|
26
|
+
脚本通过 ESM 具名导出使用,没有命令行参数解析层:
|
|
27
|
+
|
|
28
|
+
```js
|
|
29
|
+
import { createJuchachaClient, rankingDefinitions } from './juchacha-client.mjs'
|
|
30
|
+
import { normalizeRankings } from './normalize.mjs'
|
|
31
|
+
import { analyzeMarket } from './analyze.mjs'
|
|
32
|
+
import { createMarketStore } from './store.mjs'
|
|
33
|
+
import { renderMarketReportMarkdown } from './report.mjs'
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
调用顺序与依赖关系:
|
|
37
|
+
|
|
38
|
+
1. `createJuchachaClient()` 拉取所需榜单,失败时按 `JUCHACHA_TIMEOUT` / `JUCHACHA_HTTP_ERROR` 分类,不自动重试。
|
|
39
|
+
2. `normalizeRankings()` 归一化并合并重复观测。
|
|
40
|
+
3. `analyzeMarket()` 产出指标;`previousItems` 用于趋势对比,缺失时趋势字段保持缺失,不推断。
|
|
41
|
+
4. `createMarketStore(workspaceRoot)` 写入快照,`readLatest()` 回读最新报告。
|
|
42
|
+
5. `renderMarketReportMarkdown()` 生成可读摘要。
|
|
43
|
+
|
|
44
|
+
生成的报告必须满足 [报告合同](../analyze-drama-market/market-report.schema.json),`schema_version` 为 `market-report.v2`;引用时按 Skill 要求给出 `report_id` 与 SHA-256 前 12 位。
|
|
45
|
+
|
|
46
|
+
## 测试
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
node --test *.test.mjs
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
在项目根目录也可以用 `npm run test:skill-scripts` 执行同一组测试(80 项,纯本地,不访问网络)。测试用注入的 `fetchImpl` 覆盖成功、超时、HTTP 错误和畸形响应,因此离线可跑。
|
|
53
|
+
|
|
54
|
+
修改脚本时必须保持:
|
|
55
|
+
|
|
56
|
+
- 不引入 `fetch` 之外的外部依赖;
|
|
57
|
+
- 不记录或传递账号凭据;
|
|
58
|
+
- 分析结果缺失字段保持缺失,不用 0 或推测值填充;
|
|
59
|
+
- 快照写入保持不可变,重复写入同一内容返回原记录而不是覆盖。
|