在 Arch 上使用 Hyprland，改个圆角、换个模糊参数都要手改配置文件再 reload？Ryoku 把这一切装进了一个叫Ryoku Settings的图形控制中心：按Super + ,即可打开，用原生的 Quickshell（Qt6/QML）界面，管住显示、外观、输入、快捷键、窗口规则、锁屏到系统更新——一个 GUI 管住整个 Hyprland 桌面。本文带你完整过一遍它的每个分区和工作原理。

快速上手：打开Ryoku Settings控制中心的3种方式

Ryoku Settings 是随桌面预装的应用，无需额外安装：

• 快捷键：Super + ,（默认绑定在 ryoku/hyprland/modules/binds.lua 中）
• 命令启动：qs -c hub（内部二进制与配置目录沿用hub命名）
• 定位：窗口自动浮动并居中于当前窗口之上，不抢占焦点布局

打开后你会看到三部分：品牌头 + 分组导航栏（NavRail）、全局模糊搜索框、功能分区内容区。侧边栏按任务分组（概览、设备、桌面、高级等），选中项有滑动指示条，底部署名标记——这就是整个控制中心的骨架，源码见 ryoku/hub/quickshell/Hub.qml。

用全局搜索直达任意设置项

不想翻菜单？按Ctrl + K聚焦搜索框，输入关键词即可在所有分区中模糊匹配：匹配的快捷键会带分类标签列出，匹配的分区名可直接跳转。匹配器是一个轻量子序列打分器，实现在 ryoku/hub/quickshell/fuzzy.js。找"圆角"、找"night light"、找某个 bind，一次输入直达。

设备区：Displays显示器管理与输入设置

显示器管理：拖拽画布+命名档案

Displays分区（ryoku/hub/quickshell/pages/DisplaysPage.qml）是很多人最惊喜的一页：

• 自动检测所有已连接显示器，排布在一个拖拽画布上，边缘自动吸附对齐
• 每台显示器单独设置分辨率、刷新率、缩放、旋转、自适应同步、镜像、启用/停用
• 可保存命名档案，以连接硬件的身份为钥匙——下次插上同一批显示器，布局自动恢复

数据面由ryoku-monitor负责，档案存放在~/.config/ryoku/monitors/，画布上的编辑只在你点 Apply 时才落到实时屏幕。

Input输入与鼠标、Cursor光标

Input分区（ryoku/hub/quickshell/pages/InputPage.qml）覆盖键盘布局/变体/选项、numlock、键位重复速度；鼠标灵敏度、加速度、左手模式、滚轮速度、自然滚动、中键粘贴；触控板轻点、双指手势切换工作区（可调方向与距离）。Cursor单独一页管理光标主题（扫描已安装主题）、大小、闲置/打字时隐藏。

桌面区：Appearance外观、Bar Studio与窗口规则

Appearance外观：一个页面调出整套Hyprland视觉

Appearance是内容最重的分区，把 Hyprland 的"灵魂参数"全部做成控件：

• 窗口：间距、圆角与圆角柔和度、边框粗细、激活/非激活透明度、非激活压暗
• 模糊与阴影：blur 尺寸、pass 数、X-ray、vibrancy、noise；阴影范围、锐度；窗口 glow
• 平铺布局：dwindle / master / scrolling 切换，边缘 resize 与浮动吸附
• 动画风格：含 wobbly windows（拖拽时带弹簧的晃动窗口）与开关窗风格
• Theme 标签页：Follow Wallpaper 或 57 个命名调色板色卡（走theme.theme键，与侧边栏主题选择器读写同一键），以及 Material You（Matugen）引擎与按应用主题
• Comfort 标签页：背光与夜灯；Rices 标签页：捕获、导入、应用、导出整套桌面外观

Bar Studio：顶栏外观实时预览

