@aswless_854771076/ai_short_studio_cli 0.1.149 → 0.1.151

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aswless_854771076/ai_short_studio_cli",
3
- "version": "0.1.149",
3
+ "version": "0.1.151",
4
4
  "description": "VVICAT 无限画布项目命令行工具",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -56,7 +56,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
56
56
 
57
57
  1. **预检与恢复**:运行 `preflight --json`;更新后重跑。再读取 `config get`、目标项目、`canvas documents` 和 `canvas workflow status`。只有历史项目需要新增媒体节点时才读取实时 `canvas node types`。`skill status --target codex` 非 current 时先询问再更新,禁止强制覆盖用户修改。
58
58
  2. **项目语言门禁**:新建项目前必须从用户确认交付语言,并用 `project create --language <BCP47>` 写入;界面 `--locale` 不能代替内容语言。创建后回读 `project get` 与 `canvas settings get`,确认两者语言一致且不可修改。项目语言约束剧本、分镜、台词、配音、画面文字和字幕;验收须区分剧情内容与制作信息:项目语言允许正常外语穿插和规范英文摄影术语,不按字符种类判死;道具文字和剧情内界面遵循来源原文。存在实际语言合同冲突时停止并说明。
59
- 3. **项目配置门禁**:读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`,以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`、`musicModel`;`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
59
+ 3. **项目配置门禁**:项目初始化时必须向用户展示并确认创作配置,不得只采用账户默认值:交付语言、画幅、目标时长、画风、分镜板策略、分析/文本模型、图片模型及其厂商、视频模型及其厂商、视频提示词协议、音频/配乐模型及其厂商、分辨率、画质、候选数量、参考素材和预计请求范围。先读取 `canvas settings get`,展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options;确认 `imageResolution`、`imageQuality` 和 `videoResolution` 后再用 `--file settings.json` 原子写入并携带 `expectedVersion`,回读一致前不得创建或运行付费节点。`$ART_STYLE_ID` 必须解析实时 `option.value`。节点确需不同参数时才按实时能力覆盖,并记录覆盖原因;`automation_mode` 只能省略已确认且未变化的重复询问,不能替用户确认模型/厂商或付费范围。
60
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
61
  5. **资产门禁**:先完成人物、场景、道具及其派生版本。每批生成完成后必须用 `canvas asset download` 或等效预览能力取得真实候选,并在当前对话中展示候选缩略图/文件链接、资产 key、版本和用途;用户确认后才能写入 selected version。只在用户看过候选且确认后选版。执行资产—剧情匹配审计;缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
62
62
  6. **拆镜和滚动生成**:先执行 [拆镜模式与交付范围](references/assets-and-storyboard.md#拆镜模式与交付范围) 和 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁)。短剧新建默认专业拆镜,显式设置 `sourceFormat` 与 `storyboardPipelineVersion: 2`,不自动新增首帧节点。Agent 先读取每镜 `storyboard_strategy`,按制作目标选择单幅分镜图、时间故事版、镜头分镜板、专项板或 Blender;已选择一种板型时不得自动补生成另一种。只审核实际生成的板型,并让视频提示词只引用真实存在且已审核的分镜资产。用户的停止阶段优先于 [滚动异步调度](references/async-pipeline.md):仅分镜图任务完成实际选择的板型并通过审核后停止,不运行视频提示词和视频。允许视频时,已就绪镜头滚动提交,单镜失败不阻塞其他镜头。
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## 初始化和配置
6
6
 
7
- 1. `preflight --json` 检查地址、CLI 版本、认证和标准能力;`restartRequired` 为真时重跑。仅缺可确定的账户 `capabilityDefaults` 时,从实时 options、目标项目有效值或模型默认值补齐并回读;模型不可用或候选缺失时停下询问。
7
+ 1. `preflight --json` 检查地址、CLI 版本、认证和标准能力;`restartRequired` 为真时重跑。项目初始化先向用户确认交付语言、画幅、目标时长、画风、分镜策略、各模态模型及厂商、提示词协议、分辨率、画质、候选数量和请求范围;不得把账户默认模型或厂商静默当成用户选择。仅在用户已确认且未发生变化时,缺少可确定的账户 `capabilityDefaults` 才能从实时 options、目标项目有效值或模型默认值补齐并回读;模型不可用或候选缺失时停下询问。
8
8
  2. `config get` 只管理个人默认模型、能力默认值和工作流并发。供应商、密钥和全局模型目录由管理员维护。
9
9
  3. 新项目按“确认名称/用途与交付语言 → `project create --language <BCP47>` → `project get` + 一次 `canvas inspect`”执行;既有项目先聚合读取。项目配置回读通过前不得创建创作节点。
10
10
  4. `canvas settings get` 必须确认项目覆盖值、继承后的有效值、来源和实时候选。默认推荐 `storyboardImageType: grid`;`visualBible` 按实时 schema 构造。音频配音与音乐生成使用独立槽位:`audioModel` 只服务 TTS,`musicModel` 只服务 `music-generate`;不要用 TTS 模型填充音乐槽位。项目 `outputLanguage` 必须与创建时用户确认的交付语言一致;它在创建后不可修改,画布设置只读返回,不能使用 `null` 或清空。CLI `--locale` 只影响命令界面和输出消息,不代表内容语言。
@@ -3,7 +3,7 @@
3
3
  首次使用先读取 `use-short-drama-studio`。恢复项目先读取 `.short-drama/RESUME.md`,再运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/validate-project.mjs" <项目目录>` 和 `workflow.mjs status <项目目录>`;状态不存在时,经用户确认目录后调用 `manage-drama-projects` 初始化。初始化及 startup/resume 会自动打开当前项目 Dashboard;先核对 `.short-drama/dashboard.json`,只有凭证缺失、路由不匹配或系统开窗被拦截时,才显式运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/studio.mjs" open-project <项目目录>`,不得因为项目不在默认工作区而跳过 Dashboard,也不得在自动打开成功后重复开窗。随后立即运行当前阶段的 `module-runs.mjs required`,按返回顺序执行,不用临时文件枚举代替门禁。进入媒体或剪辑阶段前分别运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/preflight.mjs" <media|editing> <项目目录>`。推进前运行 `workflow.mjs check`;`advance` 也会强制检查当前阶段的 selected 文档、未决项、资产、任务、逐镜验收或审片记录。按 [本地状态机](../pipeline.md) 依次执行分析、剧本、导演本、资产分析、资产生成、制作规划、素材视频与配音、剪辑和交付。
4
4
 
5
5
 
6
- 读取 `project.json` 的 `automation_mode`:为 `true`(默认)时由 agent 自行决定常规确认项并继续流程;异步媒体任务单次等待超时或状态无变化时,必须继续调用对应批量等待工具直到终态,不得把工具超时当作任务结束或再次询问用户。为 `false` 时逐项等待用户确认。无论模式如何,阶段门禁、权限/素材权利事实和安全校验都不可绕过。
6
+ 读取 `project.json` 的 `automation_mode`:为 `true`(默认)时,只能省略已经确认且未变化的重复询问,不能替用户确认创作配置、模型/厂商、付费请求范围、候选资产或剧情变更;异步媒体任务单次等待超时或状态无变化时,必须继续调用对应批量等待工具直到终态,不得把工具超时当作任务结束或再次询问用户。为 `false` 时逐项等待用户确认。无论模式如何,阶段门禁、权限/素材权利事实和安全校验都不可绕过。
7
7
 
8
8
  每个阶段开始前,先运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/module-runs.mjs" required <项目目录> <阶段>`,逐个完整读取返回 Skill 的 `SKILL.md` 并按其合同产出;不能只参考总入口或自行模仿产物。每个 Skill 完成后运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/module-runs.mjs" record <项目目录> <阶段> <skill> <项目内证据路径...>`;同一阶段已有各 Skill 证据、只是配置或提示词变更导致凭证失效时,可运行 `module-runs.mjs record-stage <项目目录> <阶段>` 一次重算证据哈希和提示词绑定。`workflow.mjs <check|advance>` 会同时检查产物和 Skill 执行凭证;缺少任一项都不得推进。
