✨ 魔法少女工坊 (Magic Workshop) - NAS Edition

"NAS 媒体库洗版神器 · Intel & NVIDIA & AMD 三位一体"

专为 NAS 用户 和 仓鼠党 打造的 AV1 硬件转码工具。 利用 Intel QSV、NVIDIA NVENC 或 AMD AMF 技术，在保留画质的前提下，将庞大的影视库体积缩小 30% - 50%。 Powered by Python, PySide6, QFluentWidgets, FFmpeg, ab-av1, Gemini.

---

📸 界面预览

🎯 核心功能

• 🚀 三核硬件加速:
  • Intel QSV: 专为 Intel Arc (A380/A750/B580) 及 Core Ultra 核显优化，满血释放 av1_qsv 性能。
  • NVIDIA NVENC: 支持 RTX 40 系列显卡 AV1 编码，内置 AQ (感知画质增强) 开关，画质更细腻。
  • AMD AMF: [New] 新增对 Radeon RX 7000 系列显卡及 RDNA 3 架构核显 (如 Ryzen 8000G) AV1 编码支持。
• 🧠 智能码率 (ab-av1): 集成 ab-av1 算法，根据设定的 VMAF 分数（Intel 默认 93 / NVIDIA 默认 95 / AMD 默认 97）自动测算最佳压制参数，支持 10-bit 深度。
• 📂 批量洗版: 支持选择整个文件夹，自动扫描视频文件并加入队列。支持断点续传，适合挂机处理 TB 级数据。
• 🔮 真理之眼: 拖入视频文件即可快速查看详细媒体信息（编码、流信息、码率等），二次元风格报告。
• 🛠️ 媒体库友好:
  • 音频: 默认混缩为立体声 (Opus @ 96k + Loudnorm)，[New] 自动识别并保留 5.1/7.1 环绕声通道 (Opus Multichannel)。
  • 字幕: 智能处理字幕流 (MKV 保留特效字幕，MP4 转 SRT)，确保 Emby/Plex/Jellyfin 兼容性。
  • 元数据: 尽可能保留原文件的元数据信息，[New] 增强了对 HDR10/HLG 元数据的保留。
• 🎨 Win11 风格: 基于 PySide6 + Fluent-Widgets 开发，支持云母 (Mica) 特效与深色模式，界面精美。
• 🔌 贴心辅助: 支持任务完成后自动关机，以及一键清理 ab-av1 产生的临时缓存文件。

📊 编码器参数对比

特性 / 参数	Intel QSV (默认)	NVIDIA NVENC	AMD AMF
FFmpeg 编码器	av1_qsv	av1_nvenc	av1_amf
默认 VMAF 目标	93.0	95.0	97.0
质量控制参数	-global_quality:v	-cq	-qp_p
速度预设 (Preset)	1 (慢) - 7 (快)	p7 (慢) - p1 (快)	quality (慢) - speed (快)
码率控制模式	硬件 ICQ 模式	vbr + -b:v 0	cqp 模式
感知增强 (AQ)	默认启用 (Lookahead)	默认启用 (Spatial/Temporal)	默认启用 (Pre-Analysis)
像素格式	p010le (10-bit)	p010le (10-bit)	p010le (10-bit)
特殊优化	-async_depth 1 (防溢出)	解除码率限制 (-b:v 0)	启用 VBAQ 自适应量化
硬件门槛	Intel Arc / Core Ultra	NVIDIA RTX 40 系列	AMD RX 7000 / RDNA 3

注：由于三家算法不同，相同的质量数值（如 30）在不同显卡上的表现不可直接类比，请以 VMAF 结果为准。 预设映射：软件界面统一使用 1 (慢/高质量) - 7 (快/低质量) 的数字。NVIDIA 映射为 p7→p1；AMD 映射为：1-2→quality, 3-5→balanced, 6-7→speed。

🧪 VMAF 调优指南

本工具通过 ab-av1 自动寻找最佳 ICQ 码率。VMAF 是衡量画质的关键指标：

