@aswless_854771076/ai_short_studio_cli 0.1.98 → 0.1.100

package/scripts/postinstall.mjs

@@ -1,4 +1,4 @@
-import { resolve } from 'node:path'
+import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const packageRoot = fileURLToPath(new URL('../', import.meta.url))
@@ -8,19 +8,24 @@ export function shouldAutoInstallSkill(environment = process.env) {
   return !environment.INIT_CWD || resolve(environment.INIT_CWD) !== resolve(packageRoot)
 }
 
-export async function main(environment = process.env, loadManager = () => import('../dist/skill/skill-manager.js')) {
+export async function main(environment = process.env) {
   if (!shouldAutoInstallSkill(environment)) return
   try {
-    const { autoInstallSkill, autoInstallSkills, defaultSkillsRoot } = await loadManager()
+    const { BUNDLED_SKILL_NAMES, autoInstallSkill, autoInstallSkills, defaultSkillsRoot, installSkills } = await import('../dist/skill/skill-manager.js')
     const result = environment.VVICAT_SKILL_DIRECTORY
-      ? { skills: [await autoInstallSkill(environment.VVICAT_SKILL_DIRECTORY)] }
+      ? {
+          skills: [
+            await autoInstallSkill(environment.VVICAT_SKILL_DIRECTORY),
+            ...(await installSkills({
+              root: dirname(environment.VVICAT_SKILL_DIRECTORY),
+              skills: BUNDLED_SKILL_NAMES.slice(1),
+            })).skills,
+          ],
+        }
       : await autoInstallSkills(environment.VVICAT_SKILLS_ROOT || defaultSkillsRoot('codex'))
     for (const skill of result.skills) {
       process.stdout.write(`VVICAT Skill ${skill.name} ${skill.action}: ${skill.target}\n`)
     }
-    for (const legacy of result.legacySkills || result.skills[0]?.legacySkills || []) {
-      if (legacy.requiresAttention) process.stderr.write(`旧 Skill ${legacy.name} 已保留，Codex 仍可能识别：${legacy.target}\n`)
-    }
   } catch (error) {
     process.stderr.write(`VVICAT CLI 已安装，Skill 自动安装已跳过：${error instanceof Error ? error.message : String(error)}\n`)
   }

package/skills/using-vvicat-ai-short-studio-cli/SKILL.md

@@ -1,35 +1,75 @@
 ---
 name: using-vvicat-ai-short-studio-cli
-description: 使用 VVICAT CLI 和原生无限画布创作短剧或逐镜复刻参考片，管理资产选版、审片、付费门禁和交付。
+description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI, including assets, storyboard-to-video rolling generation, task recovery, editing, captions, audio balancing, and final delivery.
 ---
 
-# VVICAT CLI 创作入口
+# 使用 VVICAT AI Short Studio CLI
 
-画布节点、边、资源选版和任务回执是唯一项目状态。每轮先运行 `ai-short-studio preflight --json` 与 `canvas inspect --project <id> --json`，按实时 `canvas node types` 取得节点参数；不得另建 `.drama-state.json`。已有剧本直接复用。未知的权利、创作目标、画幅、语言、模型或付费范围只做只读检查，向用户合并询问必要问题。
+## 按需读取
 
-## 路由与参考索引
+`SKILL.md` 只保留路由和主流程。按实际进度逐阶段读取命中的资料；长任务可以先后读取多份，但不要在开始时一次加载全部：
 
-| 触发 | 读取 | 输入 → 产物 → 下一步 |
+- 项目创建、settings、批处理、目录或安全边界：[references/project-and-canvas.md](references/project-and-canvas.md)
+- 人物/场景/道具、拆镜、分镜图和生成前审计：[references/assets-and-storyboard.md](references/assets-and-storyboard.md)
+- MiniMax H3 视频、原生音频、遮挡转场、单镜与成片验收：[references/h3-video-delivery.md](references/h3-video-delivery.md)
+- 资产、分镜图、视频提示词和视频的滚动异步调度：[references/async-pipeline.md](references/async-pipeline.md)
+- 字幕、镜头衔接、声音平衡、时间线、渲染与剪辑验收：[references/editing-delivery.md](references/editing-delivery.md)
+- 专业剧本、TTS 独立音频、Remotion 等专项流程：[references/special-workflows.md](references/special-workflows.md)
+- 精确参数和命令示例：[references/commands.md](references/commands.md) 或 `ai-short-studio <topic> --help`
+- 参考视频复刻、去字幕和深度预处理：[references/hypit/playbooks/formats/reference-recreation-canvas.md](references/hypit/playbooks/formats/reference-recreation-canvas.md)
+- 已知错误、恢复边界和历史兼容问题：[references/troubleshooting.md](references/troubleshooting.md)
+
+## 场景路由：先判断再读取
+
+不要把整个 `references/` 当成一次性上下文。根据用户目标命中下表后，只读取对应入口和它继续链接的合同；如果一个任务跨阶段，按顺序追加读取，不跳过前置门禁。
+
+| 用户目标或画布节点 | 必须先读取 | 下一步与停止条件 |
 | --- | --- | --- |
-| 原创或改编短剧 | [drama-canvas.md](references/drama-canvas.md)、[story-craft/guide.md](references/story-craft/guide.md) | 来源/简报 → 剧本与导演本选版 → 资产与分镜 |
-| 题材、开场、节奏、钩子、反派、付费卡点、审校 | [story-craft/index.md](references/story-craft/index.md) | 目标集与故事事实 → 创作/审校依据 → 剧本选版 |
-| 润色剧本或台词 | [writing-polish.md](references/writing-polish.md) | 已选剧本 → 新资源版本 → 重跑审校 |
-| 参考片复刻 | [recreation.md](references/recreation.md) | 授权来源 → 连续切镜/资产/处理/逐镜审片 → 时间线 |
-| 原片理解、目标简报、对白读法与语义切点 | [reference-analysis-and-timing.md](references/reference-analysis-and-timing.md) | 来源与授权 → 保留/替换关系及语义事件 → 剧本/镜头 |
-| 逐镜资产和分镜 | [assets-and-storyboard.md](references/assets-and-storyboard.md)、[shot-production.md](references/shot-production.md) | 剧本/镜头清单 → 已选资产和逐镜合同 → 视频提示词 |
-| 镜头、人物、打斗、预演、声音、字幕等专业导演问题 | [craft-index.md](references/craft-index.md) | 当前镜头问题 → 对应专业参考 → 可审画布版本 |
-| H3 提示词与视频 | [h3-video-delivery.md](references/h3-video-delivery.md)、[h3-prompts.md](references/h3-prompts.md) | 已选资产/参考 → 模型适配提示词 → 逐镜生成 |
-| 异步付费生成或失败恢复 | [async-pipeline.md](references/async-pipeline.md)、[paid-plan.md](references/paid-plan.md) | 画布/模型/价格 → 只读执行计划与任务回执 → 审片 |
-| 字幕、配音、音轨、剪辑交付 | [editing-delivery.md](references/editing-delivery.md)、[sound-and-captions.md](references/sound-and-captions.md)；本地 Remotion 工程再读 [remotion-editing.md](references/remotion-editing.md) | 已审镜头 → 时间线/字幕/音频/清单 → 完整观片 |
-| 媒体导入、抽帧、派生、版权音乐和审片证据 | [media-provenance-and-review.md](references/media-provenance-and-review.md)；外部曲目再读 [licensed-music.md](references/licensed-music.md) | 原件及 selected 版本 → 可追溯候选与权利凭证 → 审片/时间线 |
-| Meme、独立配音等专项任务 | [special-workflows.md](references/special-workflows.md) | 已确认任务类型 → 专用画布链路 → 对应审片 |
-| CLI 命令、项目设置、异常 | [commands.md](references/commands.md)、[project-and-canvas.md](references/project-and-canvas.md)、[troubleshooting.md](references/troubleshooting.md) | 实时 CLI 输出 → 精确操作或恢复 |
-
-## 控制循环
-
-1. 读取当前画布和所选版本，只推进当前阶段。按参考合同补齐节点和连线；`canvas apply` 带 `expectedVersion`，409 后重读。
-2. 付费前按 [paid-plan.md](references/paid-plan.md) 核对模型、参数、请求数、管理员发布价格和用户确认；无价格或结果未知时停止。禁止对结果未知任务自动重试。
-3. 节点完成后回读任务、画布、输入指纹和产物预览；只把已选且审过的版本送入下游。上游换版使受影响的审校、逐镜绑定和成片结论失效。
-4. P0/P1 清零、人工授权、剧本审校、逐镜画面与完整音轨审片、成片从头到尾验收均为门禁；成功任务本身不等于创作合格。
-
-视频、字幕、声音和时间线始终使用 VVICAT 画布产物。第三方方法仅作随包参考；来源和许可见 [sources.md](references/sources.md)。
+| 原创短剧、小说改编、来源材料、市场灵感 | `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`，不写剧本 |
+| 故事设定、人物弧线、分集规划 | `references/short-drama/creation/design-drama-bible.md`、`references/short-drama/creation/outline-drama-series.md` | 先确认 Brief，再运行 `drama-bible → drama-outline`；未确认集数、时长或结局不得自动补齐 |
+| 单集剧本、来源片段转剧本、剧本润色 | `references/short-drama/creation/write-drama-episode.md`、`references/short-drama/review/review-drama-script.md`、`references/short-drama/creation/humanizer.md` | 改编先保留原文事实和对白，再做人味优化；必须回到 `drama-script-review`，P0/P1 未清零不得进入导演阶段 |
+| 人物、场景、道具和资产版本 | `references/short-drama/assets/` 下对应资产文档、`references/short-drama/assets/plan-drama-assets.md` | 运行资产分析后再生成；缺证据、错版、stale 或身份歧义时标记 blocked，不用相似资产替代 |
+| 导演手册、摄影、表演、分镜和镜头变体 | `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 → storyboard-image/storyboard-board-image`；读取构图受控词表，证据不足时降级构图，不补陈设或天气 |
+| 逐镜制作、跨镜连续性、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 |
+| 视频提示词、H3、Seedance、原生音频 | `references/short-drama/generation/write-drama-video-prompts.md`、`references/h3-video-delivery.md`、`references/short-drama/generation/design-drama-audio.md` | 按实时 Provider schema 选择协议；每镜完成画面、声音、字幕和转场审计后才提交生成 |
+| 去字幕、参考视频复刻、深度视频 | `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`；不得把参考板或字幕带入成片 |
+| 参考对白转写、剪辑、字幕和多图模板 | `references/hypit/SKILL.md`、`references/hypit/environment/local-tools.md`、`references/short-drama/editing-workflow.md` | WAV 音频使用 `recreation-transcribe`（StarRouter `qwen3-asr-flash`）；剪辑和字幕进入现有编辑器/Remotion 时间线；多图合板使用 `grid` 或分镜宫格节点 |
+| 逐镜审计、剪辑、字幕、声音平衡、成片交付 | `references/short-drama/review/review-drama-shots.md`、`references/short-drama/editing/edit-drama-timeline.md`、`references/short-drama/editing/edit-deliver-drama.md` | `drama-shot-review → drama-edit-plan → drama-delivery-review`；未通过的镜头、无 provenance 或未完整观看不得交付 |
+
+网站无限画布上的短剧节点按同一顺序连接：
+
+`drama-source-analysis → drama-brief → drama-bible → drama-outline → drama-episode → drama-script-review → drama-director-book → drama-asset-analysis → storyboard-breakdown → drama-production-plan → drama-continuity-plan → drama-audio-plan → drama-shot-review → drama-edit-plan → drama-delivery-review`
+
+人物、场景、道具生成节点接在 `drama-asset-analysis` 后；视频提示词、分镜图和视频节点必须消费连续性计划及逐镜审计结果。仅有参考资料而没有对应画布节点或阶段证据时，不得声称该阶段已完成。
+
+## 核心原则
+
+生产环境认证优先使用 MemHub；CLI 通过浏览器 PKCE 登录或个人 API Key 访问，只有本地明确关闭 MemHub 时才使用 Supabase 兼容登录。
+
+把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时，合并询问最少必要问题；得到答复前只做只读检查。不得用示例值替用户作创作决定。
+
+优先使用一次 `canvas inspect` 聚合查询。同阶段可合并的 settings、节点和连线分别使用 `canvas settings set --file`、`canvas apply`、`canvas node update-many`。生成链使用单个调度循环滚动提交，不用 `--wait` 把整批阶段串行化：节点一完成就刷新画布并立即提交它已就绪的下游节点。默认每类并发 4、总并发上限 16；同一节点同一输入指纹只允许一个在途任务，不并发启动多个相互竞争的调度器。409 重读并确认，401/403、schema、业务门禁和付费错误必须停下修正。
+
+## 主流程
+
+1. **预检**：运行 `preflight --json`；更新后重跑。再读取 `config get`、实时 `canvas node types` 和目标项目。`skill status --target codex` 非 current 时先询问再更新，禁止强制覆盖用户修改。
+2. **项目配置门禁**：读取 `canvas settings get`，展示 `currentValue`、`effectiveValue`、`source`、建议值和实时 options。确认 `aspectRatio`、`artStyle`、`visualBible`、`storyboardImageType`、`outputLanguage`、`analysisModel`、`imageModel`、`imageResolution`、`imageQuality` 和 `videoResolution`，以及 `editModel`、`videoModel`、`videoPromptType`、`audioModel`；`$ART_STYLE_ID` 必须解析实时 `option.value`。标准创作门禁使用 `--file settings.json` 原子写入并携带 `expectedVersion`，回读一致前不得创建或运行付费节点。节点确需不同参数时才按实时能力覆盖。
+3. **剧本和目标集**：已有专业剧本时直接复用，不得重复执行 `novel-to-script`。需要创作微短剧时，按需读取 `references/short-drama/`，再读取 `references/humanizer/` 去除 AI 味；不得改动已经确认的剧情事实，润色后回到短剧 reference 复核。确认目标集数后，只生产该集实际需要的资产。
+4. **资产门禁**：先完成人物、场景、道具及其派生版本，展示真实预览并确认 selected version。执行资产—剧情匹配审计；缺失、多余、错版、stale、错边未清零时拆镜前门禁失败。
+5. **拆镜和滚动生成**：拆镜前按 [语言匹配门禁](references/assets-and-storyboard.md#拆镜语言匹配门禁) 核对源剧本语言、交付语言、项目 `outputLanguage` 和节点 `targetLanguage`，不一致时禁止执行。把该集剧本与全部确认资产连接到 `storyboard-breakdown`，复用服务端自动创建的 `storyboard-shot` / `storyboard-image`。完成后逐镜执行语言与镜头质量审计且不抽样；P0/P1 未清零不得继续。分镜图生成前按实时 schema 确认画幅、布局、格数和费用。进入付费生成后读取 [滚动异步调度](references/async-pipeline.md)：分镜图完成一镜即审计并提交该镜视频提示词，提示词完成即审计、显式写入视频配置并提交该镜视频；不得等待同阶段全部镜头完成。单镜可恢复失败只标记并重试该镜，不阻塞其他已就绪镜头。
+6. **视频规划**：视频生成前依次完成素材连线、镜头逻辑和上下镜连续性审计。读取实时 `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。
+7. **H3 生成门禁**：`videoModel` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时，同次设置 `videoPromptType: "h3"`。仅有效的节点 `promptType` 可覆盖项目值；旧 `seedance` 覆盖必须清除并回读，否则不得执行视频提示词或视频生成。编写或改写 H3 提示词时读取 `references/hypit/playbooks/craft/h3-prompt-writing.md`；进入生成前必须读取 [H3 成片规则](references/h3-video-delivery.md)。
+8. **逐镜后验**：每个视频镜头完成后实际看画面、听完整音轨，并完成视觉、音频、转场、字幕四项验收。任一 P0/P1 失败只修复并重跑受影响镜头；未通过不得进入成片剪辑。
+9. **成片和交付**：剪辑只使用通过验收的 selected 版本，并完整执行 [剪辑与交付](references/editing-delivery.md)。默认对白/旁白字幕进入成片，人物与场景介绍仅在首次出现时显示短暂角标，同时输出独立 SRT/ASS。根据叙事动机选择硬切、动作切、J/L-cut、遮挡匹配或短淡化，不给所有镜头机械套淡入淡出。完成节奏裁切、声音平衡、画面统一、字幕和必要技术处理后，从头到尾观看成片并执行完整成片验收；未通过不得声称完成。原始视频按 `selectedOutputVersionId` 下载，字幕独立保存，`manifest` 记录镜号、节点、任务、资产、版本、时间线和文件名。
+
+## 强制分流
+
+- H3 成片中的人物说话、旁白、环境音和 BGM 全部由 H3 原生生成；不得用 `voice-design`、`voice-clone`、`tts` 或其他外部 TTS 覆盖。独立音频交付才读取专项 TTS 流程。
+- 涉及剪辑、字幕、转场、音频编排或渲染时，读取 `references/hypit/` 中对应的制作规则。
+- 编辑镜头用 `canvas node edit-shot`，编辑结构化资源用 `canvas node edit-resource`，均追加不可变版本。`outputLanguage` 变化只标记下游 stale；手工首尾帧使用 `video-frame-extract`。
+
+## 安全与完成条件
+
+不把密码、Token 或 API Key 写入参数、日志、Skill 或仓库。删除项目、覆盖画布、切换模型、重新付费生成或覆盖用户选版前，必须明确目标和影响并取得授权。临时项目在所有结束路径清理；既有项目不得擅自删除。
+
+任务成功只代表服务端完成，不代表创作合格。每批产物都要回读任务、画布、连线、资产和最终配置并查看真实预览；只有阶段门禁、逐镜四项验收和最终成片验收全部通过，才可交付。

package/skills/using-vvicat-ai-short-studio-cli/references/commands/canvas.md

@@ -15,17 +15,18 @@ ai-short-studio canvas node types --json
 ```bash
 ai-short-studio canvas node list --project <projectId> --json
 ai-short-studio canvas node get <nodeId> --project <projectId> --json
-ai-short-studio canvas node quote <nodeId> --project <projectId> --json
 ai-short-studio canvas node add <kind> --project <projectId> --config node.json --json
+ai-short-studio canvas node add audio --project <projectId> --asset-id <assetId> --json
 ai-short-studio canvas node update <nodeId> --project <projectId> --set 'gridSize=9' --json
 ai-short-studio canvas node update-many --project <projectId> --file updates.json --json
 ai-short-studio canvas node edit-shot <nodeId> --project <projectId> --file shot.json --json
 ai-short-studio canvas node edit-resource <nodeId> --project <projectId> --file resource.json --json
-ai-short-studio canvas node edit-resource <screenplayResourceNodeId> --project <projectId> --markdown-file episode.md --json
 ai-short-studio canvas node delete <nodeId> --project <projectId> --yes --json
 ```
 
-`update` 只改普通 config、标题和坐标；资源 artifact 必须用 `edit-shot` / `edit-resource` 追加版本。`--markdown-file` 只用于 `drama-episode` 生成的剧本资源；其他资源继续传 JSON。身份字段不可修改，409 后重新读取当前选版。
+`update` 只改普通 config、标题和坐标；结构化 artifact 必须用 `edit-shot` / `edit-resource` 追加版本。身份字段不可修改，409 后重新读取当前选版。
+
+`--asset-id` 仅用于 `image`、`video`、`audio` 媒体节点，把已有资产的 selected 版本绑定为节点输出；CLI 会先按实时节点目录拒绝非媒体节点，资产类型仍由服务端校验。上传资产后先用 `canvas asset list` 或上传响应取得资产 ID，再创建媒体节点并连线。
 
 H3 批量启用原生音频的 `updates.json`：
 

package/skills/using-vvicat-ai-short-studio-cli/references/commands/project.md

@@ -8,12 +8,11 @@ ai-short-studio skill status --target codex --json
 ai-short-studio auth signup --email user@example.com --password-stdin
 ai-short-studio auth login --google
 ai-short-studio auth login --email user@example.com --password-stdin
-ai-short-studio auth login --provider memhub
 ai-short-studio auth status --json
 ai-short-studio auth logout
 ```
 
-更新 CLI 后重跑 preflight。邮箱密码只从隐藏输入或安全 stdin 读取；`confirmationRequired: true` 时先完成邮件确认。MemHub 登录会打开系统浏览器并使用 loopback + PKCE，不能同时传 `--email`、`--google` 或 `--password-stdin`。
+更新 CLI 后重跑 preflight。邮箱密码只从隐藏输入或安全 stdin 读取；`confirmationRequired: true` 时先完成邮件确认。
 
 ## 项目与供应商
 
@@ -23,12 +22,8 @@ ai-short-studio project get <projectId> --json
 ai-short-studio project create --name <name> [--description <text>] --json
 ai-short-studio project update <projectId> [--name <name>] [--description <text>] --json
 ai-short-studio project delete <projectId> --yes --json
-ai-short-studio project provider get <projectId> --json
-ai-short-studio project provider set <projectId> --json
-ai-short-studio project provider test <projectId> --json
 ```
 
-`provider set` 的 Key 只从安全 stdin 或秘密管理器提供。删除既有项目必须取得明确授权。
 
 ## Settings
 
@@ -63,23 +58,4 @@ ai-short-studio config get --json
 ai-short-studio config set --file config.json --json
 ```
 
-`config set` 只接受个人默认模型和能力默认值；供应商、密钥、全局模型目录与工作流并发只能由管理员维护。
-
-## 管理员 AI Provider
-
-仅管理员账号可用。Agent 在排查"我能不能用这个 provider / 还缺什么配置"时，先跑 `config ai-provider capabilities`，再决定后续命令。
-
-```bash
-ai-short-studio config ai-provider list --json
-ai-short-studio config ai-provider get --id <providerId> --json
-ai-short-studio config ai-provider set --id <providerId> [--base-url <url>] [--api-key-stdin] [--enabled true|false] [--preset <name>] [--json]
-ai-short-studio config ai-provider test --id <providerId> --json
-ai-short-studio config ai-provider models --id <providerId> --json
-ai-short-studio config ai-provider capabilities --json
-```
-
-- `--api-key-stdin` 从隐藏 stdin 读取；CI 用 `VVICAT_AI_PROVIDER_<ID>_API_KEY` 注入。
-- `--preset <name>` 触发服务端 Preset（如 `openai-compatible`、`runninghub`、`comfly`）一键种子。
-- `test` 不消耗 token，只报告 HTTP/延迟；`models` 仅在 `enabled` 且最近 `test` 成功时返回。
-- `capabilities` 报告当前生效的私有/LAN baseUrl 白名单（环境变量 `VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS`，CSV `host:port`）、已注册 Provider、缺失项与诊断。
-- 私有/LAN baseUrl（如本地 ComfyUI `http://127.0.0.1:8188`、`http://192.168.3.30:8188`）需要在 Next.js 运行环境里设置 `VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS` 显式打开；公网 URL 仍强制 HTTPS 与公网 IP。
+`config set` 只接受个人默认模型、能力默认值和并发；供应商、密钥与全局模型目录只能由管理员维护。

package/skills/using-vvicat-ai-short-studio-cli/references/commands.md

@@ -16,6 +16,6 @@
 
 最终 `videoModel.effectiveValue` 为 `comfly::minimax-h3` 或 `runninghub::minimax-h3-reference-to-video` 时，必须写入 `videoPromptType: "h3"`；仅有效的节点 `promptType` 可覆盖项目值，旧 `seedance` 必须清除并回读，否则不得执行视频提示词或视频生成。实时能力 `generateAudioOptions` 必须包含 `true`，H3 节点显式设置并回读 `generateAudio: true`。
 
-视频时长读取实时 `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。
+视频时长读取实时 `durationOptions`。只有实时选项恰为 5、10、15 秒时才按这三档向上取整。RunningHub MiniMax H3 支持纯文本，5–15 秒逐秒可选，1–4 秒归一为 5 秒；画幅为 16:9 / 9:16，分辨率为 480p / 720p / 1K / 2K。
 
-结构化资源使用 `canvas node edit-resource`，镜头使用 `canvas node edit-shot`。Meme 使用 `meme-scene-analysis → meme-material-search → cat-meme-video`，禁止静默切换通用视频；`CAT_MEME_REQUIRED_PROP_MISSING` 返回素材检索修复。
+结构化资源使用 `canvas node edit-resource`，镜头使用 `canvas node edit-shot`。

package/skills/using-vvicat-ai-short-studio-cli/references/editing-delivery.md

@@ -1,6 +1,6 @@
 # 剪辑与交付流程
 
-涉及本地 Remotion 工程时，先读随包的 [Remotion 剪辑实现参考](remotion-editing.md)。H3 人声、旁白、环境音与 BGM 仍以每镜原生整轨为唯一来源；允许轻量修整，不允许外部 TTS、配音或音乐覆盖原生失败。
+涉及时间线、字幕、转场、音频处理或渲染时，先加载 `remotion-best-practices`，并按实际需要读取其中 captions、markup 和 rendering 参考。H3 人声、旁白、环境音与 BGM 仍以每镜原生整轨为唯一来源；允许轻量修整，不允许外部 TTS、配音或音乐覆盖原生失败。
 
 ## 1. 入库与选镜
 

package/skills/using-vvicat-ai-short-studio-cli/references/h3-video-delivery.md

@@ -60,7 +60,7 @@
 
 ## 5. 完整成片验收
 
-只使用逐镜四项验收通过的 selected 版本。涉及 Remotion 时先读随包的 [Remotion 剪辑实现参考](remotion-editing.md)，保留每镜 H3 原生音轨，以遮挡点轻微重叠拼接；不要另铺外部旁白、对白、环境音或 BGM 覆盖原生轨。
+只使用逐镜四项验收通过的 selected 版本。涉及 Remotion 时先加载 `remotion-best-practices`，保留每镜 H3 原生音轨，以遮挡点轻微重叠拼接；不要另铺外部旁白、对白、环境音或 BGM 覆盖原生轨。
 
 渲染后必须从头到尾完整观看并听完，再检查：
 

package/skills/using-vvicat-ai-short-studio-cli/references/humanizer/humanizer.md

@@ -0,0 +1,9 @@
+# 自然化短剧剧本
+
+读取已选剧本、brief、bible、outline、source-analysis，以及用户明确提供的语言样本。只处理表达与可表演性，不新增事实，不改人物身份、关系、关键动作、场次顺序、伏笔兑现、时长目标或已确认台词含义。忠实改编不得用“更自然”为理由改写原作事实。
+
+逐场检查并修正：角色都说同一种话、台词解释动机、连续完整句缺少打断与潜台词、旁白重复画面、舞台说明像散文、机械三段式、泛滥的转折词和总结句、口号式金句、同义反复、刻意悬念、过量标题与括号。让每个角色的词汇、句长、回避方式和情绪泄露符合人物档案；保留必要停顿、沉默、抢话和未说完的话，但不为“人味”堆口头禅。
+
+输出完整剧本新版本，不输出修改建议代替成稿。用 `project-store.mjs put-script` 写入下一个不可变版本并 `select-script`，禁止覆盖原稿；随后必须执行 `review-drama-script`。用户语言样本只作为风格参考，不能复制其中的个人信息或无关事实。
+
+本 Skill 是插件内的短剧专用 Humanizer，吸收通用 Humanizer 的反模板化原则，但不套用百科写作规则，也不依赖外部 Skill。