fix(hotkey): Esc 取消改走独立通道——修复转写/润色期间按 Esc 停不下来

[bigsongeth]

User description

问题

转写（Transcribing）和 LLM 润色（Polishing）期间按 Esc 完全没有反应，必须干等整段流程跑完。#798 已经给 end_session 加了「转写 vs 取消」的 tokio::select! 赛跑、润色流也有 should_cancel 检查——但取消信号本身送不进来。

根因

Esc 的 HotkeyEvent::Cancelled 与 Pressed/Released 共用同一条 mpsc channel + 同一条 bridge 线程。bridge 为修 #468/#475 的 latch 竞态改成了串行 block_on（#489），Hold 松手后 end_session 就在 bridge 线程上同步跑完整段转写 + 润色：

1. 用户松开听写键 → bridge block_on(end_session)，线程被占死；
2. 用户按 Esc → Cancelled 进 channel 排队，没有人能 recv；
3. wait_for_processing_cancel 每 75ms 轮询的 cancelled 旗标只有 cancel_session 会设置，而 cancel_session 正等着这条被堵死的线程来调——fix(dictation): 转写阶段可中断——按 Esc 立即取消在途 ASR 请求 #798 的 select! 赛跑永远等不到信号；
4. 流程跑完、bridge 空出来才取出 Cancelled，此时 phase 已回 Idle，cancel 变 no-op。

听写键为修饰键（默认 fn 等）时必现；自定义组合键用户不受影响（按键事件走 ComboHotkeyMonitor 的独立线程，主 monitor 的 channel 空闲）——这也是 #798 验证时没暴露的原因。

修法

把 Cancelled 从 HotkeyEvent 枚举中拆出（编译器强制所有平台改到位），Esc 在 tap/hook 回调里改发独立的 Sender<()>，由专用 esc-cancel-bridge 线程消费并调 cancel_session（纯同步快路径，不 await）：

• hotkey.rs：HotkeyMonitor::start 新增 cancel_tx: Sender<()> 参数；macOS CGEventTap 与 Windows WH_KEYBOARD_LL 的 Esc 分支改发 cancel 通道；Linux 占位 adapter / mobile stub 同步签名。
• hotkey_loops.rs：新增 esc_cancel_bridge_loop + spawn_esc_cancel_bridge；两个 bridge loop 删除 Cancelled 臂；Less Computer 修饰键 monitor 的 Esc 转发同样迁移（cancel_session 幂等，双 tap 重复触发无害）。

Pressed/Released 的串行化语义（#468/#475）完全不动。

验证

• cargo check / cargo check --tests 通过；cargo test 794 passed。
• 取消旗标置位后，转写阶段由 fix(dictation): 转写阶段可中断——按 Esc 立即取消在途 ASR 请求 #798 的 select! 立即 drop 在途请求，润色阶段由 should_cancel 停止流式输出——两个阶段均恢复可中断。

🤖 Generated with Claude Code

---

PR Type

Bug fix, Tests

---

Description

• Route Esc cancel through dedicated esc_cancel_bridge thread

• Remove HotkeyEvent::Cancelled and use Sender<()> cancel channel

• Update macOS/Windows listeners plus Linux/mobile stubs

• Add unit tests for recording-skip and idempotent cancel

---

File Walkthrough

	Relevant files
Bug fix	hotkey_loops.rs Add dedicated Esc cancel bridge loop and tests openless-all/app/src-tauri/src/coordinator/hotkey_loops.rs Add esc_cancel_bridge_loop and spawn_esc_cancel_bridge for a dedicated cancel consumer. Remove HotkeyEvent::Cancelled handling from hotkey and less-computer bridge loops. Spawn cancel bridge and pass cancel_tx to HotkeyMonitor::start. Add unit tests covering Processing cancel, recording skip, and repeated signals. +151/-6 hotkey.rs Split Esc cancel into dedicated channel openless-all/app/src-tauri/src/hotkey.rs Remove Cancelled variant from HotkeyEvent. Thread Sender<()> cancel channel through monitor, adapters, listener loops, and contexts. macOS handle_key_down and Windows dispatch_keyboard_event send Esc on cancel channel. Linux placeholder adapter accepts the new cancel channel parameter. +50/-13
Miscellaneous	hotkey.rs Update mobile hotkey stub for cancel channel openless-all/app/src-tauri/src/mobile_stubs/hotkey.rs Remove Cancelled variant from mobile stub HotkeyEvent. Add _cancel_tx parameter to HotkeyMonitor::start. +1/-1
Enhancement	coordinator.rs Wire Esc cancel bridge into hotkey startup openless-all/app/src-tauri/src/coordinator.rs Spawn esc_cancel_bridge before each HotkeyMonitor::start call. Pass cancel channel to initial and supervisor hotkey monitors. Update less-computer modifier monitor to forward Esc cancel. +2/-1

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 349b221)

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis ❌ 798 - Partially compliant Compliant requirements: 按 Esc 产生的取消信号现在通过独立线程/通道送达 cancel_session，Processing 期间不会被占用的 hotkey bridge 阻塞，用户可立即中断 Non-compliant requirements: 本 PR diff 不包含 fix(dictation): 转写阶段可中断——按 Esc 立即取消在途 ASR 请求 #798 主体实现（select! 赛跑、drop future、provider 覆盖），无法单独证明这些条目已满足，需结合 fix(dictation): 转写阶段可中断——按 Esc 立即取消在途 ASR 请求 #798 已合入代码核验 Requires further human verification: 真机端到端：转写/润色中按 Esc 应立即变“已取消” 各 provider（Volcengine / Bailian / Qwen3 / Whisper / MiMo / Foundry / Sherpa / Apple Speech / local Qwen3）的真机取消行为 468 - Not compliant Non-compliant requirements: 本 PR 未涉及启动/静默运行逻辑 489 - Partially compliant Compliant requirements: 本 PR 将 Esc 取消从 Pressed/Released 共用队列中拆出，取消信号不会再与已串行化的边沿事件互相阻塞 Non-compliant requirements: 本 PR 未修改 fix(windows): 快捷键二次按键失效 - 串行化 Pressed/Released edge #489 的 Pressed/Released 串行化逻辑，也未直接修复二次按键 latch 问题 Requires further human verification: Windows 实机回归：toggle/hold 模式下快捷键二次按键行为

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Possible Gap Linux 分支的 start_adapter 接收 _cancel_tx 后没有保存或转发，函数返回时 sender 被 drop， esc_cancel_bridge_loop 的 rx.recv() 会立刻返回 Err，独立取消线程随即退出；同时 HotkeyEvent::Cancelled 已从枚举中移除。如果 Linux fcitx 路径之前依赖该枚举发送 Esc 取消， 本次改动后 Linux 上转写/润色期间的 Esc 取消将没有可用的信号通道。需确认 Linux 是否在取消功能 范围内；若在，应像 macOS/Windows 一样把 cancel_tx 接入 fcitx 事件源，否则该修复在 Linux 上不生效。 pubfn start_adapter(_binding:HotkeyBinding,_tx:Sender<HotkeyEvent>,_cancel_tx:Sender<()>,) -> Result<Box<dynHotkeyAdapter>,HotkeyInstallError>{ log::info!("[hotkey] Linux — fcitx5 plugin handles hotkeys");Ok(Box::new(PlaceholderAdapter{ _tx }))

[github-actions]

Persistent review updated to latest commit edcdda7

[github-actions]

Persistent review updated to latest commit 349b221