• VMAF 95+ (极高画质): 适合 4K HDR 收藏，画质几乎等同于原盘，体积缩减约 20-30%。
• VMAF 93 (推荐平衡): 默认设置。肉眼无损的黄金分割点，体积缩减可达 40-60%。
• VMAF 90 (高压缩比): 适合在平板或手机上观看，在保持良好观感的前提下极大节省空间。
• VMAF < 85: 可能会出现可见的压缩伪影，不建议用于长期收藏。
• （不同编码器适合的 VMAF 参数不一致，Intel 建议 93，NVIDIA 建议 95，AMD 建议 97）

⚙️ 系统要求

• 操作系统: Windows 10 / 11 (推荐 Win11 以获得最佳 UI 体验)
• 显卡: 必须 支持 AV1 硬件编码
  • 🟢 Intel: Arc A380 / A750 / B580 等独显，或 Core Ultra 系列核显。
  • 🟢 NVIDIA: GeForce RTX 40 系列 (如 RTX 4060 / 4080 / 4090)。
  • 🟢 AMD: Radeon RX 7000 系列独显或 RDNA 3 架构核显 (如 Ryzen 8000G)。
  • 注意: 旧款 NVIDIA (30系及以下) 及 AMD (RX 6000系及以下) 不支持。
• 驱动: 请安装最新的显卡驱动。

🔍 硬件兼容性自测

程序启动时会自动检测环境（真实初始化硬件）。

软件内状态 (GUI Log):

• ✅ 通过: >>> 适格者认证通过： [Intel QSV] [NVIDIA NVENC] [AMD AMF] (Ready) (根据实际硬件显示)
• ❌ 失败: >>> 警告：未侦测到有效的 AV1 硬件编码器...

手动确认 (Terminal): 如果您想手动确认，请在终端执行对应显卡的检测命令：

Intel QSV:

.\ffmpeg.exe -init_hw_device qsv=hw -f lavfi -i color=black:s=1280x720 -pix_fmt p010le -c:v av1_qsv -frames:v 1 -f null - -v error

NVIDIA NVENC:

.\ffmpeg.exe -f lavfi -i color=black:s=1280x720 -pix_fmt p010le -c:v av1_nvenc -frames:v 1 -f null - -v error

AMD AMF:

.\ffmpeg.exe -f lavfi -i color=black:s=1280x720 -pix_fmt p010le -c:v av1_amf -usage transcoding -quality balanced -rc cqp -qp_i 30 -qp_p 30 -qp_b 30 -frames:v 1 -f null - -v error

• 无输出: 恭喜！您的硬件完美支持 QSV, NVENC 或 AMF AV1 硬件编码。
• 有输出 (报错): 说明您的显卡不支持对应的硬件编码器或驱动未正确安装。

📥 下载与使用

---

🚀 更新日志

• v1.2.0 (2026-02-16)

  • 🔴 新增 AMD AMF AV1 硬件编码支持: 适配 Radeon RX 7000 系列及 RDNA 3 核显，默认 VMAF 设为 97.0。
  • 🔊 音频增强: 智能识别并保留 5.1/7.1 多声道 (Opus Multichannel)，新增响度标准化 (Loudnorm) 智能模式，避免破坏环绕声动态。
  • ⚡ 核心重构: 底层框架迁移至 PySide6，引入异步任务队列与日志缓冲池，大幅提升大量文件列表下的 UI 响应速度。
  • 🌈 画质优化: 全程强制 10-bit 像素处理，优化 HDR 色彩保留；NVENC/QSV/AMF 均已启用感知增强 (AQ/Lookahead/PreAnalysis)。
  • 🛠️ 体验升级: 优化了任务进度条显示，增加剩余时间预估；修复了停止任务时后台进程残留的 Bug。

• v1.1.0 (2026-02-13)

  • 💡 新增 NVIDIA NVENC AV1 硬件编码支持 (需 RTX 40 系列)。
  • ⚙️ 优化硬件检测逻辑，区分显卡型号和驱动问题。
  • 🚀 修复 ab-av1 参数兼容性问题，大幅提升 NVENC 压制画质 (开启 AQ 感知增强)。
  • 📝 增加日志 VMAF 实时显示，NVENC 感知增强开关，以及 VMAF 默认值智能切换。

