guanghulab/video-ai-system/experience/D144-SUBTITLE-PIPELINE-SMOKE.hdlp
冰朔 81d8a3905f
Some checks failed
自动更新代码和重启 / update-and-restart (push) Has been cancelled
CI检查 + 自动部署 / check (push) Has been cancelled
CI检查 + 自动部署 / deploy (push) Has been cancelled
docs: smoke test subtitle pipeline tools
2026-06-24 13:15:51 +08:00

93 lines
2.2 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# D144 · 字幕工业化工具链快速验收
> HLDP://video-ai-system/experience/D144-SUBTITLE-PIPELINE-SMOKE
> 日期: 2026-06-24
> 范围: 腾讯AI提交的字幕工业化流水线 8 大工具
> 结论: 入口与基础 ASS 生成通过;尚未完成烧录后视觉对标验收。
---
## 覆盖文件
```
assets/subtitle-styles/subtitle-style.reference-drama.json
engines/subtitle-pipeline/reference-analysis/reference-subtitle-analyzer.py
engines/subtitle-pipeline/reference-analysis/ass-subtitle-renderer.py
engines/subtitle-pipeline/font-manager/subtitle-font-manager.py
engines/subtitle-pipeline/qc-tools/subtitle-safe-area-qc.py
engines/subtitle-pipeline/preview-tools/subtitle-preview-contact-sheet.py
engines/subtitle-pipeline/ab-test-tools/subtitle-style-ab-test.py
engines/subtitle-pipeline/srt-tools/script-to-srt-with-timing.py
```
---
## 快速验收
```
syntax_check: PASS
help_entrypoints: PASS
minimal_srt_to_ass: PASS
burned_video_visual_qc: NOT_RUN
sample_match_to_reference: NOT_RUN
```
实测最小样例:
```
input: /tmp/subtitle-smoke.srt
output: /tmp/subtitle-smoke.ass
style: reference-drama
result: 1条字幕成功生成ASS
```
生成样式要点:
```
font: PingFang SC
font_size: 38
bold: true
primary_colour: white
outline: 2
shadow: 0
alignment: bottom_center
margin_v: 50
canvas: 1080x1920
```
---
## 依赖提示
```
fonttools: optional_missing
face-recognition: optional_missing
ultralytics: optional_missing
```
说明:
- 缺 `fonttools` 时字体中文覆盖率验证会降级。
- 缺 `face-recognition` / `ultralytics` 时安全区 QC 使用简化检测。
---
## 尚未验收
```
not_verified:
- reference-subtitle-analyzer 对真实样片截图的自动量化是否准确
- ASS 烧录到视频后的观感是否与《渔乡守真心》字幕标准一致
- 安全区 QC 是否能正确识别人脸/身体遮挡
- A/B 工具是否能稳定输出对比预览
- 字幕颜色、描边、字号、底部距离是否需要继续校准
```
---
## 结论
```
字幕工业化工具链可以进入下一步真实样片对标测试。
当前不能直接宣布“字幕标准已完成”只能说“工具入口可用ASS基础生成通过”。
```