linyqh/speclip-skills/portrait-subtitle-layout

竖屏视频字幕位置与参数

用于 竖屏视频 的字幕排版与烧录决策。当前版本的原则很明确：

• 先把字幕参数调对
• 暂时不处理遮罩 / 底板 / 背景条
• 靠 字号、位置、行长、换行 来优化效果

如果是横屏 / 16:9，请改用 landscape-subtitle-layout。

什么时候用

• 用户明确说是 竖屏 / 9:16 / portrait 视频
• 用户要字幕烧录，并且关心 位置、安全区、字号、边距、换行
• 用户说：别挡人脸 / 再往上抬一点 / 底部还有按钮 / 字幕两行太满 / 字幕太小 / 字幕超宽
• 用户说：遮住原字幕 / 替换视频自带字幕 / 原字幕盖不住 / 三行太挤

当前范围

这个 skill 只处理字幕参数：

• FontSize
• MarginV
• MarginL
• MarginR
• Outline
• Shadow
• WrapStyle
• MaxLineLength
• 分句与拆事件策略

这个 skill 暂不处理：

• 遮罩
• 底部黑条
• 半透明底板
• 毛玻璃背景
• 额外 drawbox / 背景滤镜

如果用户提到背景、底板、遮罩，当前回答应明确说明：先移除遮罩，只保留字幕参数优化。

先判断是哪一种模式

A. 安全区上移模式 safe-area

适用于：

• 没有原片硬字幕需要遮挡
• 重点是 别挡人脸 / 别压按钮 / 别压底部 UI

B. 原字幕压住模式 cover-original-no-mask

适用于：

• 原视频底部已经有自带硬字幕
• 新字幕需要尽量压住 / 替换原字幕
• 当前阶段 不用任何遮罩，只靠更大的字号和更低的位置处理

如果用户提到“遮住原字幕 / 替换原字幕 / 原字幕露出来了”，优先使用 cover-original-no-mask。

硬约束

1. 最多两行；如果会变成三行，必须拆句或拆成多个字幕事件
2. 单行宽度目标不超过画面宽度的 `70%`，极限不超过 76%
3. 先拆句，再缩字号；不要一上来把字体缩小
4. cover-original-no-mask 下，字幕要 足够低、足够大，但不能裁切
5. 当前阶段 禁止默认添加任何遮罩或背景条

默认基准

以 1080x1920 竖屏为基准。

模式 A：安全区上移模式 safe-area

• Alignment = 2（bottom-center）
• FontSize = 86
• MarginV = 600
• MarginL = 72
• MarginR = 72
• Outline = 4
• Shadow = 1
• WrapStyle = 2
• MaxLineLength = 12

模式 B：原字幕压住模式 cover-original-no-mask

• Alignment = 2（bottom-center）
• FontSize = 98
• MarginV = 118
• MarginL = 92
• MarginR = 92
• Outline = 3
• Shadow = 0
• WrapStyle = 2
• MaxLineLength = 8

核心思路：

• 不靠黑条盖住旧字幕
• 靠更低的位置和更大的新字幕，尽量在视觉上替换旧字幕
• 如果仍然过长，就拆句或拆事件

缩放公式

如果分辨率不是 1080x1920，按下面规则缩放：

safeFontSize    = clamp(round(86 * H / 1920), 60, 148)
safeMarginV     = clamp(round(600 * H / 1920), 360, 1200)
coverFontSize   = clamp(round(98 * H / 1920), 76, 164)
coverMarginV    = clamp(round(118 * H / 1920), 72, 220)
marginLSafe     = clamp(round(72 * W / 1080), 48, 132)
marginRSafe     = clamp(round(72 * W / 1080), 48, 132)
marginLCover    = clamp(round(92 * W / 1080), 56, 160)
marginRCover    = clamp(round(92 * W / 1080), 56, 160)
outlineSafe     = clamp(round(4 * H / 1920), 2, 6)
outlineCover    = clamp(round(3 * H / 1920), 2, 5)

其中：

• W = 视频宽度
• H = 视频高度

