feat(hotkey): 会话激活期间 Esc 由 OpenLess 独占——不再透传宿主应用 - #855

User description

依赖 #853,请先合并那个。 没有独立取消通道的话,Processing 期间吞掉的 Esc 无法真正触发取消,会退化成「吃掉按键但什么都不做」。

问题

胶囊转圈(录音/转写/润色)时按 Esc,OpenLess 取消会话的同时,宿主应用也收到了这个 Esc——一次按键双重生效。典型场景:在 Claude 里边对话边听写,按 Esc 想取消转写,结果顺带把 Claude 正在生成的回复也取消了。

交互模型

参照输入法:组合窗激活时按 Esc,取消的是候选词,宿主应用收不到这个键——因为此刻用户的意图对象显然是输入法。胶囊显示进行中的会话时完全同构:Esc 的语义就是「取消这个会话」,应当被独占消费。一次输入触发两个语义(且第二个是破坏性的)违反基本交互原则。

Windows 底层钩子本来就吞掉听写触发键(返回 LRESULT(1)),唯独 Esc 一直放行——本 PR 是把同一语义补齐到 Esc,并给 macOS 补上对应能力(active tap 返回 null 删除事件)。

实现

• hotkey.rs:进程级 ESC_EXCLUSIVE 旗标 + set_esc_exclusive()。置位期间 macOS tap 对 Esc keydown 返回 null,Windows 钩子返回 LRESULT(1)。keyup 不吞(宿主应用几乎都在 keydown 响应 Esc,孤儿 keyup 无害)。
• capsule_focus.rs:在 emit_capsule(所有会话状态变化的单一出口,含 fix(capsule): 终止态 2s 自动隐藏 — 覆盖 Done/Cancelled/Error 全路径 #77 审计保证的全部终止路径)维护旗标——胶囊为 Recording/Transcribing/Polishing 且 dictation phase 非 Idle 时置位,终止帧(Done/Cancelled/Error/Idle)自然清除。
• phase 条件专门排除 QA 会话:QA 也走胶囊,但它的 Esc 由聚焦的浮窗窗口自行处理([qa] 划词追问浮窗多处取消 race：Esc 关不掉流 / 烧 token / 跨会话漏字 / loading 帧丢失 #161 的路由),全局吞键反而会把浮窗的 Esc 挡掉。QA 行为完全不变。
• 卡死风险有界:万一 Processing 挂住,吞键窗口由转写全局超时兜底,不会永久吃掉全系统的 Esc;进程退出则 tap 一并消失。

验证

• cargo check --tests 干净;cargo test 794 passed。
• daily 构建 dogfood 实测通过(macOS):转写/润色中按 Esc → 会话取消且宿主应用无反应;空闲时 Esc 正常透传;QA 浮窗 Esc 行为不变。

🤖 Generated with Claude Code

PR Type

Bug fix, Enhancement, Tests

Description

• Add process-wide ESC_EXCLUSIVE flag, maintained by emit_capsule.

• macOS tap and Windows hook consume Esc during active dictation.

• Exclude QA sessions; Esc remains owned by focused floating panel.

• Harden capsule idle scheduling and approval cancellation races.

Diagram Walkthrough

flowchart LR
  Esc["Esc keydown"] --> Listener["Platform listener (macOS tap / Windows hook)"]
  Listener --> Check{"esc_exclusive?"}
  Check -- "yes" --> Consume["Return null / LRESULT(1)"]
  Check -- "no" --> Host["Pass to host app"]
  emit_capsule["emit_capsule state change"] --> Flag["set_esc_exclusive"]
  Flag --> Check