[area] Debian操作系统Wayland桌面环境下录音快捷键不可用

[StarForAll]

现象

Debian操作系统Wayland桌面环境下录音快捷键不可用

即使是在应用点击快捷键也不可用
建议补充对应的脚本或者命令让用户去系统设置中配置快捷键即可

在Linux中的桌面环境中Wayland是主流，建议增强在linux中wayland中的可用性

影响

当前在配置好模型信息之后测试快捷键就不可用

建议接受标准

在全局环境下录音识别快捷键可用

TODO / 不确定项

No response

[aeoform]

是的，现在在wayland下完全无法使用

[appergb]

@StarForAll @aeoform 感谢反馈，已在 Beta v1.3.1-18 修复，请帮忙测试一下。

修复方式

Wayland 协议出于安全考虑禁止应用监听非聚焦窗口的键盘事件，原 rdev 路径在 Wayland 必然失效。本次按你们建议的方向落地：

• Wayland 下 OpenLess 不再硬拒绝（之前那条 "请切到 X11 session" 报错已删）
• 新增 CLI 命令 openless --toggle-dictation（QA 触发用 --toggle-qa、取消用 --cancel-dictation），通过 single-instance 把命令转发给主实例
• Settings → 录音 顶部多了一段引导 callout，含可复制命令 + GNOME / KDE / Hyprland / sway 四段配置步骤

下载（Debian/Ubuntu 用户）

https://github.com/Open-Less/openless/releases/tag/v1.3.1-18-beta-tauri

• OpenLess_1.3.1-18_amd64.deb — Debian/Ubuntu
• OpenLess_1.3.1-18_amd64.AppImage — 通用 AppImage
• OpenLess-1.3.1-18-1.x86_64.rpm — Fedora/openSUSE

使用步骤

1. 安装并启动 OpenLess
2. 打开 Settings → 录音，会看到 检测到 Wayland 桌面环境 的引导 callout
3. 按 callout 的步骤把 openless --toggle-dictation 绑到你桌面环境的自定义快捷键（GNOME 是 设置 → 键盘 → 自定义快捷键；KDE 是 系统设置 → 快捷键 → 自定义快捷键）
4. 按你绑的快捷键就能触发录音了

反馈点

测试时麻烦帮忙看下：

• 绑命令后按快捷键能否稳定触发录音/停止
• callout 文案是否清楚，步骤是否能照做下来
• 有没有遇到第二实例闪现/聚焦抢夺等异常

任何问题在本 issue 回复即可。这是 Beta 测试版，正式版会在测试稳定后合入。

[StarForAll]

使用的是beta 1.3.1-19_amd64.deb，在系统中配置了快捷键之后然后去设置中修改应用内的快捷键，导致页面出现黑白闪烁然后全黑没有反应，之后强制退出进程再次打开时，进入设置界面，就只是移动鼠标就出现了黑白闪烁的情况;有一次打开系统通知栏原本正常的界面也黑屏了

[aeoform]

beta 1.3.1-18_amd64.deb在我这里正常唤醒了

[aeoform]

beta 1.3.1-19_amd64.deb也没问题，但是应用内提示没写QA 触发用 --toggle-qa、取消用 --cancel-dictation，建议加上

[appergb]

@StarForAll 1.3.1-19 在你机器上闪烁 / 黑屏，麻烦帮忙补几个环境信息好定位：

1. 桌面环境 + 版本（GNOME / KDE / sway / Hyprland，含版本号）
2. 显卡 + 驱动：glxinfo | grep "OpenGL renderer" 和 lspci -k | grep -A2 VGA
3. 是否能稳定复现？复现步骤、复现率
4. workaround 试一下：
   • WEBKIT_DISABLE_COMPOSITING_MODE=1 openless 启动，闪烁是否消失？
   • GDK_BACKEND=x11 openless 启动呢？
5. 安装方式：deb / AppImage / rpm
6. 日志：~/.local/share/OpenLess/Logs/openless.log 闪烁前后那一段

