fix: 统一前后端标题渲染参数，修复描边/阴影样式丢失 #1393

Merged

auto-approve-bot merged 3 commits from fix/title-render-consistency into develop 2026-08-16 19:01:05 +08:00

Conversation 5 Commits 3 Files Changed 2

+239 -3

xiaoxia commented 2026-08-16 18:39:28 +08:00

Owner

Copy Link

Copy Source

问题

预览标题（前端Canvas）与生成视频标题（后端ASS）渲染效果不一致。

根因

1. stroke/shadow 类型不匹配：前端发送 boolean (true/false)，后端期望 dict ({enabled,color,width}) → 样式被丢弃
2. 字号不一致：前端上限 36px，后端默认 48px
3. 描边宽度不一致：前端 2px，后端默认 1px

修复

• packages/domain/ass_subtitle_builder.py:
  • boolean stroke/shadow 自动转换为标准 dict（与前端参数对齐）
  • stroke=true → {enabled:true, color:#000, width:2}
  • shadow=true → {enabled:true, color:#000, blur:4, offset:2}
  • 字号上限 48→36（与前端一致）
  • 描边宽度默认 1→2（与前端一致）
• tests/unit/test_title_render_consistency.py — 11个新测试验证一致性

改动文件

• packages/domain/ass_subtitle_builder.py — boolean→dict 标准化 + 默认值修正 (+24 -3)
• tests/unit/test_title_render_consistency.py — 11个新测试 (+181)

## 问题 预览标题（前端Canvas）与生成视频标题（后端ASS）渲染效果不一致。 ## 根因 1. stroke/shadow 类型不匹配：前端发送 boolean (true/false)，后端期望 dict ({enabled,color,width}) → 样式被丢弃 2. 字号不一致：前端上限 36px，后端默认 48px 3. 描边宽度不一致：前端 2px，后端默认 1px ## 修复 - packages/domain/ass_subtitle_builder.py: - boolean stroke/shadow 自动转换为标准 dict（与前端参数对齐） - stroke=true → {enabled:true, color:#000, width:2} - shadow=true → {enabled:true, color:#000, blur:4, offset:2} - 字号上限 48→36（与前端一致） - 描边宽度默认 1→2（与前端一致） - tests/unit/test_title_render_consistency.py — 11个新测试验证一致性 ## 改动文件 - packages/domain/ass_subtitle_builder.py — boolean→dict 标准化 + 默认值修正 (+24 -3) - tests/unit/test_title_render_consistency.py — 11个新测试 (+181)

xiaoxia added 1 commit 2026-08-16 18:39:28 +08:00

fix: 统一前后端标题渲染参数，修复描边/阴影样式丢失 ... a9b93cc220

根因：
1. 前端 TitleSettings 发送 stroke/shadow 为 boolean (true/false)，
   后端 build_ass_content 期望 stroke={enabled,color,width} dict 格式
   → 类型不匹配导致描边/阴影样式被丢弃
2. 前端字号上限 Math.min(size,36)，后端默认48 → 字号不一致
3. 前端描边宽度2px，后端默认1px

修复：
- ass_subtitle_builder.py: boolean stroke/shadow 自动转换为标准dict
  stroke=true → {enabled:true, color:#000, width:2}
  shadow=true → {enabled:true, color:#000, blur:4, offset:2}
- 字号上限从48改为36（与前端一致）
- 描边宽度默认从1改为2（与前端一致）
- 11个新测试验证前后端样式一致性

auto-approve-bot added 1 commit 2026-08-16 18:43:53 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 02d2c7ea65

auto-approve-bot commented 2026-08-16 18:45:37 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：1 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

1. [packages/domain/ass_subtitle_builder.py: 254, 262] 避免直接修改传入的可变参数
   • 具体内容：代码中直接对 title_config 字典进行了修改（如 title_config["stroke"] = ...）。虽然在当前上下文中可能不会导致问题，但直接修改函数传入的可变参数（字典）会产生副作用，如果调用方在函数调用后继续使用该配置对象，可能会遇到意外的数据结构变化。建议在函数开始时使用 copy.deepcopy(title_config) 创建副本，或者在修改前明确知晓此副作用并添加注释说明。

✅ 良好实践

1. 测试覆盖全面：新增的测试文件 test_title_render_consistency.py 很好地覆盖了新旧格式兼容、边界值（如字号上限）以及默认值逻辑，确保了前后端行为的一致性。
2. 逻辑清晰：布尔值到字典的转换逻辑使用了三元表达式，简洁明了，正确处理了 True（填充默认值）和 False（仅保留 enabled 键）两种情况。
3. 默认值统一：将字号的默认值从 48 调整为 36 并设置上限，与前端逻辑保持一致，避免了渲染效果不匹配的问题。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-16 10:45:37 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：1 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 1. **[packages/domain/ass_subtitle_builder.py: 254, 262] 避免直接修改传入的可变参数** - 具体内容：代码中直接对 `title_config` 字典进行了修改（如 `title_config["stroke"] = ...`）。虽然在当前上下文中可能不会导致问题，但直接修改函数传入的可变参数（字典）会产生副作用，如果调用方在函数调用后继续使用该配置对象，可能会遇到意外的数据结构变化。建议在函数开始时使用 `copy.deepcopy(title_config)` 创建副本，或者在修改前明确知晓此副作用并添加注释说明。 ### ✅ 良好实践 1. **测试覆盖全面**：新增的测试文件 `test_title_render_consistency.py` 很好地覆盖了新旧格式兼容、边界值（如字号上限）以及默认值逻辑，确保了前后端行为的一致性。 2. **逻辑清晰**：布尔值到字典的转换逻辑使用了三元表达式，简洁明了，正确处理了 `True`（填充默认值）和 `False`（仅保留 enabled 键）两种情况。 3. **默认值统一**：将字号的默认值从 48 调整为 36 并设置上限，与前端逻辑保持一致，避免了渲染效果不匹配的问题。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-16 10:45:37 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia added 1 commit 2026-08-16 18:52:05 +08:00

fix: rename ambiguous variable 'l' to 'line' in tests (E741) ... 2f7789f10b

Fix 8 flake8 E741 errors in test_title_render_consistency.py
where list comprehension used 'l' as variable name.

gitea-actions bot commented 2026-08-16 18:54:41 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot approved these changes 2026-08-16 19:00:34 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-16 19:00:34 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot merged commit 16767f675b into develop 2026-08-16 19:01:05 +08:00

auto-approve-bot deleted branch fix/title-render-consistency 2026-08-16 19:01:05 +08:00

gitea-actions bot commented 2026-08-16 19:01:57 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

xiaoxia referenced this issue from a commit 2026-08-16 19:11:30 +08:00

test: add API-level tests for preview edit_plan auto-association

xiaoxia referenced this issue from a commit 2026-08-16 21:49:27 +08:00

fix: update test_title_font_size assertion for PR #1393 font cap

xiaoxia referenced this pull request 2026-08-16 21:49:36 +08:00

fix: 修复 test_title_font_size 断言适配 PR #1393 字号上限 #1397

auto-approve-bot referenced this issue from a commit 2026-08-16 22:01:02 +08:00

fix: 修复 test_title_font_size 断言适配 PR #1393 字号上限 (#1397)

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#1393