handraw-jianying-producer 属于 handraw-style 技能包，用于在已明确选择剪映输出路线（episode.output_target=jianying）时，制作手绘视频、绘本视频的原生剪映草稿与素材交付包。
一、用途 本技能由视频总控在用户明确选择剪映路线后调用，主要面向需要可编辑剪映草稿的手绘视频与绘本视频制作场景。它按剪映原生能力设计动作与剪辑，而非先编写 JS 再塞入草稿。
二、前置条件与草稿箱配置 调用前必须先确认已配置剪映草稿箱路径。若用户从未填写过剪映草稿箱文件夹位置（hvp jianying-config 为空），必须先询问并获取用户剪映草稿箱绝对路径并保存，不得在未配置时直接生成或交付草稿。草稿箱位置用 hvp jianying-config --draft-dir "绝对路径" 保存，不传参数可查看；配置存放于仓库外的本机用户目录，更新仓库和同步 Skill 不会覆盖。hvp jianying-install <包> 默认读取保存位置，--draft-dir 只临时覆盖，不修改保存值；未设置、目录失效或配置损坏时明确报错，不自动换路径，用户配置不随草稿包交付。
三、主要能力
- 前期设计：按镜头 ST 编号读取分镜素材准备目录及对应文档，核对原生配置实际需要的图片、透明 PNG、帧序列或视频；为可生成的缺失素材交付具体提示词、实际参考图和回传要求，真实录屏、事实数据和原件需采集。
- 镜头范围：默认只使用 ST-001～004，且每镜检查具体配置。基础图片、原速视频、透明 PNG、有限帧序列、可编辑文字/字幕与已适配关键帧可原生；1～4 编号本身不代表任意环境特效、有规律运动、旋转或复杂遮罩都支持。
- 轨道组织：轨道按可编辑对象组织，背景图、各 sprite、文字和声音分轨。同一 sprite 的循环或非循环图片帧顺序放在一条角色轨道，不为每帧另建轨道；不同 sprite 仍独立。全图有限帧也在同一主画面轨道排列。仅需要原生转场的相邻主画面共享轨道，不能把角色、文字合并进去；其他背景按镜头独立。交付 editing-map.json 及轨道说明，逐镜标明背景、角色、文字与字幕的位置。
- 绘本制作：用户要求绘本时必须读绘本制作指南。多个 ST-001 镜头分别作为故事页，原生组织纸色色底、居中完整插画、下方短句和可选小标题，交付实际插画素材与可编辑文字草稿。用已适配的位置/缩放/透明度关键帧制作轻微运镜；跨页使用已检索的剪映原生转场。文字居中须按真实字体宽度计算 region，不能假设存在通用 align 字段；检查插画、故事短句与共享字幕互不遮挡。
- 效果与转场：可按已检索的实际名称、resource_id 或 effect_id 在每镜 jianying 字段配置 transition_out、effects、filters，导出时自动写入原生材料和引用。转场在前片段上并使用相邻主画面同轨；ST-003 仅背景转场，角色/文字不随转场。复杂整镜多层转场未适配时明确报告。
- 配音与字幕：火山配音使用同包火山语音 Skill 及 hvp tts，客户端随包提供，账户保存在仓库外本机配置；不读取外部本地 CLI。实际声音与字幕作为独立素材进入剪映音轨和字幕轨。
四、使用方式与流程 与总控共用方案确认、全素材审查、Flow 回传、配音与字幕流程。制作前用 export-plan 检查，不支持时报告具体镜头和原因。通过总控 hvp export/build 输出草稿包，禁止全片 render/mix；只处理用户同意的预渲染镜头，其他图层保持原生。包内含草稿、实际素材、清单、安装工具及中文说明。交付前执行 hvp jianying-check <包>，安装后对新草稿目录再检查。资源查找用 hvp jianying-resources，不猜资源 ID。用户在剪映 10.9 打开并手动导出。
五、默认不预渲染与授权例外 默认不调用浏览器预渲染。确需 ST-005～007 或 JS 环境效果时，先说明具体镜头、耗时来源、画面将合并为视频和可编辑性损失，取得用户真实同意；更新并确认包含该路线的方案后，用 output_backends.record_prerender_approval 记录回复与镜头编号。render_backend=web 或 auto 都不等于用户授权，方案改版旧授权失效。未经同意时，调整为可原生效果或提交浏览器路线方案，不静默改变视觉；明确 render_backend=jianying 的镜头不支持时仍阻止，不用授权覆盖其原生要求。
六、交付与验证 交付时执行镜头审查与交付核对，检查实际导出 track ID、角色帧序列与图层顺序，并给出轨道对照。预览素材卡片、布局示意和剪映实际画面明确区分。修改后生成唯一新版草稿与交付包，核对预览及安装路径。打包新版 draft_info.json 与 draft_content.json 一致副本、实际播放素材、editing-map.json、离线检查器、安装工具与许可。生成时检查实际结构及哈希，失败不得标注通过；安装先验证完整性，新目录重绑定后检查，通过才发布。禁止 overwrite 自修复用户工程。
七、适用场景与限制 适用于已选剪映路线的手绘视频、绘本视频、需要原生可编辑草稿的交付场景。限制包括：默认仅支持 ST-001～004 的原生能力，复杂效果需用户授权预渲染；软件或网页未能实际审看时标记未验证，不能只凭结构断言画面正确；草稿结构通过不能称为剪映实际导出通过，剪映程序、本机字体与效果资源仍需本机具备；应用打开、实际导出、音频与字体检查、用户审美接受分别登记。
八、其它说明 本地吸收两项目的草稿与检查方法，详见整合说明；不依赖外部参考项目目录、外部 Skill 安装或生成服务。intro/outro 当前仅查询。效果资源是否在本机可用、实际视觉与导出另行验证。