Seekey 配置与编辑器

配置文件查找顺序#

Seekey 每次只读取一个 INI 文件，优先级如下：

1. --config /path/to/file.ini
2. 传入 --xdg 时的 $XDG_CONFIG_HOME/seekey/config.ini
3. 当前工作目录的 seekey.ini
4. 内置默认值

普通 seekey 不会隐式读取 ~/.config/seekey/config.ini；安装的 desktop 文件 会主动传入 --xdg。用下面的命令确认实际来源和最终值：

seekey --print-config
seekey --xdg --print-config
seekey --validate-config

初始化配置：

seekey --init-config
seekey --init-config --xdg

GUI 和 TUI#

seekey --config-gui
seekey --config-tui

两个编辑器都会先检查真实输入浮层。主浮层已经运行时继续显示它并跳过样例； 没有主浮层时才启动独立示例，实时渲染尚未保存的样式，因此不会出现“实际输入 浮层 + 样例浮层”两层显示框。预览子进程不读取 evdev；用户级运行锁保证同一 时间只有一个编辑器预览。GUI 根菜单会根据主浮层状态显示“启动按键浮层”或 “关闭按键浮层”；关闭主浮层后补上样例，启动主浮层前先移除样例。

GUI 使用 fuzzel 风格的提示行、固定列表和搜索交互，并读取 ~/.config/fuzzel/fuzzel.ini 的布局和颜色。该文件缺失或损坏时会使用内置样式。

常用行为设置#

[general]
duration-ms=1200
typing-idle-ms=650
typing-display=full
fade-ms=180
max-items=5
layer-shell=auto
theme=default
merge-repeats=true
merge-modifiers=true
show-mouse=false

• duration-ms：气泡保持可见的时间。
• typing-idle-ms：超过该停顿后，下一个字符另开打字气泡。
• typing-display：full 显示并拼接文字；masked 始终显示一个固定的 <若干字符> 标签；off 隐藏普通字符，但保留快捷键和非文字按键。
• merge-repeats：把重复非打字操作合并为 Key xN。
• merge-modifiers：把 Ctrl 后续扩展为 Ctrl + C，而不是创建两个气泡。
• show-mouse：显示点击与滚轮；默认关闭。

演示密码或其他敏感字段时建议使用 masked 或 off。masked 的标签不会随 输入增长，因此不暴露字符数量。这两个隐私模式也会阻止 --debug-input 输出 普通字符事件，但 Seekey 仍需读取 evdev 事件来区分普通字符和快捷键。

布局与字体#

[style]
align=right
disappear=fade
spacing=7
overlay-padding=12
key-min-width=0
key-padding-x=14
key-padding-y=8
key-radius=6
key-border-width=1
key-font-px=20
key-font-weight=700
font-family=inherit
typing-max-width=480

align 决定气泡从左、中央或固定右边界排列。font-family=inherit 使用桌面 GTK 字体，也可以填写 Pango 可识别的字体族。typing-max-width=0 表示不限制连续输入 气泡宽度。

当前主题包括 default、light、nord、dracula、catppuccin、 monokai 和 matugen。[style] 中显式写出的颜色总是覆盖主题值。

Matugen 单独见动态配色，窗口锚定见 显示逻辑与桌面兼容。