@aswless_854771076/ai_short_studio_cli 0.1.150 → 0.1.152
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 +2 -2
- package/dist/commands/preflight.js +1 -1
- package/package.json +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/SKILL.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/orchestrate-short-drama.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/operations/use-short-drama-studio.md +2 -2
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/project-spec-v1.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md +1 -1
- package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/usage-guide.md +1 -1
package/README.md
CHANGED
|
@@ -21,7 +21,7 @@ CLI 默认使用 MemHub 浏览器授权。已有 Supabase 登录档案仍可用
|
|
|
21
21
|
|
|
22
22
|
CLI 将长期凭据保存到系统钥匙串。短期 access token 会写入权限为 `0600` 的本机 session 缓存;同一 profile 的并发进程通过跨进程锁共享刷新结果。退出登录会清除该缓存,CI 可用 `VVICAT_ACCESS_TOKEN` 直接注入临时令牌。未配置服务地址时默认连接 `https://ai-short-studio.vvicat.dev`,`--base-url`、`VVICAT_BASE_URL` 和当前 profile 可依次覆盖。服务地址和非敏感 profile 写入系统配置目录;切换环境时必须使用独立的 `--profile`,避免复用旧认证。
|
|
23
23
|
|
|
24
|
-
创作前运行 `ai-short-studio preflight --json`。CLI 会通过公开的 `/api/v1/bootstrap` 检查服务连通性、取得 Supabase 公共配置、读取 npm `latest`
|
|
24
|
+
创作前运行 `ai-short-studio preflight --json`。CLI 会通过公开的 `/api/v1/bootstrap` 检查服务连通性、取得 Supabase 公共配置、读取 npm `latest` 稳定版本并自动更新全局 CLI;更新成功后按输出重新运行。临时不更新时传 `--no-update`。随后预检检查登录态和文本、人物、场景、故事版、视频模型配置。npm registry 暂时不可用时服务端使用配置版本降级。
|
|
25
25
|
|
|
26
26
|
专业拆镜由 Agent 按镜头合同选择实际需要的板型;已有首帧与历史产物保留,额外单图、时间故事版或镜头分镜板按需添加和接线,不为满足默认规则自动补板。
|
|
27
27
|
|
|
@@ -187,7 +187,7 @@ Token 只从环境变量读取,不要放入参数、Git 或日志。
|
|
|
187
187
|
|
|
188
188
|
未显式传入 `--version` 时,发布脚本会从包清单版本开始查询 npm,并自动选择第一个未占用的 patch 版本;例如 `0.1.1` 已存在时发布 `0.1.2`。显式传入 `--version` 时严格使用指定版本,版本已存在则幂等跳过。
|
|
189
189
|
|
|
190
|
-
Docker 自动发布使用 `.env` 中的 `NPM_PUBLISH_PACKAGE_NAME` 选择目标;当前默认个人包为 `@aswless_854771076/ai_short_studio_cli`,获得组织权限后可改为 `@vvicat/ai_short_studio_cli`。`
|
|
190
|
+
Docker 自动发布使用 `.env` 中的 `NPM_PUBLISH_PACKAGE_NAME` 选择目标;当前默认个人包为 `@aswless_854771076/ai_short_studio_cli`,获得组织权限后可改为 `@vvicat/ai_short_studio_cli`。`preflight` 会自动检查并升级已安装的全局 CLI;手动更新仍可使用:
|
|
191
191
|
|
|
192
192
|
```bash
|
|
193
193
|
npm install --global @aswless_854771076/ai_short_studio_cli@latest
|
|
@@ -8,7 +8,7 @@ export default class Preflight extends BaseCommand {
|
|
|
8
8
|
static description = '创作前检查 CLI、服务连接、认证和模型配置';
|
|
9
9
|
static flags = {
|
|
10
10
|
...BaseCommand.baseFlags,
|
|
11
|
-
update: Flags.boolean({ description: '
|
|
11
|
+
update: Flags.boolean({ description: '发现新版本时自动更新全局 CLI(使用 --no-update 禁用)', default: true, allowNo: true }),
|
|
12
12
|
};
|
|
13
13
|
async run() {
|
|
14
14
|
const { flags } = await this.parse(Preflight);
|
package/package.json
CHANGED
|
@@ -5,7 +5,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
|
|
|
5
5
|
|
|
6
6
|
# 使用 VVICAT AI Short Studio CLI
|
|
7
7
|
|
|
8
|
-
所有画布制作都先遵循 [Agent 恢复链路](references/agent-recovery.md)。节点失败或审核待办不是结束整个任务的条件:读取具体诊断,修正输入或产物,保存并复查,仅继续受影响步骤。平台不自动看图审核质量;Agent
|
|
8
|
+
所有画布制作都先遵循 [Agent 恢复链路](references/agent-recovery.md)。节点失败或审核待办不是结束整个任务的条件:读取具体诊断,修正输入或产物,保存并复查,仅继续受影响步骤。平台不自动看图审核质量;Agent 须观察真实媒体并如实提交记录。不要把缺少审核记录当成检测出图片缺陷。已授权范围内自主修复,不因同一操作重复索取确认;单镜问题不阻塞无依赖的其他镜头。每次创作前先运行 `ai-short-studio preflight --json`;预检默认检查并自动更新全局 CLI,更新后按输出重新运行。只有离线或明确需要保留当前版本时才使用 `--no-update`。更新失败必须报告原因并停止依赖新版本的流程,不得静默继续。
|
|
9
9
|
|
|
10
10
|
## 按需读取
|
|
11
11
|
|
|
@@ -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
|
|
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`
|
|
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`
|
|
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
|
|
127
|
+
`automation_mode` 控制项目后续操作的确认策略,默认值为 `true`。开启后,Codex/agent 只能在用户已确认且内容未变化的范围内自动继续选版、批量请求和重试;不得替用户确认创作配置、模型/厂商、付费请求范围、候选资产或剧情变更。仍须展示制作计划且不计算具体价格,并满足阶段门禁、权限/素材权利事实和安全校验。缺少这些依据时必须停下。设置为 `false` 时恢复逐项确认。
|
|
128
128
|
|
|
129
129
|
|
|
130
130
|
未确认的可选值写 `null`,不删除字段,也不使用示例值代替用户决策。例外是新项目画风默认使用 `system-realistic` 完整预设,分镜默认使用 `shot-board`(分镜板)和 4 格;用户可在资产生成前修改。制作计划仍须逐镜在 `single`(单图)、`storyboard`(故事版)和 `shot-board`(分镜板)之间判断,项目默认值只作回退。项目 key 创建后不可变。
|
package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/review/review-drama-shots.md
CHANGED
|
@@ -26,7 +26,7 @@ visual 必须 passed;无声音或字幕时使用 not-applicable,不得伪造
|
|
|
26
26
|
|
|
27
27
|
H3 原生音频镜头在候选选版后整集批量审计:先跑 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/native-audio-audit.mjs" audit-episode <项目> <ep-001>` 取待审计清单(自动跳过无 speech_timeline、未选版和已按当前 sha256 审计过的镜头),向用户展示 ASR 模型、镜头数和请求次数,不计算具体价格;确认后加 `--confirmed` 顺序执行。单镜重生成后用 `audit <项目> <ep-001> <镜号> <视频资产 key> <候选版本> --confirmed` 单审。默认使用 StarRouter `whisper-1`(可用 `STARROUTER_ASR_MODEL` 显式切换)核对 speech_timeline 的对白文本、说话人和时间偏差;接口未返回时间戳或说话人时不能自动通过,命令对未通过项返回非零退出码。再人工核对统一 music_anchor 和相邻 transition_pair;任一对白错位、音乐断层或声音桥不成对都记为 audio/transition 缺陷,不用后配音静默掩盖。
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
审片采用分层取证,不对整段视频逐帧人工检查:先用媒体 QC 检查解码、黑帧、冻结、静音、时长和响度;再完整观看和听完每镜,在首/中/尾及自动检测出的异常区间记录实际观察;仅对关键动作入点、接触点、完成点、镜尾和转场前帧/切点/淡化中点/完成帧逐帧复核。六个维度仍须分别填写,不能用计划或提示词代替画面证据。`action-cut` 接缝还要核对地点、主体姿态、运动方向和道具状态;任一突变记为 P1。
|
|
30
30
|
|
|
31
31
|
视觉复核还要逐项检查:非有意空镜是否把开头浪费在主体到场;物理交互中手、道具和目标是否都发生了计划中的状态变化,邻接物是否错误跟随;多人镜人数、左右顺序、朝向和肢体归属是否稳定;人物离画后的边、最后姿态、运动方向和持物状态是否延续到重新入画,是否无依据从错误一侧返回;步行是否有落脚、重心转移、方向与同行相对位置;跨镜动作或打斗是否在切点重置姿势和速度;缺少可信运动参考时,打斗是否用招式名称冒充编排而没有可读的身体位置、蓄力、接触点、受力结果和反应;焦点是否锁在叙事对象上,是否出现无动机拉焦或自动对焦漂移。任何一项影响剧情因果、人物身份或动作完成态都记为 P1。
|
|
32
32
|
|
|
@@ -98,7 +98,7 @@ Agent 只有在用户明确要求“参考市场/排行榜找灵感”时才执
|
|
|
98
98
|
|
|
99
99
|
## 通用门禁
|
|
100
100
|
|
|
101
|
-
项目配置 `automation_mode` 默认为 `true
|
|
101
|
+
项目配置 `automation_mode` 默认为 `true`。开启时 agent 只自动处理已经确认且未变化的常规重复步骤;创作配置、模型/厂商、付费请求范围、候选资产和剧情变更仍须用户确认。关闭时逐项确认。阶段门禁、权限/素材权利事实和安全校验始终有效。
|
|
102
102
|
|
|
103
103
|
- 覆盖、删除、重命名、阶段回退、批量生成、付费重试、切换 Provider/模型/工作流、上传参考素材和最终选版都必须产生确认记录。
|
|
104
104
|
- 多集项目仍按全局阶段推进;分集级 Skill 必须为每个已建 `ep-NNN` 同时登记独立产物,Codex 合同运行记录必须逐一绑定对应分集证据,不能用某一集替其他集背书。
|