feat: #1789 标题 drawtext 滤镜渲染 — 单视频+批量生成都生效 #1792

Merged

auto-approve-bot merged 3 commits from feat/title-drawtext-1789 into develop 2026-09-08 13:14:13 +08:00

Conversation 2 Commits 3 Files Changed 4

+541 -2

xiaoxia commented 2026-09-08 12:49:44 +08:00

Owner

Copy Link

Copy Source

背景

#1789 标题设置中字号滑块和样式切换后，生成的视频中标题配置没有生效。

改动

packages/domain/video_filter_builder.py

• 新增 build_title_drawtext_filter() — 从 title_config 生成 FFmpeg drawtext 滤镜
• 支持 position（top/center/bottom/custom+pos_x/pos_y）
• 支持 font_size / font_color / bold / stroke / shadow
• 字段名归一化：兼容前端两套命名（content↔text、font_preset↔font、size↔font_size、color↔font_color）
• drawtext 特殊字符转义（: ' %）
• 字体搜索路径（Noto Sans CJK → DejaVu 降级）

apps/api/app/services/video_compose_service.py

• build_compose_command() 从 plan.config 读取 title_config（兼容 title / title_config 两个 key）
• drawtext 滤镜链入 filter_complex：[outv] → [composed] → drawtext → [outv]
• 单视频和批量生成共用同一 compose 路径，标题都能生效

tests/unit/domain/test_title_drawtext_1789.py

• 26 新测试覆盖：基本参数、位置、样式、字段归一化、特殊字符转义、输出尺寸

与 ASS 字幕路径的关系

UnifiedRenderService 使用 ASS 字幕渲染标题（已有完整实现），本 PR 新增的 drawtext 滤镜用于 VideoComposeService.build_compose_command() 路径，两条路径互补。前端 TitleSettings 的样式参数在 drawtext 路径中完整映射到 FFmpeg 参数。

## 背景 #1789 标题设置中字号滑块和样式切换后，生成的视频中标题配置没有生效。 ## 改动 ### packages/domain/video_filter_builder.py - 新增 build_title_drawtext_filter() — 从 title_config 生成 FFmpeg drawtext 滤镜 - 支持 position（top/center/bottom/custom+pos_x/pos_y） - 支持 font_size / font_color / bold / stroke / shadow - 字段名归一化：兼容前端两套命名（content↔text、font_preset↔font、size↔font_size、color↔font_color） - drawtext 特殊字符转义（: ' %） - 字体搜索路径（Noto Sans CJK → DejaVu 降级） ### apps/api/app/services/video_compose_service.py - build_compose_command() 从 plan.config 读取 title_config（兼容 title / title_config 两个 key） - drawtext 滤镜链入 filter_complex：[outv] → [composed] → drawtext → [outv] - 单视频和批量生成共用同一 compose 路径，标题都能生效 ### tests/unit/domain/test_title_drawtext_1789.py - 26 新测试覆盖：基本参数、位置、样式、字段归一化、特殊字符转义、输出尺寸 ## 与 ASS 字幕路径的关系 UnifiedRenderService 使用 ASS 字幕渲染标题（已有完整实现），本 PR 新增的 drawtext 滤镜用于 VideoComposeService.build_compose_command() 路径，两条路径互补。前端 TitleSettings 的样式参数在 drawtext 路径中完整映射到 FFmpeg 参数。

xiaoxia added 1 commit 2026-09-08 12:49:45 +08:00

feat: #1789 标题 drawtext 滤镜渲染 — 单视频+批量生成都生效 ... 4513f82fb1

在 video_filter_builder.py 新增 build_title_drawtext_filter()：
- 从 title_config 生成 FFmpeg drawtext 滤镜
- 支持 position(top/center/bottom/custom+pos_x/pos_y)
- 支持 font_size/font_color/bold/stroke/shadow
- 字段名归一化：兼容 content↔text、font_preset↔font、size↔font_size、color↔font_color
- 特殊字符转义（:/'%）
- 字体搜索路径（Noto Sans CJK 优先）

在 video_compose_service.py build_compose_command() 集成：
- 从 plan.config 读取 title_config（兼容 title/title_config 两个 key）
- drawtext 滤镜链入 filter_complex（[composed]→drawtext→[outv]）
- 单视频和批量生成共用同一 compose 路径，标题都能生效

26 新测试覆盖：基本参数/位置/样式/字段归一化/特殊字符转义/输出尺寸

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

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

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

test: #1789 补充 drawtext 滤镜分支覆盖率 — 40 个新测试 ... 53f17db0a7

- _escape_drawtext_text 直接测试（6 用例）
- _resolve_font_path mock 字体搜索/fallback/无字体（6 用例）
- build_title_drawtext_filter 全分支覆盖：font_path 存在/不存在、stroke 各类型、shadow 各类型、bold、位置各模式、字段归一化（23 用例）
- video_compose_service 标题集成测试（5 用例）：drawtext 注入、title_config 回退、非 dict 容错

目标：CI diff coverage 从 17% 提升到 ≥40%

xiaoxia added 1 commit 2026-09-08 13:07:52 +08:00

test: #1789 将 drawtext 测试合并到 CI 映射的测试文件 ... 51b1556f8b

CI 增量测试模式只运行与变更源文件映射的测试文件：
- video_filter_builder.py → test_video_filter_builder.py
- video_compose_service.py → test_video_compose_service.py

之前独立测试文件 (test_title_drawtext_*.py) 未被映射所以被跳过，
导致 diff coverage 始终只有 17%。

本次改动：
- 37 个 drawtext 测试合并到 test_video_filter_builder.py
- 5 个 compose 标题集成测试合并到 test_video_compose_service.py
- _StubPlan 新增 config 参数支持
- 删除独立测试文件（不再需要）

共 155 个测试全部通过。

auto-approve-bot merged commit 9dec75c365 into develop 2026-09-08 13:14:13 +08:00

auto-approve-bot deleted branch feat/title-drawtext-1789 2026-09-08 13:14:14 +08:00

gitea-actions bot commented 2026-09-08 13:14:52 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

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 frontend-dev xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1792