Better Blur DX 是一款面向Plasma 6（KDE）桌面的 KWin 模糊特效插件，在系统默认模糊效果的基础上增加了三大核心能力：Force Blur（强制模糊）、折射（Refraction）玻璃透镜效果和可调窗口圆角，同时还修复了多个 Plasma 官方未解决的模糊相关 Bug。本文将带新手从零开始：安装、启用、配置核心功能，并附常见问题排查技巧，帮你快速玩转这款"终极模糊特效"。

一、Better Blur DX 是什么？✨

Better Blur DX 是知名插件 Better Blur 的延续版本（fork），针对 Plasma 6 的默认模糊效果重新移植并增强。与默认模糊相比，它提供了：

版本支持：官方明确支持Plasma 6.5 / 6.6 / 6.7，同时提供 Wayland 与 X11 两个构建版本（X11 需显式开启，详见下文）。

二、如何安装 Better Blur DX：一键包与手动编译两种方法

方法 1：使用发行版软件包（推荐新手）

• Arch Linux：通过 AUR 安装

yay -S kwin-effects-better-blur-dx

• Fedora：通过 COPR 源安装

dnf copr enable infinality/kwin-effects-better-blur-dx dnf install kwin-effects-better-blur-dx

• 此外还有Gentoo overlay与NixOS flake方案（参考 flake.nix 与 nix/package.nix）。

方法 2：手动编译

git clone https://gitcode.com/gh_mirrors/kw/kwin-effects-better-blur-dx cd kwin-effects-better-blur-dx chmod +x build.sh ./build.sh # X11 版本加 --x11 参数

需要 CMake、extra-cmake-modules、Qt6、KF6 及 KWin 开发包等依赖。

⚠️重要提醒：该特效只对其构建时的 KWin 版本生效。系统升级 Plasma 后必须重新构建/重装；且 KWin 需要退出登录再登录（重启 KWin）才能加载新版本，首次安装则不需要。

三、一分钟启用：桌面特效配置步骤

安装完成后，Better Blur DX 与 KWin 默认模糊特效互斥（同时开启会导致部分窗口双重模糊、观感异常），按以下步骤操作：

1. 打开系统设置 → 桌面特效；
2. 关闭所有已有的模糊特效（包括 KWin 自带 Blur）；
3. 勾选启用Better Blur DX特效；
4. 让窗口半透明——只有半透明窗口才能透出模糊效果，可选方式：
   • 使用支持透明主题的窗口装饰/应用；
   • 使用透明配色方案（如 Alpha 方案）；
   • 通过窗口规则降低窗口不透明度。

四、Force Blur 强制模糊：想模糊哪个窗口就模糊哪个

🎯 默认情况下只有窗口"主动声明"的区域（如 Plasma 面板、部分应用）才会被模糊。Force Blur 让你按窗口类（Window Class）强制指定模糊对象，是插件的灵魂功能。

打开特效的 "Force blur" 选项卡，核心配置项包括：

• Classes of windows to force blur：逐行填写要强制模糊的窗口类，支持正则匹配；
• Blur only matching / Blur all except matching：只模糊匹配的窗口，或反过来"模糊除匹配项之外的所有窗口"；
• Blur window decorations as well：连同标题栏、边框一起模糊（装饰不支持模糊时的救星）;
• Blur menus / Blur docks：允许对菜单、dock 应用模糊（仍需加入匹配列表）。

如何获取窗口类？两种方法：

qdbus org.kde.KWin /KWin org.kde.KWin.queryWindowInfo

然后点击目标窗口，取resourceClass或resourceName；也可以右键标题栏 → 更多选项 → 配置特定窗口/应用设置，查看 "Window class (application)"。

注意：自己提供模糊区域的窗口（如 Plasma 表面）会忽略 Force Blur 设置。匹配逻辑实现可参考 src/window.cpp 中的shouldForceBlur()。

五、Refraction 折射：给窗口加上玻璃透镜质感

🔮 折射是 Plasma 6.6 起重新实现的进阶特效，位于 "Refraction" 选项卡，参数一览：

底层实现位于 src/refraction_pass.cpp 与着色器 src/shaders/refraction_core.frag，所有默认值定义在 src/blur.kcfg。

六、圆角与色彩调节：让模糊更精致

在 "General" 选项卡（界面定义见 src/kcm/blur_config.ui）中：

• Blur strength（1–15）：模糊模糊度；
• Noise strength（0–50）：噪点强度，用于消除平滑渐变中的色带；
• Brightness / Saturation / Contrast（0–500%）：分别控制模糊背景的亮度、饱和度与对比度；
• Force Contrast Parameters：默认插件会尊重窗口自带的对比度参数（如 Plasma 面板），勾选后可强制全窗口使用你的设置；
• Corner Radius：为模糊背景添加圆角，主要解决方形模糊区域从圆角窗口后"漏角"的 korners Bug，实现见 src/rounded_corners_pass.cpp。

每一项参数的详细说明可阅读官方文档 docs/configuration.md。

七、性能优化与常见问题排查 🔧

性能选项

"Performance" 选项卡（默认值见 src/blur.kcfg）：

• Blur Source Mode：Full（整屏，默认）或 Wallpaper（实验性，只采样壁纸，缓存利用率更高）；
• Ignore Cache：关闭模糊缓存；
• Cache Rate Limit：缓存重绘限频（默认约 33 ms，即 ~30fps）。

常见问题

八、核心文件路径速查清单

结语

Better Blur DX 是 Plasma 6 用户美化桌面的利器：用Force Blur精准控制模糊范围，用折射增添玻璃质感，用圆角与色彩参数打磨细节。跟着本文"安装 → 启用 → 调参 → 排错"的路径走一遍，十分钟即可拥有媲美 macOS 的模糊桌面体验。祝折腾愉快！🚀