用途
handraw-video-producer 是手绘视频制作的总控 Skill，用于制作手绘视频、动态绘本与有声绘本。它不直接完成全部制作，而是负责选择输出路线、确认方案、审查素材，并分派给对应的制作 Skill。
输出路线
制作前必须先明确用户需要哪种输出：
- web：浏览器制作 Skill，按实际实现选择七类分镜，制作程序动画并输出 MP4。
- jianying：剪映制作 Skill，默认限 ST-001～004 并检查具体原生配置，输出草稿加素材包，由用户在剪映导出。
未明确时，需先介绍这两个选项并询问，不默认替用户选择。新建 CLI 必须填写 --output-target。
剪映草稿箱前置检查
当用户选择剪映路线或提示词中包含「渲染方式：剪映」时，Skill 必须先检查用户是否已配置剪映草稿箱路径（检查 hvp jianying-config 状态）。若用户从未填写过草稿箱文件夹位置，必须先主动询问并获取草稿箱绝对路径（提示用户在剪映全局设置中查看），保存至本机配置后方可推进后续方案确认与草稿交付。
分镜体系（v3.8）
用 hvp catalog --kind shot 读取 catalog/shots.json。共享目录仅七类：
- ST-001 单图动画
- ST-002 视频
- ST-003 背景＋透明素材动画
- ST-004 全图有限帧动画
- ST-005 Remotion 动画
- ST-006 simo 版白板动画
- ST-007 SRT 版白板动画
每镜选择一个主类型，内部可用多个图层。AI 根据需求设计受众、目标、脚本、全片视觉与运动方向，再逐镜选择类型。画风、图型、配色为共同视觉设置；字幕、声音、衔接和输出方式为共享设置。不得用业务名称选择实现。
ST-001 单图动画只列全屏模式与绘本模式：前者以完整主图组织全屏画面，后者使用背景、插画区与文字区。关键帧动画和环境特效均可选，环境特效按具体实现检查，不默认添加。
七类不足时，可在本期 local_types 写独立类型、素材契约和 HTML 实现。先完成技术验证与实际审片，由用户决定是否收录共享库；新增名称不等于新增能力。
绘本视频
用户提出「做绘本类视频」「动态绘本」「有声绘本」时，必须读取绘本制作指南，按 ST-001 绘本模式设计多页故事，浏览器与剪映两条路线都可采用。默认参考《一片叶子的屋檐》的阅读布局：纸页留白、完整插画居中、短句在插画下方、小标题可选。参考的是布局与阅读节奏，故事、角色、画风和色板按本期需求设计。多页使用多个 ST-001 镜头。
阶段门槛
流程为：调研与方案 → 用户确认 → 画面素材准备 → 全部画面素材审查通过 → 配音与动画 → 合成 → 验收。
「帮我做视频」仅授权方案阶段。完整方案包含受众、目标、依据、标题、脚本、预计时长、视觉与运动方向、逐镜目的/帧区间/动作/类型/来源、素材责任、声音和交付。确认前可盘点已有素材，但不得生成画面、配音、动画代码或预演。确认后可准备插画、参考图、录屏及外部生成提示词。全部必需素材经技术检查与实际画面审查通过前，不生成配音、不编写本期动画、不预渲染或合成。
分镜素材准备与补齐
所有视频图片提示词与出图沿用手绘出图规则。方案确认后，每个缺失且可生成的素材都必须交付本镜完整、可复制的提示词，并保存到本期 work/material-prompts/；同时给出素材编号、文件名、格式、实际参考图、回传位置和审查点。不能仅交付泛用模板。真实录屏、事实数据、用户原件及实际字幕时间缺失时，提供采集或补充要求，不能用生成内容冒充。
素材策略与外部视频
auto可含零视频no_video禁止视频画面输入video_only每镜主画面来自原速视频，可添加文字/声音/字幕
有 Flow 或其他平台生成任务时，交付独立提示词与参考图任务包，等待用户回传。保存版本、候选、哈希、审看与选用记录。未回传、过短、损坏、身份/动作/衔接不合格均阻止制作。不循环、冻结或变速凑时长。
实现与输出
新工程仅 composition-v2。episode.json 为全片方案，composition.json 为 shots。旧工程、成片与原始素材保留，不执行、不转换。
new / validate / render / build / export-plan / export 使用同一模型。export 使用已准备声音，不调用配音。火山引擎使用随包火山语音 Skill，hvp tts 按 provider 分派并生成实际字幕时间。hvp volc-config 保存用户提交的账户，hvp volc-status 仅查看配置状态；密钥在仓库外用户目录保存。
每帧由帧号复算。网页实现保留 renderFrame(t)；CSS 动画暂停并定位，JS 不依赖墙钟。Remotion 与有状态白板逐镜生成内容寻址缓存，再解码逐帧合成。SRT 白板先审核线稿与输入数据；没有 SRT 时审核通过后配音，再用真实字幕对齐。
剪映规则
全片输出与逐镜实现分别记录，但须服从已选路线。默认剪映原生；不能原生时阻止并报告，不自动预渲染。用户同意具体镜头后才可按镜生成视频缓存。剪映交付使用内置 pyJianYingDraft。
hvp jianying-check <包或草稿目录>检查文件、引用、时间和路径hvp jianying-resources <关键词> --kind transition|filter|effect|character_effect|intro|outro检索名称及真实 ID，不自动选用或下载hvp jianying-config --draft-dir "目录"保存本机剪映草稿箱
方案选定的转场/特效/滤镜在 shot.jianying 记录并自动写入草稿。原生效果改版参与方案签名，需重新确认。
证据与交付
交付或修正预览/草稿时读取镜头审查与交付核对。核对用户指定的实际案例版本，区分原图、整页和截图；按可编辑对象分轨。技术验证、应用打开/导出、用户审美接受分别记录。交付 MP4/草稿、预览、字幕、封面、关键帧、工程和制作记录。
依赖与限制
安装或判断可制作能力时先读安装与依赖。代码与必要资源随包提供；Python、FFmpeg、浏览器、Node.js、剪映和生成服务按路线另行准备。不读取开发者本机工具或私有案例目录。剪映路线默认限 ST-001～004。截图受限或软件未审看时如实列待验项，不能用坐标/哈希/JSON 通过代替视觉通过。