Prevent Wayland dictation text loss

[H-Chris233]

User description

Summary

• make Linux Wayland dictation output copy-only instead of trusting streaming/paste success
• disable streaming insertion eligibility on Wayland and report explicit Wayland clipboard fallback states
• align Settings/Linux guidance with the current CLI + single-instance Wayland trigger path

Refs #420

Validation

• cargo fmt --manifest-path openless-all/app/src-tauri/Cargo.toml
• cargo test --manifest-path openless-all/app/src-tauri/Cargo.toml --lib coordinator::dictation
• cargo test --manifest-path openless-all/app/src-tauri/Cargo.toml --lib focus_restore_failure_uses_specific_error_code
• git diff --check
• cargo check --manifest-path openless-all/app/src-tauri/Cargo.toml
• npm run build

Notes

• [area] Debian操作系统Wayland桌面环境下录音快捷键不可用 #420 should remain open; this only lands Phase 1 output safety plus current-path guidance cleanup.
• Real Wayland compositor clipboard behavior still needs host validation.

---

PR Type

Bug fix, Documentation

---

Description

• Disable Wayland streaming insertion

• Fall back to clipboard-only output

• Update Linux hotkey guidance text

• Add Wayland behavior tests and docs

---

Diagram Walkthrough

flowchart LR
  A["Wayland session detected"] -- "disable streaming insert" --> B["Clipboard-only fallback"]
  B -- "manual paste required" --> C["User keeps dictated text"]
  D["Settings and i18n hints"] -- "reflect CLI shortcut path" --> E["Wayland trigger guidance"]
  F["Tests"] -- "cover fallback and errors" --> G["Wayland-specific validation"]

Loading

File Walkthrough

	Relevant files
Bug fix	2 files coordinator.rs Pass Wayland state into dictation errors                                  +2/-2      dictation.rs Force clipboard fallback on Wayland                                            +141/-19
Documentation	8 files types.rs Refresh Linux hotkey support hint                                                +1/-1      en.ts Clarify Wayland streaming insert behavior                                +1/-1      ja.ts Clarify Wayland streaming insert behavior                                +1/-1      ko.ts Clarify Wayland streaming insert behavior                                +1/-1      zh-CN.ts Clarify Wayland streaming insert behavior                                +1/-1      zh-TW.ts Clarify Wayland streaming insert behavior                                +1/-1      AdvancedSection.tsx Update Wayland streaming input guidance                                    +1/-1      issue-420-wayland-plan.md Add Wayland support phase plan                                                      +317/-0

---

[github-actions]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis 🔶 420 - Partially compliant Compliant requirements: Wayland dictation output now avoids trusting streaming/paste success and uses an explicit clipboard fallback path. Linux/Wayland guidance text was updated to point users toward the CLI trigger path. Non-compliant requirements: A usable global recording hotkey on Debian Wayland. A concrete script/launcher command package for users to bind in desktop settings. Requires further human verification: Whether the documented CLI + single-instance trigger path can actually be bound and used reliably across Wayland desktop environments.

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ No major issues detected