@aswless_854771076/ai_short_studio_cli 0.1.96 → 0.1.98

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

@@ -0,0 +1,19 @@
+# 原生画布短剧流程
+
+先运行 `preflight`、`canvas inspect`、`canvas settings get` 和实时 `canvas node types`。画布及 selected 版本是唯一项目状态。原创或改编只推进用户确定的集数；已有专业剧本直接复用，不重复执行 `novel-to-script`。编剧方法见 [story-craft/guide.md](story-craft/guide.md)。
+
+| 阶段 | 画布输入与产物 | 完成门禁 |
+| --- | --- | --- |
+| 1 来源分析 | `text`/已授权来源 → `drama-source-analysis` | 来源事实、推断、权利和未知分开 |
+| 2 剧本 | `drama-brief` → `drama-bible` → `drama-outline` → 目标集 `drama-episode` | 集数、语言、基调和剧情因果确认；物化 `screenplay-resource.script` |
+| 3 导演本 | 剧本资源 → `drama-script-review` → `drama-director-book` | P0/P1 清零并人工确认 `approvedReviewVersionId`；导演本写表演、调度、轴线和连续性 |
+| 4 资产分析 | 目标集剧本/导演本 → 人物、场景、道具和必要声音需求 | 资产与剧情逐项匹配，空类明确，错名、漏项、错版清零 |
+| 5 资产生成 | 已确认需求 → 形象、场景、道具版本 | 实际预览与 selected 版本确认；付费前读 [paid-plan.md](paid-plan.md) |
+| 6 制作计划 | 所选剧本/资产 → `storyboard-breakdown`、逐镜分镜和连续性计划 | 每镜覆盖、轴线、视线、动作、道具、语言、参考版本和费用全量核对 |
+| 7 媒体制作 | 逐镜提示词、图片、视频、音轨 | 一镜就绪即可滚动提交；每镜实际看画面、听完整音轨，P0/P1 清零 |
+| 8 剪辑 | 已审 selected 镜头 → 时间线、声音与字幕 | 版本顺序、衔接、阅读速度和音画同步核对 |
+| 9 交付 | 时间线 → 成片、SRT/ASS、manifest | 从头到尾观看成片，manifest 记录镜号、节点、任务和版本 |
+
+`drama-episode` 生成的同一个 `screenplay-resource.script` 必须同时连接 `drama-script-review.source`、`drama-director-book.source` 和 `storyboard-breakdown.script`。审校节点还要连接来源分析、简报、故事设定和目标集大纲；已批准报告分别连到导演本和拆镜节点。润色按 [writing-polish.md](writing-polish.md) 追加剧本资源版本，然后重新审校。上游换版后重读所有受影响下游选版和门禁，不复用旧报告。
+
+复刻项目从 [recreation.md](recreation.md) 的授权、连续切镜和逐镜合同进入同一九阶段的资产、分镜、生成、剪辑和交付。原片不进入最终成片。所有节点与 handle 以实时目录为准；缺节点时先确认平台当前支持的等价原生节点，不在本地伪造画布状态。

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

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

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

@@ -0,0 +1,15 @@
+# 参考形式与叙事关系
+
+适用于短剧或参考片包含不同视频形式时。先从参考片找“谁推动叙事、注意力为何转移、揭示何时发生”，再把关系写入目标镜头表与时间线；形式名称不是项目必须填写的分类。
+
+| 参考形式 | 需要保留或改写的关系 | 画布检查点 |
+| --- | --- | --- |
+| 短剧 | 角色目标、行动、反应和场景变化推动事件 | 剧本、导演本、逐镜表演与连续性 |
+| 单人口播 | 一人直接对观众说话，画面和图形只补充关键论点 | 人物视线、音轨、必要插画或字幕 |
+| 双人对话 | 共同空间、相对机位和反应镜头让交谈成立 | 双方身份、轴线、反打与声场 |
+| 街访 | 邂逅、追问、回答与揭示构成前后变化 | 主客体视角、收声、说话人字幕 |
+| 榜单/清单 | 持续可见的比较状态随论点更新 | 名次、状态变化、图形可读时间 |
+| 主持讲解 | 表演串联实物、界面、图解与例子 | 人声主线、证据画面和图形占位 |
+| 旁白主导 | 一条稳定声音主线组织多种视觉答案 | 旁白身份、每幅画面的证据作用与声画关系 |
+
+复刻时只迁移用户确认且有权使用的结构与表现关系。原片人物、台词、商标、音乐、画面风格均按权利范围另行处理；形式混合时逐镜说明主导关系，不机械套一个模板。

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

