使用 Codex 和 AI Short Studio 创作

AI Short Studio 可以通过 CLI 接入 Codex。你只需描述想制作的内容，Codex 会调用 Skill 和 CLI，协助完成项目配置、素材生成、分镜与视频制作。

Codex Skill 名称：using-vvicat-ai-short-studio-cli

CLI 会一键安装 using-vvicat-ai-short-studio-cli、short-drama 和 humanizer。剧本先用 short-drama 创作和复核，再用 humanizer 审计、去除 AI 味，最后回到 short-drama 检查剧情连贯性；操作 VVICAT 使用主 CLI Skill。安装、状态和更新默认覆盖三者，也可用 --skill short-drama 或 --skill humanizer 单独管理；用户修改过的 Skill 会独立跳过，不影响其他 Skill。

在 Codex 中发起创作时，请明确写出这个名称。

三者如何配合

组件	作用
Codex	理解创作要求、安排步骤并向你确认关键选择
`using-vvicat-ai-short-studio-cli`	告诉 Codex 正确的操作流程和安全边界
`short-drama`	创作、复核微短剧剧本及剧情连贯性
`humanizer`	审计并改写模板化台词、虚浮修辞和机械节奏，不改变剧情事实
`ai-short-studio` CLI	连接 AI Short Studio，操作项目、画布、任务和素材

1. 安装 CLI

需要 Node.js 22 或更高版本。


npm install --global @aswless_854771076/ai_short_studio_cli@latest
ai-short-studio --version

连接服务并完成环境检查：


ai-short-studio preflight \
  --profile vvicat \
  --base-url https://ai-short-studio.vvicat.dev/ \
  --json

以后使用同一个 --profile vvicat 即可，不需要重复填写服务地址。

2. 登录

推荐使用 Google 登录：


ai-short-studio auth login --google --profile vvicat --json
ai-short-studio preflight --profile vvicat --json

命令会打开浏览器。登录完成后，CLI 会把会话安全地保存到系统钥匙串。

3. 安装或更新 Codex Skill

先检查本机状态：


ai-short-studio skill status --target codex --json
ai-short-studio skill update --target codex --skill short-drama --json
ai-short-studio skill update --target codex --skill humanizer --json

尚未安装：运行 ai-short-studio skill install --target codex --json。
已安装但不是最新版：运行 ai-short-studio skill update --target codex --json。
返回 current: true：无需处理。

自定义全部内置 Skills 的父目录时使用 --root <path>。旧版 --directory <path> 仅为兼容保留，它仍把主 CLI Skill 精确安装到该目录，不代表 Skills 父目录。

安装后的 Skill 名称是：


using-vvicat-ai-short-studio-cli

如果 Codex 已经打开，建议新建一个任务，让它重新加载 Skill。

4. 检查创作配置


ai-short-studio preflight --profile vvicat --json

看到 ready: true 就可以开始。若返回 missing，先按提示在 AI Short Studio 中补齐模型供应商和默认模型，再重新检查。

API Key 只应配置在平台账号设置或安全输入中，不要粘贴到 Codex 对话、命令参数或仓库文件。

5. 在 Codex 中开始创作

复制下面这段话，并把方括号中的内容替换成你的需求：


使用 using-vvicat-ai-short-studio-cli，在 vvicat 环境创建一个 AI Short Studio 项目。
我要制作[内容主题]，用于[发布平台]，画幅为[9:16 / 16:9]，时长约[秒数]，风格是[风格描述]。
请先检查登录、模型和项目配置，向我确认后再执行生成任务。

也可以直接提供小说、剧本、参考图或已有项目名称。信息不足时，Codex 会集中询问，不会直接替你决定。

创作过程中会发生什么

Codex 检查 CLI、登录状态、模型配置和已有项目。
你确认项目名称、画幅、风格、模型、素材范围和费用范围。
Codex 创建或读取项目，生成角色、场景和道具素材。
你确认素材后，Codex 继续生成分镜图。
你确认分镜图和镜头范围后，Codex 再生成视频。

生成任务可能产生模型费用。Codex 会在付费任务、模型修改、覆盖画布或删除项目之前请求确认。

常见问题

Codex 找不到 Skill

重新执行 skill status。如果刚完成安装或更新，请在 Codex 中新建任务后再试。

preflight 显示未登录

确认登录和检查命令使用的是同一个 profile：--profile vvicat。

preflight 返回 `ready: false`

查看返回结果中的 missing，补齐供应商和默认模型后再次运行 preflight。