GUI Editor.zh CN

GUI 编辑器

语言： English · 简体中文

seekey --config-gui 会打开 Seekey 内置的可搜索配置菜单。菜单由 Seekey 自身实现，运行时不依赖 fuzzel。

实时浮层预览

真实输入浮层未运行时，打开 GUI 会启动样例浮层，用当前内存配置渲染组合键、 打字组和方向键示例；未保存设置变化时会自动重启。真实浮层已经运行时则保留它， 不再额外创建样例，因此不会出现两层按键显示框。通过菜单关闭真实浮层后会启动 样例；启动真实浮层前会先销毁样例。

样例只读取独立临时 ini，不打开 evdev，不会保存修改，也不会改变记住的显示器； 关闭菜单后子进程和临时文件都会自动清理。每个用户同时只允许一个编辑器预览。

外观

菜单复刻 fuzzel 的提示行、计数器、选中行、固定行数和间距，并遵循 Fuzzel 的标准查找顺序：先读用户的 fuzzel/fuzzel.ini，再查 $XDG_CONFIG_DIRS。 它会读取：

• font、lines、width、horizontal-pad、vertical-pad、inner-pad
• [border] 中的 width、radius、selection-radius
• 标准 [colors] 配色项

使用绝对路径或 ~/ 路径的 fuzzel include= 会递归加载；主文件中的值覆盖 被包含文件，循环引用及超过 16 层的嵌套会被忽略。

fuzzel 配置不存在或损坏时会直接使用内置默认值。尺寸值有安全上限，错误的 超大数值不会创建失控窗口。Matugen 已写入 fuzzel.ini 的颜色会直接生效。

操作

• 输入文字过滤当前列表。
• Up / Down 或 Ctrl+P / Ctrl+N 移动选择。
• Enter 打开或应用选中项。
• Esc 返回；在根页面关闭菜单。
• 浮层未运行时，启动按键浮层会先保存未提交设置，再启动 Seekey；浮层运行 时，该操作会变为关闭按键浮层，无需手动结束进程。
• 使用 Matugen 配色会在 Seekey 能加载有效 colors.json 时应用壁纸调色板； 文件缺失时该行会显示缺失状态并禁用。

没有选中配置文件时，保存配置会写入 <cwd>/seekey.ini，与普通 Seekey 和 TUI 一致。desktop 启动会传入 --xdg，因此菜单仍保存到 $XDG_CONFIG_HOME/seekey/config.ini。

若编辑器通过 --matugen <path> 打开，实时预览和启动按键浮层都会继续使用 同一路径。

字体选择器首先提供系统默认，然后列出 Pango 可见的已安装字体族。 font-family=inherit 会保留桌面 GTK 字体；其他值控制按键气泡字体； 菜单自身仍跟随 fuzzel 的字体。

Desktop 文件

安装后会生成 dev.seekey.desktop，主入口执行：

seekey --xdg --desktop-launch

第一次从 desktop 入口启动时，Seekey 会询问以后默认打开配置菜单还是直接启动 按键浮层。选择保存在 $XDG_STATE_HOME/seekey/window.ini，可在 GUI 的 Desktop launcher 页面修改。seekey --config-gui 始终打开菜单，不受该偏好 影响。

desktop 文件还提供明确的打开设置和启动按键浮层快捷操作。

桌面兼容性

在 niri、Hyprland、Sway、river、Wayfire、labwc 上，菜单使用 wlr-layer-shell 并在打开期间独占键盘输入。在 GNOME、KDE Plasma 或未安装 gtk4-layer-shell 的系统上，会降级为居中的无装饰普通 GTK 窗口。