@@ -0,0 +1,7 @@
+# H3 逐镜提示词
+
+先按实时模型能力确定模式：纯文本、首帧图、首尾帧、尾帧或完整参考。只在能力目录允许时传相应类型和数量；节点最终生效的 `promptType` 必须是 `h3`，若项目值被节点级 `seedance` 覆盖，先修正并回读再运行。提示词写主体身份、场景、动作起止、镜头位置与运动、光线、声画事件、对白说话人和原语、禁止出现的文字。多参考输入应给每份媒体明确作用及顺序，避免互相争夺身份或动作。不要把生成过的关键帧误称为原片，也不要把深度视频当成所有模型的强制输入。
+
+基础模式按时序描述可见的画面、动作和声音，再写整镜声场与非画内音乐。首帧模式从已选图的真实状态继续；首尾帧模式解释两帧之间可实现的动作路径；尾帧模式安排合乎因果的开场并收束到目标状态。完整参考模式先列每个引用标签承担的身份、空间、表演、机位或运动职责，再说明要保留与替换的关系；引用标签在整份提示词里保持一致。无论哪种模式，段落和字段格式以当前模型实际支持的协议为准，不把参考片的台词、音乐或烧录文字自动继承进新片。
+
+H3 原生音频承担人物说话、旁白、环境声与音乐；对白写在音频要求中，字幕在后期制作。对重复人物沿用同一已选声音设定，避免镜头间音色漂移。相邻镜头保留动作、声场和情绪的接续；复杂的精确手势、文字和接触动作在提示词中拆为可见事件，审片不通过则重做最小镜头。

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

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

package/skills/using-vvicat-ai-short-studio-cli/references/image-and-reference-direction.md

@@ -0,0 +1,9 @@
+# 图片与参考关系
+
+适用于人物设定、场景、道具、分镜状态图与复刻中的新视角。输入是已选剧本事实、目标镜头和有权使用的参考版本；产物是可审核的图片提示词、连线与 selected 图片版本。
+
+每张图片先决定一个首要可读信息：谁或什么最重要，它与机位、动作、空间的关系是什么。人物只写足以识别的外观锚点、当前形象状态、视线与身体朝向；场景用少量有叙事作用的物件和空间关系建立可信环境；道具写形状、位置与使用状态。画幅、分辨率和数量放在节点参数，不用空泛形容词代替可见画面。
+
+人物图若将作为视频首帧，优先给可继续的动作状态；只有镜头需要瞬时表情时才固定在惊讶或大笑的一帧。构图同时考虑下游裁切、字幕和图形留白，但不要把后期字幕或动态图形直接画进角色图。选定图片后实际查看面部、手、道具接触、空间、文字与画风，再连接下游。
+
+每个参考图写明职责：人物身份、服装状态、场景几何、道具形状或镜头构图。新视角只继承需要延续的事实；场景切换时不要无意继承旧房间陈设，人物换装时不要把旧衣服当身份。对话反打要保持人物相对位置、视线、屏幕方向和道具进入画面的侧别。多个参考按模型上限有序连接，记录引用版本与舍弃原因。参考片原帧只有权利允许且模型用途明确时才进入生成请求。

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

@@ -0,0 +1,9 @@
+# 独立音乐与音效的使用权
+
+只有项目确需外部 BGM、片头片尾曲或独立音效，且目标工作流允许外部声轨时读取。H3 原生音频合同优先遵守 [H3 成片规则](h3-video-delivery.md)，不能把外部音乐当成修复失败原生音轨的办法。
+
+先确定音乐在剧情中的作用、进入和退出点、对白密度、目标长度与平台，再选生成曲或已有曲。热门歌曲和参考片原声可以说明希望的情绪或节奏，但不能据此推定同步权、母带权或改编权。用户提供的文件也要确认项目和交付平台的使用范围。
+
+使用已有曲目时，记录曲名、作者、文件版本、来源页、取得日期、适用许可证、署名要求、允许的平台与商业用途，以及 Content ID 等可能影响发布的限制。下载当时的许可与凭证要随版本保存；换曲、换用途或换平台时重新核对。剪辑时间线绑定确切已选音频版本与该项权利记录，不能只写一个曲库名称。
+
+试听并检查曲目结构、时长、对白覆盖、音量和切点；用户确认后才能加入时间线。若许可证不覆盖目标使用，停在选曲阶段并换用有凭证的素材。来源：MIT 许可短剧模块的配乐流程，见 [许可](licenses/oh-my-short-drama-MIT.txt)。

package/skills/using-vvicat-ai-short-studio-cli/references/licenses/oh-my-short-drama-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fuyang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/using-vvicat-ai-short-studio-cli/references/media-provenance-and-review.md

@@ -0,0 +1,22 @@
+# 媒体来源、派生与审片证据
+
+用于导入原片、人物图、音轨、录屏，或对 selected 素材做抽帧、裁切、去字幕、深度、局部修复与剪辑时。输入是原文件与画布 selected 版本；产物是带来源的候选版本、审核结论和最终时间线。
+
+## 素材与用途
+
+每份媒体先标记用途：来源证据、模型参考、目标成片保留内容或后期图形。用途不能仅凭文件类型推断；参考片复刻的原片只用于分析和经授权的生成参考，不进入最终成片。其他明确要求保留原录制素材的项目，也必须先确认使用权与审片合同。
+
+导入时核对文件可解码、真实分辨率、帧率、时长、音视频流、文件大小和来源。后期派生保留源节点、所选版本、输入哈希、操作范围与参数，原件不覆盖。去字幕、深度、转码或画幅裁切产生新版本；处理成功只证明任务完成，必须看实际画面和听实际声音后才能选版。
+
+Agent 查看原片时先用本地工具读取尺寸和大小，通常制作最长边不超过 2048 像素、文件不超过 2 MB 的临时预览；细节不清楚时裁局部再看。预览仅用于分析，来源哈希、画布导入和模型参考仍使用经授权的原件。
+
+模型参考要核对其真正接受的媒体类型、数量和顺序。抽帧不自动成为身份参考；深度片不自动赋予所有视频模型深度控制。图形、字幕和模型生成图片需要的准备不同，不能为了统一格式而丢失透明度、音轨或原时间基准。
+
+## 按问题取证
+
+- 静态形象：看整张图，再检查面部、手、文字、道具和结构细节；缩略图无法证明细节通过。
+- 运动与切点：先完整播放；对动作入点、接触、结果和镜尾慢看或抽连续帧。前镜尾与后镜头必须合看。
+- 声音与字幕：完整听音轨，核对原语、说话人、口型、环境、音乐和静音意图。ASR 是辅助证据，没有逐词时间戳时不得写成字级对齐。
+- 成片：审片版可用于讨论布局；只有实际导出的文件可以证明编码、字幕、安全区、响度和完整交付效果。最终仍需从头到尾看、听。
+
+审核写具体时间点或可见事实，并绑定所审版本。无法亲自观看或使用可接收该媒体的工具时，将该维度留作待人工验收，不用任务状态、波形或首帧冒充通过。失败时记录症状与最小修正；同样修正反复无效，应回到资产、分镜或模型能力重新判断。

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

