企业官网建设流程全解析

Ryoku 是一款基于 Arch Linux 的「有主见的」高端桌面系统，它的锁屏子系统用同一套qylock 皮肤同时驱动SDDM 登录界面和会话内锁屏。本文带你从 Ryoku Settings 一键换主题、看懂 3 个关键配置文件，到指纹、安全密钥解锁的完整锁屏定制玩法。🔐

一块皮肤,两个入口: Ryoku 锁屏架构速览

Ryoku 的锁屏由两个画面组成，但共享同一套 qylock 主题皮肤（默认是clockwork/orbital）：

• 开机登录画面：由 SDDM 渲染选中的皮肤（greeter）
• 会话内锁屏：按锁屏快捷键或空闲超时后触发，是 Quickshell 的WlSessionLock表面，Hyprland 和 niri 下表现一致

默认主题clockwork/orbital是一面轨道时钟：同心分钟环与秒环扫过粗体小时读数，输入密码的过程会像"上发条"一样积蓄能量，最终弹簧弹开进入桌面。登录/认证流程本身不受换肤影响，只换"长相"。

架构细节可参考 ryoku/lockscreen/README.md。

一键换锁屏主题: Ryoku Settings 的 Lockscreen 页面

这是最推荐的定制入口，全程图形化：

1. 打开 Ryoku Settings（Hub），进入Lockscreen页面
2. 页面以瀑布流列出所有已安装的 qylock 主题，每块磁贴带循环动图预览
3. 点击磁贴即可激活，背后执行ryoku-hub lock set <slug>，它会做两件事：
   • 写入~/.config/qylock/theme→会话内锁屏立即换肤
   • 通过pkexec提权执行apply-greeter：把主题复制到固定路径/usr/share/sddm/themes/ryoku，并写/etc/sddm.conf.d/99-ryoku.conf（Current=ryoku）→SDDM 登录界面下次开机同步换肤
4. 想先看看效果再决定？磁贴上的Preview按钮会用ryoku-qylock-lock <slug>启动真实的锁屏预览

后端逻辑在 ryoku/hub/backend/lock.go，界面实现在 ryoku/hub/quickshell/pages/LockscreenPage.qml。

去哪里找新主题: RyoStore 负责安装, Settings 负责激活

Ryoku 自带的主题是精简过的（约 35 个上游主题中只保留了默认皮肤，保证离线可安装）。更多主题通过RyoStore（ryostore）获取：

• ryostore open lockscreens打开锁屏专区，可浏览上游 qylock 目录、看预览、搜索
• 遵循「只安装、不激活」原则：安装完只提示Open in Settings，不会偷偷改变你的桌面
• 下载的主题落到~/.local/share/qylock/themes，之后到 Settings 的 Lockscreen 页面激活

商店机制详见 docs/store.md。

主题"骨架"解剖: clockwork/orbital 文件结构

每个 qylock 主题就是一个文件夹，核心结构如下（以默认主题为例）：

qylock/themes/clockwork/orbital/ Main.qml # 主题主体（Qt6 QML） theme.conf # 主题配置 metadata.desktop # 显示名、作者 preview.gif # Settings 中的预览动图 font/ # 主题字体 i18n/ # 多语言文案

其中最常用的是 theme.conf：

主题的时钟与动画逻辑集中在 Main.qml，例如第 87 行的themeMode读取就会决定整个界面的明暗配色。想做一个自己的皮肤，照着这个目录结构复制一份改就行——只要文件夹里有Main.qml，它就会被 Settings 识别为一个可选主题。

SDDM 登录界面深度玩: 三个配置文件 + 两个安装脚本

想深入定制登录界面，记住这 3 个文件：

1. /etc/sddm.conf.d/99-ryoku.conf—[Theme] Current=ryoku，告诉 SDDM 用哪套皮肤
2. /usr/share/sddm/themes/ryoku— 登录界面实际加载的皮肤目录（固定叫ryoku，换肤就是整目录替换）
3. ~/.config/qylock/theme— 会话内锁屏读取的 slug（如clockwork/orbital）

两条手动安装命令（正常安装时由后端自动执行，这里供进阶参考）：

sudo ryoku/lockscreen/sddm/setup # 启用 sddm.service、graphical.target、PAM 密钥环 ryoku/lockscreen/install-qylock # 安装 greeter 主题 + 会话内锁屏

两者都支持--dry-run（或RYOKU_DRYRUN=1），先打印计划再动手。⚙️

几个值得知道的细节（来自 sddm/setup 与 CHANGELOG.md）：

• 登录界面跑在 Wayland 上：SDDM 通过weston --shell=kiosk运行 greeter，避免 X11 残留进程白耗电
• 多显示器定位：greeter 默认钉在笔记本内屏（eDP）上；想换屏可写/etc/ryoku/greeter.conf（PRIMARY=<name>）
• 键盘布局与会话一致：非 US 布局密码在登录框也能正常输入
• 指针永远可见：主题甚至自带软件绘制的箭头，兼容 NVIDIA 等不画硬件光标的机器

不止密码: 指纹与安全密钥解锁

Lockscreen 页面还整合了完整的生物/硬件解锁方案：👆

• 指纹解锁：基于fprintd，Settings 里可直接录入、验证、命名、删除指纹；锁屏上任何主题都会浮出一层平滑的扫描动画（FingerprintScan覆盖在主题之上，无需改主题代码）。还能一键把指纹接入sudo和 SDDM 登录界面（通过pam_fprintd_grosshack）。开关文件是~/.config/qylock/fingerprint
• 安全密钥：基于pam_u2f，ryoku security-key enroll录入后即可用于登录、sudo 和锁屏，支持"密钥+密码"双因素模式
• 密钥环联动：默认unlock-on-login，登录密码同时解锁浏览器保存的密码库，桌面不再弹密钥环提示

快速自检清单: 锁屏定制常见问题

• 只想预览不想应用？用 Lockscreen 页面的 Preview 按钮，或终端跑ryoku-qylock-lock <slug>
• 换肤后登录界面没变？登录界面在系统路径下，需要提权那一步（apply-greeter）成功才生效；取消 polkit 授权时本次会话锁屏会先换、登录界面保持旧皮肤
• 主题文件坏了会被锁在外面吗？不会。lock.sh启动前会校验Main.qml是否存在，缺失时自动回退到随附的clockwork/orbital
• 想回退？回到 Lockscreen 页面重新选中旧主题即可，一次操作同时恢复锁屏与登录界面
• 多会话安全：每个在线会话各自有独立的 qylock 客户端，锁/解锁按 login1 会话串行化，不会互相抢占传感器或解锁 UI

照着上面的流程走，你大约 5 分钟就能让 Ryoku 的登录界面和锁屏换上全新皮肤——而这一切都只需要一块 qylock 主题，一个命令同步两处。