宽度与分句控制规则

如果用户反馈“字幕超出了视频宽度”或你预估会超宽，按下面顺序处理：

1. 把 MaxLineLength 收紧到 6–8
2. 主动拆句，优先在逗号、顿号、语义停顿点换行
3. 增加左右边距
4. 如果仍会超过两行，直接拆成两个字幕事件
5. 只有前面都做过了，才把字号下调 4–6px

字幕事件拆分规则

• 一条字幕如果会渲染成三行，必须拆成两个连续字幕事件
• 拆分优先点：，、。、？、！
• 拆分后每个事件目标为 1–2 行
• 不要为了保留原始整句而接受三行大字幕

位置调整规则

默认位置

• safe-area：MarginV = 560–680
• cover-original-no-mask：MarginV = 96–140

用户说“别挡到底部按钮 / 商品卡 / CTA”

只对 safe-area 生效：

• MarginV = 680–820
• 重度遮挡时可到 820–960

用户说“字幕太高了，想压低一点”

• safe-area：优先调到 480–560
• cover-original-no-mask：优先调到 88–118

用户说“别挡脸 / 别挡嘴部 / 别挡人物胸口”

优先处理顺序：

1. 先上移 MarginV
2. 再缩短每行长度
3. 再考虑略微缩字号

用户说“要盖住原视频自带字幕”

优先处理顺序：

1. 切到 cover-original-no-mask
2. 让字幕回到底部原字幕区域：MarginV = 88–140
3. 提大字号到 98–106
4. 把 MaxLineLength 收紧到 6–8
5. 如仍会三行，拆分成多个事件

失败判定

出现以下任一情况，说明参数方案失败，必须重做：

1. 新字幕变成三行或更多行
2. 新字幕超宽或被画面边缘裁切
3. cover-original-no-mask 下字幕仍然太小，视觉上压不住旧字幕
4. 回答里默认又加回了遮罩、底板、黑条或背景滤镜

ASS 建议参数

安全区上移模式

Style: Default,PingFang SC,86,&H00FFFFFF,&H000000FF,&H00000000,&H66000000,-1,0,0,0,100,100,0,0,1,4,1,2,72,72,600,1

原字幕压住模式（无遮罩）

Style: Default,PingFang SC,98,&H00FFFFFF,&H000000FF,&H00000000,&H00000000,-1,0,0,0,100,100,0,0,1,3,0,2,92,92,118,1

重点：

• 不使用背景色来做底板
• 保留适度描边保证可读性
• 靠字号、位置、分句来尽量压住旧字幕

FFmpeg 烧录示例

ffmpeg -y -i "IN.mp4" -vf "subtitles='SUB.ass'" \
  -c:v libx264 -preset medium -crf 19 \
  -c:a aac -b:a 128k -map 0:v:0 -map 0:a? -movflags +faststart "OUT.mp4"

说明：

• 当前版本不附加 drawbox 或其它背景滤镜
• 如果用户之前已经用了遮罩，当前应先移除遮罩，再单独调字幕参数

常见决策

口播 / talking head

• 使用 safe-area
• MarginV = 700–900
• MaxLineLength = 10–12

原片有自带底部字幕，但先不做遮罩

• 使用 cover-original-no-mask
• FontSize = 98–106
• MarginV = 88–140
• MaxLineLength = 6–8
• 超过两行就拆事件

用户直接说“字幕参数可以了，把遮罩去掉”

• 保留当前字幕参数方向
• 移除所有背景、底板、黑条、drawbox
• 只输出无遮罩版本的 .ass 样式或 FFmpeg 命令

输出要求

使用这个 skill 时，最终回答应包含：

1. 当前判定为竖屏的依据（分辨率或用户说明）
2. 当前选择的是 safe-area 还是 cover-original-no-mask，以及原因
3. 最终采用的字幕参数
4. 是否做了拆句/拆事件来避免三行
5. 明确说明：当前版本已移除遮罩，只保留字幕参数优化
6. 可直接使用的 .ass 样式或 FFmpeg 命令
7. 输出路径或建议输出文件名