@@ -0,0 +1,7 @@
+# 付费前只读执行计划
+
+在运行任何付费节点前，从 `canvas inspect --project <项目> --include nodes --include edges --include settings --include node-types --json` 与 `canvas node get <节点> --project <项目> --json` 读取当前版本、输入连线和 selected 输入版本。逐节点运行 `canvas node quote <节点> --project <项目> --json`：该只读命令与画布执行器共用模型、参数、用量和已发布价格档位的计算路径，不创建资产、任务或积分冻结。报价返回节点与画布版本、输入版本、参数指纹、请求数、价格档位及预估积分。任一节点无可用价格时请管理员配置并重新报价；不能把 0 或猜测值当报价。
+
+计划逐行写：镜号、节点 ID、操作、模型、模型参数、输入版本与指纹、预计请求数、已发布价格及总额、用户授权状态。请求数以每镜每个远端任务计算，包含可能的去字幕、深度、转写、图片、视频和音频；不同模型分列。计划只读，不提交、不冻结积分。用户确认计划及其价格后，重新报价；节点/画布版本、输入版本、参数指纹、请求数或价格变化就重新计划和确认。报价是预估，实际费用以任务结算为准。
+
+任务提交后保留任务 ID 与远端回执。超时、无任务 ID、进程退出或费用状态不明均视为结果未知；失败节点仍可只读报价，但先查同一任务与账单，禁止自动付费重试。`--max-attempts` 对付费复刻节点保持 0。对于服务端明确失败且已核对账单的任务，记录原 task ID 和原因，再由用户确认新请求；`acknowledgedFailedTaskId` 只在服务端合同要求时设置。

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

@@ -0,0 +1,25 @@
+# 按需加载的短剧专项方法
+
+以下方法改写自 MIT 许可的短剧专业模块，用于补充画布创作判断。只有镜头实际命中条件时才使用；结果写入相应的剧本、导演本、资产、分镜或审片节点，不建立插件状态文件，也不调用原插件脚本。
+
+| 触发 | 输入 → 决策 → 画布产物 |
+| --- | --- |
+| 角色首登场或多镜反复出现 | 剧本角色与风格合同 → 选定可辨的轮廓、发型、衣装、年龄、表情范围和声线锚点；成年人物的吸引力应服务性格，儿童形象不得成人化 → 人物设定、已选图片与逐镜一致性检查 |
+| 打斗、追逐、多人接触或精确受力 | 导演本与空间图 → 逐拍列出发起、接触、反应、位移、结果和安全边界；保持轴线、屏幕方向、道具持有状态与可剪接的动作峰值 → 动作分镜、镜头合同和审片记录 |
+| 静态分镜无法证明复杂空间关系 | 镜头目标、人物/道具位置 → 制作可审的运动或白模预演，仅作为运动参考；核对路径、接触、遮挡、景别和时长后再绑定视频节点 → 经审预演资产与有序参考 |
+| 跨镜衣装、道具、视线或动作跳变 | 连续镜头及 selected 版本 → 逐对核对人物位置、道具左右手、场景时间、光线和上一镜尾部动作；对必要的尾帧承接使用真实已选视频提帧 → 连续性计划或受影响镜头重做 |
+| 用户明确要求市场立项 | 可追溯的公开样本、平台及日期 → 分开记录事实、机会、风险和创作假设，不把样本热度当成收益预测 → 项目简报与待验证的题材假设 |
+
+复杂动作预演是按风险选用的参考，不是每镜的固定门禁。市场分析也不替代用户确认的题材与权利范围。来源及许可见 [sources.md](sources.md)。
+
+## 人物与画风验收
+
+人物设定板分别检查年龄与身份、脸和轮廓、妆造衣装、跨镜记忆锚点、目标受众的可辨性，以及选定画风的媒介、材质、色彩和光线。任一身份或年龄错误、儿童保护问题、画风不符都不能用其他维度的高分抵消。场景和道具另查结构、视角间一致性及剧本没有要求的新增元素；画风名称写在提示词里不能代替实际图像观察。
+
+## 动作与预演
+
+动作设计先锁定剧本中的人物、武器、能力、胜负和结果，再把每个关键节拍写成“目的、起势、接触或落空、对手反应、受力与状态结果”。记录人物的左右位置、进入和离开方向、持物手、遮挡与观察轴。多人冲突要让每个人有同时成立的任务，不能排队等主角逐个击打；复杂超自然动作还须写清发动条件、介质和结束状态。
+
+只有静态分镜无法说明路径、接触或复杂机位时才做白模或运动预演。预演以选定剧本、导演本、分镜和资产为依据，检查因果、调度、机位、构图、轴线、物理接触和实际时长；它不替代人物美术或正式视频审片。发现冲突回到上游修订，不让预演自行改写剧情。
+
+正式镜头审核先看完整画面和音轨，再对关键动作的起点、接触、结果及跨镜接缝取证。记录可见症状、可能机制和只改一个变量的修正；连续两次修正无效时停止盲重试，回查参考绑定、模型能力或动作拆镜。若审核工具不能接收真实视频或音频，保留待人工验收状态。

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

