fix(insertion): make Windows/Linux paste shortcut configurable (#360)

[appergb]

User description

Summary

• 修 [area] #360：模拟粘贴硬编码 Ctrl+V，kitty / alacritty / wezterm / gnome-terminal / foot 等 Linux 终端只接受 Ctrl+Shift+V，听写文本只剩在剪贴板里，看起来像"什么也没插入"。
• 新增 PasteShortcut 枚举（CtrlV / CtrlShiftV / ShiftInsert）作为 UserPreferences 字段，串到 simulate_paste 的 enigo 路径；Settings → 录音 多了"模拟粘贴快捷键"一行，仅在非 macOS 显示（macOS 走 AX 直写不受影响）。
• 默认 CtrlV 与历史行为一致，老配置文件没有 pasteShortcut 字段时 #[serde(default)] 回退到默认值——不破坏既有用户。

Why this scope

issue 里用户提到两点：(1) 加粘贴方式配置，(2) 按前台程序自动检测。前者满足验收标准；后者在 Linux 上实际很难做（Wayland 多数情况下根本拿不到前台窗口的 class，X11 要再依赖 xprop/xdotool）。本 PR 只做 (1)——一个全局选择器，3 个预设覆盖现实里能遇到的所有终端。如果以后有需求再加自动检测。

Files changed

• src-tauri/src/types.rs — PasteShortcut 枚举 + UserPreferences.paste_shortcut（默认 CtrlV），串接 wire 类型 / Default / Deserialize。
• src-tauri/src/insertion.rs — simulate_paste(shortcut) 走新 paste_keys() helper；insert / insert_via_clipboard_fallback 三平台签名都带 paste_shortcut（macOS 忽略）。modifier 按下/释放严格对称，中途失败反向释放避免卡键。
• src-tauri/src/coordinator.rs — 从 prefs 读 paste_shortcut，串到三个 insert 调用点 + Windows IME 兜底链。
• 前端 src/lib/types.ts、src/lib/ipc.ts、src/lib/stylePrefs.test.ts、src/pages/Settings.tsx。
• i18n：zh-CN、zh-TW、en、ja、ko 各加 5 个 key。

Test plan

• cargo test --manifest-path src-tauri/Cargo.toml --lib — 181 passed, 0 failed，新增 3 个测试：
  • paste_shortcut_defaults_to_ctrl_v — 默认值 + 老配置反序列化都回到 CtrlV
  • paste_shortcut_round_trips_explicit_values — 三种取值的 JSON 互转
  • paste_keys_match_configured_shortcut — 枚举 → enigo Key 映射（cfg(not(macos)) 门控）
• cargo check --manifest-path src-tauri/Cargo.toml（host = aarch64-apple-darwin）干净
• npm run build（tsc + vite build）干净
• 手动验证：macOS 上看 Settings → 录音 看不到这一行（capability.adapter !== 'macEventTap' 门控）
• 手动验证：Linux + kitty 上选 Ctrl+Shift+V 后听写能粘进去
• 手动验证：Windows + Windows Terminal 上 CtrlV / CtrlShiftV 都能工作
• 手动验证：老配置文件（无 pasteShortcut 字段）启动后不报错、行为不变

Linux cross-target check 在我本机被 x11 crate 的 pkg-config sysroot 卡住——CI ubuntu-22.04 runner 有 sysroot，应该没问题；新加的代码 cfg 门控完全镜像现有的 cfg(target_os = "windows") 模式，没引入新形态。

Closes #360

---

PR Type

Bug fix, Enhancement, Tests

---

Description

• Add PasteShortcut config for Windows/Linux paste key ([area] #360)

  • New enum PasteShortcut with CtrlV, CtrlShiftV, ShiftInsert
  • UserPreferences.paste_shortcut field (default CtrlV, backward compatible)

• Refactor simulate_paste to handle multiple modifiers safely

  • paste_keys() maps shortcut to modifiers+primary key
  • Press modifiers in order, click primary, release in reverse; partial release on error
  • Fix DoubleEndedIterator compile error on Linux with slice indexing

• Plumb shortcut setting through coordinator → insertion call chain

  • insert, insert_via_clipboard_fallback, Windows IME fallback paths all carry the preference
  • macOS path keeps consistent signature but ignores the value

• Add UI selector under Settings → Recording (non‑macOS only)

  • i18n labels for EN, JA, KO, ZH‑CN, ZH‑TW
  • Frontend types, IPC mock, style test mock updated

• Unit tests for default value, deserialization round‑trip, and key mapping

---

Diagram Walkthrough

flowchart LR
  A["Settings UI (select)"] -- "updates" --> B["UserPreferences.paste_shortcut"]
  B -- "read by" --> C["Coordinator end_session"]
  C -- "calls with shortcut" --> D["TextInserter::insert / fallback"]
  D -- "invokes" --> E["simulate_paste(shortcut)"]
  E -- "maps via" --> F["paste_keys()"]
  F -- "produces" --> G["(modifiers, primary)"]
  G -- "feeds" --> H["enigo key press/release"]

Loading

File Walkthrough

	Relevant files
Enhancement	6 files types.rs Define PasteShortcut enum and add to preferences                  +50/-0    insertion.rs Refactor simulate_paste for configurable shortcut                +103/-21 coordinator.rs Thread paste_shortcut through Windows IME and fallback paths +7/-3      dictation.rs Pass paste_shortcut from prefs to insert calls                      +3/-1      types.ts Add PasteShortcut type to UserPreferences interface            +11/-0    ipc.ts Update mock settings with new pasteShortcut field                +1/-0
Configuration changes	1 files Settings.tsx Add paste shortcut selector UI (non‑macOS)                              +19/-0
Tests	1 files stylePrefs.test.ts Include pasteShortcut in test preferences mock                      +1/-0
Documentation	5 files en.ts English translations for paste shortcut setting                    +5/-0      ja.ts Japanese translations for paste shortcut setting                  +5/-0      ko.ts Korean translations for paste shortcut setting                      +5/-0      zh-CN.ts Simplified Chinese translations for paste shortcut setting +5/-0      zh-TW.ts Traditional Chinese translations for paste shortcut setting +5/-0

---

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 26e31f2)

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis 🔶 360 - Partially compliant Compliant requirements: 修复无法在kitty等使用Ctrl+Shift+V的终端中输入文字的问题（通过新增全局粘贴快捷键配置解决） 添加粘贴方式的配置 Non-compliant requirements: 根据当前前台程序针对性的配置和处理（未实现按程序自动检测粘贴快捷键） Requires further human verification: 可以在各种terminal中插入文字（需实际在kitty、alacritty、wezterm等终端中测试配置后的插入效果）

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ No major issues detected

[github-actions]

Persistent review updated to latest commit 644dc63

[github-actions]

Persistent review updated to latest commit 26e31f2