kinema-sketchboard

name	kinema-sketchboard
description	为单镜设计简笔分镜预演板和逐秒 beats。用户要草图分镜、九宫格分镜、逐秒运动脚本，或在生成视频前控制动作节奏时使用；与 3D previz、深度捕捉逐镜互斥。
metadata	{"kinema-managed-by":"agent/manifest.json","kinema-kind":"capability","kinema-status":"stable","kinema-version":"2.0.0","kinema-owner":"Kinema","kinema-source":"workspace","kinema-trust":"first-party","kinema-digest":"sha256:999f7d6ffa46801dba856d80d240821c3d59ae5960b546a275ec57e440338f3e"}

kinema-sketchboard · 简笔分镜预演板

先 Read kinema/SKILL.md（流程真源）。本 skill 管一件事：在烧 Seedance 之前，用一张 0.3 元的素描板 + 一段零成本的分段文本把这一镜的 动作、走位、机位节奏逐秒钉死。

三条产物、各锁一样东西：

• beats（shots[].sketch.beats，你写）——按镜头时长配拍的逐秒动作设计 （按 2~3 秒一拍：5s 镜 23 拍、8s 镜 34 拍，见下「beats 快则」），编译成分段时间轴 进视频提示词——段头随型号的 timeline_unit 分两支：响应秒时间戳的型号（seedance-2.5） 发「第0-1.2秒：…」秒段，缺省主力（Seedance 2.0 系列）发不带时间的「第1段：…」顺序编号 （官方指南把 2.0 的精确秒段列为支持不稳定；分段时间结构远胜一大段散文）。 t 仍按秒写：它用于拆拍、板上的秒段标签与秒段档的段头；
• 简笔板（sketch gen 生成）——铅笔素描网格（格数=拍数，恰好填满；素描灰阶为主，仅发光体/能量少量点缀色），红箭头=人物运动轨迹、 蓝箭头=摄影机运动、绿=构图、橙=灯光、紫=声音情感、黑=编号与秒段标签； gen-video 时缺省档板在盘即随请求附发（native 缺省=全能参考·一镜一片： 板+分镜图+角色/场景/道具设定图全作参考、不发首/末帧；dubbed 走参考媒体模式同样附板）； 只有衔接参与镜（章级/镜级 frame_chain，首帧任务禁混参考图）只发分段时间轴、 板不附——衔接章里逐镜 sketch ref --shots N --state on 才强制该镜切回参考孤岛；
• 末拍收束——最后一拍必须落在 end_state 上（衔接章里它同时与链末帧天然一致）。

规划优先（铁律〇）：先秒级描述，再画板

动态化的提示词质量取决于秒级规划，板只是规划的可视化——顺序绝不能反过来：

1. 每个要 gen-video 的镜都先有秒级运动规划。首选 authored beats（带 t 的 shots[].sketch.beats）；beats 单独存在即生效——gen-video 自动把它编译成 分段时间轴注入提示词（纯文本零成本，sketch list 显示 「生效=sketch·纯时间轴」，dry-run 逐镜行标「分段时间轴(无板)」）。
2. 板从同一份 beats 生成（effective_beats 单一真源）——先规划后画板， 板与时间轴天然一致。不是每镜都要出板：0.3 元/板花在重点镜（复杂调度/ 多主体/精确卡点/动作戏），普通镜 beats+时间轴已足够。
3. 没写 beats 也没出板的镜：引擎不注入时间轴（自动拆拍只在板/beats 语境下 生效），发出去的就是 video_prompt 原文——所以它必须自带先后次序的详细分段 （起势→推进→收束，每阶段一个主动词）；更推荐直接补 beats。
4. 改了 video_prompt/beats 板不会自动跟上：板条与 sketch list 会报 「⚠ 拍序列已变」（与「⚠ 时长已变」同制度，判据 gen.sketch.sig 拍序列指纹）， gen-video 附板前也会点名——重点镜记得 sketch gen --only N --force 重生， 否则板与时间轴说的是两套动作，模型会二选一或折中。

与 3D 导演台、深度捕捉的互斥（铁律）

