feat: add KDE Plasma customization scripts and docs

README.md

@@ -0,0 +1,173 @@
+# 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 用户服务
+
+## 这套美化当前依赖
+
+- 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`
+- 启用并立即运行自动重算服务
+
+### 3. 生效逻辑
+
+- 登录后自动执行一次
+- 当 KDE 显示器布局配置发生变化时自动执行
+- 会自动为每块启用中的屏幕创建/修正底部 dock
+
+## 当前 dock 行为
+
+- 底部
+- 居中
+- 浮动
+- 自动隐藏
+- 长度按内容动态扩展，不固定留大空白
+- 每块屏幕都各自有 dock
+- 显示器变化后自动重算
+
+## Panel Colorizer 预设说明
+
+当前使用的是 `LogicDock` 预设，而不是单纯的内置 `Dock`：
+
+- 更大的圆角：更接近 mac 风格
+- 更大的左右内边距：图标不会太挤
+- 更大的 widget spacing：dock 视觉更舒展
+- 阴影稍加强：悬浮感更明显
+
+如果你想手动应用这个预设：
+
+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`
+
+## 恢复 / 卸载
+
+```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
+```