fix: ASR字幕路径叠加标题，修复封面没有标题的问题 #1374

Merged

xiaoxia merged 4 commits from fix/cover-title-asr-path into develop 2026-08-15 14:21:09 +08:00

Conversation 5 Commits 4 Files Changed 3

+381 -3

xiaoxia commented 2026-08-15 13:49:35 +08:00

Owner

Copy Link

Copy Source

根因

1. _maybe_generate_ass 的 ASR 路径直接 return，跳过了 generate_ass_subtitles()（负责标题叠加），导致 ASR 字幕生成的 ASS 文件中没有标题
2. generation.py 设置 auto_generated=True 但未设置 enabled=True，导致模板 subtitle.enabled=false 时 ASR 路径从未被触发

修复

unified_render_service.py

• ASR 路径生成 ASS 后，调用 _overlay_title_on_ass() 追加标题事件
• ASR 无结果/失败时，如有标题仍降级生成标题 ASS
• 新增 _overlay_title_on_ass() 辅助函数：复用 build_ass_content 生成 TitleStyle + Dialogue，插入到 ASR 生成的 ASS 文件中

generation.py

• voice_ids 注入时同步设置 subtitle_cfg["enabled"] = True

测试

• 新增 6 个测试覆盖：标题叠加到 ASR ASS、空标题 noop、ASR 保留原有事件、ASR+标题集成、ASR 无结果降级标题、ASR 失败降级标题
• 全量 13651 passed

## 根因 1. `_maybe_generate_ass` 的 ASR 路径直接 `return`，跳过了 `generate_ass_subtitles()`（负责标题叠加），导致 ASR 字幕生成的 ASS 文件中没有标题 2. `generation.py` 设置 `auto_generated=True` 但未设置 `enabled=True`，导致模板 `subtitle.enabled=false` 时 ASR 路径从未被触发 ## 修复 ### unified_render_service.py - ASR 路径生成 ASS 后，调用 `_overlay_title_on_ass()` 追加标题事件 - ASR 无结果/失败时，如有标题仍降级生成标题 ASS - 新增 `_overlay_title_on_ass()` 辅助函数：复用 `build_ass_content` 生成 TitleStyle + Dialogue，插入到 ASR 生成的 ASS 文件中 ### generation.py - `voice_ids` 注入时同步设置 `subtitle_cfg["enabled"] = True` ## 测试 - 新增 6 个测试覆盖：标题叠加到 ASR ASS、空标题 noop、ASR 保留原有事件、ASR+标题集成、ASR 无结果降级标题、ASR 失败降级标题 - 全量 13651 passed

xiaoxia added 1 commit 2026-08-15 13:49:35 +08:00

fix: ASR字幕路径叠加标题，修复封面没有标题的问题 ... 17761124c2

根因：
1. _maybe_generate_ass 的 ASR 路径直接 return，跳过了 generate_ass_subtitles()
   （负责标题叠加），导致 ASR 字幕生成的 ASS 文件中没有标题
2. generation.py 设置 auto_generated=True 但未设置 enabled=True，
   导致模板 subtitle.enabled=false 时 ASR 路径从未被触发

修复：
- unified_render_service.py:
  - ASR 路径生成 ASS 后，调用 _overlay_title_on_ass() 追加标题事件
  - ASR 无结果/失败时，如有标题仍降级生成标题 ASS
  - 新增 _overlay_title_on_ass() 辅助函数：复用 build_ass_content
    生成 TitleStyle + Dialogue，插入到 ASR 生成的 ASS 文件中
- generation.py:
  - voice_ids 注入时同步设置 subtitle_cfg['enabled'] = True

新增 6 个测试，全量 13651 passed

gitea-actions bot commented 2026-08-15 13:51:08 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1374
预览链接	https://pr-1374.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1374 | | 预览链接 | [https://pr-1374.preview.xiaoxiajianji.com](https://pr-1374.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot added 1 commit 2026-08-15 13:53:35 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 486fa7b20d

