@aswless_854771076/ai_short_studio_cli 0.1.147 → 0.1.149
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
CHANGED
|
@@ -11,11 +11,11 @@ ai-short-studio project list --json
|
|
|
11
11
|
ai-short-studio canvas node types --json
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
-
npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill
|
|
14
|
+
npm 包只内置一个 `using-vvicat-ai-short-studio-cli` Agent Skill。短剧和 humanizer 等参考资料统一放在该 Skill 的 `references/` 下。安装或升级 CLI 时,`postinstall` 会自动安装或更新这个 Skill;用户修改过或不由 CLI 管理的副本不会被覆盖。设置 `VVICAT_SKIP_SKILL_INSTALL=1` 可关闭自动安装。
|
|
15
15
|
|
|
16
16
|
短剧采用专业拆镜,Agent 按每镜制作目标选择单幅分镜图、时间故事版、镜头分镜板或专项板;不会自动补生成未选择的板型。用户要求只完成分镜图时不执行视频提示词或视频。`canvas node edit-shot` 会同步镜头字段别名并拒绝改写来源原文;修改时长后检查响应的 `durationOverrides`,保留的下游手工时长需要逐项确认。
|
|
17
17
|
|
|
18
|
-
`skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer
|
|
18
|
+
`skill install/status/update` 管理这个唯一 Skill。短剧创作、humanizer 审计和自由画布视频制作资料通过主 Skill 的 references 按需读取。
|
|
19
19
|
|
|
20
20
|
CLI 默认使用 MemHub 浏览器授权。已有 Supabase 登录档案仍可用于兼容旧环境,但公开帮助只展示 MemHub 登录方式。
|
|
21
21
|
|
|
@@ -35,7 +35,7 @@ CLI 将长期凭据保存到系统钥匙串。短期 access token 会写入权
|
|
|
35
35
|
- `ai-short-studio canvas edge`:连线读写。
|
|
36
36
|
- `ai-short-studio canvas continuity analyze`:视频生成前分析镜头依赖,可修复已具备源视频的首尾帧连线。
|
|
37
37
|
- `ai-short-studio canvas asset`:资产列表、上传、版本选择和下载。
|
|
38
|
-
- `ai-short-studio canvas documents`:一次读取当前分集的
|
|
38
|
+
- `ai-short-studio canvas documents`:一次读取当前分集的 自由画布文档、选版和阻塞原因;`canvas document get|save|status` 读取、保存或检查单个文档。
|
|
39
39
|
- `ai-short-studio canvas workflow status`:读取当前阶段、基础模块门禁和下一步缺失项。
|
|
40
40
|
- `ai-short-studio canvas asset review-context|review`:读取当前媒体摘要和必需维度,提交实际逐项审核并追加独立审核文档;不自动生成通过结论。
|
|
41
41
|
- `ai-short-studio canvas folder`:画布资产目录管理(5 预设 + 用户子目录 + 软删 + 跨项目复制)。
|
|
@@ -127,7 +127,7 @@ CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置
|
|
|
127
127
|
|
|
128
128
|
`storyboard-breakdown` 还可按实时 schema 写入 `targetDurationSeconds`、`pacingPreset` 和 `maxShotCount`。结构化剧本会先生成固定镜号、顺序和来源的确定性骨架;其中 `maxShotCount` 是硬预算,无法完整覆盖来源时会在模型调用前明确失败。纯文本旧链路仍按软提醒处理镜头数,`targetDurationSeconds` 始终是柔性时长目标。留空时不限制镜头数,也不启用时长硬门禁。生成链采用滚动异步调度:单镜分镜图完成后立即进入视频提示词,提示词通过审计后立即提交该镜视频,可恢复失败不阻塞其他镜头。内置 Skill 同时补全字幕、人物/场景首次介绍角标、有动机的镜头衔接、声音平衡和成片验收流程。
|
|
129
129
|
|
|
130
|
-
标准短剧制作读取主 Skill `references/short-drama/` 与 `references/humanizer
|
|
130
|
+
标准短剧制作读取主 Skill `references/short-drama/` 与 `references/humanizer/`:先生成和复核专业剧本,再审计模板化台词、虚浮修辞与机械节奏,最后检查剧情连贯性。自由画布视频制作流程读取随包参考目录。Humanizer 只润色表达,不改剧情事实、人物关系、专有名词、数字、时间线、世界观规则、场次结构或拍摄标记。剧本确认后再选择目标集数、创建或复用项目,并只建立目标集实际出现的人物、场景、道具和可选音色设定。拆镜前必须完成资产—剧情匹配审计;拆镜后逐镜全量检查重复、无效、缺失、冲突、穿帮、连续性、道具交互朝向、语言和来源身份。P0/P1 未清零时不得进入图片、声音或视频生产。
|
|
131
131
|
|
|
132
132
|
`character-visual-design` schema 暴露 `candidateCount`,范围为 1~3,默认值为 1。CLI 按实时 schema 校验和写入;多个视觉描述仍分别进入独立三视图和图片资产链。
|
|
133
133
|
|
|
@@ -215,10 +215,10 @@ npm run release:ci:test -- --version 0.1.1-beta.0
|
|
|
215
215
|
|
|
216
216
|
### Agent 恢复 / Agent recovery
|
|
217
217
|
|
|
218
|
-
新项目先运行 `canvas documents` 和 `canvas workflow status`,由 Agent 在无限画布创建
|
|
218
|
+
新项目先运行 `canvas documents` 和 `canvas workflow status`,由 Agent 在无限画布创建 自由画布 JSON 文档;用 `canvas document save` 追加版本,用 `canvas document status` 检查上游选版。`canvas node diagnose <nodeId>` 仅用于历史媒体节点的恢复,不是新流程入口。完整操作见随包 Skill 的 自由画布文档流程。
|
|
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` 节点保存剧本、导演本和制作计划等自由画布文档(底层 schema key 保持兼容);每次保存都通过 `--input` 固化上游版本,审核使用独立 `hypit.review.v1` 文档。历史 `screenplay-resource` 和 `storyboard-draft` 只用于迁移旧项目,不得用于新项目。
|
|
223
223
|
|
|
224
|
-
Agents author
|
|
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.
|
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.
|
|
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 commands are read-only compatibility paths for existing projects.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 使用 VVICAT AI Short Studio CLI
|
|
@@ -29,12 +29,11 @@ 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` |
|
|
33
|
-
|
|
|
32
|
+
| 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/short-drama/creation/humanizer.md` | 已有专业剧本时先复用并审核,不得重复执行 `novel-to-script`;改编先保留原文事实和对白,再做人味优化;必须回到 `drama-script-review`,P0/P1 未清零不得进入导演阶段 |
|
|
33
|
+
| 人物、场景、道具和资产版本 | `references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成;每批候选下载或读取真实预览并展示给用户,用户确认后才选版;缺证据、错版、stale 或身份歧义时标记 blocked,不用相似资产替代 |
|
|
34
34
|
| 导演手册、摄影、表演、分镜和镜头变体 | `references/short-drama/creation/write-drama-director-book.md`、`references/short-drama/storyboard/build-drama-storyboard.md`、`references/short-drama/director-composition.md` | `drama-director-book → storyboard-breakdown → selected storyboard image type`;由 Agent 按镜头目标选择单图、时间故事版、镜头分镜板或专项板,读取构图受控词表,证据不足时降级构图,不补陈设或天气 |
|
|
35
35
|
| 逐镜制作、跨镜连续性、previous-tail | `references/short-drama/storyboard/plan-drama-production.md`、`references/short-drama/storyboard/plan-shot-continuity.md` | 先生成 `drama-production-plan`,再生成 `drama-continuity-plan`;只有前镜已审核且选版时允许 previous-tail |
|
|
36
|
-
|
|
|
37
|
-
| 视频提示词、H3、Seedance、原生音频 | `references/video-prompt-spec.md`、`references/video-model-routing.md`、`references/short-drama/generation/write-drama-video-prompts.md`、`references/h3-video-delivery.md` | 先编译平台中立镜头事实,再按实时 Provider schema 选择协议并审计后提交视频 |
|
|
36
|
+
| 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/short-drama/generation/seedance-community-skills.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 默认由 Agent 生成并保存 自由画布文档;按实时 Provider schema 选择协议并审计后提交视频 |
|
|
38
37
|
| 背景音乐、主题曲、纯音乐 | `references/short-drama/generation/design-drama-audio.md`、`references/short-drama/starrouter-provider.md` | 使用画布 `music-generate` 和实时音频模型目录;有自定义歌词时不得同时开启纯音乐;生成后试听并回读 AUDIO 资产版本 |
|
|
39
38
|
| 去字幕、参考视频复刻、深度视频 | `references/hypit/playbooks/formats/reference-recreation-canvas.md`、`references/short-drama/generation/transform-drama-media.md` | 使用 `recreation-subtitle-remove → recreation-depth-preprocess/depth-video → video-generate`;不得把参考板或字幕带入成片 |
|
|
40
39
|
| 参考对白转写、剪辑、字幕和多图模板 | `references/hypit/SKILL.md`、`references/hypit/environment/local-tools.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`(默认 StarRouter `whisper-1`);剪辑和字幕进入现有编辑器/Remotion 时间线;多图合板使用 `grid` 或分镜宫格节点 |
|
|
@@ -42,9 +41,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
42
41
|
|
|
43
42
|
自由画布短剧制作不要求预先搭建固定功能节点:Agent 先用 `canvas documents` 恢复分集,再按 `module-map.json` 选择模块;结果保存为 `hypit.<module>.v1` 版本并以 `--input` 记录来源,文档选版和审核证据作为阶段依据。
|
|
44
43
|
|
|
45
|
-
新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource`
|
|
44
|
+
新项目禁止搭建上述固定功能节点链。每个阶段都必须由 Agent 在无限画布创建或更新 `text-resource` 自由画布文档,并通过 `canvas document save` 追加不可变版本;媒体节点只消费已审核的 自由画布文档和选定媒体版本。
|
|
46
45
|
|
|
47
|
-
旧版固定节点命令仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与
|
|
46
|
+
旧版固定节点命令仍保留用于读取和恢复历史项目,但不得作为新项目入口,也不得与 自由画布文档并行写入同一阶段。发现旧节点链时先用 `canvas documents` 和 `canvas workflow status` 建立 自由画布文档快照,再迁移受影响阶段;迁移完成后停止继续创建旧节点。
|
|
48
47
|
## 核心原则
|
|
49
48
|
|
|
50
49
|
生产环境认证优先使用 MemHub;CLI 通过浏览器 PKCE 登录或个人 API Key 访问,只有本地明确关闭 MemHub 时才使用 Supabase 兼容登录。
|
|
@@ -57,9 +56,9 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
57
56
|
|
|
58
57
|
1. **预检与恢复**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`。只有历史项目需要新增媒体节点时才读取实时 `canvas node types`。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
|
|
59
58
|
2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
|
|
60
|
-
3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value
|
|
61
|
-
4.
|
|
62
|
-
5.
|
|
59
|
+
3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
|
|
60
|
+
4. **自由画布文档和目标集**:先读取 `canvas workflow status`,按当前阶段和条件模块生成 JSON;使用 `canvas document save` 写入 `hypit.<module>.v1`,用 `--input` 固化上游选版。审核必须另存为 `hypit.review.v1` 并绑定被审核版本。无需先调用固定节点或生成模型,不要创建没有版本的文档空壳。已有自由画布文档直接复用;历史 `screenplay-resource` 或结构化资源先迁移成 自由画布文档,再继续流程。需要创作微短剧时,按需读取 `references/short-drama/`,再读取 `references/humanizer/` 去除 AI 味;不得改动已经确认的剧情事实,润色后回到短剧 reference 复核。确认目标集数后,只生产该集实际需要的资产。
|
|
61
|
+
5. **资产门禁**:先完成人物、场景、道具及其派生版本。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
|
|
63
62
|
6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
|
|
64
63
|
7. **视频规划**:视频生成前依次完成素材连线、镜头逻辑和上下镜连续性审计。读取实时 `durationOptions`;只有选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本和 0–9 张参考图、0–2 个参考视频、0–2 个参考音频,5–15 秒逐秒可选,1–4 秒归一为 5 秒;参考视频只传画面。画幅为 16:9 / 9:16,分辨率为 480p / 720p / 1K / 2K。
|
|
65
64
|
8. **H3 生成门禁**:`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时,同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值;旧 `seedance` 覆盖必须清除并回读,否则不得执行视频生成或写入提示词。Agent 编写 H3 提示词时读取 `references/hypit/playbooks/craft/h3-prompt-writing.md`;进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
|
|
@@ -77,4 +76,4 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
77
76
|
|
|
78
77
|
不把密码、Token 或 API Key 写入参数、日志、Skill 或仓库。删除项目、覆盖画布、切换模型、重新付费生成或覆盖用户选版须在用户已授权的目标和范围内;只有超出既有授权才补充确认。临时项目在所有结束路径清理;既有项目不得擅自删除。
|
|
79
78
|
|
|
80
|
-
任务成功只代表服务端完成,不代表创作合格。每批产物都要回读任务、画布、连线、资产和最终配置并查看真实预览;只有阶段门禁、逐镜四项验收和最终成片验收全部通过,才可交付。
|
|
79
|
+
任务成功只代表服务端完成,不代表创作合格。每批产物都要回读任务、画布、连线、资产和最终配置并查看真实预览;只有阶段门禁、逐镜四项验收和最终成片验收全部通过,才可交付。
|
|
@@ -93,7 +93,7 @@
|
|
|
93
93
|
|
|
94
94
|
## 分镜图后验
|
|
95
95
|
|
|
96
|
-
|
|
96
|
+
每批完成后回读任务、节点、连线、资产和最终配置;先用 `canvas asset download` 或等效预览能力取得每个候选的真实图片,再在当前对话中展示候选缩略图/文件链接、资产 key、版本、用途和审核状态。用户看过并确认候选后才能写入 selected version,不能只在 Agent 内部查看后静默选版。随后实际查看所有图片,检查身份、肢体、道具、构图、画幅、裁切、文字、连续性和空结果。缺陷需再次付费生成或改选版本时,遵循已有授权;超出用户已确认的生成数量或修改范围才补充确认。
|
|
97
97
|
|
|
98
98
|
已选板型的 `storyboard_strategy.frame_plan` 必须登记 `beats:[{id,sourceUnitIds,description}]`,来源并集恰好等于本镜 `sourceUnitIds`;`temporal_cells` 与 `shot_cells` 各为 `frame_count` 个 `{beat_id,visible_change}`,各自覆盖全部节拍且不重复填格。时间格按节拍顺序,空间格表达几何证据,不能复制同一计划。`overflow_strategy` 固定 `return-to-breakdown`;容量不足退回拆镜,不截断、不借邻镜来源。旧策略可读,重新生成/审核前须补计划;`STORYBOARD_BOARD_FRAME_PLAN_*` 指出计划缺陷。专业镜头按下文“读取—预览—保存—复查”通过 `canvas node revise-storyboard` 保存策略补丁,改格数时同步已选择板型的计划及节点配置。结构校验不证明语义或像素符合预期。
|
|
99
99
|
|
|
@@ -10,7 +10,7 @@ ai-short-studio canvas node types --json
|
|
|
10
10
|
|
|
11
11
|
常见审计优先通过 `inspect` 的 `--kind`、`--status`、`--search`、`--operation`、`--resource-type`、`--producer-node` 过滤。同阶段多个图变更用一次 `apply`;409 后重读并合并。
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## 自由画布文档(新项目唯一入口)
|
|
14
14
|
|
|
15
15
|
新项目不得通过固定功能节点编排短剧。先运行:
|
|
16
16
|
|
|
@@ -23,7 +23,7 @@ ai-short-studio canvas workflow status --project <projectId> --json
|
|
|
23
23
|
|
|
24
24
|
## 历史节点兼容
|
|
25
25
|
|
|
26
|
-
下面的节点命令仅用于读取、审计和迁移历史项目,不得作为新项目的流程入口,也不得与
|
|
26
|
+
下面的节点命令仅用于读取、审计和迁移历史项目,不得作为新项目的流程入口,也不得与 自由画布文档并行写入同一阶段。
|
|
27
27
|
|
|
28
28
|
## 节点
|
|
29
29
|
|
|
@@ -43,7 +43,7 @@ ai-short-studio canvas node delete <nodeId> --project <projectId> --yes --json
|
|
|
43
43
|
|
|
44
44
|
`--asset-id` 仅用于 `image`、`video`、`audio` 媒体节点,把已有资产的 selected 版本绑定为节点输出;CLI 会先按实时节点目录拒绝非媒体节点,资产类型仍由服务端校验。上传资产后先用 `canvas asset list` 或上传响应取得资产 ID,再创建媒体节点并连线。
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
自由画布 JSON 产物保存到 `text-resource` 节点;每次保存追加版本,`--input` 记录上游节点当前资产选版。续写前先读状态,`ready: false` 时根据 `staleInputs` 重做受影响产物,不能沿用旧审核。
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
49
|
ai-short-studio canvas document get <scriptNodeId> --project <projectId> --json
|