@@ -0,0 +1,21 @@
+# 参考片逐镜复刻
+
+只在用户确认来源、下载/分析权利、允许保留和必须替换的元素后进入制作。若来源是本地文件，先用 `canvas asset upload <文件> --project <项目> --kind video` 导入，再按 [画布命令](commands/canvas.md) 的 `canvas apply` 合同建立 `video` 源节点，绑定返回的 `assetId`（`refType: GlobalCreativeAsset`），选定版本并回读；单独上传资产不会自动生成画布源节点。保存原片来源、所选版本与 SHA-256；原片只作分析依据，不作为最终片像素素材。未知权利只允许结构迁移。对近似复刻逐项确认身份、对白、声音、音乐、商标和画面风格的授权范围。
+
+## 连续切镜与逐镜资料
+
+完整观看参考片，结合候选切点人工修正成镜头表：稳定镜号、起止时间、叙事功能、画面、动作、对白、音轨、字幕、待替换内容。时间段从零到片尾连续覆盖且不重叠；每段最长 15 秒，超限按动作边界切开，不按固定秒数盲切。每镜单独连接 `recreation-shot-extract`，确认输出确实来自该时间段；重切后旧镜头的资产绑定、转写、深度结果、提示词和审片结论全部失效。
+
+逐镜核对人物、形象状态、场景、道具，给每类写明确需求，空类也显式记空；只绑定当前已选版本。对白镜头可运行 `recreation-transcribe`，`qwen3-asr-flash` 的文本只是待审转写，不含逐词时间戳。人工校对原语、说话人和时间位置，原文、译文、字幕分别管理，不从译文倒推原文。转写修改后使旧审批失效。
+
+只有原片带烧录字幕才运行 `recreation-subtitle-remove`，核对画面主体、首尾动作和残留字幕。其输出经审核后可连接 `recreation-depth-preprocess`；原镜、去字幕镜和深度镜各自保存版本，不互相覆盖。空文件、不可解码、错误镜头或时长漂移超过 5% 时拒收；恢复时间基准不能补回缺失画面。深度片只给明确支持参考视频/深度条件的最终模型使用，不能声称所有视频模型都有深度控制。
+
+## 有序参考与生成
+
+每镜记录有序绑定：已选人物/形象、场景、道具、必要的分镜状态图、该镜经审深度视频、必要音频。保持各输入版本、顺序、镜号及权利来源，按目标模型的数量和媒体类型上限裁剪；裁剪需说明遗漏的语义。原片关键帧、上一镜尾帧和未经授权的原片音视频不得悄悄进入最终请求。倒计时、设备状态、手部接触或精确姿势有风险时制作有针对性的分镜板，普通镜头无需机械增加分镜。
+
+提示词记录该镜可见事件、景别、运镜、动作方向、连续性首尾状态和对白 `说话人 [语言]: 原文`。对白仅进入音轨，字幕在后期制作；禁止生成烧录字幕、译文、标题、水印、Logo 或 UI，除非用户明确授权且画面确需文字。逐镜生成后把成片与原镜并排看完、听完整音轨，核对人物、动作、机位、时间、对白、声音、残留文字和下一镜衔接。失败只重做受影响镜头；审片通过的所选版本才可进时间线。
+
+## 付费与换版
+
+去字幕 `starrouter::comfly/1194`、深度 `starrouter::comfly/1776`、转写 `starrouter::qwen3-asr-flash` 均用现有 StarRouter 账号。执行前按 [只读计划](paid-plan.md) 核对模型可用性、参数、请求数和管理员已发布价格；无价格时请管理员配置。任何付费任务回执不明时先查原任务及账单，禁止自动重提。确认后按服务端返回的上次本地任务 ID 设置 `acknowledgedFailedTaskId` 再由用户授权重新执行。

package/skills/using-vvicat-ai-short-studio-cli/references/reference-analysis-and-timing.md