xiaoxia added 1 commit 2026-08-15 14:04:34 +08:00

fix: ruff E741 - rename ambiguous variable 'l' to 'ln' in test_overlay_title_on_ass 3d9e084a32

auto-approve-bot approved these changes 2026-08-15 14:10:31 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-15 14:10:32 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia added 1 commit 2026-08-15 14:14:51 +08:00

fix: 隔离_overlay_title_on_ass异常，防止ASR数据被覆盖 ... 25873c0b89

AI Review发现：_overlay_title_on_ass在ASR的try块内，如果叠加标题失败，
会进入except分支覆盖已生成的ASR字幕数据。

修复：用独立try-except包裹_overlay_title_on_ass调用，叠加失败时
记录warning但保留ASR生成的ASS文件。

新增测试：test_overlay_failure_preserves_asr_data 验证叠加失败时
ASR数据完整保留。

auto-approve-bot commented 2026-08-15 14:19:21 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #1374

⚠️ 问题（2个需要修改）

1. apps/worker/video_processing/unified_render_service.py 第171行：索引计算逻辑错误，当 ASS 文件中不存在 [Events] 段或 Format: Layer, 行（即 events_format_idx 为 -1）时，执行 events_format_idx += 1 会导致索引变为 0。随后的插入操作会将标题 Dialogue 错误地插入到文件头部（如 [Script Info] 之后），导致 ASS 文件结构损坏，字幕无法正常渲染。
2. apps/worker/worker_app/tasks/generation.py 第1208行：强制将 subtitle_cfg["enabled"] 设为 True 会覆盖用户的配置。如果用户明确配置了“不显示字幕”但配置了“显示标题”，此修改会导致系统强制生成 ASR 字幕并显示，违背了用户意图，属于功能逻辑错误。

💡 建议（1个可选）

1. apps/worker/video_processing/unified_render_service.py 第179行：使用 splitlines() 再 "\n".join() 会统一换行符为 \n。如果原文件是 Windows 风格（\r\n），写入后会被改变。建议在读取时记录换行符类型或统一使用 \r\n（ASS 标准通常兼容），以避免 Git diff 出现大量换行符变更或某些严格播放器的兼容性问题。

---

✅ 格式检查通过 | ❌ 逻辑审查需修改 | ⚠️ 建议关注性能

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-15 06:19:21 | 模型:}

## 代码审查结果 - PR #1374 ### ⚠️ 问题（2个需要修改） 1. **apps/worker/video_processing/unified_render_service.py 第171行**：索引计算逻辑错误，当 ASS 文件中不存在 `[Events]` 段或 `Format: Layer,` 行（即 `events_format_idx` 为 -1）时，执行 `events_format_idx += 1` 会导致索引变为 0。随后的插入操作会将标题 Dialogue 错误地插入到文件头部（如 `[Script Info]` 之后），导致 ASS 文件结构损坏，字幕无法正常渲染。 2. **apps/worker/worker_app/tasks/generation.py 第1208行**：强制将 `subtitle_cfg["enabled"]` 设为 `True` 会覆盖用户的配置。如果用户明确配置了“不显示字幕”但配置了“显示标题”，此修改会导致系统强制生成 ASR 字幕并显示，违背了用户意图，属于功能逻辑错误。 ### 💡 建议（1个可选） 1. **apps/worker/video_processing/unified_render_service.py 第179行**：使用 `splitlines()` 再 `"\n".join()` 会统一换行符为 `\n`。如果原文件是 Windows 风格（`\r\n`），写入后会被改变。建议在读取时记录换行符类型或统一使用 `\r\n`（ASS 标准通常兼容），以避免 Git diff 出现大量换行符变更或某些严格播放器的兼容性问题。 --- ✅ 格式检查通过 | ❌ 逻辑审查需修改 | ⚠️ 建议关注性能 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-15 06:19:21 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit d7bc908ed3 into develop 2026-08-15 14:21:09 +08:00

gitea-actions bot commented 2026-08-15 14:21:38 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1374 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1374 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1374