• v1.0.0 (2026-01-28)

  • 🎉 首次发布！支持 Intel QSV AV1 硬件编码。
  • ✨ 集成 ab-av1 智能 VMAF 码率控制。
  • 🎨 Win11 Fluent Design 风格界面。

---

方式一：下载正式版 (推荐)

1. 前往 Releases 页面下载最新版本的压缩包。
2. 解压至任意目录。
3. 双击 MagicWorkshop.exe 即可直接使用 (已内置 FFmpeg, ab-av1 等核心组件，无需额外配置)。

方式二：源码运行 (Dev)

如果您熟悉 Python 开发，可以使用源码运行：

1. 克隆仓库

   git clone https://github.com/LingMoe404/MagicWorkshop.git
   cd MagicWorkshop

2. 安装依赖 本项目推荐使用 uv 进行依赖管理 (根目录已包含 uv.lock)。

   # 安装 uv
   pip install uv
   # 同步环境
   uv sync

   或者使用 pip 安装核心库: pip install PySide6 QFluentWidgets

3. 准备工具链 请确保项目根目录下的 tools/ 文件夹内包含以下可执行文件：

   • ffmpeg.exe & ffprobe.exe
   • ab-av1.exe

4. 启动

   # 使用 uv
   uv run main.py
   
   # 或标准 python
   python main.py

🛠️ 常见问题

Q: 为什么启动时提示“结界破损警告”？ A: 说明程序目录下缺少 ffmpeg.exe、ffprobe.exe 或 ab-av1.exe。请下载这些工具并和 exe 放在一起。

Q: 为什么点击开始后直接报错/闪退？ A: 请检查您的显卡是否支持 AV1 硬件编码。

• Intel: 需要 Arc A380/A750/B580 或 Core Ultra 核显。
• NVIDIA: 需要 RTX 40 系列 (如 4060/4080/4090)。
• AMD: 需要 Radeon RX 7000 系列或 RDNA 3 架构核显。

Q: 转换后的 MKV 字幕显示不正常？ A: 程序会自动判断：如果是 MP4 源文件，字幕会转为 SRT 以兼容 MKV；如果是 MKV 源文件，则保留原始字幕（如 ASS 特效）。

💡 给 NAS 用户的建议

• 路径映射: 为了获得最佳稳定性，建议将 NAS 的共享文件夹映射为本地磁盘（例如映射为 Z: 盘），然后再拖入软件处理，避免使用 \\192.168.x.x 路径。
• 虚拟机直通或 SR-IOV: 如果您是在宿主机系统下的 Windows 虚拟机中使用，请确保显卡已正确直通 (Passthrough) 或 SR-IOV 虚拟，并安装了最新的显卡驱动 (Intel/NVIDIA/AMD)。
• 原始文件: 软件默认开启“覆盖源文件”模式，但对于珍贵的原盘资源，建议先开启“另存为”模式测试效果。

🔗 关于作者

我是 泠萌404，一名喜欢折腾硬件、NAS的普通上班族。

平台	ID / 频道	链接
Bilibili	泠萌404	点击跳转
YouTube	泠萌404	点击跳转
Douyin	泠萌404	点击跳转

🙏 致谢

本项目离不开以下优秀的开源项目与工具的支持：

• FFmpeg: 强大的多媒体处理框架。
• ab-av1: 自动寻找最佳 AV1 编码参数的工具。
• PyQt6: Python 的 Qt 绑定。
• PyQt-Fluent-Widgets: 精美的 Fluent Design 风格组件库。
• Google Gemini: 提供了强大的代码生成与辅助能力。

🤖 开发幕后

本项目是一个纯粹的 AI 辅助开发 实验。 100% 的代码 均由 Google Gemini 在我的 Prompt 引导下生成。 我负责提供逻辑架构和需求，AI 负责编写 Python 代码和 UI 实现。

📜 开源协议

本项目遵循 GPL-3.0 开源协议。

• GUI: 基于 PySide6 和 QFluentWidgets (GPLv3)。
• Core: 核心算法基于 FFmpeg (LGPL/GPL) 和 ab-av1 (MIT)。
• License: MagicWorkshop by 泠萌404 is licensed under GPL-3.0.

Copyright © 2026 泠萌404