@@ -0,0 +1,19 @@
+# 简报、参考分析与语义时间
+
+原创短剧从来源事实和用户目标建立简报；复刻先确认来源、权利和“保留什么、改变什么”。输入可以是原片、剧本、小说或用户描述；产物写入画布的来源分析、简报、剧本、镜头及审片节点，不另建本地项目状态。
+
+## 把参考读成可执行关系
+
+完整观看参考片，逐段记录时间码、人物或物件的状态、推动注意力的事件、镜头与声音的交接，以及观众在何时知道了什么。把可观察事实、个人判断和待确认推断分开；原片对白转写须标明语言、说话人和待审状态。视频下载或上传前先核对来源和授权，不能把可公开访问等同于可复用。
+
+来源是网页链接时，先取得用户有权下载的原文件或经授权的本地副本，再探测并导入 VVICAT 画布；保存来源页、取得时间和文件哈希。网页截图或录屏只证明被捕获时的可见状态，不自动证明链接中的视频可用于生成参考。
+
+给每项保留关系指定目标：叙事顺序、节奏、机位运动、动作因果、表演关系或声画配合。另列必须替换的身份、造型、台词、声音、音乐、品牌和画面元素。用户只授权结构借鉴时，原片像素与原声都不得进入最终生成和成片。
+
+## 用事件驱动时间线
+
+剧本原文、实际说出的读法、屏幕显示文字分开记录。姓名、数字、外语缩写或方言可能需要发音说明；不能把字幕文字直接当作模型实际说出的台词。对白与动作按自然试读、源片观察或已生成音轨估时，给反应、呼吸、入出画和切点留余量。
+
+逐镜记录 `语义事件 → 来源时间/证据 → 目标镜头 → 目标时间 → 实际观察`。例如揭示应发生在对方回答之后；上游镜头换版或对白时长变化时，重新核对所有依赖这个事件的字幕、图形、音乐和切点。参考片时间码说明来源事实，目标时间码由新片所选版本决定，二者不能混用。
+
+原创建议依次回写 `drama-source-analysis`、`drama-brief`、剧本和导演本；复刻从 [逐镜复刻](recreation.md) 的连续镜头表进入资产和参考绑定。是否可以提交付费节点以 [只读计划](paid-plan.md) 为准。

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

@@ -0,0 +1,18 @@
+# Remotion 剪辑实现参考
+
+当交付需要本地 Remotion 工程时读取。先按 [剪辑与交付流程](editing-delivery.md) 确认入库镜头、时间线与审片门禁；这里仅约束 Remotion 实现。不存在 Remotion 工程时可以新建工程，已有工程则沿用现有依赖与目录约定。所有输入必须来自画布中已选且逐镜审过的版本。
+
+## 确定性时间线
+
+- 把镜号、版本、媒体路径、入出点、时间线位置、字幕、角标、转场和音量包络集中保存在可审阅的时间线数据中。视频、图片和音频引用已下载的本地文件，保留原件，不把任务 URL 当作交付资产。
+- Composition 的帧率、画幅和总帧数由交付规格及时间线尾点确定。把秒数换算成帧时选定一致的取整规则，并在预览与正式渲染中复用。
+- React 画面与动画只依赖当前帧和时间线数据；使用 `useCurrentFrame()`、`interpolate()`、`Sequence` 等帧确定方式。不要让 CSS transition、随机数或运行时时钟决定成片画面。
+- 视频入出点和声音桥分别核对。J/L cut 或重叠转场必须保留实际声音来源、说话者与起止点；H3 镜头仅处理其原生整轨，不另配外部声音覆盖失败。
+
+## 字幕、图形与渲染
+
+- 字幕先按真实成片音轨转写并人工复核，再换算为帧。预览中检查断句、停留时长、双人对白、画面安全区及字幕与角标冲突；SRT、ASS 与烧录版应来自同一份已审文本和时间码。
+- 人物名条、地点、手机界面或倒计时由时间线事件驱动；文字必须与已确认剧本和资产一致，不能在图形层补写未经确认的剧情事实。
+- 先渲染审片版，逐个检查切点和字幕，并完整观看、听完成片。修正后重新渲染正式版，记录工程版本、时间线版本、媒体哈希、渲染规格和输出路径。
+
+具体 Remotion API、组件属性和版本以工程中实际安装的包及其官方文档为准；本参考不规定外部模板、插件脚本或特定 Remotion 版本。来源：MIT 许可的短剧剪辑方法，见 [许可](licenses/oh-my-short-drama-MIT.txt)。

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

@@ -0,0 +1,9 @@
+# 逐镜资产与制作合同
+
+将每镜视为独立制作单位：稳定镜号、来源剧本/参考镜时间段、起止状态、镜头功能、人物及形象、场景、道具及状态、对白语言、环境音、构图、运动、转场意图、目标时长。先从全量镜头表盘点所有可见人物、场景、道具及其状态，再生成资产；不能只按台词人物建表。人物多视角、无人场景和道具状态图分别审看并选版。所有资产必须指向当前 selected 版本，连线与镜号一一核对；某类无资产时显式记空，避免被当成漏审。镜头表完整覆盖目标集剧情或参考片区间，不能因“生成成功”跳过遗漏镜头。
+
+逐镜参考按目的排序：人物身份与衣装、场景空间、道具状态、动作/姿态板、经审深度或运动参考、必要音频。每份参考只承担一个明确职责，记录节点、selected 版本、顺序和适用镜号；向模型编译时核对实时输入上限与实际支持的媒体类型。若某个参考被排除，记录原因和受影响风险。分镜板依据具体状态风险制作：原创可用时序或镜头板，复刻仅在姿态、手部接触、道具状态等高风险处补板；不机械套固定格数。核对分镜图与最终全屏画幅的区别。相邻镜检查屏幕方向、轴线、视线、接触动作、手中道具、光线、衣装和音轨延续。
+
+运行前核对资产板、必要的风险分镜、首尾状态、提示词、对白语言、原生音轨及禁用文字约束均已通过；再核对模型、实际参数、参考媒体类型及数量、价格、请求数和用户确认。任务结果未知时查询原凭证，不自动重新运行；成功但审片失败时只重做该镜。同一根因连续两次生成失败，先修正资产、绑定或提示词，不直接购买第三次候选。换版上游资产、镜头切点、剧本或导演本后，重审受影响的分镜、提示词、逐镜视频与时间线。
+
+手工首尾帧或衔接证据由 `video-frame-extract` 从已选镜头版本提取；提取帧只作为经审参考，不自动代替下一镜的身份、动作和场景合同。

