feat(#1758): FFmpeg 渲染加速——preset medium→fast + 多线程 + 环境变量可覆盖 #1757

Merged

auto-approve-bot merged 2 commits from feat/ffmpeg-hardware-acceleration into develop 2026-09-07 16:37:35 +08:00

Conversation 2 Commits 2 Files Changed 6

+388 -15

xiaoxia commented 2026-09-07 16:04:49 +08:00

Owner

Copy Link

Copy Source

问题

当前 FFmpeg 纯 CPU 渲染速度慢。服务器硬件：Intel Xeon Platinum 4核 / 14GB RAM / 无 GPU（Cirrus Logic GD 5446 虚拟显卡），无法使用 CUDA/VAAPI 硬件加速。

方案

CPU 优化路线（预期渲染速度提升 ≥30%）：

1. 集中编码常量 到 packages/shared/ffmpeg_utils.py，支持环境变量覆盖：

   • FFMPEG_ENCODE_PRESET: medium → fast（速度提升 30-50%，画质 PSNR 差异 <0.1dB）
   • FFMPEG_ENCODE_CRF: 23（保持，画质不变）
   • FFMPEG_ENCODE_THREADS: 0（自动检测 CPU 核心数，充分利用多核）

2. 统一替换所有渲染路径 的硬编码参数（5 处）：

   • _execute_ffmpeg（filter_complex 完整渲染）
   • _render_pass_through（单图层直通渲染）
   • normalize_video（视频标准化）
   • random_edge_crop（边缘裁剪）
   • VideoProcessor.concatenate_videos（视频拼接）

3. 环境变量动态调整：部署后可通过 FFMPEG_ENCODE_PRESET/FFMPEG_ENCODE_CRF/FFMPEG_ENCODE_THREADS 微调

测试

• 26 个新测试覆盖常量默认值 / 环境变量覆盖 / 所有路径一致性验证
• 200 个相关既有测试全部通过，无回归

改动文件

• packages/shared/ffmpeg_utils.py：新增编码常量定义
• apps/worker/video_processing/ffmpeg_utils.py：re-export + normalize_video/random_edge_crop 改用常量
• apps/worker/video_processing/unified_render_service.py：_execute_ffmpeg/_render_pass_through 改用常量
• apps/worker/video_processing/processor.py：concatenate_videos 改用常量
• tests/unit/test_ffmpeg_encoding_optimization.py：26 个新测试

## 问题 当前 FFmpeg 纯 CPU 渲染速度慢。服务器硬件：Intel Xeon Platinum 4核 / 14GB RAM / 无 GPU（Cirrus Logic GD 5446 虚拟显卡），无法使用 CUDA/VAAPI 硬件加速。 ## 方案 **CPU 优化路线（预期渲染速度提升 ≥30%）：** 1. **集中编码常量** 到 `packages/shared/ffmpeg_utils.py`，支持环境变量覆盖： - `FFMPEG_ENCODE_PRESET`: `medium` → `fast`（速度提升 30-50%，画质 PSNR 差异 <0.1dB） - `FFMPEG_ENCODE_CRF`: `23`（保持，画质不变） - `FFMPEG_ENCODE_THREADS`: `0`（自动检测 CPU 核心数，充分利用多核） 2. **统一替换所有渲染路径** 的硬编码参数（5 处）： - `_execute_ffmpeg`（filter_complex 完整渲染） - `_render_pass_through`（单图层直通渲染） - `normalize_video`（视频标准化） - `random_edge_crop`（边缘裁剪） - `VideoProcessor.concatenate_videos`（视频拼接） 3. **环境变量动态调整**：部署后可通过 `FFMPEG_ENCODE_PRESET`/`FFMPEG_ENCODE_CRF`/`FFMPEG_ENCODE_THREADS` 微调 ## 测试 - 26 个新测试覆盖常量默认值 / 环境变量覆盖 / 所有路径一致性验证 - 200 个相关既有测试全部通过，无回归 ## 改动文件 - `packages/shared/ffmpeg_utils.py`：新增编码常量定义 - `apps/worker/video_processing/ffmpeg_utils.py`：re-export + normalize_video/random_edge_crop 改用常量 - `apps/worker/video_processing/unified_render_service.py`：_execute_ffmpeg/_render_pass_through 改用常量 - `apps/worker/video_processing/processor.py`：concatenate_videos 改用常量 - `tests/unit/test_ffmpeg_encoding_optimization.py`：26 个新测试

gitea-actions bot commented 2026-09-07 16:07:42 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

xiaoxia force-pushed feat/ffmpeg-hardware-acceleration from 2dbf5599c3 to d062cb44e4 2026-09-07 16:16:27 +08:00 Compare

xiaoxia added 1 commit 2026-09-07 16:24:43 +08:00

feat(#1758): FFmpeg 渲染加速——preset medium→fast + 多线程 + 环境变量可覆盖 ... de63050609

问题：当前 FFmpeg 纯 CPU 渲染慢，服务器无 GPU（Cirrus Logic GD 5446 虚拟显卡）
方案：
1. 集中编码常量到 packages/shared/ffmpeg_utils.py，支持环境变量覆盖
   - FFMPEG_ENCODE_PRESET: medium → fast（速度提升 30%+，画质 PSNR 差异 <0.1dB）
   - FFMPEG_ENCODE_CRF: 23（保持）
   - FFMPEG_ENCODE_THREADS: 0（自动检测 CPU 核心数）
2. 统一替换所有渲染路径的硬编码参数：
   - _execute_ffmpeg（filter_complex 完整渲染）
   - _render_pass_through（单图层直通渲染）
   - normalize_video（视频标准化）
   - random_edge_crop（边缘裁剪）
   - VideoProcessor.concatenate_videos（视频拼接）
3. 支持通过环境变量动态调整（FFMPEG_ENCODE_PRESET/CRF/THREADS）

测试：26 个新测试覆盖常量默认值/环境变量覆盖/所有路径一致性验证
200 个相关既有测试全部通过，无回归

xiaoxia force-pushed feat/ffmpeg-hardware-acceleration from 39a90bff06 to de63050609 2026-09-07 16:24:43 +08:00 Compare

auto-approve-bot added 1 commit 2026-09-07 16:27:11 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 6069c9c1ff

auto-approve-bot merged commit debb3a5d67 into develop 2026-09-07 16:37:35 +08:00

auto-approve-bot deleted branch feat/ffmpeg-hardware-acceleration 2026-09-07 16:37:36 +08:00

gitea-actions bot commented 2026-09-07 16:38:01 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1757