一个镜要么走 previz（首帧/末帧/V2V），要么走深度控制视频（实拍运动 V2V），要么走 简笔板（时间轴+参考图），绝不同发——三者都在向模型描述"这几秒怎么运动"，同发 必然打架。仲裁单一真源 sketchboard.active_guide：显式 shots[].guide 恒赢（即便 指向空槽也不静默回落，引擎会告警）；缺省自动仲裁 previz > control > sketch。 表态入口：sketch use --shot N --guide sketch|previz|control|auto，或 Studio 分镜卡的 仲裁徽章（配置了两路及以上时才出现，点击轮换）。缺省档（章不衔接）简笔镜就是全能参考： 时间轴管过程、板与设定图管外观，一镜一片；开了章级衔接（frame_chain: true）的章里 简笔镜与链末帧并存（时间轴管过程、链末帧管收束），板只当拍表不附发——要板随请求发 须逐镜「板作参考」表态（sketch ref，代价见「边界与成本」）。

工作流（五步，逐门确认）

1. 写 beats（规划优先的默认动作，见铁律〇）：Read 分镜脚本（narration/action/ video_prompt/end_state/light_shift）与小说原文对应段落，把每镜按时长拆成 对应拍数（23 秒一拍：5s→23 拍、8s→3~4 拍）写进 shots[].sketch.beats——正式通道是 agent plan 的 ChapterPlan（sketch.beats 白名单，merge 语义不动引擎管的 sheet， 带 expected_revision 并发保护）。拆拍工法见 references/board-craft.md。绝不发明剧情——细节从原作搬运。 没写 beats 也能生成：分镜词足够详细时，引擎按运动设计句读自动拆拍 （sketchboard.auto_beats，纯标点切分零语义改写，authored beats 恒优先）—— 板与时间轴取同一份拍序列，自动拆拍的时间轴会替代散文正文（同句不发两遍）。 自动拆拍秒段只能均分；节奏要精确（爆发拍 0.4s、余韵拍 1.2s）就手写 beats。 秒段基准=实际请求秒数（引擎按 request_seconds 铺，不是裸 dur）：手写 t 必须首尾相接、末拍收在实际秒数上——sketch gen 与 Studio 会做覆盖体检（断档/ 重叠/收不到位报 ⚠）；板生成后镜头时长一变，板条与 sketch list 会打「⚠ 时长已变」， 重生即可（灯箱「↻ 重新生成」）。
2. 先 1 镜出板验证：sketch gen --chapter x/ch --only 1，Read 板图做四查 （见下），过了再 sketch gen 全量（并发缺省 4）。
3. 质检四查（引擎无 OCR，必须逐板 Read）：① 格数与编号齐全、按时间推进； ② 秒段标签与 beats 对拍；③ 每格动作与该拍 action 一致且有可见运动（静态站姿 =坏板）；④ 五色箭头在场且红/蓝语义不串。坏板 --force 重生或改 beats 措辞。
4. 表态 guide：该镜要走板就 sketch use --shot N --guide sketch（若该镜从未 配 previz，自动仲裁已选 sketch，可省）。
5. （仅衔接章）挑镜开板作参考：本章开了 frame_chain: true 且某镜的动作调度 复杂到时间轴文字说不清时，sketch ref --shots N --state on——开一镜断一条接缝， 只给真需要的镜开；缺省章（不衔接）板在盘即自动附发，无需此开关。
6. 审后发：gen-video --chapter x/ch --dry-run 逐镜核对时间轴提示词与附板 标记（缺省 native 镜显「全能参考(分镜图+简笔板·一镜一片)」；无板显 「全能参考(分镜图·一镜一片)」；dubbed 显「参考图=分镜图+简笔板」；衔接章的 首帧任务镜照常标末帧、板不附），无误后去掉 --dry-run 正式生成。

beats 快则（起承收结构 · 拍数按秒数配）

