fix(ai-avatar): B-roll时间戳/标题重影/TTS卡死防护 #1873

Merged

xiaoxia merged 4 commits from fix/ai-avatar-broll-title-worker-issues into develop 2026-09-12 22:37:12 +08:00

Conversation 2 Commits 4 Files Changed 7

+212 -68

xiaoxia commented 2026-09-12 21:09:33 +08:00

Owner

Copy Link

Copy Source

修复项

1. B-roll 时间全 0.0~0.0s（P0）：sentences.ts 优先使用后端 sentence_timings，修正参数顺序与 ModalBRollEditor 调用对齐；之前后端虽然返回了精确时间戳，但前端 splitScriptIntoSentences(text, timings, duration) 的第二/三参数错位，导致时间被忽略而全部走默认0估算。

2. 标题重影（P0）：bold=true 时原本用 borderw=3 + 同色描边 模拟粗体，在竖屏小字号上会产生字形偏移，视觉上像文字被打印了两次（用户截图中“曝光曝光…”重影）。改为黑色细描边 borderw=2, black，加粗清晰且不重影。

3. 对口型卡 tts_processing 10+ 分钟不失败（P0）：给 Celery TTS 任务加 soft_time_limit=180s / time_limit=200s，防止因网络/CosyVoice异常导致任务永久挂起；任务开头加 INFO 日志（job_id/voice_id/text_len）便于排查 worker 是否真的收到任务。

测试

• Python 单测 74 passed（ai_avatar_render/lipsync_tts/ai_avatar_render_routes）
• video_filter_builder 单测 110 passed
• 前端 tsc 无新增错误

关联

staging 用户反馈 5 问题中 1/2/3 项修复；带宽问题（问题4）将另行评估；问题5用户未写完。

## 修复项 1. **B-roll 时间全 0.0~0.0s（P0）**：sentences.ts 优先使用后端 `sentence_timings`，修正参数顺序与 ModalBRollEditor 调用对齐；之前后端虽然返回了精确时间戳，但前端 `splitScriptIntoSentences(text, timings, duration)` 的第二/三参数错位，导致时间被忽略而全部走默认0估算。 2. **标题重影（P0）**：bold=true 时原本用 `borderw=3 + 同色描边` 模拟粗体，在竖屏小字号上会产生字形偏移，视觉上像文字被打印了两次（用户截图中“曝光曝光…”重影）。改为黑色细描边 `borderw=2, black`，加粗清晰且不重影。 3. **对口型卡 tts_processing 10+ 分钟不失败（P0）**：给 Celery TTS 任务加 `soft_time_limit=180s / time_limit=200s`，防止因网络/CosyVoice异常导致任务永久挂起；任务开头加 INFO 日志（job_id/voice_id/text_len）便于排查 worker 是否真的收到任务。 ## 测试 - Python 单测 74 passed（ai_avatar_render/lipsync_tts/ai_avatar_render_routes） - video_filter_builder 单测 110 passed - 前端 tsc 无新增错误 ## 关联 staging 用户反馈 5 问题中 1/2/3 项修复；带宽问题（问题4）将另行评估；问题5用户未写完。

xiaoxia added 1 commit 2026-09-12 21:09:34 +08:00

fix(ai-avatar): B-roll时间戳、标题粗体重影、TTS卡死防护 ... a83b53ae58

1. B-roll时间戳全0修复：
   - sentences.ts 新增 sentenceTimings 参数优先使用后端精确时间戳，
     降级才按字数比例估算
   - 修正参数顺序，与 ModalBRollEditor 现有调用 (scriptText, timings, duration) 对齐
   - 前端 AiAvatarPage 已通过 props 传 sentenceTimings（旧版已传但因顺序错位被忽略）

2. 标题粗体重影修复：
   - 之前 bold=true 时使用 borderw=3 + font_color 同色描边模拟粗体，
     会在小字号/竖屏视频上造成字形边缘偏移，视觉上文字像被打印了两次
     （用户截图中的'曝光曝光…'重影）
   - 改为黑色细描边（borderw=2, 黑色），既保留清晰加粗效果又不重影
   - 用户显式开启 stroke 时仍按用户配置走
   - 新增 _resolve_font_path(bold=True) 预留粗体字体查找能力（当前镜像
     无独立 Bold 字体文件，沿用 VF 常规字重）

3. TTS 任务防卡死：
   - 给 tts_synthesize_and_submit 加 soft_time_limit=180s / time_limit=200s，
     避免因网络/上游问题导致 Celery 任务永久挂起（用户之前卡10+分钟
     tts_processing 不失败）
   - 任务开头加 INFO 日志（job_id/voice_id/text_len），方便排查 worker
     是否真的收到任务

相关：staging 用户反馈 5 问题中的 1/2/3 项（B-roll时间、标题重影、对口型卡死）

gitea-actions bot commented 2026-09-12 21:12:05 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

xiaoxia added 1 commit 2026-09-12 21:40:13 +08:00

test(ai-avatar): 补充B-roll/标题单测，修正断言 831075a9c0

xiaoxia added 1 commit 2026-09-12 21:59:18 +08:00

fix(lipsync): 修复Celery事务竞态导致job永远卡在tts_processing（P0） ... 2fa6de29bc

根因：create_job() 先 apply_async() 发送 Celery 任务，再 db.commit() 提交事务。
worker 是独立进程+独立DB连接，任务<4ms就被消费，但此时 API 事务还未 commit，
worker 查询 job 返回 None → 静默 return 不重试 → job 永远卡在 tts_processing。

修复：
1. API侧（lipsync_service.py）：先 db.commit()+db.refresh(job)，再 apply_async() 发任务；
   投递失败/MediaKit提交失败分支也各自 commit，确保状态及时落库。
2. Worker侧（lipsync_tts.py）：job not found 时改用 self.retry() 递增重试3次
   （1s/3s/7s退避），作为竞态场景的第二道防线；
   增加 autoretry_for=(OSError, ConnectionError) 自动重试网络抖动；
   max_retries 从2调整到5。

子agent在staging实锤：受影响job共5个，手工重投递后全部3秒内完成TTS+提交MediaKit，
证实TTS本身只需要2秒，卡顿完全是因为竞态。

单测：新增 TestCreateJobCommitOrder 验证 commit 在 apply_async 之前。

auto-approve-bot added 1 commit 2026-09-12 22:10:27 +08:00

style: auto-format with black + isort + ruff + prettier [skip ci-format-check] 1a4f475fbf

xiaoxia merged commit 4a93aaaf4c into develop 2026-09-12 22:37:12 +08:00

gitea-actions bot commented 2026-09-12 22:38:10 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1873