fix: Worker容器安装CJK中文字体 — 修复ASS字幕标题不渲染 #1400

Merged

xiaoxia merged 1 commits from fix/worker-cjk-fonts into develop 2026-08-17 12:10:40 +08:00

Conversation 3 Commits 1 Files Changed 1

+3

xiaoxia commented 2026-08-17 11:33:25 +08:00

Owner

Copy Link

Copy Source

问题

预览视频标题不显示。PR #1399 代码链路正确（custom_title注入→ASS生成→FFmpeg烧录），但Worker容器没有中文字体，FFmpeg subtitles滤镜找不到思源黑体，所有中文glyph缺失导致标题静默跳过。

根因

Worker容器(Debian 13)只装了fonts-dejavu-core(拉丁字符)，没有CJK字体。FFmpeg报Glyph not found。

修复

worker.Dockerfile runtime阶段安装fonts-noto-cjk + fc-cache

## 问题 预览视频标题不显示。PR #1399 代码链路正确（custom_title注入→ASS生成→FFmpeg烧录），但Worker容器没有中文字体，FFmpeg subtitles滤镜找不到思源黑体，所有中文glyph缺失导致标题静默跳过。 ## 根因 Worker容器(Debian 13)只装了fonts-dejavu-core(拉丁字符)，没有CJK字体。FFmpeg报Glyph not found。 ## 修复 worker.Dockerfile runtime阶段安装fonts-noto-cjk + fc-cache

xiaoxia added 1 commit 2026-08-17 11:33:25 +08:00

fix: Worker容器安装CJK中文字体 — 修复ASS字幕标题不渲染 ... ea2db17b59

根因：Worker容器(Debian 13)没有中文字体，FFmpeg subtitles滤镜
找不到思源黑体(Noto Sans CJK)，所有中文字符glyph缺失导致标题
不显示。代码链路(generation.py→unified_render_service→ass_subtitle_builder)
完全正确，但容器缺字体导致渲染时静默跳过。

修复：worker.Dockerfile runtime阶段安装 fonts-noto-cjk + fc-cache
fonts-noto-cjk 包含 Noto Sans CJK SC(简体中文)，覆盖所有中文字符。

验证：手动在容器内执行ffmpeg -vf subtitles测试，修复前报
"Glyph not found"，修复后正常渲染中文标题。

gitea-actions bot commented 2026-08-17 11:35:01 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot commented 2026-08-17 11:35:58 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #1400

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

1. infra/docker/worker.Dockerfile 第72行：Dockerfile 层缓存利用不当，导致构建性能严重下降。
   • 原因：RUN apt-get install ... 指令被放置在 COPY apps/worker/ ... 之后。根据 Docker 构建机制，只要业务代码发生变更，后续的层缓存都会失效。fonts-noto-cjk 是一个体积很大的包（通常数百MB），这意味着每次业务代码提交都会触发重新下载和安装该字体包，极大地增加构建时间和资源消耗。
   • 后果：CI/CD 构建时间显著变长，增加构建成本。
   • 建议：将字体安装的 RUN 指令移动到 COPY apps/worker/ ... 之前（例如放在 COPY 之前或与其他系统依赖安装放在一起），确保该层被业务代码变更之外的缓存命中。

💡 建议（1个可选）

1. infra/docker/worker.Dockerfile 第72行：fc-cache -fv 中的 -v (verbose) 参数会输出大量详细信息，建议移除以保持构建日志简洁，仅保留 fc-cache -f 即可。

---

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

---

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

## 代码审查结果 - PR #1400 ### ⚠️ 问题（1个需要修改） 1. **infra/docker/worker.Dockerfile 第72行**：Dockerfile 层缓存利用不当，导致构建性能严重下降。 - **原因**：`RUN apt-get install ...` 指令被放置在 `COPY apps/worker/ ...` 之后。根据 Docker 构建机制，只要业务代码发生变更，后续的层缓存都会失效。`fonts-noto-cjk` 是一个体积很大的包（通常数百MB），这意味着每次业务代码提交都会触发重新下载和安装该字体包，极大地增加构建时间和资源消耗。 - **后果**：CI/CD 构建时间显著变长，增加构建成本。 - **建议**：将字体安装的 `RUN` 指令移动到 `COPY apps/worker/ ...` 之前（例如放在 `COPY` 之前或与其他系统依赖安装放在一起），确保该层被业务代码变更之外的缓存命中。 ### 💡 建议（1个可选） 1. **infra/docker/worker.Dockerfile 第72行**：`fc-cache -fv` 中的 `-v` (verbose) 参数会输出大量详细信息，建议移除以保持构建日志简洁，仅保留 `fc-cache -f` 即可。 --- ✅ 格式检查通过 | ❌ 逻辑审查需修改 | ⚠️ 建议关注性能 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-17 03:35:58 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit ff3f6ddf97 into develop 2026-08-17 12:10:40 +08:00

gitea-actions bot commented 2026-08-17 12:11:20 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1400