闪烁触发点定位到"应用内快捷键编辑"，怀疑 WebKitGTK + Wayland 合成器冲突或 hotkey 输入框的低层级键盘捕获跟 Wayland 互掐。等你回信再定 fix 方向。

——

另外补一下，@aeoform 提到的"应用内提示没写 --toggle-qa / --cancel-dictation"已经在 #433 修了（callout 三命令并列 + 5 语言同步翻译）。

[StarForAll]

@appergb
❯ uname -a
Linux X10Ti 6.1.0-42-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.159-1 (2025-12-30) x86_64 GNU/Linux
❯ glxinfo | grep "OpenGL renderer"
OpenGL renderer string: Mesa Intel(R) UHD Graphics (CML GT2)
❯ lspci -k | grep -A2 VGA
00:02.0 VGA compatible controller: Intel Corporation CometLake-H GT2 [UHD Graphics] (rev 05)
DeviceName: Onboard - Video
Subsystem: Tongfang Hongkong Limited CometLake-H GT2 [UHD Graphics]

01:00.0 VGA compatible controller: NVIDIA Corporation TU106M [GeForce RTX 2070 Mobile / Max-Q Refresh] (rev a1)
Subsystem: Tongfang Hongkong Limited TU106M [GeForce RTX 2070 Mobile / Max-Q Refresh]
Kernel driver in use: nvidia

以上是我正在使用的Debian12 KDE Wayland桌面环境信息;

屏幕闪烁的问题在使用快捷键完成录音之后每一次都出现了

WEBKIT_DISABLE_COMPOSITING_MODE=1 openless 使用时快捷键进行录音没有出现闪烁的情况但是出现的录音有黑色的背景，而且点击那个'x'也很难关闭

GDK_BACKEND=x11 openless 使用录音快捷键完全没有反应

安装方式：deb