package/skills/using-vvicat-ai-short-studio-cli/references/sound-and-captions.md

@@ -0,0 +1,7 @@
+# 声音、字幕与剪辑审校
+
+先听镜头原生音轨，区分对白/旁白、环境、效果声与音乐。保留源语言和说话人身份；连续角色沿用已选声音设定。需要独立配音时先确认音频交付目的、模型和费用，不能默默覆盖 H3 原生音轨。对白与音效跟随动作事件，镜头切换可用 J/L cut 保留声场连续。混音核查可懂度、突发峰值、底噪和跨镜响度，不只看波形。
+
+字幕从人工审核的对白或旁白生成，原文、译文与屏幕显示文本分开；没有逐词时间戳的 ASR 不可直接制作字级高亮。逐条核对入出点、分行、阅读速度、人物指代和画面安全区。默认交付独立 SRT/ASS；是否烧录由用户交付要求决定。对于参考片，禁止把原片烧录字幕作为新片字幕事实源。
+
+剪辑只使用逐镜审过的 selected 版本。硬切、动作切、J/L cut、遮挡转场和短淡化按叙事动机选择；不对所有镜头统一加转场。导出后从头到尾看、听成片，核对缺帧、黑帧、字幕、音画同步、过响/过轻、画幅和时间线顺序；manifest 保留镜号、节点、任务、版本、时间线和文件名。

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

@@ -0,0 +1,6 @@
+# 资料来源与许可
+
+- 短剧编剧参考由 0xsline 的 short-drama 方法资料迁入，保留 [MIT 许可](licenses/short-drama-MIT.txt)。这些题材和节奏规则是创作参考，不能代替平台和用户的要求。
+- 文风审校参考 Siqi Chen 的 Humanizer 方法，保留 [MIT 许可](licenses/humanizer-MIT.txt)。
+- 逐镜资产、参考绑定、视频提示词、声音、字幕和复刻步骤，以及 `craft-index.md` 中的图片、表演、声音、图形和形式参考，依据本机 Hypit 项目的 Craft / Format 工作方法重新整理为 VVICAT 原生画布步骤；不复制 Hypit 源文件，不要求安装 Hypit。Hypit 的独立许可证仍由其原项目管理。
+- 角色形象、导演构图、打斗、预演、连续性、市场立项、独立音乐授权与 Remotion 剪辑方法参照 Hypit 仓库随附的 `vendor/oh-my-short-drama` 开源短剧模块改写，保留其 [MIT 许可](licenses/oh-my-short-drama-MIT.txt)。原模块依赖本地插件状态、脚本和模板；本包只纳入适用于 VVICAT 画布的创作合同与剪辑原则。

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

@@ -4,7 +4,7 @@
 
 ## 专业剧本和纯文本拆镜
 
