fix(GPU): 修复GFPGAN增强后蓝色遮罩问题 #2011

Merged

xiaoxia merged 3 commits from fix/gfpgan-blue-face into develop 2026-09-22 13:34:14 +08:00

Conversation 0 Commits 3 Files Changed 1

+12 -17

xiaoxia commented 2026-09-22 12:56:24 +08:00

Owner

Copy Link

Copy Source

问题

GFPGAN增强后，人脸出现蓝色遮罩（整半张脸变蓝）。

根因

musetalk_server.py L935 附近：

• gfpgan_enhancer(_face_t, return_rgb=False, weight=0.35) — return_rgb=False 返回 BGR 格式
• 紧接着 cv2.cvtColor(_out.astype(np.uint8), cv2.COLOR_RGB2BGR) — 又做了一次 RGB→BGR 转换
• 结果：BGR 数据被当作 RGB 处理，R/B 通道互换 → 脸变蓝

同时复杂的色彩校正（mean/std 对齐）在错误的色彩空间下工作，可能引入额外色偏。

修复

1. return_rgb 改为 True：GFPGAN 直接输出 RGB 格式
2. 保持后续 RGB→BGR 转换正确：cv2.cvtColor(_out_rgb, cv2.COLOR_RGB2BGR) 现在是正确的
3. 简化逻辑：去掉复杂的色彩校正代码，避免引入额外色偏风险
4. 添加清晰的色彩通道注释：标注 ori_frame/res_frame/_face_up 均为 BGR，GFPGAN 输出 RGB 再转 BGR，确保后续 face_parsing 融合一致

值域处理

• GFPGAN 输出 tensor：[-1, 1] 范围
• clamp(-1, 1) → 映射到 [0, 255] → astype(uint8)
• 不会丢失 [0, 1] 范围内的信息

测试

• 现有 musetalk_server 测试通过（23 passed，2 个已有失败与本次修改无关）
• 需 GPU 机器验证实际视频输出无蓝色遮罩

备注

• MUSE_USE_GFPGAN=0 环境变量仍可临时禁用 GFPGAN
• 如需进一步调色，建议在确保通道正确后再加

## 问题 GFPGAN增强后，人脸出现蓝色遮罩（整半张脸变蓝）。 ## 根因 `musetalk_server.py` L935 附近： - `gfpgan_enhancer(_face_t, return_rgb=False, weight=0.35)` — `return_rgb=False` 返回 BGR 格式 - 紧接着 `cv2.cvtColor(_out.astype(np.uint8), cv2.COLOR_RGB2BGR)` — 又做了一次 RGB→BGR 转换 - 结果：BGR 数据被当作 RGB 处理，R/B 通道互换 → 脸变蓝 同时复杂的色彩校正（mean/std 对齐）在错误的色彩空间下工作，可能引入额外色偏。 ## 修复 1. **return_rgb 改为 True**：GFPGAN 直接输出 RGB 格式 2. **保持后续 RGB→BGR 转换正确**：`cv2.cvtColor(_out_rgb, cv2.COLOR_RGB2BGR)` 现在是正确的 3. **简化逻辑**：去掉复杂的色彩校正代码，避免引入额外色偏风险 4. **添加清晰的色彩通道注释**：标注 ori_frame/res_frame/_face_up 均为 BGR，GFPGAN 输出 RGB 再转 BGR，确保后续 face_parsing 融合一致 ## 值域处理 - GFPGAN 输出 tensor：[-1, 1] 范围 - clamp(-1, 1) → 映射到 [0, 255] → astype(uint8) - 不会丢失 [0, 1] 范围内的信息 ## 测试 - 现有 musetalk_server 测试通过（23 passed，2 个已有失败与本次修改无关） - 需 GPU 机器验证实际视频输出无蓝色遮罩 ## 备注 - MUSE_USE_GFPGAN=0 环境变量仍可临时禁用 GFPGAN - 如需进一步调色，建议在确保通道正确后再加

xiaoxia added 1 commit 2026-09-22 12:56:24 +08:00

fix(GPU): 修复GFPGAN增强后蓝色遮罩问题 ... 130120c8a7

根因：return_rgb=False 返回 BGR 格式，但后续 cvtColor 误用 RGB2BGR
导致 R/B 通道互换，人脸变蓝。

修复：
- return_rgb 改为 True，输出为 RGB 格式
- 保持后续 RGB→BGR 转换正确
- 简化逻辑：去掉复杂的色彩校正（mean/std对齐），
  避免引入额外的色偏风险
- 添加清晰的色彩通道注释，防止后续维护出错

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

chore(ci): retrigger CI - previous run had DNS resolution issues e7ea90798b

xiaoxia added 1 commit 2026-09-22 13:19:27 +08:00

chore(ci): retrigger CI - 3rd attempt af7b2bb436

xiaoxia closed this pull request 2026-09-22 13:33:42 +08:00

xiaoxia reopened this pull request 2026-09-22 13:34:00 +08:00

xiaoxia merged commit af7b2bb436 into develop 2026-09-22 13:34:14 +08:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

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

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#2011