fix(ass): 字段名归一化(font_size/font_color→size/color) + 移除字号上限36 #1501

Merged

auto-approve-bot merged 1 commits from fix/ass-subtitle-field-mapping into develop 2026-08-25 21:56:02 +08:00

Conversation 5 Commits 1 Files Changed 3

+87 -13

xiaoxia commented 2026-08-25 21:15:27 +08:00

Owner

Copy Link

Copy Source

问题

1. 前端传 font_size/font_color，后端内部用 size/color，字段名不一致导致字号、颜色不生效
2. 标题字号被 min(size, 36) 硬上限截断，用户设置大于36的字号不生效，预览与最终渲染不一致

修改

packages/domain/ass_subtitle_builder.py

• 在 stroke/shadow boolean 转换之前增加字段名归一化：
  • font_size → size（当 size 不存在时）
  • font_color → color（当 color 不存在时）
• 移除两处 min(int(...), 36) 字号上限：
  • build_ass_style 的 font_size
  • _wrap_title_text 的 title_font_size

测试

• 更新 test_title_font_size：72 应原样保留（之前断言被 cap 到 36）
• 更新 TestFontSizeCap → TestFontSize：test_size_60_capped_at_36 → test_size_60_preserved
• 新增 5 个测试覆盖字段别名归一化：
  • font_size→size 别名
  • font_color→color 别名
  • size 优先于 font_size
  • 一致性测试中两个别名用例
• 共 167 个相关测试全部通过

验收

• 前端传 font_size 能正确控制 ASS 字号
• 前端传 font_color 能正确控制 ASS 颜色
• 字号 >36 不再被截断
• 已有 size/color 字段不受影响（size 优先）

## 问题 1. 前端传 `font_size`/`font_color`，后端内部用 `size`/`color`，字段名不一致导致字号、颜色不生效 2. 标题字号被 `min(size, 36)` 硬上限截断，用户设置大于36的字号不生效，预览与最终渲染不一致 ## 修改 **packages/domain/ass_subtitle_builder.py** - 在 stroke/shadow boolean 转换之前增加字段名归一化： - `font_size` → `size`（当 `size` 不存在时） - `font_color` → `color`（当 `color` 不存在时） - 移除两处 `min(int(...), 36)` 字号上限： - `build_ass_style` 的 `font_size` - `_wrap_title_text` 的 `title_font_size` **测试** - 更新 `test_title_font_size`：72 应原样保留（之前断言被 cap 到 36） - 更新 `TestFontSizeCap` → `TestFontSize`：`test_size_60_capped_at_36` → `test_size_60_preserved` - 新增 5 个测试覆盖字段别名归一化： - font_size→size 别名 - font_color→color 别名 - size 优先于 font_size - 一致性测试中两个别名用例 - 共 167 个相关测试全部通过 ## 验收 - [x] 前端传 font_size 能正确控制 ASS 字号 - [x] 前端传 font_color 能正确控制 ASS 颜色 - [x] 字号 >36 不再被截断 - [x] 已有 size/color 字段不受影响（size 优先）

xiaoxia added 1 commit 2026-08-25 21:15:28 +08:00

fix(ass): normalize font_size/font_color field aliases and remove font size cap ... 35f4ae8b3f

- Add field name normalization in build_ass_content: frontend sends
  font_size/font_color, internal uses size/color. Normalize before
  stroke/shadow boolean conversion.
- Remove min(size, 36) cap from both build_ass_style font_size and
  _wrap_title_text font_size, allowing larger title fonts.
- Update tests: rename TestFontSizeCap to TestFontSize, change capped
  assertions to preserve-actual, add alias normalization tests.

gitea-actions bot commented 2026-08-25 21:16:59 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot commented 2026-08-25 21:17:33 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

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

📊 审查概览

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

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

无

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

1. [packages/domain/ass_subtitle_builder.py: 250-253] 字典参数副作用风险
   • 具体内容：代码直接修改了传入的 title_config 字典对象（如 title_config["size"] = ...）。如果调用方在函数调用后继续复用该字典对象，可能会因为字段名变化而产生意外行为。建议在函数开始处使用 title_config = (title_config or {}).copy() 创建副本，避免副作用。

✅ 良好实践

1. 测试覆盖全面：新增的测试用例很好地覆盖了字段归一化、优先级逻辑以及边界条件（如移除字号上限后的行为）。
2. 代码可读性：新增的注释清晰地说明了字段归一化的目的，有助于后续维护。

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无问题

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-25 13:17:33 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：1 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 1. **[packages/domain/ass_subtitle_builder.py: 250-253] 字典参数副作用风险** - 具体内容：代码直接修改了传入的 `title_config` 字典对象（如 `title_config["size"] = ...`）。如果调用方在函数调用后继续复用该字典对象，可能会因为字段名变化而产生意外行为。建议在函数开始处使用 `title_config = (title_config or {}).copy()` 创建副本，避免副作用。 ### ✅ 良好实践 1. **测试覆盖全面**：新增的测试用例很好地覆盖了字段归一化、优先级逻辑以及边界条件（如移除字号上限后的行为）。 2. **代码可读性**：新增的注释清晰地说明了字段归一化的目的，有助于后续维护。 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无问题 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-25 13:17:33 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot approved these changes 2026-08-25 21:27:09 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-25 21:27:10 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot merged commit 7635a20fdb into develop 2026-08-25 21:56:02 +08:00

auto-approve-bot deleted branch fix/ass-subtitle-field-mapping 2026-08-25 21:56:03 +08:00

gitea-actions bot commented 2026-08-25 21:57:07 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

🗑️ **预览环境已清理** PR #1501 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 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#1501