9
9
 
@@ -6,10 +6,10 @@
6
6
 
7
7
 
8
8
 
9
- 项目 `automation_mode` 默认开启;开启后 agent 自主处理常规确认,不重复打断用户,但不能伪造权限、素材权利或绕过安全门禁。
9
+ 项目 `automation_mode` 默认开启;开启后只跳过已确认且未变化的常规重复询问,不能替用户确认创作配置、模型/厂商、付费请求范围、候选资产或剧情变更,也不能伪造权限、素材权利或绕过安全门禁。
10
10
 
11
11
  标准顺序是:初始化与环境预检 → 打开项目 Dashboard → Codex 分析小说与要求 → `short-drama` 方法论 + 剧本初稿 → `humanizer` 自然化新版本 → 剧本复核批准 → 导演本落盘 → 资产分析 → 人物吸引力/儿童保护审核与资产生成落盘 → 制作规划(每镜板型选择、可选白模、模型和提示词协议)→ 按镜头选择的板型生成/选版/审计,复杂镜头追加白模编导/生成/评分 → 空间连续性与可选尾帧承接 → Seedance 2.0/H3/通用逐镜提示词落盘 → 原生声音生成和复听 → 仅对失败区间兜底、按需口型 → 授权配乐与媒体修复 → 对已选视频按需超分并复审 → `remotion-best-practices` + Remotion 剪辑 → 成片交付。每阶段必须先用 `module-runs.mjs required` 获取原子 Skill,完整读取并执行,再用 `module-runs.mjs record` 记录项目内产物;仅生成文件但没有 Skill 凭证不能通过阶段门禁。