-微短剧从选题或方案开始时，先用 `short-drama` 完成方案、角色、分集、目标单集剧本和 review，再用 `humanizer` 只润色表达，最后回到 short-drama 复核。已有专业剧本直接创建 screenplay resource。
+微短剧从选题或方案开始时，按 [编剧合同](story-craft/guide.md) 完成方案、角色、分集、目标单集剧本和审校，再按 [文风润色](writing-polish.md) 只调整表达，最后重新运行画布剧本审校。已有专业剧本直接创建 screenplay resource。
 
 用户明确要求专业 Markdown 纯文本拆镜测试时，给 `storyboard-breakdown` 配置 `storyboardPipelineVersion: 2`、`sourceFormat: screenplay-markdown.v1`、任意规范 BCP 47 `targetLanguage`、平台和画幅，且只连接一条剧本。执行前按 [拆镜语言匹配门禁](assets-and-storyboard.md#拆镜语言匹配门禁) 验证每个本地化块；`targetLanguage` 不能被项目 `outputLanguage` 或 CLI `--locale` 替代。该模式只验收分镜文本和镜头资产，不执行声音设计、TTS、图片、音频或视频生成；失败时确认没有持久化半成品。
 
@@ -22,4 +22,4 @@
 
 ## AI 剪辑
 
-涉及时间线、裁切、字幕、转场、音频编排或渲染时，必须先加载 `remotion-best-practices`，然后完整执行 [剪辑与交付流程](editing-delivery.md)。只使用已确认的 selected 资产；原始镜头和 manifest 单独保留。H3 成片只对原生整轨做轻量处理，禁止另铺外部 TTS、旁白、对白、环境音或 BGM 覆盖。
+涉及时间线、裁切、字幕、转场、音频编排或渲染时，完整执行 [剪辑与交付流程](editing-delivery.md)；使用 Remotion 时再读随包的 [实现参考](remotion-editing.md)。只使用已确认的 selected 资产；原始镜头和 manifest 单独保留。H3 成片只对原生整轨做轻量处理，禁止另铺外部 TTS、旁白、对白、环境音或 BGM 覆盖。

package/skills/using-vvicat-ai-short-studio-cli/references/story-craft/canvas-production.md

@@ -0,0 +1,9 @@
+# 无限画布短剧制作
+
+先用 CLI `preflight --json` 和 `canvas inspect --project <id>` 读取登录、模型、设置和当前节点。来源分析、创作简报、故事设定、分集大纲、单集剧本、导演手册和剧本审校分别使用对应的 `drama-*` 节点；节点所需的输入及配置以 `canvas node types <kind> --json` 为准。
+
+创作时只推进当前阶段。分析必须分清来源事实与推断；改编不得增加无依据事件。简报里的受众、格式、集数、语言和禁改项由用户确认。故事设定及大纲保证人物选择和事件之间的因果。单集剧本写可见动作、逐句对白和原语语言；导演手册记录场景意图、调度、轴线和连续性，不提前指定镜头编号或供应商参数。
+
+审校需给出带场景定位、问题说明和修复要求的 P0/P1/P2 问题。将单集剧本物化出的同一个 `screenplay-resource.script` 同时连到 `drama-script-review.source`、`drama-director-book.source` 和 `storyboard-breakdown.script`；人工润色也在该资源上追加版本，随后重新审校。P0/P1 未清零不得进入导演手册和分镜。人工确认报告后，将报告版本 ID 写入审校节点的 `approvedReviewVersionId`，并把审校节点分别连到 `drama-director-book.review` 和 `storyboard-breakdown.review`。沿用 CLI 主 Skill 的资产、双重分镜参考、视频提示词、逐镜生成与审片、剪辑交付规则，不把任务成功误判为创作合格。
+
+参考片复刻时改用逐镜链路：人工审切镜 → `recreation-shot-extract` → 可选 `recreation-transcribe` 与人工校词 → 可选 `recreation-subtitle-remove` 与原片比对 → `recreation-depth-preprocess` 与时序检查 → 已选人物/场景/道具和镜头提示词 → 支持参考视频的生成节点 → 逐镜审片。每步保存独立资产版本。新 StarRouter 模型缺少管理员发布的价格修订时停止付费执行，不推定费用；回执不明或远端任务已创建但本地失败时，先查原任务和费用；只有核对后把上次本地任务 ID 写入节点 `acknowledgedFailedTaskId`，才允许再次付费提交。

package/skills/using-vvicat-ai-short-studio-cli/references/story-craft/guide.md

@@ -0,0 +1,7 @@
+# 短剧编剧合同
+
+先从 `drama-source-analysis` 记录来源事实、授权边界、推断和待确认问题；`drama-brief` 锁定受众、类型、基调、语言、画幅、集数和时长。`drama-bible` 记录世界规则、人物目标、冲突、伏笔和回收。`drama-outline` 给每集稳定编号、因果事件、情绪收益和结尾钩子。仅对用户选定的集数生成 `drama-episode`，将物化的 `screenplay-resource.script` 作为剧本事实源。
+
+单集剧本写可拍摄的动作、地点、人物、逐句对白和原语语言。开场尽早建立人物欲望和对抗，事件通过人物选择推进；钩子必须改变下一场的期待，避免机械套用固定秒数、固定集数或模板反派。导演本记录场景目标、表演、调度、轴线、动机光、声音和连续性，逐镜细节留给分镜。
+
+`drama-script-review` 同时读来源、简报、故事设定、分集大纲和同一个剧本资源。对因果、人物、信息、台词、节奏、格式、授权边界给出可定位的 P0/P1/P2；P0/P1 清零后人工确认 `approvedReviewVersionId`。改动剧本资源或报告选版后重跑审校。题材、开场、节奏、爽点、反派、钩子、付费卡点及内容审查的详细资料按 [index.md](index.md) 加载。它们是创作方法，不覆盖用户设定、平台规则和当前授权。

package/skills/using-vvicat-ai-short-studio-cli/references/story-craft/index.md

@@ -0,0 +1,13 @@
+# 编剧资料索引
+
+| 触发 | 资料 | 输入 → 产物 → 下一步 |
+| --- | --- | --- |
+| 选择类型与受众 | [genre-guide.md](genre-guide.md) | 创作方向 → 类型约束 → 简报 |
+| 开篇与前几集 | [opening-rules.md](opening-rules.md) | 核心冲突 → 开场事件 → 大纲/剧本 |
+| 全剧结构和单集节拍 | [rhythm-curve.md](rhythm-curve.md) | 集数/时长 → 节奏计划 → 大纲 |
+| 情绪收益 | [satisfaction-matrix.md](satisfaction-matrix.md) | 人物欲望 → 收益与代价 → 大纲/审校 |
+| 反派与阻力 | [villain-design.md](villain-design.md) | 冲突 → 对抗升级 → 人物设定 |
+| 集尾悬念 | [hook-design.md](hook-design.md) | 本集结果 → 下一集问题 → 剧本审校 |
+| 付费集设计 | [paywall-design.md](paywall-design.md) | 商业策略 → 合理卡点 → 大纲审校 |
+| 合规审查 | [compliance-checklist.md](compliance-checklist.md) | 已选剧本 → 风险清单 → 修订与再审 |
+| 画布落地 | [canvas-production.md](canvas-production.md) | 已选剧本 → 节点与资源版本 → 分镜 |

package/skills/using-vvicat-ai-short-studio-cli/references/video-and-performance-direction.md

@@ -0,0 +1,9 @@
+# 视频动作与表演导演
+
+适用于逐镜提示词、参考视频选择、说话表演与复杂动作。输入是 selected 剧本、人物/场景/道具、镜头表与授权参考；产物是可执行的逐镜动作合同和生成配置，下一步为逐镜生成与审片。
+
+写可见的因果链：人物为何行动、先看到什么、手和身体怎样接触物体、动作造成什么结果、镜尾留下什么状态。形容“自然”“有张力”不能代替动作起止与受力。潜台词落实为视线、停顿、表情变化和对他人的反应。镜头中说话时先确定谁开口、说哪句原语、身体与机位如何配合；无对白镜头不凭空安排口型。
+
+参考图负责稳定身份、造型、场景和静态状态；参考视频仅在需要保留时序运动、表演或机位行为，且模型明确支持时连接。首帧、尾帧、深度片和原片镜头各有不同职责，不把“接了参考”当作都具备深度控制。对每镜先确定镜头长度、可见动作是否能在模型允许时长内完成，再依据实时 `durationOptions`、参考数量和媒体类型限制配置请求。切点是叙事事件，不为了适配模型机械等分。
+
+单镜生成后从头到尾看画面、听完整音轨，核对动作、视线、手部接触、人物身份、原语对白、镜尾状态与下一镜衔接。换版后重审受影响的连续性和时间线。高风险接触、武器、设备状态或精确文字镜头按需加状态分镜或白模预演；普通镜头不强制增加中间资产。

package/skills/using-vvicat-ai-short-studio-cli/references/voice-and-sound-direction.md

@@ -0,0 +1,9 @@
+# 声音选角与混音
+
+适用于角色声音、对白表演、原音使用、音乐和效果声。输入是人物设定、原语台词、场级声场与已有音轨；产物是已选声音版本、音轨编排和完整试听记录。
+
+先决定这个人听起来是谁、对谁说话，以及音高、质地、口音、吐字和说话方式中真正定义身份的少数特征。选一段短而自然、能显出声音特点的原语样本；跨语言复用音色时仍要单独审发音、重音和节奏。同一人物尽量复用已选声音身份，但不同场次可以有不同情绪与语速。声音设计、克隆和 TTS 只在目标模型及授权允许时使用；若视频模型已原生生成对白与环境声，先审实际音轨，不自动另配音覆盖。
+
+先听素材自带声音，再决定新增声源。对白承载叙事时让关键词清楚；音乐或效果声在姓名、数字、反转和安静反应处让位。音效应响应实际接触、揭示或转场，不按每个切点机械添加。场级先定房间底噪、空间透视、混响与音乐状态；跨镜保持同一声场，视角变化时做有动机的衔接。逐镜生成的呼吸、脚步和接触声都需听审，不能默认相邻生成片自然接轨。
+
+剪辑阶段对照画面和对白检查电平、停顿、尾音、环境连续性与静音意图。完整试听最终成片后才确认音轨通过。字幕文本和译文分别管理，不从混音结果推断原语台词。

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

@@ -0,0 +1,15 @@
+# 剧本和台词润色
+
+读取当前选中的 `screenplay-resource` 版本和用户提供的语言样本，先列出主要人物的说话习惯、知识边界、此场目标和情绪变化。逐场检查：
+
+- 空泛评价、宣传口吻、没有来源的“大家都认为”、无具体行动的宏大意义，改成角色当下能看见、听见或做出的事。
+- 模板化开头与总结、连续三段并列、机械反问、为了押韵反复换同义词、无根据的对立句，按真实对话节奏删减。
+- 人物都用同一语气解释剧情、每句都把动机说透、台词重复画面信息时，保留动作和沉默能传达的部分。
+- 被动或无主语句使责任不清、无端的模糊词让事件失去确定性时，恢复具体人物、动作和对象。
+- 过多感叹号、破折号、加粗、口号式短句或刻意俏皮话时，按题材与人物语气调整；角色有意使用这些表达时保留。
+
+先区分缺陷与角色性格、地域口音、平台格式、悬念留白。不要机械删除重复、口头禅、停顿、粗粝语气或非标准句，它们可能承担人物身份和节奏。改写后读出声，检查每个人是否仍有可辨声音，信息是否能在该镜头时长内说完。
+
+保留已确认的剧情事实、人物关系、名字、数字、时间线、世界规则、场次结构、拍摄标记和授权边界。不要为了“自然”增添未确认事件。无法从画布证据判断的用语先标待确认，不擅自补事实。
+
+先内部拟稿，再核对是否出现新事实及违背人物语气的词句，最后只写入完成版。用 `canvas node edit-resource <剧本资源节点> --project <项目> --markdown-file <剧本.md>` 追加版本，重新运行并确认剧本审校；旧报告和下游选版不可沿用。来源：Humanizer（MIT，见 [许可证](licenses/humanizer-MIT.txt)），本资料已按短剧场景改写。