• 拍数上限 = 秒数 ÷ 1.2（每拍 ≥1.2s，硬底线 0.8s/拍）——abyss 镜1 的教训： 9 拍铺 5s（0.56s/拍），Seedance 只挑 2-3 个主事件演完整、其余拍整段丢弃 （转夹具/报纸颤/影子移/直身搁枪全没出现）。手写口径是 23 秒一拍：5s 镜 23 拍、8s 镜 34 拍、 12s+ 长镜才配 56 拍；9 拍只在 12s 以上、且逐拍都有独立主动词时才成立。 上面那条「秒数 ÷ 1.2」是引擎代切（sketch gen 无 beats 时自动拆）的收敛上限， 不是手写目标——两个数一个管「引擎别塞太密」、一个管「你写多粗」，别互相套用 （手写口径的真源是 kinema/SKILL.md 的「拍数按 2~3 秒一拍切」，本文与它同源）。次要氛围件（报纸颤/影子移）挂进主拍的 action 从句， 别独立占拍。
• 自动拆拍已由引擎按时长收敛（auto_beat_cap：min(12, 秒数÷1.2) 再向下取到 最近的整齐拍数，下限 2 拍，均匀并拍保时序不丢句）——不写 beats 直接 sketch gen 时，5s/7s 镜出 4 拍、8s 出 6 拍、10s 出 8 拍，不是固定 9 格。 素材不足不凭空造拍。
• 版式：网格恒按拍数恰好填满（grid_of，引擎自动算，你不用管）—— 2/3 拍=单行、4 拍=2×2、6 拍=2×3、8 拍=2×4、9 拍=3×3、10 拍=2×5、12 拍=3×4。 优先写整齐拍数 2/3/4/6/8/9/10/12：5/7/11 拍排不成矩形，末行只能居中留半排 （引擎会明说「最后一行 N 格居中」并禁止补空框，但满格版面每格更大更好读）。 历史事故：列数硬编码为 3 时，4 拍算出「2×3 网格共 4 个面板」自相矛盾，模型只能猜—— 同为 4 拍，一张排成 2×2 满格、另一张照 2×3 画完留了两个空白框。
• 手写 beats 引擎一个字不动（创作资产）：超密只报「⚠ 拍密度」给建议， 该并哪几拍是你的判断——见警必改，别指望引擎替你合。
• 拍 12 起：入拍即动（承接上一镜末态，绝不从静止慢慢起）；中段 推进： 每拍一个主动词、动作连续递进，微表情/次要运动挂在主动作上；末 12 拍 收： 减速收束，末拍=end_state 的画面。
• 打斗镜的手写 t 按「停—爆—停」配拍（蓄势 0.81.2s → 爆发 0.40.6s×23 → 亮相/受击 0.81.2s，绝不均分）——完整工法见 kinema/references/action-direction.md（因人设招/拆镜/升格纪律都在那）。
• 每拍 {"t":"0-1.5s","action":"…","camera":"…","framing":"…","light":"…","sound":"…"} ——action 必填（具体、物理、可画出来的运动），其余按需；t 缺省引擎按 dur 均分，写显式 t 时须覆盖全时长不留洞。
• authored beats 写全后，video_prompt 转职为「全局层」——只消重，绝不收敛成 一句总括（一句话正文是硬违规，prompt_thin 按 ≥140 字警戒（地板真源 = 引擎 variation.MIN_VIDEO_PROMPT_CHARS）；两档规则真源 kinema/SKILL.md「运动规划两档」）。分工对齐视频模型官方的分层提示结构 （全局描述定风格质感、分段描述管动作运镜）：逐拍的「谁+做什么+镜头怎么动」归 beats（时间轴会原样发出，与拍逐句重复的动作句从正文删去——同句发两遍既费 预算又稀释时间轴权重）；正文保留并写厚跨拍的东西：动作的力学、物理反馈与 次级动画、材质与光的响应、情绪质感与氛围。引擎只替代自动拆拍的散文，authored 的逐句重复要靠你自己收。
• 拍数区间 2~12（AUTO_BEATS_MIN/PANEL_MAX）；九格是版式上限不是拍数指标——只有 12s 以上的长镜才配得起 9 拍。

命令速查

python3 -m kinema sketch gen   --chapter x/ch [--only 1,3] [--force] [--mock] [--concurrency N]
python3 -m kinema sketch use   --chapter x/ch --shot N|--all --guide sketch|previz|control|auto
python3 -m kinema sketch list  --chapter x/ch          # beats/板/guide/生效路径一览
python3 -m kinema sketch clear --chapter x/ch --shot N # 摘板挂载（文件与 beats 保留）
python3 -m kinema gen-video    --chapter x/ch --dry-run # 审时间轴（板附发标记同源）

