docs(release): 0.2.22 release notes

CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable released changes to Navide will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.22] — 2026-10-14 — signed release
+
+### Added
+
+- **Read aloud** (off by default): when a pane marked 🔊 finishes or needs an answer, Navide speaks a short notice with the system voice ("{pane} is done" / "{pane} needs your answer"; "{n} panes are done" when several finish together). The 🔊 toggle is in each pane's title bar, and Esc or the voice input shortcut stops speech at once. Turn it on with "Read replies aloud" in Settings › Voice Input › Read aloud, which also offers a voice picker, speed and preview. The "Voice model" row shows whether the recommended voice for the interface language is installed (美佳（Premium） for zh-TW, Ava (Premium) for en-US, Kyoko (Enhanced) for ja-JP); on macOS its Download button opens Accessibility › Spoken Content in System Settings. Speech is synthesized on this computer (#229).
+
+### Changed
+
+- Settings: the status badges, keyboard shortcuts and analyzer pages are polished further (#215, #219). Disabled Reset buttons keep readable text, the keyboard shortcuts page uses outlined icons instead of emoji with a visible legend under the toolbar, the analyzer has one primary button per page, and status badge descriptions and tags wrap instead of being cut off (most visible in ja-JP).
+- Settings: the layout, CLI agents and CLI extensions pages are polished (round 4, #225). Icons are consistent and controls aligned, disabled controls are visible, push badges read "Push on / Push off / No push channel", the CLI extensions tab is shortened to "What Navide changes", the analyzer's ghost buttons have readable contrast, and ja-JP lines no longer leave a single character on its own line.
+- Settings: the accounts, credentials and security pages are polished (round 5, #230). CLIs with several accounts are listed first with full email addresses, long explanations fold under "Details", Credentials switches between findings and inventory with a segmented control, deferred cards use a dashed outline, Security lists the CLIs in two columns with the terminal-protection sub-blocks nested, scope rows are labelled "Applies to", CLI initials are unique (for example KM and KL), the zh-TW sidebar reads "CLI 代理", and ja-JP line breaking follows the page's `lang` attribute. Visual only; no setting or behaviour changes.
+- Account popover: each pane's "Follow account switch" toggle sits at the top of the account popover. The 🔗 button in the pane header is removed, and the header shows 📌 only when the pane is pinned (#223).
+- Status bar: the backend popover (title, connection state, Restart/Start/Stop) and the pipeline pill (Stage N / M, completed/aborted) are translated in zh-TW and ja-JP instead of showing English (#222).
+- Dependencies: fastapi 0.143, anthropic 1.13, ruff 0.17, koffi 3.3.3, Electron 44.7, Playwright and happy-dom (#207, #208, #209, #210, #211).
+- Tests: four timing-sensitive tests now count clock reads, order by events or await their own return instead of waiting on wall-clock deadlines (#204, #206, #220, #228).
+
+### Fixed
+
+- Channels: a Telegram or other channel chat no longer stays on "⏳ 仍在執行" after Claude compacts an idle conversation; the compaction summary is no longer treated as a prompt from the pane (#213).
+- Channels: when a channel-bound Claude pane hits its usage limit while a chat request is open, the chat is told once, with the reset time (and the limit menu's options when it is on screen). The request stays open, so a reply after the reset still arrives in the chat (#217).
+- Channels: when Claude splits one reply into two transcript lines, the chat no longer gets an extra empty "（pane 回合結束，沒有文字輸出）" reply; the turn's text is replied once. A turn that is really empty still gets that notice, up to 120 s later (#221).
+- Account switching: "Make all follow", the switch offer and the quota switch find a pane that was rebuilt while their question was open, and move it instead of reporting it missing (#214).
+- CLI install prompt: the "Stop asking" box now shows up before the CLI status has loaded and is saved, so the Codex install prompt no longer comes back after every failed launch. A box the user ticked is not unticked by a status that arrives later (#216).
+- CLI install prompt: an uncertain detection result no longer counts as "not installed", so a CLI that is already installed (common with nvm or a slow login shell) no longer gets the install prompt. The ＋ menu waits for the login-shell PATH before marking a CLI as missing and re-detects before prompting, a `--version` timeout counts as installed, and exit 127 opens the installer only when a probe confirms the CLI is missing (#226).
+- Pipelines: pipeline tools use the pane's own workspace path when the pane sits in a subfolder of a repository (M1, M2; #227).
+- Plans: a plan document keeps its DOCTYPE first when it is promoted (P3), and a failed Plans backend subscription answers with an error instead of leaving the Host waiting (P2) (#227).
+- Plans: migrated Plans preferences land in the right workspace partition (X1), and the history backfill no longer stamps entries whose removal time is unknown with today's date (X2) (#227).
+
 ## [0.2.21] — 2026-10-13 — signed release
 
 ### Added

src/renderer/src/lib/whatsNew.ts

@@ -110,6 +110,51 @@ export const WHATS_NEW_CHROME = {
 }
 
 export const WHATS_NEW: WhatsNewEntry[] = [
+  {
+    version: '0.2.22',
+    title: {
+      'zh-TW': '設定頁全面整理、語音朗讀通知、頻道聊天不再卡在「仍在執行」',
+      'en-US': 'A Tidier Settings Window, Spoken Notices, and Channel Chats No Longer Stuck on “Still Running”',
+      'ja-JP': '設定画面を全面的に整理、音声による通知の読み上げ、チャンネルのチャットが「実行中」で止まらなくなりました',
+    },
+    highlights: [
+      {
+        'zh-TW': '設定頁全面整理：狀態徽章、鍵盤快速鍵和分析頁面中，停用的按鈕文字清楚可讀，鍵盤快速鍵改用圖示並附上看得到的說明，每頁只留一個主要按鈕，日文的文字也不會再被截斷。版面、CLI agent 和 CLI 擴充頁面也一併整理：圖示一致、控制項對齊，停用的控制項看得出來，推送標籤改成「推送開啟／推送已關／無推送通道」，分頁名稱縮短為「Navide 做的修改」，分析頁面的按鈕對比更清楚，日文也不會再有單獨掉到下一行的字。帳號、憑證和安全性頁面也重新排版：支援多帳號的 CLI 排在前面並顯示完整 email，較長的說明收進「詳細說明」，憑證頁用分段切換在發現與清單之間切換，安全性頁的 CLI 分兩欄列出，範圍列標成「適用範圍」，每個 CLI 的縮寫也不再重複，側欄的「CLI Agents」改為「CLI 代理」。',
+        'en-US': 'A tidier Settings window: on the status badges, keyboard shortcuts and analyzer pages, disabled buttons stay readable, keyboard shortcuts use icons with a visible legend instead of emoji, each page has one primary button, and Japanese text is no longer cut off. The layout, CLI agents and CLI extensions pages are tidied up as well: consistent icons and aligned controls, disabled controls you can see, push badges that read “Push on / Push off / No push channel”, a shorter “What Navide changes” tab, better contrast on the analyzer buttons, and Japanese lines that no longer leave a lone character on the next line. The accounts, credentials and security pages are laid out again too: CLIs with several accounts come first with full email addresses, long explanations fold under “Details”, Credentials switches between findings and inventory with a segmented control, Security lists the CLIs in two columns with scope rows labelled “Applies to”, and every CLI has its own distinct initials.',
+        'ja-JP': '設定画面を全面的に整理：ステータスバッジ、キーボードショートカット、分析のページでは、無効なボタンの文字も読みやすくなり、キーボードショートカットは絵文字の代わりにアイコンと見える凡例で表示し、各ページの主ボタンは一つになり、日本語の文字が切れることもなくなりました。レイアウト、CLI エージェント、CLI 拡張機能のページも整えました。アイコンをそろえて操作部品の位置を合わせ、無効な操作部品も見分けられるようにし、プッシュの表示を「プッシュ有効／プッシュ無効／プッシュ非対応」に、タブ名を「Navide による変更」に短くし、分析ページのボタンのコントラストを改善し、日本語で一文字だけ次の行に送られることもなくなりました。アカウント、認証情報、セキュリティのページも整理しました。複数アカウントに対応した CLI を先頭に完全なメールアドレスで表示し、長い説明は「詳細」に折りたたみ、認証情報ではセグメント切り替えで検出結果と一覧を切り替え、セキュリティでは CLI を 2 列に並べて「適用範囲」の行を見出し付きにし、CLI の略称も重複しなくなりました。日本語の改行位置もさらに自然になりました。',
+      },
+      {
+        'zh-TW': '語音朗讀：標上 🔊 的 pane 完成時，Navide 會用系統聲音念出「<pane> 完成了」，需要你回答時念「<pane> 需要你回答」。在 pane 標題列點 🔊 就能標記；按 Esc 或語音輸入快速鍵會立刻停止。預設關閉，到設定 › 語音輸入 › 語音朗讀開啟「朗讀回覆」。「語音模型」一列會顯示建議的聲音（中文是美佳（Premium））是否已安裝，按「下載」會打開 macOS 系統設定的「輔助使用 › 朗讀內容」下載。',
+        'en-US': 'Read aloud: when a pane marked 🔊 finishes or needs your answer, Navide speaks a short notice in the system voice — “<pane> is done” or “<pane> needs your answer”. Click 🔊 in a pane’s title bar to mark it; Esc or the voice input shortcut stops speech at once. It is off by default: turn on “Read replies aloud” in Settings › Voice Input › Read aloud. The “Voice model” row shows whether the recommended voice (Ava (Premium) for English) is installed, and Download opens Accessibility › Spoken Content in macOS System Settings to get it.',
+        'ja-JP': '読み上げ：🔊 を付けたペインが完了したり回答を求めたりすると、Navide がシステムの音声で「<pane> が完了しました」「<pane> があなたの回答を待っています」と短く読み上げます。ペインのタイトルバーの 🔊 をクリックして付け、Esc か音声入力のショートカットですぐに止められます。既定ではオフなので、設定 › 音声入力 › 読み上げ で「返信を読み上げる」をオンにしてください。「音声モデル」の行で推奨の音声（日本語は Kyoko (Enhanced)）がインストール済みかを確認でき、「ダウンロード」を押すと macOS のシステム設定の「アクセシビリティ › 読み上げコンテンツ」が開きます。',
+      },
+      {
+        'zh-TW': 'Telegram 等頻道聊天：Claude 在閒置時自動壓縮對話後，聊天不會再一直停在「⏳ 仍在執行」。綁定頻道的 pane 用完 Claude 額度時，聊天會收到一次通知並附上重置時間；這則請求會先保留，重置後的回覆照樣會送到聊天。Claude 把一則回覆拆成兩行紀錄時，聊天也不會再多收到一則空白的「（pane 回合結束，沒有文字輸出）」。',
+        'en-US': 'Telegram and other channel chats: a chat no longer stays on “⏳ still running” after Claude compacts an idle conversation. When a pane bound to a chat hits its Claude usage limit, the chat is told once, with the reset time; the request stays open, so the reply after the reset still arrives there. When Claude splits one reply into two transcript lines, the chat no longer gets an extra empty “pane turn ended with no text output” reply.',
+        'ja-JP': 'Telegram などのチャンネルのチャット：Claude がアイドル中の会話を自動で圧縮したあとも、チャットが「⏳ 実行中」のまま止まらなくなりました。チャットに紐づいたペインが Claude の使用量の上限に達すると、チャットにリセット時刻つきで一度だけ通知します。リクエストは保留されたままなので、リセット後の返信もそのチャットに届きます。Claude が一つの返信を記録の二行に分けたときに、空の「ペインのターンが終了、テキスト出力なし」という返信が余分に届くこともなくなりました。',
+      },
+      {
+        'zh-TW': '帳號清單的「全部改為跟隨」和切換帳號，現在也能找到在問題開著時被重建的 pane，不會再把它當成不見了。每個 pane 的「跟隨帳號切換」開關移到帳號彈出視窗的最上方；pane 標頭的 🔗 按鈕已移除，只有固定帳號的 pane 會在標頭顯示 📌。',
+        'en-US': '“Make all follow” and account switching in the account list now find a pane that was rebuilt while the question was open, instead of reporting it missing. Each pane’s “Follow account switch” toggle now sits at the top of the account popover; the 🔗 button in the pane header is gone, and the header shows 📌 only when a pane is pinned.',
+        'ja-JP': 'アカウント一覧の「すべて追従にする」とアカウントの切り替えは、確認を開いている間に作り直されたペインも見つけられるようになり、見つからないと報告しなくなりました。ペインごとの「アカウント切り替えに追従」のスイッチはアカウントのポップオーバーの一番上に移りました。ペインのヘッダーの 🔗 ボタンはなくなり、📌 は固定したペインのヘッダーにだけ表示されます。',
+      },
+      {
+        'zh-TW': 'CLI 安裝提示的「不要再詢問」勾選框現在一定會出現並記住你的選擇，Codex 的安裝提示不會再一直跳出來。偵測結果不確定時也不會再當成沒安裝，所以用 nvm 或 shell 啟動較慢時，已經裝好的 CLI 不會再跳出安裝提示。',
+        'en-US': 'The “Stop asking” box on the CLI install prompt now always shows up and is saved, so the Codex install prompt stops coming back. An uncertain detection result no longer counts as “not installed”, so a CLI that is already installed — common with nvm or a slow shell — no longer gets the install prompt.',
+        'ja-JP': 'CLI のインストール確認にある「今後確認しない」のチェックボックスが必ず表示され、選択が保存されるようになりました。Codex のインストール確認が何度も出ることはなくなります。検出結果がはっきりしないときに「未インストール」と扱うこともなくなったため、nvm を使っていたりシェルの起動が遅かったりしても、インストール済みの CLI でインストールの確認が出ることはなくなりました。',
+      },
+      {
+        'zh-TW': '狀態列的後端彈出視窗（標題、連線狀態、重新啟動／啟動／停止）和流程進度標籤（階段 N / M、已完成／已中止）現在會依介面語言顯示，不再出現英文。',
+        'en-US': 'The status bar’s backend popover (title, connection state, Restart/Start/Stop) and pipeline pill (Stage N / M, completed/aborted) are now translated in Traditional Chinese and Japanese.',
+        'ja-JP': 'ステータスバーのバックエンドのポップオーバー（タイトル、接続状態、再起動／開始／停止）とパイプラインの進行状況（ステージ N / M、完了／中止）が日本語で表示されるようになり、英語のままにならなくなりました。',
+      },
+      {
+        'zh-TW': 'pane 在儲存庫的子資料夾裡工作時，Plan 和 pipeline 也能正常運作。',
+        'en-US': 'Plans and pipelines work correctly when a pane works in a subfolder of a repository.',
+        'ja-JP': 'ペインがリポジトリのサブフォルダーで作業しているときも、Plan とパイプラインが正しく動作するようになりました。',
+      },
+    ],
+  },
   {
     version: '0.2.21',
     title: {