以下是对应一次完整打开关闭的日志：
2026-05-13T15:58:37.972951349Z [INFO] [startup] Wayland session — frontend will pull via is_wayland_cli_mode
2026-05-13T15:58:37.973000004Z [INFO] [hotkey] Wayland session detected; rdev listener skipped — use desktop shortcut → openless --toggle-dictation instead (issue #420)
2026-05-13T15:58:37.973045999Z [INFO] [coord] hotkey listener installed (after 1 attempt(s))
2026-05-13T15:58:37.999280172Z [INFO] [coord] combo hotkey listener installed on main thread (after 1 attempt(s))
2026-05-13T15:58:38.049289724Z [INFO] [coord] QA hotkey listener installed on main thread (after 1 attempt(s))
2026-05-13T15:58:38.099469039Z [INFO] [coord] action hotkey SwitchStyle listener installed after 1 attempt(s)
2026-05-13T15:58:38.149524163Z [INFO] [coord] action hotkey OpenApp listener installed after 1 attempt(s)
2026-05-13T15:58:41.301288828Z [INFO] [single-instance] another instance launched with intent=ToggleDictation, dispatching
2026-05-13T15:58:41.301424189Z [INFO] [cli] toggle-dictation: Idle → start_dictation
2026-05-13T15:58:41.476663767Z [INFO] [audio-mute] system output muted for recording
2026-05-13T15:58:41.47669396Z [INFO] [audio-mute] acquired by dictation; holders=1
2026-05-13T15:58:41.486841434Z [INFO] [recorder] inputDevice=default inputFormat sampleRate=44100 channels=2 fmt=F32
2026-05-13T15:58:41.487334106Z [INFO] [coord] recorder started (asr=siliconflow, phase=Starting)
2026-05-13T15:58:41.487358655Z [INFO] [coord] session started
2026-05-13T15:58:41.525518386Z [INFO] [recorder] cb#1 inLen=1853 outLen=673 inRMS=0.29616 outRMS=0.29453 peakIn=0.29600 peakOut=0.29500
2026-05-13T15:58:43.615951457Z [INFO] [recorder] cb#50 inLen=1882 outLen=682 inRMS=0.27027 outRMS=0.26883 peakIn=0.36400 peakOut=0.36400
2026-05-13T15:58:45.749202966Z [INFO] [recorder] cb#100 inLen=1882 outLen=683 inRMS=0.83358 outRMS=0.83336 peakIn=0.98000 peakOut=0.97900
2026-05-13T15:58:46.942330173Z [INFO] [single-instance] another instance launched with intent=ToggleDictation, dispatching
2026-05-13T15:58:46.942411838Z [INFO] [cli] toggle-dictation: Listening → stop_dictation
2026-05-13T15:58:46.948928611Z [INFO] [recorder] cpal Stream dropped (mic released)
2026-05-13T15:58:47.488738441Z [INFO] [audio-mute] released by dictation; holders=0
2026-05-13T15:58:47.50503506Z [INFO] [audio-mute] system output mute restored after recording
2026-05-13T15:58:48.239265125Z [INFO] [coord] polish dispatch: translation=false mode=Light streaming_eligible=false
2026-05-13T15:58:48.297029606Z [INFO] [llm] POST https://api.siliconflow.cn/v1/chat/completions provider=siliconflow model=Qwen/Qwen2.5-72B-Instruct-128K
2026-05-13T15:58:48.754401155Z [INFO] [llm] HTTP 200 body={"id":"019e220fe88592c62faf1504ca50ff73","object":"chat.completion","created":1778687928,"model":"Qwen/Qwen2.5-72B-Instruct-128K","choices":[{"index":0,"message":{"role":"assistant","content":"嗯。"
2026-05-13T15:58:48.755381306Z [WARN] [insertion] clipboard get_text failed before overwrite: The clipboard contents were not available in the requested format or the clipboard is empty.
2026-05-13T15:58:49.544692528Z [WARN] [insertion] clipboard get_text failed during restore: The clipboard contents were not available in the requested format or the clipboard is empty.
2026-05-13T15:58:49.54472757Z [INFO] [insertion] skip clipboard restore: latest clipboard no longer matches inserted text

[bbbybus2]

@StarForAll 1.3.1-19 在你机器上闪烁 / 黑屏，麻烦帮忙补几个环境信息好定位：

1. 桌面环境 + 版本（GNOME / KDE / sway / Hyprland，含版本号）

2. 显卡 + 驱动：glxinfo | grep "OpenGL renderer" 和 lspci -k | grep -A2 VGA

3. 是否能稳定复现？复现步骤、复现率

4. workaround 试一下：

   • WEBKIT_DISABLE_COMPOSITING_MODE=1 openless 启动，闪烁是否消失？
   • GDK_BACKEND=x11 openless 启动呢？

5. 安装方式：deb / AppImage / rpm

6. 日志：~/.local/share/OpenLess/Logs/openless.log 闪烁前后那一段

闪烁触发点定位到"应用内快捷键编辑"，怀疑 WebKitGTK + Wayland 合成器冲突或 hotkey 输入框的低层级键盘捕获跟 Wayland 互掐。等你回信再定 fix 方向。

——

另外补一下，@aeoform 提到的"应用内提示没写 --toggle-qa / --cancel-dictation"已经在 #433 修了（callout 三命令并列 + 5 语言同步翻译）。

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
环境与硬件信息
桌面环境：GNOME 46.0

显卡：AMD Radeon RX 7900 GRE (Navi 31)

驱动：amdgpu (Kernel 6.17.0)

安装方式：deb

复现情况
闪屏：设置快捷键后 100% 出现，重启后概率性解除

Chrome 兼容性：录音方式为“切换式”时，无法在 Chrome 浏览器中触发

粘贴板失效：在其他场景触发后，内容无法返回到粘贴板

重复唤起：录音方式为“按住说话”时，会重复多次唤起且伴随闪屏概率

测试结果 (Workaround)
命令测试：执行 WEBKIT_DISABLE_COMPOSITING_MODE=1 openless 后，闪烁依然存在