@aswless_854771076/ai_short_studio_cli 0.1.158 → 0.1.160
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 +35 -5
- package/dist/command-helpers.js +1 -0
- package/dist/commands/canvas/asset/audit.d.ts +14 -0
- package/dist/commands/canvas/asset/audit.js +90 -0
- package/dist/commands/canvas/asset/select.d.ts +1 -0
- package/dist/commands/canvas/asset/select.js +1 -0
- package/dist/commands/canvas/continuity/analyze.js +1 -1
- package/dist/commands/canvas/document/save.d.ts +1 -0
- package/dist/commands/canvas/document/save.js +14 -0
- package/dist/commands/canvas/settings/set.d.ts +1 -0
- package/dist/commands/canvas/settings/set.js +2 -1
- package/dist/commands/preflight.js +28 -0
- package/dist/commands/skill/diff.d.ts +16 -0
- package/dist/commands/skill/diff.js +17 -0
- package/dist/domain/canvas-asset-audit.d.ts +53 -0
- package/dist/domain/canvas-asset-audit.js +112 -0
- package/dist/domain/canvas-document-contract.d.ts +49 -0
- package/dist/domain/canvas-document-contract.js +94 -0
- package/dist/skill/skill-manager.d.ts +64 -0
- package/dist/skill/skill-manager.js +69 -5
- package/package.json +1 -1
- package/scripts/postinstall.mjs +6 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +5 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/assets-and-storyboard.md +8 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-inspection.md +10 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-media-gates.md +39 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/canvas-production-principles.md +11 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/assets-and-tasks.md +3 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md +4 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/commands/project.md +3 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/SKILL.md +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/define-drama-brief/prompts/drama_brief.en.txt +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/assets/modules/define-drama-brief/prompts/drama_brief.zh.txt +3 -3
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/feature-completeness.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/generation/write-drama-video-prompts.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/module-map.json +130 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/pipeline.md +25 -0
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/storyboard/plan-shot-continuity.md +3 -3
|
@@ -28,7 +28,7 @@ H3 使用 Ref2VA 六段英文正文,保留原文对白,最终发给 Provider
|
|
|
28
28
|
|
|
29
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` 排列,仅对白、歌词和画内文字保留原语言。不得混用两套语法。
|
|
30
30
|
|
|
31
|
-
`continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由
|
|
31
|
+
`continuity.mode=previous-tail` 时仍使用 `full-reference`/`Ref2VA`,由 `previous-tail` 承接派生的 `other-transition-*` 作为第一个 `image/first_frame` 语义连续性锚点,其余人物、实际选择的分镜板和音频参考不得省略。编译前核对其来源版本与 SHA-256 仍对应上一镜当前 selected 视频;来源镜换版后必须重新派生尾帧。
|
|
32
32
|
|
|
33
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`、伪造空数组或手写占位文档。
|
|
34
34
|
|
|
@@ -401,6 +401,136 @@
|
|
|
401
401
|
"edit-deliver-drama"
|
|
402
402
|
]
|
|
403
403
|
},
|
|
404
|
+
"documents": {
|
|
405
|
+
"source-analysis": {
|
|
406
|
+
"module": "analyze-drama-source",
|
|
407
|
+
"template_stem": "source_analysis",
|
|
408
|
+
"stage": "analysis",
|
|
409
|
+
"required_fields": [
|
|
410
|
+
"source_scope",
|
|
411
|
+
"adaptation_mode",
|
|
412
|
+
"facts",
|
|
413
|
+
"timeline",
|
|
414
|
+
"characters",
|
|
415
|
+
"locations",
|
|
416
|
+
"props",
|
|
417
|
+
"conflicts",
|
|
418
|
+
"themes",
|
|
419
|
+
"visual_challenges",
|
|
420
|
+
"content_constraints",
|
|
421
|
+
"user_requirements",
|
|
422
|
+
"contradictions",
|
|
423
|
+
"open_questions",
|
|
424
|
+
"coverage"
|
|
425
|
+
]
|
|
426
|
+
},
|
|
427
|
+
"bible": {
|
|
428
|
+
"module": "design-drama-bible",
|
|
429
|
+
"template_stem": "ai_story_expand",
|
|
430
|
+
"stage": "analysis",
|
|
431
|
+
"required_fields": [
|
|
432
|
+
"premise",
|
|
433
|
+
"genre",
|
|
434
|
+
"tone",
|
|
435
|
+
"themes",
|
|
436
|
+
"world_rules",
|
|
437
|
+
"ending",
|
|
438
|
+
"characters",
|
|
439
|
+
"relationships",
|
|
440
|
+
"three_act",
|
|
441
|
+
"conflict_ladder",
|
|
442
|
+
"promises_and_payoffs",
|
|
443
|
+
"foreshadowing",
|
|
444
|
+
"continuity_rules",
|
|
445
|
+
"adaptation_constraints",
|
|
446
|
+
"open_questions"
|
|
447
|
+
]
|
|
448
|
+
},
|
|
449
|
+
"outline": {
|
|
450
|
+
"module": "outline-drama-series",
|
|
451
|
+
"template_stem": "episode_split",
|
|
452
|
+
"stage": "analysis",
|
|
453
|
+
"required_fields": [
|
|
454
|
+
"episodes"
|
|
455
|
+
],
|
|
456
|
+
"non_empty_fields": [
|
|
457
|
+
"episodes"
|
|
458
|
+
]
|
|
459
|
+
},
|
|
460
|
+
"script": {
|
|
461
|
+
"module": "write-drama-episode",
|
|
462
|
+
"template_stem": "screenplay_conversion",
|
|
463
|
+
"stage": "script",
|
|
464
|
+
"required_fields": [
|
|
465
|
+
"clip_id",
|
|
466
|
+
"original_text",
|
|
467
|
+
"scenes",
|
|
468
|
+
"unresolved"
|
|
469
|
+
],
|
|
470
|
+
"non_empty_fields": [
|
|
471
|
+
"scenes"
|
|
472
|
+
]
|
|
473
|
+
},
|
|
474
|
+
"director-book": {
|
|
475
|
+
"module": "write-drama-director-book",
|
|
476
|
+
"template_stem": "director_book",
|
|
477
|
+
"stage": "director-book",
|
|
478
|
+
"required_fields": [
|
|
479
|
+
"episode_key",
|
|
480
|
+
"source_script_version",
|
|
481
|
+
"scenes",
|
|
482
|
+
"continuity_ledger",
|
|
483
|
+
"open_questions"
|
|
484
|
+
],
|
|
485
|
+
"non_empty_fields": [
|
|
486
|
+
"scenes"
|
|
487
|
+
]
|
|
488
|
+
},
|
|
489
|
+
"asset-plan": {
|
|
490
|
+
"module": "plan-drama-assets",
|
|
491
|
+
"template_stem": "asset_analysis",
|
|
492
|
+
"stage": "asset-analysis",
|
|
493
|
+
"required_fields": [
|
|
494
|
+
"episode_key",
|
|
495
|
+
"characters",
|
|
496
|
+
"scenes",
|
|
497
|
+
"props",
|
|
498
|
+
"unresolved"
|
|
499
|
+
]
|
|
500
|
+
},
|
|
501
|
+
"production-plan": {
|
|
502
|
+
"module": "plan-drama-production",
|
|
503
|
+
"template_stem": "production_plan",
|
|
504
|
+
"stage": "production-plan",
|
|
505
|
+
"required_fields": [
|
|
506
|
+
"episode_key",
|
|
507
|
+
"source_versions",
|
|
508
|
+
"shots",
|
|
509
|
+
"totals",
|
|
510
|
+
"unresolved",
|
|
511
|
+
"approved"
|
|
512
|
+
],
|
|
513
|
+
"non_empty_fields": [
|
|
514
|
+
"shots"
|
|
515
|
+
]
|
|
516
|
+
},
|
|
517
|
+
"continuity-plan": {
|
|
518
|
+
"module": "plan-shot-continuity",
|
|
519
|
+
"template_stem": "continuity_plan",
|
|
520
|
+
"stage": "production-plan",
|
|
521
|
+
"required_fields": [
|
|
522
|
+
"episode_key",
|
|
523
|
+
"source_versions",
|
|
524
|
+
"scenes",
|
|
525
|
+
"shots",
|
|
526
|
+
"unresolved",
|
|
527
|
+
"approved"
|
|
528
|
+
],
|
|
529
|
+
"non_empty_fields": [
|
|
530
|
+
"shots"
|
|
531
|
+
]
|
|
532
|
+
}
|
|
533
|
+
},
|
|
404
534
|
"provider_prompts": [
|
|
405
535
|
"character_asset_sheet",
|
|
406
536
|
"scene_asset_sheet",
|
|
@@ -23,6 +23,31 @@
|
|
|
23
23
|
|
|
24
24
|
进入媒体或剪辑阶段前运行 `ai-short-studio preflight --json`。每次付费生成前重新核对当前阶段、全部上游门禁、模型实时能力和用户确认范围;失败发生在提交付费请求之前。
|
|
25
25
|
|
|
26
|
+
## 文档键与内容合同
|
|
27
|
+
|
|
28
|
+
阶段状态只按 `document-key` 匹配文档:不按节点标题、`schema-key` 或创建顺序判断,键写错时该阶段会一直显示 `missing`。以下键与必需顶层字段以 `module-map.json` 的 `documents` 为唯一机器事实;`canvas document save` 在发出请求前按同一合同核对正文,缺字段或非空字段为空时直接失败并指出要读的模板路径。
|
|
29
|
+
|
|
30
|
+
| 文档键 | 模块 | 说明 |
|
|
31
|
+
| --- | --- | --- |
|
|
32
|
+
| `source-analysis` | `analyze-drama-source` | 来源分析,15 个顶层字段全部必填,`coverage` 记录逐份来源覆盖 |
|
|
33
|
+
| `bible` | `design-drama-bible` | 故事设定,三幕、人物弧、冲突阶梯与伏笔回收 |
|
|
34
|
+
| `outline` | `outline-drama-series` | 分集大纲,`episodes` 不得为空 |
|
|
35
|
+
| `script` | `write-drama-episode` | 单集剧本,保存时使用 `ep-001.script` 这类带分集前缀的键,`scenes` 不得为空 |
|
|
36
|
+
| `director-book` | `write-drama-director-book` | 导演本,逐场摄影与表演决定 |
|
|
37
|
+
| `asset-plan` | `plan-drama-assets` | 资产计划,人物、场景、道具与未决问题 |
|
|
38
|
+
| `production-plan` | `plan-drama-production` | 逐镜制作计划,`shots` 不得为空 |
|
|
39
|
+
| `continuity-plan` | `plan-shot-continuity` | 跨镜连续性计划,`shots` 不得为空 |
|
|
40
|
+
|
|
41
|
+
其余阶段文档键固定为 `brief`、`humanized`、`script.review`、`art-style`、`asset-selection`、`storyboard`、`storyboard-images`、`video-prompts`、`videos`、`shot-review`、`edit-plan`、`delivery-review`;审核类文档另存为 `canvas.review.v1`,正文按 [画布命令](../commands/canvas.md) 的审核形状写 `decision` 与 `issues`,不能写成模板里的 `approved` 字段。
|
|
42
|
+
|
|
43
|
+
保存顺序固定为:读取 `module-map.json` 的文档合同 → 完整读取对应 `assets/modules/<module>/prompts/<template_stem>.zh.txt` 模板 → 按模板声明的顶层字段生成 JSON → `canvas document save --document-key <登记键> --schema-key canvas.<键末段>.v1 --input <上游节点>` → `canvas documents` 与 `canvas document get` 回读必需字段和来源快照。
|
|
44
|
+
|
|
45
|
+
- 只写摘要、`source_type` 一类自造字段或空数组的占位文档不是阶段产物:它会让 `workflow status` 变成 ready,但下游拿到的是空分析。这类文档必须重写,不能用 `--allow-partial` 绕过。
|
|
46
|
+
- `--allow-partial` 只用于用户明确要求保存的半成品草稿;该版本不得作为阶段依据,也不得下游继承。
|
|
47
|
+
- 不要先铺一批空的 `text-resource` 节点再补正文;只有实际写出正文并保存版本的文档才创建节点,或直接复用已有节点。
|
|
48
|
+
- 文档键与 `--input` 快照必须同时正确:键对而来源缺失、来源选版变化都会让阶段重新变为不可用。
|
|
49
|
+
|
|
50
|
+
|
|
26
51
|
## 资产与媒体
|
|
27
52
|
|
|
28
53
|
图片、音频和视频生成成功后,必须立即下载或回读真实产物,登记为画布资产版本并记录 SHA-256、来源和任务信息,再允许选版或进入下游。远程 URL 只是临时传输结果,不得作为最终资产;未选版、未审核或带过期链接的素材不得写入下游节点。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/prompt/seedance-prompting.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Seedance 2.0 逐镜提示词规范
|
|
2
2
|
|
|
3
|
-
本文件是随包内置的 Seedance 提示词检查层,不依赖外部站点或社区仓库。正式提交模板是 `assets/modules/write-drama-video-prompts/prompts/seedance2_video.zh.txt` 与 `.en.txt`;本文件只规定编译前的判断、素材用途、动作、镜头、表演、声音、连续性和返工顺序。类型决策、描述维度和质量分级见 [通用提示词规范](prompt-craft.md)。模型参数、素材上限和输入模式以实时 Provider schema 为准,模板与实时能力冲突时先修正路由。
|
|
3
|
+
本文件是随包内置的 Seedance 提示词检查层,不依赖外部站点或社区仓库。正式提交模板是 `references/short-drama/assets/modules/write-drama-video-prompts/prompts/seedance2_video.zh.txt` 与 `.en.txt`;本文件只规定编译前的判断、素材用途、动作、镜头、表演、声音、连续性和返工顺序。类型决策、描述维度和质量分级见 [通用提示词规范](prompt-craft.md)。模型参数、素材上限和输入模式以实时 Provider schema 为准,模板与实时能力冲突时先修正路由。
|
|
4
4
|
|
|
5
5
|
## 先定本镜任务
|
|
6
6
|
|
|
@@ -4,12 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
规划阶段固定使用 `coordinate_mode=semantic`,以画面左/中/右、前/中/后景、朝向、视线对象和出入画边表达语义位置;不得从结构化分镜、图片透视或经验估算三维坐标。后续 Blender 白模只能验证或暴露冲突,不能静默改写已批准连续性计划;冲突必须回退规划阶段生成新版本。
|
|
6
6
|
|
|
7
|
-
逐镜记录 `camera_setup_id`、`start_state`、`end_state
|
|
7
|
+
逐镜记录 `camera_setup_id`、`start_state`、`end_state`、人物位置/姿态/运动方向/持物、道具状态、轴线、机位侧和主光锚点。对每组相邻镜按 `continuity_plan` 模板的 `recommendTailLink(previous,current)` 规则判定:仅同场景、同机位、同轴线且状态无未解释跳变时,才可启用 `previous-tail`;第一镜、切换机位、越轴、场景变化或有意状态跳变使用 `independent`。合法 previous-tail 必须绑定上一镜号、上一镜 `camera_setup_id` 和 `video.first-frame` 能力。
|
|
8
8
|
|
|
9
9
|
任何无法由证据解释的差异都写入 `unresolved`,并令 `approved=false`;不得把猜测写进 `allowed_changes` 以绕过校验。`allowed_changes` 只记录剧本、导演本或已批准调度明确要求的变化,`evidence` 指向相应来源。
|
|
10
10
|
|
|
11
|
-
用 `canvas document save`
|
|
11
|
+
用 `canvas document save` 保存不可变版本,保存返回的 `assetId`/`versionId` 即成为当前选定版本。只有 `unresolved=[]` 且逐镜校验通过后才能写 `approved=true`;随后用 `canvas document get <nodeId>` 回读,确认 `selectedVersionId` 与本次返回的 `versionId` 一致;未选定或已漂移到其他版本的连续性计划不能进入视频提示词编译。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
计划确定使用 `previous-tail` 时,媒体阶段按 `previous-tail` 承接上一镜尾帧。上一镜视频换版后必须重新派生尾帧,不能继续使用旧文件或旧 SHA-256。
|
|
14
14
|
|
|
15
15
|
`storyboard.shot_group` 是导演叙事分组,必须完整、连续且保持同组 type/pattern 一致;它可以包含反打、蒙太奇或其他切机位镜头,因此不能直接等同于尾帧链。执行阶段把每段连续的 `previous-tail` 链派生为一个生成镜头组:不同生成组可以并行,同组只开放一个前沿镜头。前镜候选未审核时状态为 `waiting-review`;前镜已审核选版但首帧尚未派生时为 `waiting-tail`;只有尾帧版本、来源版本和 SHA-256 全部匹配后,下一镜才可进入 `ready`。
|