12
12
 
13
- 文本资产全部由 Codex 直接创作和校验,不调用任何文本生成 Provider;媒体生成统一交给 `drama-generation-service`,由用户选择 StarRouter 模型和参数。需要公网 URL 时,另行路由 `publish-drama-references`;TempFile.org 链接公开、临时且受用途条款约束。项目 `automation_mode=true` 时,已配置范围内的生成、上传、选版、覆盖、回退和切换按合同自动继续,不为常规步骤重复询问;`false` 时才逐项等待确认。真实付费、素材权利、安全事实和删除项目仍需明确确认,不能由 agent 代替授权;缺少这些条件时一次说明缺口并停在安全边界。阶段交付前再次运行项目校验。
13
+ 文本资产全部由 Codex 直接创作和校验,不调用任何文本生成 Provider;媒体生成统一交给 `drama-generation-service`,由用户选择 StarRouter 模型和参数。需要公网 URL 时,另行路由 `publish-drama-references`;TempFile.org 链接公开、临时且受用途条款约束。项目 `automation_mode=true` 时,已确认且未变化范围内的生成、上传、选版、覆盖、回退和切换按合同自动继续,不为重复步骤询问;新增模型、厂商、付费请求、候选资产或剧情变更仍须明确确认;`false` 时逐项等待确认。真实付费、素材权利、安全事实和删除项目仍需明确确认,不能由 agent 代替授权;缺少这些条件时一次说明缺口并停在安全边界。阶段交付前再次运行项目校验。
14
14
 
15
15
  生成型媒体优先由 Studio 打开的同一项目通过 Hypit Source、Run 与 Runtime 执行,任务是否暴露插件 MCP 工具不影响原生 Provider 可用性。仅插件专属且尚无 Hypit Model 的能力依赖 MCP;未暴露时停止该能力,不得绕过 Runtime 直接加载厂商脚本,也不得降级为占位素材或声称已生成。
@@ -124,7 +124,7 @@
124
124
  }
125
125
  ```
126
126
 
127
- `automation_mode` 控制项目后续操作的确认策略,默认值为 `true`。开启后,Codex/agent 可自行判断并提交项目内的选版、批量请求范围和重试确认,不再为每一步询问用户;仍须展示制作计划且不计算具体价格,并满足阶段门禁、权限/素材权利事实和安全校验。缺少这些依据时必须停下。设置为 `false` 时恢复逐项确认。
127
+ `automation_mode` 控制项目后续操作的确认策略,默认值为 `true`。开启后,Codex/agent 只能在用户已确认且内容未变化的范围内自动继续选版、批量请求和重试;不得替用户确认创作配置、模型/厂商、付费请求范围、候选资产或剧情变更。仍须展示制作计划且不计算具体价格,并满足阶段门禁、权限/素材权利事实和安全校验。缺少这些依据时必须停下。设置为 `false` 时恢复逐项确认。
128
128
 
129
129
 
130
130
  未确认的可选值写 `null`,不删除字段,也不使用示例值代替用户决策。例外是新项目画风默认使用 `system-realistic` 完整预设,分镜默认使用 `shot-board`(分镜板)和 4 格;用户可在资产生成前修改。制作计划仍须逐镜在 `single`(单图)、`storyboard`(故事版)和 `shot-board`(分镜板)之间判断,项目默认值只作回退。项目 key 创建后不可变。
@@ -98,7 +98,7 @@ Agent 只有在用户明确要求“参考市场/排行榜找灵感”时才执
98
98
 
99
99
  ## 通用门禁
100
100
 
101
- 项目配置 `automation_mode` 默认为 `true`。开启时由 agent 自主完成下表中的常规确认;关闭时才等待用户逐项确认。阶段门禁、权限/素材权利事实和安全校验始终有效。
101
+ 项目配置 `automation_mode` 默认为 `true`。开启时 agent 只自动处理已经确认且未变化的常规重复步骤;创作配置、模型/厂商、付费请求范围、候选资产和剧情变更仍须用户确认。关闭时逐项确认。阶段门禁、权限/素材权利事实和安全校验始终有效。
102
102
 
103
103
  - 覆盖、删除、重命名、阶段回退、批量生成、付费重试、切换 Provider/模型/工作流、上传参考素材和最终选版都必须产生确认记录。
104
104
  - 多集项目仍按全局阶段推进;分集级 Skill 必须为每个已建 `ep-NNN` 同时登记独立产物,Codex 合同运行记录必须逐一绑定对应分集证据,不能用某一集替其他集背书。