@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
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`
|
|
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 = '
|
|
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('
|
|
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('
|
|
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: '
|
|
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
|
|
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 = '
|
|
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 = '
|
|
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,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('
|
|
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: using-vvicat-ai-short-studio-cli
|
|
3
|
-
description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI. Freeform JSON documents and workflow status are the canonical production interface; legacy fixed-node
|
|
3
|
+
description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI. Freeform JSON documents and workflow status are the canonical production interface; legacy fixed-node pipelines are read-only compatibility paths for existing projects.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 使用 VVICAT AI Short Studio CLI
|
|
@@ -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
|
-
-
|
|
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,47 +29,47 @@ 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
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
| 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/
|
|
37
|
-
| 背景音乐、主题曲、纯音乐 | `references/short-drama/
|
|
38
|
-
| 去字幕、参考视频复刻、深度视频 | `references/
|
|
39
|
-
| 参考对白转写、剪辑、字幕和多图模板 | `references/
|
|
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/creation/write-drama-director-book.md`、`references/short-drama/director-composition.md` | 在资产生成和拆镜前完成 `drama-director-book`;构图、轴线和表演决定必须来自剧本事实,证据不足时降级构图,不补陈设或天气 |
|
|
34
|
+
| 人物、场景、道具和资产版本 | `references/short-drama/prompt/prompt-craft.md`、`references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
|
|
35
|
+
| 结构化分镜、分镜图、逐镜制作计划与跨镜连续性 | `references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | `storyboard-breakdown → drama-production-plan → drama-continuity-plan → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,只生成已选择的板型;只有前镜已审核且选版时允许 previous-tail |
|
|
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` 选择模块;结果保存为 `
|
|
42
|
+
自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `canvas.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
新项目禁止预搭旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条连好的流水线)。分析阶段每个产物都由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的自由画布文档和选定媒体版本。媒体生成节点和专业拆镜入口(`canvas node add storyboard-breakdown --source-format …`)仍是当前接口,由画布按文档物化或按需单独创建。
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
旧版固定节点链仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点链。
|
|
47
47
|
## 核心原则
|
|
48
48
|
|
|
49
49
|
生产环境认证优先使用 MemHub;CLI 通过浏览器 PKCE 登录或个人 API Key 访问,只有本地明确关闭 MemHub 时才使用 Supabase 兼容登录。
|
|
50
50
|
|
|
51
|
-
把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema
|
|
51
|
+
把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时,合并询问最少必要问题;得到答复前只做只读检查。不得用示例值替用户作创作决定。节点 `prompt` 只能补充创作意图,服务端会把语言与最终结构合同追加在它之后,冲突时以后置合同为准。
|
|
52
52
|
|
|
53
53
|
优先使用一次 `canvas inspect` 聚合查询。同阶段可合并的 settings、节点和连线分别使用 `canvas settings set --file`、`canvas apply`、`canvas node update-many`。生成链使用单个调度循环滚动提交,不用 `--wait` 把整批阶段串行化:节点一完成就刷新画布并立即提交它已就绪的下游节点。默认每类并发 4、总并发上限 16;同一节点同一输入指纹只允许一个在途任务,不并发启动多个相互竞争的调度器。409 重读并审阅差异;schema 和业务检查错误进入恢复链路,能修正的自主修正后继续。401/403、供应商余额等无法自主修正的问题报告准确原因,继续不依赖该节点的工作。
|
|
54
54
|
|
|
55
55
|
## 主流程
|
|
56
56
|
|
|
57
|
-
1.
|
|
57
|
+
1. **预检与实时节点目录门禁**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`,并在创建或配置任何节点前读取 `canvas node types --json`。config 只写实时 `configSchema.properties` 声明的键;`title`、坐标和连线身份属于节点属性(`canvas node add --title`、`canvas node update --title`),不写入 `config`,`music-generate` 的 `title` 只是 Suno 模型参数,不得复制到其他节点;服务端或调用方拒绝未知配置字段时,删除该字段并按实时 schema 重试,不猜字段名。结构化短剧节点的输出按 `structuredOutputSchema` 组织,不能从 `TEXT`/`SCRIPT` 端口猜 JSON。`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`
|
|
60
|
-
4.
|
|
61
|
-
5.
|
|
62
|
-
6.
|
|
63
|
-
7.
|
|
64
|
-
8.
|
|
65
|
-
9.
|
|
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` 返回的 `currentStage` 依次生成来源分析 → 创作简报 → 故事设定 → 分集大纲 → 单集剧本 → Humanizer 自然化 → 剧本审校 → 导演手册 → 资产计划;每步用 `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 味;不得改动已经确认的剧情事实,剧本审校 P0/P1 未清零不得进入导演与资产阶段,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
|
|
61
|
+
5. **资产门禁**:先完成人物、场景、道具及其派生版本。资产图分别用 `character-turnaround`、`location-image`(`locationImagePurpose: location-sheet`)、`prop-turnaround`,`prompt` 端口连接结构化设定节点;默认模板 `character_asset_sheet`、`scene_asset_sheet`、`prop_generate` 是参考正文,不得删除,也不得改用 `image-generate` 代替设定板。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
|
|
62
|
+
6. **拆镜与制作计划**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。结构化分镜之后依次生成逐镜制作计划和跨镜连续性计划;只有前镜已审核且选版时才允许 previous-tail。视频提交前必须完成素材连线、镜头逻辑和上下镜连续性审计。
|
|
63
|
+
7. **分镜图与逐镜审计**:Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。逐镜审计 P0/P1 未清零不得写入视频提示词或提交视频。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。
|
|
64
|
+
8. **视频规划、提示词与 H3 生成门禁**:读取实时 `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。`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
|
+
9. **视频滚动生成与逐镜后验**:允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。每个视频镜头完成后实际看画面、听完整音轨,并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头;未通过不得进入成片剪辑。
|
|
66
66
|
10. **成片和交付**:剪辑只使用通过验收的 selected 版本,并完整执行 [剪辑与交付](references/editing-delivery.md)。默认对白/旁白字幕进入成片,人物与场景介绍仅在首次出现时显示短暂角标,同时输出独立 SRT/ASS。根据叙事动机选择硬切、动作切、J/L-cut、遮挡匹配或短淡化,不给所有镜头机械套淡入淡出。完成节奏裁切、声音平衡、画面统一、字幕和必要技术处理后,从头到尾观看成片并执行完整成片验收;未通过不得声称完成。原始视频按 `selectedOutputVersionId` 下载,字幕独立保存,`manifest` 记录镜号、节点、任务、资产、版本、时间线和文件名。
|
|
67
67
|
|
|
68
68
|
## 强制分流
|
|
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/
|
|
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
|
## 安全与完成条件
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
ai-short-studio canvas node diagnose "$NODE_ID" --project "$PROJECT_ID" --json
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
-
返回节点配置、实时输入端口、上游当前版本及正文、最近任务状态和 `recoveryActions`。它是只读检查,不是执行成功或创作质量证明。按实时节点 schema 修正配置,按精确 edge ID 修正接线;字段修改使用 `canvas node update --set` 或 `--config`,批量修改使用 `update-many` 的 `set/unset`,不要传被忽略的 `config`
|
|
25
|
+
返回节点配置、实时输入端口、上游当前版本及正文、最近任务状态和 `recoveryActions`。它是只读检查,不是执行成功或创作质量证明。按实时节点 schema 修正配置,按精确 edge ID 修正接线;字段修改使用 `canvas node update --set` 或 `--config`,批量修改使用 `update-many` 的 `set/unset`,不要传被忽略的 `config` 包装。配置被拒绝(服务端或调用方提示未知字段,例如把节点标题 `title` 写进 `config`)时,删除该字段并按实时 `configSchema.properties` 修正后重试;节点标题用 `canvas node update --title`,换名猜字段或重复提交同一无效字段都不算修复。
|
|
26
26
|
|
|
27
27
|
| 问题所在位置 | 恢复方法 |
|
|
28
28
|
| --- | --- |
|
|
@@ -28,6 +28,17 @@
|
|
|
28
28
|
|
|
29
29
|
## 资产生产门禁
|
|
30
30
|
|
|
31
|
+
### 默认资产模板与生成节点
|
|
32
|
+
|
|
33
|
+
默认模板是 Agent 生成资产图的参考正文,随包保留,不因节点内置合同存在而删除:人物 `character_asset_sheet`、场景 `scene_asset_sheet`、道具 `prop_generate`、分镜板 `panel_grid_image` / `panel_storyboard_image`。生成时按下列对应关系落到真实节点,模板输出与端口连线共同决定实际正文;这些节点由画布按已选文档物化,也可按需单独创建,不属于被禁止的旧版固定功能节点链:
|
|
34
|
+
|
|
35
|
+
- **人物**:`character-resource → character-visual-design → character-turnaround`;`prompt` 端口接人物视觉方案,`reference` 只接该人物已选主形象。
|
|
36
|
+
- **场景**:`location-resource → location-image`;空间设定多视图用 `locationImagePurpose: location-sheet`,单幅无分格干净背景另建 `background-plate` 节点。
|
|
37
|
+
- **道具**:`prop-resource → prop-turnaround`;白底单道具、主视图加正/侧/背三视图由服务端合同追加。
|
|
38
|
+
- **分镜板**:`storyboard-grid-image`(时间故事版)、`storyboard-board-image`(镜头分镜板)、`storyboard-image`(其他已选择主类型);`prompt` 端口接结构化分镜。
|
|
39
|
+
|
|
40
|
+
这些资产不得用 `image-generate` 生成:它是透明边界,只组合用户直填或连入的文本,不追加设定板或分镜板合同。每项资产使用独立节点和独立资产版本,`count` 的多结果不能拼图。模板变量必须由已选资产计划、已确认档案和完整画风对象填充,不保留占位符,不把临时 URL、节点标题或未选版素材写进正文。
|
|
41
|
+
|
|
31
42
|
专业镜头的 `assetNodeRefs` 与 `visualAssetBindings` 共用镜头选版。通过下文专业增量修订流程,为每项设定来源绑定实际 `imageNodeId`,并把这些图片接到已选择板型的 `reference` 端口;不能按节点标题猜归属。每个绑定图片节点只能代表一个选定媒体,多候选需使用单项资源节点。服务端在付费板图前检查全部声明资产、上游真实设定边、选版与实际上送图片;提示词按实际数组编译身份和参考序号。修改绑定会使已选择板型及下游 stale;设定换版或文字投影变化同样使旧来源失效。所有已选择板型都审核通过仍要比较实际参考集合,差异不能由文字批准覆盖;引用覆盖不代表图像像素已符合设定。
|
|
32
43
|
|
|
33
44
|
1. 只生产目标集实际出现的人物及形象版本、场景/子场景、关键道具及叙事版本。每项任务成功后展示真实预览,让用户确认并设置 selected version。
|
|
@@ -12,18 +12,18 @@ ai-short-studio canvas node types --json
|
|
|
12
12
|
|
|
13
13
|
## 自由画布文档(新项目唯一入口)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
新项目不得通过旧版固定功能节点链编排短剧;分析阶段产物走自由画布文档。先运行:
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
18
|
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` 写入 `
|
|
22
|
+
按返回的 `currentStage`、`checks` 和条件模块,在 `text-resource` 节点用 `canvas document save` 写入 `canvas.<module>.v1`。每个版本必须使用 `--input` 绑定上游选版;审核单独保存为 `canvas.review.v1`。保存后重新运行 `canvas documents`,直到阶段状态和审核证据一致。
|
|
23
23
|
|
|
24
24
|
## 历史节点兼容
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
旧版固定功能节点链(`screenplay-resource` 起始、`drama-*` 分析节点整条预连的流水线)只用于读取、审计和迁移历史项目,不得作为新项目入口,也不得与自由画布文档并行写入同一阶段。节点命令本身是当前接口:媒体生成节点(`character-turnaround`、`location-image`、`prop-turnaround`、`storyboard-*`、`video-generate`)由画布按文档物化或按需单独创建,专业拆镜用 `canvas node add storyboard-breakdown --source-format …`;分析阶段产物仍以 `text-resource` 文档为准。
|
|
27
27
|
|
|
28
28
|
## 节点
|
|
29
29
|
|
|
@@ -41,19 +41,23 @@ ai-short-studio canvas node delete <nodeId> --project <projectId> --yes --json
|
|
|
41
41
|
|
|
42
42
|
`update` 只改普通 config、标题和坐标;结构化 artifact 必须用 `edit-shot` / `edit-resource` 追加版本。身份字段不可修改。两类编辑对同节点、同基线、同载荷重复提交或当前选版已满足目标时幂等;画布冲突刷新当前选版后重试一次,资产版本竞争保留原基线重试一次,其他 409 直接停止核对。
|
|
43
43
|
|
|
44
|
+
节点 config 只能写实时 `canvas node types --json` 中该 kind 的 `configSchema.properties` 键,并按其中的类型、枚举和默认值提交。`title`、`x`、`y`、端口和节点身份不是 config 字段:标题用 `canvas node add --title` 或 `canvas node update --title`。只有 `music-generate` 的 `title` 是该节点的 Suno 模型参数,不得复制到其他节点。服务端或调用方拒绝未知配置字段时,删除该字段并按实时 schema 重试,不猜字段名,也不用重复提交绕过校验。
|
|
45
|
+
|
|
44
46
|
`--asset-id` 仅用于 `image`、`video`、`audio` 媒体节点,把已有资产的 selected 版本绑定为节点输出;CLI 会先按实时节点目录拒绝非媒体节点,资产类型仍由服务端校验。上传资产后先用 `canvas asset list` 或上传响应取得资产 ID,再创建媒体节点并连线。
|
|
45
47
|
|
|
46
48
|
自由画布 JSON 产物保存到 `text-resource` 节点;每次保存追加版本,`--input` 记录上游节点当前资产选版。续写前先读状态,`ready: false` 时根据 `staleInputs` 重做受影响产物,不能沿用旧审核。
|
|
47
49
|
|
|
50
|
+
`--schema-key` 使用 `canvas.<小节>.v<版本>`,例如 `canvas.script.v1`。CLI 在发起请求前本地校验该格式;旧前缀 `hypit.*` 仍被接受,但会归一化为 `canvas.*` 后再提交并给出迁移提示,服务端也只保存 `canvas.*`。
|
|
51
|
+
|
|
48
52
|
```bash
|
|
49
53
|
ai-short-studio canvas document get <scriptNodeId> --project <projectId> --json
|
|
50
|
-
ai-short-studio canvas document save <scriptNodeId> --project <projectId> --name 剧本 --schema-key
|
|
54
|
+
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
55
|
ai-short-studio canvas document status <scriptNodeId> --project <projectId> --json
|
|
52
56
|
ai-short-studio canvas documents --project <projectId> --json
|
|
53
57
|
ai-short-studio canvas workflow status --project <projectId> --json
|
|
54
58
|
```
|
|
55
59
|
|
|
56
|
-
审核报告也保存为独立 `text-resource` 文档:`--schema-key
|
|
60
|
+
审核报告也保存为独立 `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
61
|
|
|
58
62
|
音乐节点使用 `music-generate`,输出 AUDIO。`prompt` 必填,可配置 `model`、`title`、`tags`、`lyrics` 和 `makeInstrumental`;`lyrics` 与 `makeInstrumental: true` 不能同时提交。`--config` 读取 JSON 文件,不接受内联 JSON 字符串。
|
|
59
63
|
|
|
@@ -86,6 +90,22 @@ H3 批量启用原生音频的 `updates.json`:
|
|
|
86
90
|
|
|
87
91
|
提交前以实时命令 schema 为准,提交后逐节点 `get` 回读。
|
|
88
92
|
|
|
93
|
+
## 声音库与角色音色绑定
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
ai-short-studio canvas voice list --json
|
|
97
|
+
ai-short-studio canvas voice upload ./voice/linwan.mp3 --name "林晚-冷静女声" --description "都市情感,克制" --json
|
|
98
|
+
ai-short-studio canvas voice bind <characterId> --project <projectId> --voice <globalVoiceId> --json
|
|
99
|
+
ai-short-studio canvas voice unbind <characterId> --project <projectId> --json
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
- `voice list` 返回当前账户声音库的跨项目音色条目;`item.voiceId` 才是提交给 Provider 的真实音色标识,`globalVoiceId` 只是声音库记录 ID。
|
|
103
|
+
- `voice upload` 只接受 `mp3`、`wav`、`m4a`、`aac`、`ogg`,注册为声音库条目,不上传画布资产,也不自动绑定角色。上传后先用 `voice list` 回读确认条目可用。
|
|
104
|
+
- `voice bind` 写入的是小说推广项目角色(`novelPromotionCharacter`)的音色字段,不是自由画布节点。该角色若来自全局人物库,绑定会同时改写全局人物(`globalCharacter`)的音色,影响引用同一人物的其他项目;绑定前必须确认影响范围。绑定后回读 `GET /api/novel-promotion/<projectId>/character/<characterId>/voice` 核对 `voiceId`、`voiceType` 和 `customVoiceUrl` 实际值。
|
|
105
|
+
- `voice unbind` 只清空上述音色字段,不删除声音库条目。
|
|
106
|
+
|
|
107
|
+
自由画布的短剧配音不使用这四个命令:音色写入 `audio-plan` 的 `voiceBindings` 与 `tts.voice` 节点配置,并由 `drama-audio-plan`、`voice-design`、`voice-clone` 节点执行,见 [声音与音频设计](../short-drama/generation/design-drama-audio.md)。
|
|
108
|
+
|
|
89
109
|
## 连线与连续性
|
|
90
110
|
|
|
91
111
|
```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,升级属于独立任务,需重新核对规则差异后整体替换。
|