@aswless_854771076/ai_short_studio_cli 0.1.98 → 0.1.100

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

@@ -1,21 +0,0 @@
-# 参考片逐镜复刻
-
-只在用户确认来源、下载/分析权利、允许保留和必须替换的元素后进入制作。若来源是本地文件，先用 `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

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

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

@@ -1,18 +0,0 @@
-# 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

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

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

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

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

@@ -1,6 +0,0 @@
-# 资料来源与许可
-
-- 短剧编剧参考由 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/story-craft/canvas-production.md

@@ -1,9 +0,0 @@
-# 无限画布短剧制作
-
-先用 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

@@ -1,7 +0,0 @@
-# 短剧编剧合同
-
-先从 `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

@@ -1,13 +0,0 @@
-# 编剧资料索引
-
-| 触发 | 资料 | 输入 → 产物 → 下一步 |
-| --- | --- | --- |
-| 选择类型与受众 | [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

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

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

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

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

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