Files
manjaro_kde_custom/README.md
2026-03-23 17:31:06 +08:00

216 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# manjaro_kde_custom
我当前这台 Manjaro + KDE Plasma 6 机器的美化配置归档。
## 内容
- `scripts/recalc-plasma-bottom-docks.sh`
- 自动按当前显示器数量/尺寸重算底部 dock
- 确保每块启用中的屏幕都有一个底部 dock
- dock 统一保持:底部、居中、浮动、自动隐藏、长度随内容变化 (`fit`)
- `systemd/plasma-dock-autofit.service`
- 登录后执行一次自动重算
- `systemd/plasma-dock-autofit.path`
- 监听 `~/.config/kwinoutputconfig.json`,显示器布局变化时自动重算
- `presets/LogicDock/settings.json`
- 当前实际使用中的 Panel Colorizer 自定义预设
- 基于内置 Dock 预设修改而来,当前特点:
- 更圆的圆角
- 更大的 padding / spacing
- 更明显的阴影
- 更适合多屏下的底部自动隐藏 dock
- `docs/dock-launchers.txt`
- 当前主 dock 固定的启动器列表
- `install.sh`
- 一键安装脚本
- `uninstall.sh`
- 卸载自动重算脚本与 systemd 用户服务
- `kwin/manjaro_dock_force_hide`
- 一个 KWin 脚本
- 用来处理「底部 dock 因通知/attention 弹出后不自动缩回」的问题
- 逻辑是dock 弹出后等待 N 秒;如果此时鼠标不在 dock 上,就强制触发一次隐藏
## 这套美化当前依赖
- KDE Plasma 6
- [Panel Colorizer](https://github.com/luisbocanegra/plasma-panel-colorizer)
- 当前全局主题:`com.github.vinceliuice.Layan`
- 可选:`kvantum` / `kvantum-qt5`
> 当前机器使用的是 Layan 全局主题dock 的圆角和悬浮视觉主要由 Panel Colorizer 提供。
## 安装
### 1. 安装依赖
Manjaro / Arch:
```bash
sudo pacman -S spectacle python python-dbus python-gobject kvantum kvantum-qt5 papirus-icon-theme
```
Panel Colorizer
```bash
yay -S plasma6-applets-panel-colorizer
```
Layan 主题请通过 KDE Store 安装,或者使用你自己的 Plasma 6 主题。
### 2. 安装本仓库配置
在仓库根目录执行:
```bash
./install.sh
```
它会做这些事:
- 安装自动重算脚本到 `~/.local/bin/`
- 安装用户级 systemd 服务到 `~/.config/systemd/user/`
- 安装 `LogicDock` 预设到 `~/.config/panel-colorizer/presets/LogicDock`
- 安装并启用 `manjaro_dock_force_hide` KWin 脚本
- 启用并立即运行自动重算服务
### 3. 生效逻辑
- 登录后自动执行一次
- 当 KDE 显示器布局配置发生变化时自动执行
- 会自动为每块启用中的屏幕创建/修正底部 dock
- 如果底部 dock 被某些窗口通知/attention 状态顶出来KWin workaround 会在几秒后强制让它重新隐藏
## 当前 dock 行为
- 底部
- 居中
- 浮动
- 自动隐藏
- 长度按内容动态扩展,不固定留大空白
- 每块屏幕都各自有 dock
- 显示器变化后自动重算
- 底部 dock 弹出后,如果鼠标不在 dock 上,会在几秒后自动强制缩回
## Panel Colorizer 预设说明
当前使用的是 `LogicDock` 预设,而不是单纯的内置 `Dock`
- 更大的圆角:更接近 mac 风格
- 更大的左右内边距:图标不会太挤
- 更大的 widget spacingdock 视觉更舒展
- 阴影稍加强:悬浮感更明显
如果你想手动应用这个预设:
1. 确保 bottom dock 里已经有 `Panel Colorizer`
2. 右键 `Panel Colorizer` → 配置
3. Presets → 选择 `LogicDock`
## Kvantum 说明
Kvantum 是 Qt 应用控件主题引擎,主要影响:
- 按钮
- 输入框
- 菜单
- 滚动条
它**不负责** Plasma 面板布局本身。
a. 安装:
```bash
sudo pacman -S kvantum kvantum-qt5
```
b. 打开:
```bash
kvantummanager
```
c. 在 KDE 中启用:
- 系统设置 → 应用程序样式 → Qt 程序样式 → 选择 `Kvantum`
## Dock 通知弹出后自动缩回 workaround
这是一个 **KWin 脚本 workaround**,不是 Plasma 当前的原生选项。
默认行为:
- `delaySeconds = 6`
- 当底部 dock 弹出后:
- 如果鼠标正在 dock 上:不强制隐藏
- 如果鼠标不在 dock 上6 秒后强制触发一次隐藏
### 修改等待秒数
例如改成 4 秒:
```bash
kwriteconfig6 --file ~/.config/kwinrc --group Script-manjaro_dock_force_hide --key delaySeconds 4
qdbus6 org.kde.KWin /KWin reconfigure
```
### 打开调试日志
```bash
kwriteconfig6 --file ~/.config/kwinrc --group Script-manjaro_dock_force_hide --key debug true
qdbus6 org.kde.KWin /KWin reconfigure
journalctl --user -f | grep manjaro_dock_force_hide
```
### 关闭调试日志
```bash
kwriteconfig6 --file ~/.config/kwinrc --group Script-manjaro_dock_force_hide --key debug false
qdbus6 org.kde.KWin /KWin reconfigure
```
## 恢复 / 卸载
```bash
./uninstall.sh
```
如果只想临时停用:
```bash
systemctl --user disable --now plasma-dock-autofit.path plasma-dock-autofit.service
```
## 额外推荐的小组件
### 官方最稳
- `System Monitor Memory`
- `System Monitor Net`
官方页:
- https://apps.kde.org/plasma-systemmonitor/
### 看上传/下载速度
- `Network Bandwidth Monitor - Qt6`
- KDE Store: https://store.kde.org/p/2280811
### 轻量看 RAM / 温度
- `KVitals`
- KDE Discuss: https://discuss.kde.org/t/kvitals-a-lightweight-plasma-6-panel-widget-for-system-vitals/44363
## 备注
这个仓库归档的是**我当前机器上实际跑通的一套配置**。
如果后面 Plasma / Panel Colorizer 升级后行为变化,建议:
1. 先执行 `./install.sh` 重新覆盖脚本和服务
2. 注销并重新登录一次
3. 再手动执行一次:
```bash
~/.local/bin/recalc-plasma-bottom-docks.sh
```