字幕版式设计
默认政策与输入
成功渲染素材默认进入正式后期。文字层以用户传入正文、换行、时间轴、字体和平台为事实输入；原声音轨保持。默认不抽帧测原片亮度、纹理或对比度，不凭可现度评分拒收，也不自动转录、补配音或改台词。
先记录实际画布、字体 id、平台、场景和明确参数；以下设计数值用于生成方案，用户明确要求优先。不能把建议行数、字数或并发条数当成默认删条阈值。
一、工艺判据与字号推导
字号 = 短边 × 场景基准比 × 粗细修正 × 平台倍率
粗细修正 = 1 + (2.5 − 字体粗细程度) × 0.04
描边建议 = 字号 × 0.06；复杂底可选择 0.08
安全边距建议 = 短边 × 0.05
| 场景 | 基准比 | 字体粗细建议 | 设计目的 |
|---|---|---|---|
| 标题 | 0.11 | 3..5 | 短时辨识、与字幕区分层 |
| 字幕 | 0.048 | 0.5..3 | 连续阅读、少装饰 |
| 弹幕 | 0.04 | 2..4 | 瞬时辨识、分道布局 |
| 贴纸 | 0.07 | 2..5 | 表达个性、按指定区域落位 |
字幕短边比 3.8%..7.5%、标题 8.5%..16% 是历史设计参考，不作为已生成视频的后置质量门。固定字幕尽量先分行，避免压缩字距；长文本必须完整保留，不静默省略。
二、平台位置与字号参考
| 平台 | 画幅参考 | 字幕位置 | 标题 / 倍率建议 |
|---|---|---|---|
| 默认 | 16:9 | 底部居中，边距 5% | 顶部居中，字幕倍率 1.0 |
| 抖音 / 快手 | 9:16 | 可选上抬 18% | 字幕 1.05、标题 1.15 |
| B站 | 16:9 | 底部居中 6% | 顶部留弹幕带 |
| 小红书 | 3:4 | 底部 8% | 标题倍率 1.2、可选花字 |
| 视频号 | 9:16 | 可选上抬 16% | 字幕倍率 1.10 |
| YouTube | 16:9 | 底部或 Lower-third | 字幕倍率 0.95..1.0 |
平台参考来自随包 font_db.json 的 layout_policy；它不是实时平台 UI 保证。已有账号字体锁定优先，实际 PlayResX/Y 采用当前画布。
三、安全区与描边策略
平台互动栏、底部文案、顶部关注区域由配方的 occlusion_zones 提供设计参考。规划时优先上抬/下移、分行或换边；明确请求的位置必须如实执行，实际非法坐标、缺字体或无法渲染应停止，不通过抽帧评审退回成功镜头。
- 默认使用固定配方的文字色、描边和底衬；需要深色字、浅色字或半透明底衬时明确写入方案。
- 花底可建议描边“字号×0.08”或半透明黑底，克制风格可选 0.04。
- 不根据源片亮度 ≥62%、细节密度 ≥28% 等历史诊断值自动否决或循环重排。
四、分行与节奏
- 竖屏设计参考为每行约 18 汉字 / 42 英文字符，横屏约 22 汉字；超过时完整分行，禁止截断正文。
- 字幕和标题可先按 2 行设计；用户已有多行正文必须保留其内容，按真实换行与布局执行。
- 片头标题停留可参考 1.5..4 秒，常用 3 秒；实际采用传入时间轴。
- 贴纸可设计 200ms 入场与 1.5..3 秒停留，不能改写显式时间窗。
- 双语字幕第二语言可小 12% 并下移一行；每条语言原始正文与时间轴均需要保留。
- 弹幕按滚动、顶部和底部模式分道。默认保留全部传入条目；只有明确设置 max_chars / max_concurrent 时才按该约束验证或报告处理，不能默认使用 20 字 / 8 条删减。
五、参数边界
- 字号、画布和时间必须是合法有限值，cue 起点不得为负、终点必须晚于起点。
- 字体必须实际存在并有当前用途许可；禁止静默回落系统字体。
- 禁止覆盖原片、删除用户正文、按声音质量重转录或补 TTS。
- 实际渲染失败必须明确上报；未做画面比较时 presence.reviewed=false、未测 delta/ok 为 null。
六、SOP 与证据
- 触发：用户请求文字轨。读取实际画布、cue、字体和平台。回执：输入 SHA-256、cue 条数、原文字与时间轴。失败：无时间轴、空正文、非法路径或缺许可时停止。
- 触发：布局参数齐备。运行 subtitlewrite.plan 生成 ASS，使用真实换行与 PlayRes。回执：ASS 文件、字体 id、字号、边距与实际条数。失败：方案生成错误按原错误上报，不删条保成功。
- 触发：明确要求烧录或 softmux。执行一次目标操作。回执：fontselect、输出哈希、音轨保持与实际画布。失败：工具非零、字体回落或缺产物停止交付，原片不动。
七、失败模式（原因 → 处置）
| 症状 | 原因 / 检测器 | 处置 |
|---|---|---|
| 字号与计划不一致 | PlayRes 与真实画布或字体倍率不一致 | 修正请求方案，另存版本；不重生成镜头 |
| 字是方框 | 字体不包含字符或字体解析失败 | 指明缺字与字体，选择有许可字体后重新执行 |
| 多行正文或词语丢失 | ASS 转换、换行或过期默认长度规则 | 保留完整词语与原 cue，修正转换，不靠缩短台词绕过；当前约定的 SRT 中文标点清理是明确格式规则，数字和英文标点保持 |
| 弹幕比请求少 | 隐含密度阈值或显式约束处理未留痕 | 默认保留全部；明确约束时记录每条处理与数量 |
| 用户希望换位置 | 主观反馈 | 走 text 层返修，输出新方案与回执 |
| 烧录工具失败 | 路径转义、滤镜或编码器错误 | 报原错误，不宣称已完成字幕 |