Studio：章节页「SK 简笔分镜台」区块（3D 导演台正下方）——统计三格 + 「▦ 生成 简笔板」选镜弹层 + 「⧉ 分镜板指令」（交回本 skill 写 beats）+ 板缩略条 （SHOT 签点击跳分镜卡·右上 ⧉ 复制单板改图指令·灯箱内逐拍对照表 + ↻ 重新生成）； 分镜卡「▦ 简笔」角标看板、仲裁徽章切路径。

边界与成本

• 板绝不进 shots[].image/clip（分镜画面与成片位；板是预演观看物，落 <章节>_work/sketch/，不走审阅状态机、不做版本栈，--force 直接覆盖）。
• 板生成刻意不带画风前缀、不注入 moodboard 垫图——板是素描基调、不掺成片画风， 彩色垫图混入就是"给板上成片色"的邀请函；版式一致性靠引擎内置版式蓝图自动垫 （engine/kinema/assets/blueprints/sketch1/2/3_template.png 三张同版式样板： 单人动作/双人对话/双人战斗，只学版式与标注画法、绝不复制其人物与标题文字）。 蓝图放在引擎包内而不是本 skill 目录是刻意的：它是引擎生成时自动垫的运行时 资产（转 base64 塞进 ref_images），搬进 .claude/skills/ 后 pip install 的用户 那里根本不存在、垫图会静默失效。设计归属仍在 skill（契约由 sketchboard.board_prompt 定义），出处与重做方法见 engine/kinema/assets/README.md。设定图侧有同款蓝图 （角色/道具各一张简笔线稿 char_template/prop_template，见 sheets.templates_for）。
• 成片防泄漏：板附发时引擎两处同时防——正文头部注入「板不是画面参考、只是分镜 脚本，格线与箭头是标注符号而非画面元素」，同一批词再补进负面串（标注箭头/红蓝 箭头/分镜格线/铅笔素描…）。只在正文说一次压不住：16 镜里 6 镜带板，2 镜把 红蓝箭头画进了开头几帧。绝不手工删改提示词绕过引擎拼装。
• 成本：板=一张图价（Seedream 0.3 元）；时间轴文本零成本。
• 附板是逐镜取舍，缺省不附：能力闸（只有 seedance/mock 支持参考图）× 两条通道： dubbed 参考媒体模式与 native 缺省档（全能参考·一镜一片）板在盘即附；只有 衔接章（frame_chain: true）里板让位给首帧任务，须 sketch ref --shots N --state on 显式切回参考孤岛（判据真源 sketchboard.reference_shot）。衔接章里的 取舍要点：换来板与设定图入场（板级走位与机位节奏），代价是这一镜没有首/末帧槽 ——它既不向下一镜发末帧、上一镜也焊不到它身上（分镜图降级成众多参考图之一， 不再是第 0 帧硬锁），开头几帧由几张参考图调和而来、两侧接缝改软切。

开了「板作参考」＝这一镜是链上孤岛（强制要求 · 仅衔接章）

开关一开，这一镜的两侧焊缝就都断了——不是只断后面那一条。引擎会在上下两处 各自动落一个 seamless 无缝转场（0.1s ≈3 帧柔切、静音、transition.auto="island"）， 成片里的形态就是：正常衔接 → 软切 → 这一镜独立成段 → 软切 → 正常衔接。

指挥层三条硬规矩：

1. 不要手工在孤岛镜两侧再加转场。同一处已有转场时引擎不再补软切，你手写的 fade_black 会原样保留——那是「叙事标点 + 参考模式断缝」两件事叠在一处， 看上去像是章节在这里跳了两次。用户点名要叙事转场时才插，并告诉他它替代掉的是软切。
2. 不要连开一片。相邻两镜都开 = 中间那条缝两端都不成立，整段被切得七零八落。 板级调度是给「这一镜的走位必须精确」的单镜用的，不是全章档位。
3. 开完必须重看链态：gen-video --dry-run 会打印每一处「自动插入无缝转场」 与逐镜链态；或跑 kinema transition sync 单独同步一次（零成本）。 禁止在没看链态的情况下直接 gen-video 烧钱——开关改的是整章的接缝结构。

细则（拆拍工法 / 箭头标注规范 / 板提示词契约逐段 / 艺术身份板选用）： references/board-craft.md。