feat: polish hotword overrides, audio archive, auto-update check

[appergb]

User description

Summary

围绕「ZIP 误识别 + AI 日报反馈」一波 7 项改动：

• polish 提示词：COMMON_RULES 规则 2 加热词例外、规则 5 加英文短词同音示例（ZIP/VIP）、规则 2 显式举例带次版本号产品名（GPT-5.6 / Claude 4.7 / iOS 26.1）不省略小数；Structured mode 主题数上限放宽给「多条独立新闻 / 日报」场景 + 主题标题保留实体名；热词块尾部加「优先于规则 2」强约束
• History 详情面板：修复复制按钮无反馈 bug（1.5s "已复制"）；加 AudioRecordingPlayer + 导出录音按钮
• Settings 新增：自动检查更新（默认 on，启动延 4s + 60min interval）/ 历史条数上限（5–200）/ 保留原始录音 + 录音条数上限（1–200）
• 录音归档（debug 开关版）：recorder.rs WavArchiver（Drop 回填 RIFF/data header）、DictationSession.has_audio_recording 字段、history.id 与 SessionId 对齐、prune_recordings 双重 cap、IPC 改 async + UUID-v4 白名单校验防路径越界

Test plan

代码层：

• cargo test --manifest-path src-tauri/Cargo.toml --lib → 258 全过（+2 个 is_valid_session_id path-traversal 单测）
• npx tsc --noEmit → 0 error
• 5 语言 i18n（zh-CN / en / ja / ko / zh-TW）补全所有新 key

手工验证（待 reviewer 跑）：

• 录一段说「这个 ZIP 文件解压一下」→ raw 仍可能是 VIP，polished 应该是 ZIP
• 录一段说「GPT-5.6 出来了」→ polished 不应省略成 GPT-5
• 录一段 AI 日报式播报（多条独立新闻）→ Structured mode 输出 ≥4 个主题，标题带实体名
• History 点复制 → 看到 1.5s "已复制" 反馈
• Settings 开「保留原始录音」→ 录一条 → History 看到「播放录音」+「导出录音」按钮 → 播放正常、导出落到 Downloads
• Settings 关「自动检查更新」→ 主窗口不再后台弹更新对话框
• Settings 历史条数填 5 → 录几条验证旧条目被裁掉

已知后续待优化（review 已标记，本 PR 不修）

• H2：prune 在录音前调用，cap 边界可能多出 1 条文件（不爆盘）
• M1：WavArchiver Drop unwinding 时 header 长度兜底（QuickTime 严格播放器可能拒播）
• M3：has_audio_recording 跟磁盘脱钩（前端 catch 'recording not found' 已兜住）

文件改动

20 modified + 1 new (AutoUpdateGate.tsx) / +707 -32 lines

---

PR Type

Enhancement, Bug fix, Tests

---

Description

• Archive dictation audio as WAV

  • Playback and export from History
  • Hide missing files after pruning

• Add configurable history and audio caps

  • Persist has_audio_recording per session

• Enable automatic update checks on startup

• Tighten hotword and transcript prompts

  • Validate recording IPC session IDs
  • Fix clipboard copy feedback
  • Add path-traversal unit tests

---

Diagram Walkthrough

flowchart LR
  S["Settings"] -- "writes prefs" --> P["User preferences"]
  P -- "configures" --> R["Recorder"]
  R -- "archives WAV" --> W["recordings/<session_id>.wav"]
  R -- "flags session" --> H["History entry"]
  H -- "play / export" --> UI["History page"]
  G["AutoUpdateGate"] -- "checks releases" --> U["Update dialog"]
  PR["Prompt rules"] -- "hotword / structure polish" --> T["Transcript cleanup"]

Loading

File Walkthrough

	Relevant files
Bug fix	1 files commands.rs Add secure audio-recording read command                                    +86/-5
Enhancement	15 files coordinator.rs Persist archive state with history entries                              +23/-6    lib.rs Register new recording read IPC command                                    +1/-0      polish.rs Give hotword overrides priority over defaults                        +2/-2      recorder.rs Archive microphone PCM into WAV files                                        +103/-1  App.tsx Mount auto-update gate in main app                                              +2/-0      AutoUpdateGate.tsx Schedule background update checks and dialog                          +58/-0    Icon.tsx Add play and download icons                                                            +4/-0      en.ts Add history and settings translation keys                                +13/-0    ja.ts Add history and settings translation keys                                +13/-0    ko.ts Add history and settings translation keys                                +13/-0    zh-CN.ts Add history and settings translation keys                                +13/-0    zh-TW.ts Add history and settings translation keys                                +13/-0    ipc.ts Expose audio-recording IPC and mock data                                  +21/-0    History.tsx Add recording playback and export actions                                +143/-4  Settings.tsx Add recording, history, and update controls                            +67/-0
Configuration changes	3 files persistence.rs Add recording cleanup and capped history                                  +94/-4    types.rs Extend session schema, prefs, and prompts                                +57/-3    types.ts Add recording flags and preference fields                                +14/-0
Tests	1 files stylePrefs.test.ts Update preference fixtures for new fields                                +4/-0
Additional files	1 files dictation.rs +47/-11

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 3125de8)

Here are some key observations to aid the review process:

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Compile Error Mutex::lock() returns a LockResult, so chaining .append(...) directly on it will not compile. The recorder path will fail to build unless the guard is unwrapped before calling append. if let Some(arch) = archiver { arch.lock().append(&pcm_bytes); Audio Glitch The WAV archive now performs mutex locking and file writes directly inside the CPAL audio callback. On slower disks or when the filesystem stalls, this can block the real-time capture thread long enough to cause underruns or corrupted recordings. if let Some(arch) = archiver { arch.lock().append(&pcm_bytes); }

[github-actions]

Persistent review updated to latest commit 13839a2

[github-actions]

Persistent review updated to latest commit 67d1277

[appergb]

关于 pr_agent round-3 提的 Build break (arch.lock returns Result)：这是 false positive。

recorder.rs:20 用的是 use parking_lot::Mutex（不是 std::sync::Mutex），parking_lot 的 .lock() 直接返回 MutexGuard，没有 Result 包装。本地 cargo test --lib 258 全过 + 3 平台 CI build 都绿可证。

pr_agent 没有区分 parking_lot 和 std::sync 两套 API，这里按 false positive 处理，不修。

round-3 commit 3125de8 解决了同轮的 Missing-file handling：把 read_audio_recording 里 tokio::fs::read 的 ErrorKind::NotFound 标准化成跟 exists() 失败同样的 "recording not found" 字符串，前端 catch 不依赖 OS 原文。

[github-actions]

Persistent review updated to latest commit 3125de8