material-decoration：KDE 窗口装饰主题

项目简介

material-decoration 是 KWin 的 Material 风格窗口装饰主题，基于 zzag 的原始设计，并集成了 Locally Integrated Menu（本地集成菜单）与菜单搜索功能。它同时支持 X11 与 Wayland，当前分支面向 Plasma 6（兼容 Plasma 6.5+），使用 C++ 编写，许可证为 GPL-2.0。

主要功能

• 本地集成菜单与搜索：隐藏 AppMenu 图标按钮，把菜单直接画在标题栏里，并提供搜索按钮查找菜单动作。
• 菜单助记符：按住 Alt 显示各菜单的快捷键提示，例如 Alt+F 打开“File”菜单。
• 平铺布局弹窗：用鼠标左键按住 Maximize 按钮打开平铺选择器，左下角预览当前显示器的自定义布局（Meta+T）。
• 按钮长按动作：长按“Close”按钮可在启用 kwin-minimize2tray 脚本时最小化到托盘；在 Plasma 6.6（Wayland）上长按“Minimize”可最小化除当前窗口外的所有窗口。
• 可配置外观与行为：可改成汉堡菜单、关闭搜索、决定搜索结果是否包含不可用的灰色动作等。

安装与使用

Ubuntu 可在最新 release 页面下载 deb 包；Fedora 的包位于 Terra 仓库；Arch 及衍生版请安装 AUR 包 material-kwin-decoration-git，chaotic-aur 也提供预编译包。

从源码构建（Plasma 6，需要 C++20 编译器、CMake、extra-cmake-modules、Qt 6、KDE Frameworks 6 与 KDecoration3）：

git clone https://github.com/guiodic/material-decoration.git
cd material-decoration
cmake -B build .
cmake --build build -j$(nproc)
sudo cmake --install build

安装后需要在「系统设置 > 颜色与主题 > 窗口装饰 > 配置标题栏按钮」中添加 AppMenu 按钮；点击选中 Material 主题时出现的铅笔图标即可修改装饰的外观与行为。平铺弹窗依赖配套的 Material Tiling Popup KWin 脚本，默认启用，可在「系统设置 > 窗口管理 > KWin 脚本」中检查；首次安装后建议注销并重新登录，让 KWin 发现并加载该脚本。

注意事项

• 在 Wayland 下，GTK 应用不会以 KDE 友好的方式导出菜单，需要用 GDK_BACKEND=x11 启动，或尝试实验性的 appmenu-gtk-module-wayland（仅 GTK3）。
• 若把装饰的不透明度设为 100% 以下，在 Wayland 上强烈建议配合 Better Blur 效果。
• 编译 Wayland 下的 Alt 助记符监控需要 libwayland 开发文件、wayland-scanner 与 plasma-wayland-protocols ≥ 1.15；使用 -DFORCE_X11=ON 时不需要这些可选包。
• 在 X11 上使用长按最小化全部窗口，需要把 /usr/share/kwin-wayland/scripts/minimizeall 目录复制到 /usr/share/kwin-x11/scripts/minimizeall。
• master 分支对齐最新 Plasma 版本，较早版本请参考其他（已停止维护的）分支。

本作品整理自 GitHub 开源项目 guiodic/material-decoration，原作者 @guiodic，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。