xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 8 Pull Requests 8 Actions Packages Projects Releases 7 Wiki Activity

fix: 修复 Noto Sans CJK SC Bold 字体混入 Mono 等宽变体问题 #1510

Merged
xiaoxia merged 1 commits from fix/noto-cjk-font-bold-mono-issue into develop 2026-08-26 19:12:00 +08:00
Conversation 5 Commits 1 Files Changed 2
+25 -3
xiaoxia commented 2026-08-26 18:06:31 +08:00
Owner
Copy Link
Copy Source

问题

fonts-noto-cjk apt 包安装的 .ttc 文件同时包含 Sans 和 Sans Mono 变体，导致 fc-list 中 Bold 样式匹配到等宽字体（Noto Sans Mono CJK SC Bold），视频标题加粗渲染时使用等宽字体，与前端预览的非等宽字体不一致。

修复

  1. 删除有问题的 NotoSansCJK-Regular.ttc 和 NotoSansCJK-Bold.ttc
  2. 从 Google Fonts 下载单独的 Noto Sans SC Variable Font（不含 Mono）
  3. 刷新字体缓存，确保 fontconfig 使用正确的字体

影响范围

  • api-base.Dockerfile
  • worker-base.Dockerfile

验收标准

  • fc-list 中 Noto Sans CJK SC 的 Bold 变体不再是等宽字体
  • 视频标题加粗渲染与前端预览一致
  • CI 全绿

合并后需要重新构建 base image（api-base-image.yml 和 worker-base-image.yml 工作流会自动触发）

## 问题 fonts-noto-cjk apt 包安装的 .ttc 文件同时包含 Sans 和 Sans Mono 变体，导致 fc-list 中 Bold 样式匹配到等宽字体（Noto Sans Mono CJK SC Bold），视频标题加粗渲染时使用等宽字体，与前端预览的非等宽字体不一致。 ## 修复 1. 删除有问题的 NotoSansCJK-Regular.ttc 和 NotoSansCJK-Bold.ttc 2. 从 Google Fonts 下载单独的 Noto Sans SC Variable Font（不含 Mono） 3. 刷新字体缓存，确保 fontconfig 使用正确的字体 ## 影响范围 - api-base.Dockerfile - worker-base.Dockerfile ## 验收标准 - [ ] fc-list 中 Noto Sans CJK SC 的 Bold 变体不再是等宽字体 - [ ] 视频标题加粗渲染与前端预览一致 - [ ] CI 全绿 合并后需要重新构建 base image（api-base-image.yml 和 worker-base-image.yml 工作流会自动触发）
gitea-actions bot commented 2026-08-26 18:08:36 +08:00
Copy Link
Copy Source

🚀 预览环境已部署

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

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

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

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

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1510 | | 预览链接 | [https://pr-1510.preview.xiaoxiajianji.com](https://pr-1510.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。
xiaoxia added 1 commit 2026-08-26 19:02:34 +08:00
fix: 修复 Noto Sans CJK SC Bold 字体混入 Mono 等宽变体问题
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
Details
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 47s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Has been skipped
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate - Type Check (mypy) (pull_request) Successful in 1m25s
Details
CI/CD Pipeline / PR Build Worker Image (pull_request) Successful in 36s
Details
CI/CD Pipeline / PR Build API Image (pull_request) Successful in 39s
Details
CI/CD Pipeline / Validate - Migration (alembic) (pull_request) Successful in 1m30s
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 1m47s
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 2m14s
Details
AI Code Review / AI Code Review (pull_request) Successful in 2m44s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 3m29s
Details
CI/CD Pipeline / Validate - Code Quality (pull_request) Successful in 5m11s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 2m4s
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 8m9s
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / CI Gate (pull_request) Successful in 7s
Details
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 39s
Details
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 1m7s
Details
74fffbfccb 
问题：
fonts-noto-cjk apt 包安装的 .ttc 文件同时包含 Sans 和 Sans Mono 变体，
导致 fc-list 中 Bold 样式匹配到等宽字体（Noto Sans Mono CJK SC Bold），
视频标题加粗渲染时使用等宽字体，与前端预览的非等宽字体不一致。

修复：
1. 删除有问题的 NotoSansCJK-Regular.ttc 和 NotoSansCJK-Bold.ttc
2. 从 Google Fonts 下载单独的 Noto Sans SC Variable Font（不含 Mono）
3. 刷新字体缓存，确保 fontconfig 使用正确的字体

影响范围：api-base.Dockerfile 和 worker-base.Dockerfile

验收标准：
- fc-list 中 Noto Sans CJK SC 的 Bold 变体不再是等宽字体
- 视频标题加粗渲染与前端预览一致
xiaoxia force-pushed fix/noto-cjk-font-bold-mono-issue from cc27e6367b to 74fffbfccb 2026-08-26 19:02:34 +08:00 Compare
auto-approve-bot commented 2026-08-26 19:05:17 +08:00
Collaborator
Copy Link
Copy Source

代码审查结果 - PR #1510

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

💡 建议（1个可选）

  1. infra/docker/api-base.Dockerfile & worker-base.Dockerfile：建议为下载的字体文件添加完整性校验（如 SHA256），以确保下载内容未被篡改或损坏，防止因源文件变动导致构建失败或潜在的安全风险。

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好

🤖 由 AI 代码审查机器人自动生成 | 2026-08-26 11:05:17 | 模型:

## 代码审查结果 - PR #1510 ### ⚠️ 问题（0个需要修改） ### 💡 建议（1个可选） 1. **infra/docker/api-base.Dockerfile & worker-base.Dockerfile**：建议为下载的字体文件添加完整性校验（如 SHA256），以确保下载内容未被篡改或损坏，防止因源文件变动导致构建失败或潜在的安全风险。 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好 --- <sub>🤖 由 AI 代码审查机器人自动生成 | 2026-08-26 11:05:17 | 模型: </sub> <!-- AI_CODE_REVIEW_AUTO_COMMENT -->
auto-approve-bot approved these changes 2026-08-26 19:10:30 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
auto-approve-bot approved these changes 2026-08-26 19:10:30 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
xiaoxia merged commit 3b0a29d850 into develop 2026-08-26 19:12:00 +08:00
xiaoxia deleted branch fix/noto-cjk-font-bold-mono-issue 2026-08-26 19:12:00 +08:00
gitea-actions bot commented 2026-08-26 19:13:06 +08:00
Copy Link
Copy Source

🗑️ 预览环境已清理

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

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

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

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1510
Delete Branch "fix/noto-cjk-font-bold-mono-issue"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?