# 通用规格

> 所有风格共用的「硬参数」和「出片前检查」。先看这里，再进具体风格卡。

---

## 一、画幅与交付矩阵

| 风格 | 画幅 | 成片分辨率 | 帧率 | 时长 | 音频 | 字幕 |
|---|---|---|---|---|---|---|
| S01 纸张拼贴 | 16:9 | 1920×1080 | 与素材一致（24/30） | 25s–2min | 有 | 烧入 |
| S02 暖木档案桌 | 9:16 | 1080×1920 | 30 | 3–5min | 有 | 烧入 |
| S03 微缩定格 | 4:3 | 960×720 | 30 | 2–3min | 有 | 烧入 |
| S04 双轨史诗 | 16:9 | 1920×1080 | 30 | 3min | 有 | 双轨 ASS |
| S05 黑金解说 | 16:9 | 1920×1080 | 30 | 5min | 纯画面无音轨 | 无 |
| S06 暖棕长解说 | 16:9 | 1920×1080 | 30 | 5–8min | 纯画面无音轨 | 无 |
| S07 巨字卡点 | 16:9 | 1920×1080 | 30 | 60s | BGM | 无 |
| S08 设备发布 | 16:9 | 1920×1080 | 30 | 45s | 无 | 无 |
| S09 暗室档案馆 | 9:16 / 16:9 | 1080×1920 / 1920×1080 | 30 | 45–150s | 有 | 烧入 |
| S10 胶片化 | 任意 | 跟随源 | 跟随源 | 跟随源 | 保留 | 不处理 |
| S11 AI 漫剧 | 21:9 | 3840×1646 / 2560×1080 | 24 | 3.5min | 音乐+环境 | 仅片名/片尾 |

## 二、字幕规格

| 风格 | 字体 | 字号 | 颜色 | 描边/阴影 | 位置 |
|---|---|---|---|---|---|
| S01 | 微软雅黑 | 46 | 白 | 1px 黑边 | 底部居中 MarginV 30 |
| S02 | Noto Sans SC | 44 | 白 | 2–3 层黑投影 | 左对齐 x=78 / bottom=116 |
| S03 | STSong（中）/ Arial（英） | 跟随 960×720 | 米白 / 金 / 蓝 / 橙红 | 2px 深色 outside + 阴影 | 底部 |
| S04 | 微软雅黑 | 84 | 金 `#F5F090` / 白 / 红 `#D8423C` | 3.2px 黑边 + 1.8 阴影 | 金 y=724 / 白 y=965（1080p） |
| S05 | 无 | — | — | — | 纯画面 |
| S06 | 微软雅黑 | 64 | 白 | 无描边 | 底部 MarginV 123（底沿 87.8%） |
| S07 | 无 | — | — | — | 纯画面 |
| S08 | 无 | — | — | — | 纯画面 |
| S09 | Noto Sans SC | 44–52 | 纸白 | 2px 深色投影 45% | 竖屏距底 300 / 横屏 120 |
| S10 | 不处理 | — | — | — | — |
| S11 | 仅片名/片尾 | — | 暗红 | — | 居中 |

**通用规则**：
- 单行不超过 13 字；超过按语义断行，不按字数断。
- 关键词只标一个；不要整句变色。
- 字幕不得压脸、压关键道具、压 UI 文字。
- 竖屏底部安全区 ≥220px；横屏左右安全区 ≥180px。

## 三、声音

| 项 | 标准 |
|---|---|
| 旁白响度 | −16 LUFS（S01–S08、S10）；S09 −14 LUFS |
| 真峰值 | ≤ −1.5 dBTP |
| BGM | 比人声低 18–22dB；侧链 ducking |
| 停顿 | 句间 0.3–0.7s；段落间 0.8–1.2s；结尾 1.2–2.0s |
| 语速 | 解说 228–300 字/分；人物史诗 283–300；黑金 417；S09 5.5–6.2 字/秒 |
| 音效 | 全片 ≤4 次/种；转场 whoosh、重音 impact、开场 sub-drop |

**两遍 loudnorm**：

```bash
# 第一遍：测量
ffmpeg -i in.wav -af loudnorm=I=-16:TP=-1.5:LRA=11:print_format=json -f null NUL
# 第二遍：带测量值 + linear=true
ffmpeg -i in.wav -af loudnorm=I=-16:TP=-1.5:LRA=11:measured_I=...:measured_TP=...:measured_LRA=...:measured_thresh=...:offset=...:linear=true -ar 48000 out.wav
```

## 四、出片前必查（通用）

- [ ] `ffprobe` 分辨率/帧率/时长与目标一致
- [ ] 帧数 = round(时长 × 帧率)，差 ≤2 帧
- [ ] 全量解码：`ffmpeg -v error -i out.mp4 -f null NUL` 退出码 0
- [ ] 黑帧扫描：0 处（或已知且有意）
- [ ] 抽 6 帧拼图：无黑帧、无错位、无字体回退、无字幕溢出
- [ ] 字幕最大同屏 ≤2 条（S04）
- [ ] 影调与参考/前作同方法对照（不看绝对值，看是不是一个调）
- [ ] 音频：人声清晰、BGM 不抢字、无爆音
- [ ] 文件命名：`主题_平台_版本_日期`，不要「最终版最终真的最终」

## 五、本机工具与坑

| 工具 | 路径 / 命令 | 备注 |
|---|---|---|
| ffmpeg / ffprobe | PATH 可用 | 统一 `-nostdin -y`；Windows 没有 `-pattern_type glob` |
| Python（带 Pillow） | `C:\Users\34137\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe` | PATH 里的 `python` 是空壳 |
| Pillow | 同上 | 预览图生成用 |
| Hypit | `hypit` / `hypit.cmd` | S02/S07 组件渲染 |
| Node | `C:\Users\34137\tools\node-v24.19.0-win-x64` | HyperFrames / CDP |
| 字体 | `C:\Windows\Fonts\msyhbd.ttc`、`simsun.ttc`、`STSONG.TTF` | 中文字体 |

**高频坑**：
- git-bash 下 `curl -o /dev/null` 退出码 23 → 用 `-o NUL`。
- 写 `.bat` 要 GBK + CRLF；写 `.ps1` 用无 BOM；脚本文本一律 LF + UTF-8。
- 长任务用后台运行；timeout 只停等待，不杀进程。
- `colorchannelmixer` 位置参数必须 16 个值；命名参数安全。
- `loudnorm` 单遍不准；两遍法。
- x264 会裁末帧；加 `tpad` 补足。
- 素材下载后全量解码校验；限流会产出「大小正常但深处坏」的静默截断文件。