Bar Studio（ryoku/hub/quickshell/pages/BarStudioPage.qml）管的是桌面框架（frame）的"chrome"：左侧栏、顶栏形态（sumi / qs bar / nacre / obi）、island 形态（full / fit / dock / notch）、边框与圆角像素值。每个改动实时落到桌面，Save 之后持久保留——所见即所得。

Windows窗口规则与Layer Rules

Windows（ryoku/hub/quickshell/pages/WindowRulesPage.qml）支持按 class 或标题匹配，对窗口施加：浮动、尺寸、固定位置、透明度，压制模糊/边框/阴影/圆角/压暗，焦点控制、宽高比、闲置抑制等完整效果集。Layer Rules则针对 layer-shell 表面（顶栏、launcher、通知守护）按 namespace 匹配，施加 blur、dim、X-ray 或停用动画。

进阶区：Animations动画、Keybinds快捷键与Lockscreen锁屏

Animations：可视化贝塞尔曲线编辑器

Animations分区（ryoku/hub/quickshell/pages/AnimationsPage.qml）直接读取实时动画树（hyprctl animations），每条叶子可独立开关、调速、调贝塞尔曲线、选风格（pop-in / slide / fade 变体）。亮点是可视化曲线编辑器——拖动手柄实时预览窗口动画手感，曲线与覆盖项随 Save 写入settings.lua。

Keybinds：永远不漂移的快捷键图鉴

Keybinds（ryoku/hub/quickshell/pages/KeybindsPage.qml）的完整快捷键图鉴是从实时配置现场读取的（后端ryoku-hub keybinds解析 ~/.config/hypr/modules/binds.lua），所以文档和实际行为永不脱节；在此之上还能用 Custom 编辑器叠加你自己的快捷键。

Lockscreen与Shell、Updates

• Lockscreen：列出从 RyoStore 安装的 qylock 主题，磁贴直接预览真实锁屏，一键同时激活会话锁与 SDDM 登录界面（系统路径那一步经 pkexec 要密码）
• Shell：实时编辑屏幕框架、顶岛（经典融合岛 / 悬浮药丸 / 无，可加悬停显现）与桌面可视化器，写入~/.config/ryoku/shell.json
• Updates：显示当前 checkout 在通道上落后哪些 commit，并可设自动检查频率

底层机制：覆盖模型让你放心改、随时回

Ryoku Settings 最聪明的设计是覆盖模型（override model），这也是你随便折腾也不会把系统改坏的原因：

1. 可编辑的"事实来源"是一份 JSON：~/.config/ryoku/hypr.json，由ryoku-hub独占
2. ryoku-hub从它生成~/.config/hypr/settings.lua，只写与出厂默认不同的值——没动过的设置自然落回基础模块
3. hyprland.lua在基础模块之后、user.lua之前require它：GUI 的微调覆盖默认，而手写user.lua依然拥有最高优先级
4. 编辑标量（外观/输入/光标）时通过hyprctl eval即时预览，不 reload、无闪烁；Save 时持久化 JSON、重新生成settings.lua并 reload 锁定列表类变更

唯一例外是显示器：归ryoku-monitor管，写monitors.lua，画布编辑只在 Apply 时生效。想撤销？页面上的 Revert 和离开页面都会自动恢复已保存状态；底栏还有 RESET TO DEFAULTS 一键归零。

总结：为什么这是Hyprland用户的正确打开方式

Ryoku Settings 把"编辑配置文件"这件 Hyprland 新手的劝退课，变成了"打开面板、点一下、看它发生"。它的架构——Go 数据面 ryoku/hub/backend/ + 原生 QML 前端 ryoku/hub/quickshell/ + JSON 覆盖文档——既保证了即时反馈，又保证了可恢复性。相关文档延伸阅读：

• 控制中心总览：ryoku/hub/README.md
• 桌面设计语言：docs/ui-ux.md
• 仓库结构说明：docs/structure.md
• 锁屏细节：ryoku/lockscreen/README.md

装好 Ryoku，Super + ,，你的 Hyprland 桌面从此只需要鼠标。