Ryoku 首次登录完全指南:快速上手向导、必学快捷键与桌面初体验

刚装好 Ryoku 却不知从何下手？这篇 Ryoku 首次登录指南帮你用最快速度熟悉这台"开箱即用"的 Arch 桌面：从开机后的欢迎向导、最核心的 Super 快捷键，到 Launcher 启动器与 Ryoku Settings 控制中心,一次讲清,让你第一天就能流畅使用。

第一次开机:Ryoku 桌面长什么样

从 USB 启动签名 ISO、完成引导式安装后,系统会直接进入一个"已经有人精心打理过"的 Wayland 桌面:一边是状态栏,对边是应用 Dock,壁纸上挂着时钟,其余什么都没有在争夺你的注意力。整个桌面运行在 Hyprland(或 niri)之上,由 Quickshell 构建的 Ryoku Shell 负责所有界面,主题会实时从你的壁纸中提取配色——换一张壁纸,栏、小组件、窗口边框全部跟着换色。

欢迎向导:首次登录的 5 分钟上手

第一次登录时,Ryoku 会自动弹出一个简短的Welcome 欢迎向导(以后不会再出现,由~/.local/state/ryoku/welcome-seen标记控制)。它会带你走一遍:

• 打开几乎所有界面的那几个核心快捷键;
• 可以当场做出的几个选择:界面缩放比例、状态栏样式、显示哪些桌面小组件;
• 每张界面"叫什么名字、怎么呼出"。

其余所有设置都收在Ryoku Settings(按Super + ,打开)里,向导结束后随时可以回来调整。如果你错过了向导,按Super + K可以随时调出完整快捷键速查表,相当于向导的"文字版"。

必学快捷键清单:只记这 10 个就够用

Super 键就是键盘上的 Windows 键。以下是新手最该先记住的一组(完整绑定定义在 binds.lua):

多窗口操作也有"肌肉记忆"级技巧:Super + 方向键切换焦点,Super + Shift + 方向键移动窗口,Super + Ctrl + 方向键调整窗口大小。所有按键都可以在 Ryoku Settings 里改,不强迫你适应任何布局。

Launcher 启动器:一个搜索框搞定一切

按Super + Space唤出的 Launcher 是 Ryoku 的"命令面板",也是新手的瑞士军刀。它待机时只是时钟、天气和一张艺术卡片,一输入就开始工作:

• 默认:模糊搜索并启动应用,同时匹配窗口和文件(3 个字符以上);
• 输入数字或=:直接算数学、单位、汇率;
• ?前缀:网页搜索,支持!bang站点快捷;
• install 包名:直接安装/搜索软件包;
• /前缀:执行系统动作(锁屏、换壁纸、截图等);
• ;前缀:剪贴板历史,随时找回复制过的内容;
• 有音乐在播放时,它还能当远程遥控器控制播放进度。

对新手来说,记住一条心法:想不起哪个应用、哪条命令,先按Super + Space敲关键词。更多细节见 docs/launcher.md。

Ryoku Settings 控制中心:改桌面的正确姿势

Super + ,打开的 Ryoku Settings(内部叫 Hub)是整套系统的"控制台",按页面分组:外观、动画、显示、连接、GPU、按键绑定、窗口规则、自启动……全部可视化编辑,不用碰任何配置文件。几个新手最常用的入口:

• Appearance / 壁纸:换壁纸会立刻带动整桌配色;
• App Launcher:在 Hero、Main、OkShell、Kairos 四种启动器风格间切换;
• Bar / Bar Studio(Super + .):实时调整状态栏的边、粗细和小组件,改动即时生效,Save 保留、Revert 回滚;
• Lockscreen:从卡片画廊挑选锁屏皮肤;
• Extras:一键安装如 CachyOS 内核等附加组件。

所有你的个性化修改都保存在独立的用户覆盖文件里,更新系统时不会被覆盖。

第一天必做的 3 件事

1. 过一遍 Welcome 向导,选定缩放比例和栏样式;
2. 跑两次Super + Space,把常用应用、终端、浏览器都用搜索打开,养成习惯;
3. 打开 Ryostore 逛一圈——它是官方组件商店,提供桌面主题(rices)、锁屏、栏样式、插件和软件包,安装不会自动生效,装完再到 Settings 里启用,详见 docs/store.md。

日常维护也只需记两条命令:

ryoku update # 更新 Ryoku 桌面层(自动打快照,可回滚) sudo pacman -Syu # 更新 Arch 基础系统与内核

万一更新出问题,ryoku rollback或开机菜单里的快照都能救你,完全不必慌。

延伸阅读与相关路径

• docs/ryoku.md:Ryoku 的设计理念与组件结构总览
• docs/preinstalled.md:出厂预装了什么,一目了然
• docs/launcher.md:启动器全部搜索前缀与扩展方式
• docs/bar.md:状态栏与 Bar Studio 的完整玩法
• docs/updates.md 与 docs/cli.md:更新机制与ryoku命令参考
• 快捷键绑定源码:ryoku/hyprland/modules/binds.lua

祝你在 Ryoku 的第一个晚上,只感受"力与美",不再折腾。