diff --git a/CHANGELOG.md b/CHANGELOG.md
index 58b65ac..58a3fe3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,14 @@ an Install / Update section when publishing). Sparkle's in-app update dialog
accumulates every patch in a release's minor series, so each section here only
needs its own version's changes.
+## 1.14.2 (2026-09-17)
+
+More reliable window focus and Guided Setup.
+
+### Fixes
+- **Keep recent window focus after using menus:** Returning to a workspace restores the window you last selected, even after using an app's menus and switching between its windows.
+- **Finish Guided Setup reliably:** Restore and apply saved setup drafts correctly after a relaunch. Applying a setup now closes the guide after confirmation and clears the completed draft.
+
## 1.14.1 (2026-09-11)
More reliable layout restoration, window switching, and permission handling.
diff --git a/Localization/Docs.json b/Localization/Docs.json
index 5cb1d72..6f37e53 100644
--- a/Localization/Docs.json
+++ b/Localization/Docs.json
@@ -1,4 +1,25 @@
{
+ "23b19b67e468daf9": {
+ "en": "More reliable window focus and Guided Setup.",
+ "ko": "창 포커스와 설정 안내를 더 안정적으로 다듬었어요.",
+ "ja": "ウインドウのフォーカスとガイド設定の動作を改善しました。",
+ "zh-Hans": "改进窗口焦点和引导设置。",
+ "zh-Hant": "改善視窗焦點與引導設定。"
+ },
+ "1173498f9417eea7": {
+ "en": "**Keep recent window focus after using menus:** Returning to a workspace restores the window you last selected, even after using an app's menus and switching between its windows.",
+ "ko": "**메뉴를 사용한 뒤에도 마지막 창으로 돌아가요:** 앱 메뉴를 사용하거나 같은 앱의 창을 전환한 뒤 작업 공간으로 돌아와도 마지막으로 선택한 창에 포커스를 맞춰요.",
+ "ja": "**メニューを使った後も最後のウインドウに戻る:** アプリのメニューを使ったり、同じアプリのウインドウを切り替えたりした後も、ワークスペースに戻ると最後に選んだウインドウにフォーカスします。",
+ "zh-Hans": "**使用菜单后仍返回最后选择的窗口:** 使用应用菜单并切换同一应用的窗口后,返回工作区时仍会聚焦最后选择的窗口。",
+ "zh-Hant": "**使用選單後仍回到最後選取的視窗:** 使用 App 選單並切換同一 App 的視窗後,返回工作空間時仍會聚焦最後選取的視窗。"
+ },
+ "ae2f01ecc15d8daa": {
+ "en": "**Finish Guided Setup reliably:** Restore and apply saved setup drafts correctly after a relaunch. Applying a setup now closes the guide after confirmation and clears the completed draft.",
+ "ko": "**설정 안내를 끝까지 적용해요:** 다시 실행한 뒤에도 저장한 설정 초안을 올바르게 복원하고 적용해요. 적용을 확인하면 안내 창을 닫고 완료한 초안을 정리해요.",
+ "ja": "**ガイド設定を確実に完了:** 再起動後も保存した設定の下書きを正しく復元し、適用できます。適用を確認するとガイドが閉じ、完了した下書きが削除されます。",
+ "zh-Hans": "**可靠地完成引导设置:** 重新启动后,正确恢复并应用已保存的设置草稿。确认应用设置后,引导窗口会关闭,并清除已完成的草稿。",
+ "zh-Hant": "**順利完成引導設定:** 重新啟動後,正確還原並套用已儲存的設定草稿。確認套用設定後,引導視窗會關閉,並清除已完成的草稿。"
+ },
"b8694611078e93aa": {
"en": "More reliable layout restoration, window switching, and permission handling.",
"ko": "레이아웃 복원, 창 전환, 권한 변경 처리를 더 안정적으로 다듬었어요.",
diff --git a/Project.swift b/Project.swift
index 2d014d7..df2a611 100644
--- a/Project.swift
+++ b/Project.swift
@@ -12,7 +12,7 @@ let developmentTeam = Environment.developmentTeam.getString(default: "")
let sparklePublicEDKey = Environment.sparklePublicEdKey.getString(default: "")
// Single source of truth for the marketing version. The release workflow
// verifies the pushed tag matches this before building.
-let appVersion = "1.14.1"
+let appVersion = "1.14.2"
// Build number is injected by CI (github.run_number); 1 for local builds.
let buildNumber = Environment.buildNumber.getString(default: "1")
diff --git a/docs/ja/CHANGELOG.md b/docs/ja/CHANGELOG.md
index b962f90..79b1f13 100644
--- a/docs/ja/CHANGELOG.md
+++ b/docs/ja/CHANGELOG.md
@@ -7,12 +7,22 @@
Tatamiの主な変更点です。このファイルをウェブサイトとGitHub Releasesのリリースノートの基準とし、公開時にインストール・更新案内を追加します。Sparkleの更新画面は同じマイナーバージョンの全パッチをまとめるため、各節にはそのバージョンの変更だけを記載します。
+
+## 1.14.2 (2026-09-17)
+
+ウインドウのフォーカスとガイド設定の動作を改善しました。
+
+
+### 修正
+- **メニューを使った後も最後のウインドウに戻る:** アプリのメニューを使ったり、同じアプリのウインドウを切り替えたりした後も、ワークスペースに戻ると最後に選んだウインドウにフォーカスします。
+- **ガイド設定を確実に完了:** 再起動後も保存した設定の下書きを正しく復元し、適用できます。適用を確認するとガイドが閉じ、完了した下書きが削除されます。
+
## 1.14.1 (2026-09-11)
レイアウトの復元、ウインドウ切り替え、権限変更への対応を改善しました。
-
+
### 修正
- **ウインドウを開き直しても配置を維持:** アプリの再起動や macOS によるウインドウの復元時に、分割方向、比率、全画面拡大の状態を維持します。ウインドウが順番に開く場合も、まだ開いていないウインドウの保存済みレイアウトを上書きしません。
- **ディスプレイ変更中も配置を保護:** ディスプレイが一時的に検出されない間は、直前のワークスペースの配置を維持し、古くなったディスプレイ更新を適用しません。ウインドウの識別子が変わっても、保存済みの分割比率で復元します。
@@ -36,7 +46,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **目的別に設定を探す:** カテゴリのサイドバーで、一般、タイル配置、ワークスペース、ワークスペースキー、フォーカスとマウス、ジェスチャー、外観、フックを分けて表示します。確認設定も対象の操作別にまとめました。
- **5言語で使い方を読む・見る:** アプリ内ドキュメントを選択した言語で表示し、見出し、表、リンクが正しく動作します。ウェブサイトには一連の作業フローと機能別デモを用意し、標準の再生操作、キーボード操作、関連設定へのリンクを提供します。
-
+
### 修正
- **最前面表示のウインドウに最初のクリック・ドラッグを届ける:** アクティブ化とミラーの引き継ぎ中も最初のマウス入力を保持します。キーボードフォーカスを移さずに背後の実ウインドウをスクロールでき、ホバーは Focus Follows Mouse の設定に従います。
- **ウインドウが一時的に利用できなくても配置を保持:** 配置の読み込みに失敗したり不完全だったりしても、保存済み位置を空の配置で置き換えません。ワークスペースの復元は、必要なウインドウを解決できるまで有効な配置情報を保持します。
@@ -61,7 +71,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **切り替えに共有Appを含める:** 借用中も元と借りたタイル領域の後ろに、共有のフローティング・そのままウインドウが並びます。既定でオンの設定を無効にすれば、共有Appを除いた小さな一覧にできます。
- **Appごとの手前表示をトラブルシュート:** 新しいガイドで、フローティング操作部のあるAppを登録する場面、ブラウザのピクチャインピクチャが自動でタイル対象外になる理由、切り替え後も表示するために登録が必要な条件を説明します。
-
+
### 修正
- **ブラウザのPiPを配置から除外:** ChromeとDiaのピクチャインピクチャをWindowServerのレイヤーで識別し、BSPタイルに含めません。情報取得に失敗しても有効な通常ウインドウは保持します。
- **手動調整した分割比率を保持:** 論理的なタイル構成が同じなら、フォーカス同期や表示面の交換で50:50へ戻しません。実際の追加・削除には設定に従って自動均等配置を適用します。
@@ -87,7 +97,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **コマンドの案内をすぐ確認:** 設定から同梱のCLIガイドを開くか、pangmo5.dev/Tatamiで `docs/CLI.md` から生成された案内を読めます。選択方法、JSONの規約、フックの動作、終了ステータス、スクリプト例を説明します。
- **どの幅でもショートカット競合を確認:** 記録コントロールの幅に関係なく同じ小さな警告を表示し、競合する操作の全文をポップオーバーとVoiceOverで確認できます。
-
+
### 修正
- **プロファイル境界を守るキー:** 別々のプロファイルで同じ代表キーや明示的なショートカットを再利用しても、誤って競合と判断しません。グローバルキーは引き続き全プロファイルと照合します。
- **コピー・複製時のキー競合を防止:** プレビューで競合する選択を示し、保存前に現在の設定を再検証します。競合があれば一部だけを適用せず、変更全体を拒否します。
@@ -107,7 +117,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.11.4 (2026-08-11)
-
+
### 修正
- **共有Appでも領域ごとの最後の対象を保持:** 別の領域を経由して選んだ共有タイルAppではなく、戻った領域で最後に使ったウインドウを復元します。
@@ -123,7 +133,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **最近のワークスペースを画面全体で共有:** 新規インストールでは、直前のワークスペースを画面ごとではなくデスクトップ全体で扱います。既存の設定は変更しません。
- **配置変更にポインタも追従:** 分割方向の変更や全画面拡大の切り替えで、フォーカス中のウインドウと一緒にポインタを移動します。ウインドウが離れた古いタイルに残りません。
-
+
### 修正
- **動的ワークスペースが再びポインタに追従:** 一度表示すると最後の画面に固定される問題を修正しました。有効化するとポインタのあるディスプレイへ移動し、すでにそこにある場合は現在の借用構成を保ちます。
- **複数画面でロック解除後も正しく復元:** ロック中にmacOSが画面を外して追加する中間状態を逐次処理し、割り当てが壊れたり、画面数ルールでプロファイルが変わったまま保存されたりしていました。構成が落ち着いてから反映し、一瞬消えただけなら何も変えず、実際の取り外しは一度だけ処理します。
@@ -138,7 +148,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.11.2 (2026-08-04)
-
+
### 修正
- **画面ロック中も配置を保持:** 一時的なアクセシビリティやWindowServerの情報で、ウインドウをBSPから外しません。ロック画面の前に破壊的な所属変更を止め、重なるスリープ・セッション遷移がすべて終わってから配置全体を再接続します。
- **画面をまたぐ通知を統一:** 別画面に表示済みの領域へフォーカスしても、借用構成を崩さず通知を表示します。出発側には移動先の領域と画面名を示し、結果を明確にします。
@@ -146,7 +156,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.11.1 (2026-08-02)
-
+
### 修正
- **ネイティブタブ変更中も配置を保持:** タブの生成・終了・切り替え時に一時的な表示面IDを別ウインドウとしてBSPへ追加しません。素早い変更でも実際の表示面だけを替え、タイル、フォーカス履歴、拡大、表示状態を保ちます。
@@ -163,7 +173,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **わかりやすく正確な切り替え:** 各Appアイコンにフォーカス、借用、共有、常に手前、全画面の状態を表示します。ホバーで実際の選択も変わるので、同じAppに複数のウインドウがあってもReturnや修飾キーを離す操作で強調中のものを確定できます。よりコンパクトになり、「視差効果を減らす」にも対応します。
- **配置設定に従う均等配置:** 均等配置コマンドが自動均等配置で指定した軸を使います。自動設定がオフの場合は、不均等な構造の比率だけを揃えず、標準のBSPツリーを再構築します。
-
+
### 修正
- **遅れて開く・再表示されるウインドウを安定化:** WindowServerの表示変更に即応し、IDを忘れずに隠れた表示面を取り除きます。再表示されたAppが後から古いフレームを戻してもタイルへ合わせ続けます。遅いAppの最初のウインドウも、監視の準備ができ次第、意図したフォーカス、全画面の位置、フレームを復元します。
- **借用の完了とフォーカスを安定化:** 起動の遅いAppの最初のウインドウも、現れたらすぐ配置してフォーカスします。処理中は元のフォーカスと印を保持し、全体の有効化前に古い印を消します。別の画面や、すでに表示中の元の領域へフォーカスを戻しても借用構成を保ちます。
@@ -188,14 +198,14 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.9.2 (2026-07-27)
-
+
### 修正
- **MFFとFFMの連携を安定化:** ポインタ起因のフォーカス通知がMFFへ戻り、再びポインタを動かすことがなくなりました。自分で移動した合成イベントと古いフォーカス通知を除外し、借用配置を修復する際も利用者が移動したポインタを引き戻しません。
## 1.9.1 (2026-07-23)
-
+
### 修正
- **通知から開いても借用配置を維持:** 借用中のAppの通知をクリックしても、保存済みの短いフレームを復元して下に空白を残しません。フォーカス先が落ち着いたら借用ブロック全体の配置を再適用します。
@@ -215,14 +225,14 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **借用とメニューバーの応答を改善:** 先に領域を配置し、実際のフレームに対してキーボードフォーカスとポインタ移動を順序付けます。重複AX書き込みを省き、既知の隠れた一時ウインドウは再起動せず再利用します。App Nap中もメニューバーの応答性を維持します。
- **内容に応じた操作フィードバック:** 小さなスプリング動作で表示・非表示になり、内容に合わせてサイズを調整します。表示中の内容は演出全体をやり直さず更新します。
-
+
### 修正
- **タイル外の切り替え先にもポインタを追従:** 常に手前、共有の常に手前、そのままモードのウインドウへ切り替えると、フォーカス後の実際の位置を読み取り、ポインタを中央へ移動します。
## 1.8.1 (2026-07-20)
-
+
### 修正
- **別プロファイル専用Appも一時配置:** 非アクティブなプロファイルだけに登録したAppを現在の環境で開いても、通常どおりタイル表示します。到達できない領域の所有物とは扱いません。
@@ -239,7 +249,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **全画面共通の最近の領域を選択可能:** ひとつの使用履歴を全画面で使い、ポインタの画面へ引き寄せず元の場所でフォーカスできます。既定は従来の画面ごとの動作です。
- **再度呼び出して借用を解除:** 現在のディスプレイですでに借りているワークスペースをもう一度呼ぶと、既定では借用を解除して元のワークスペースを復元します。再配置する動作を使う場合は、この設定をオフにします。
-
+
### 修正
- **同じAppの正確なウインドウを復元:** 領域を離れる前に、実際のフォーカス先を表示中の配置と照合します。同じAppの別ウインドウに古い使用順が残っていても、通知を逃しても、実際に使ったウインドウへ戻ります。
@@ -252,7 +262,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **ポインタ基準の借用:** 借用、最近・次・前、方向選択、解除をポインタの画面で統一し、方向選択は開始した画面を記憶します。
- **有効化の負荷を削減:** 重複するフレーム書き込みを省き、プロセスやウインドウが消えたら直ちにキャッシュから外します。新しい要求に置き換わった有効化、フォーカス、ミラー処理も取り消します。
-
+
### 修正
- **App間のマウス追従:** 別のAppのウインドウへ移ると、前に出すだけでなく最前面のAppも変更します。異なる画面にある場合も動作します。
- **閉じた後のフォーカスと中央移動を修正:** 一覧が落ち着いてから意図した最近のウインドウを選び、実際のフレーム中央へポインタを移します。
@@ -262,7 +272,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.7.2 (2026-07-15)
-
+
### 修正
- **画面をまたぐウインドウ切り替え:** 1.7.0から既定で有効なalt/opt+tabが、同じ2つのウインドウを往復したり別の画面で動いたりする問題を修正しました。アクセシビリティで前に出すだけでなく、WindowServerで最前面のAppも切り替えるため、App間・画面間で正しく移動します。
- **画面構成通知をまとめて処理:** OSから同じ画面設定の通知が連続して届いてもまとめて扱い、変わっていない構成を繰り返し評価しません。
@@ -279,7 +289,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **共有Appのサイドバーを全体へ:** 共有Appは全プロファイルの全領域に参加するため、個別プロファイルからサイドバーの**すべての場所**へ移しました。
- **画面ごとのプロファイル切り替え通知:** ひとつの一覧にまとめず、各画面へそこに表示されるワークスペースを案内します。
-
+
### 修正
- **未接続画面の固定領域を保持:** 固定先がない状態で有効化してからプロファイルを往復しても、別の領域へ戻りません。最後の場所を保持し、画面を再接続したら本来の場所へ戻します。
@@ -298,7 +308,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **設定を再整理:** 代表キーを**ワークスペースキー**、トラックパッド操作を**ジェスチャー**へ移し、ウインドウ切り替えの設定とキーをまとめました。派生ショートカットからキー設定へ直接移動でき、読み取り専用の通常テキストで別の場所で設定することを明確にしました。
- **新規インストールの初期設定を改善:** 新しい設定には推奨ショートカットを追加し、Appの有効化時に所属ワークスペースへ移る*Appフォーカス追従*を既定でオンにします。既存設定はそのままです。
-
+
### 修正
- **複数所属Appのフォーカスを安定化:** Appが複数の領域に属していても、そのうちのひとつにいる場合はクリックで別の領域へ移りません。
- **メインウインドウを確実に手前へ:** Tatamiのウインドウを開いたとき、別のAppの後ろへ沈まなくなりました。
@@ -306,7 +316,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.6.1 (2026-07-10)
-
+
### 修正
- **画面再接続後も拡大を復元:** 画面を閉じて開いても拡大状態を失いません。画面変更で一瞬隠れたときに拡大を解除していた問題を直し、同じウインドウを拡大したまま戻します。実際に閉じた場合は解除し、再び開くと新しい状態から始めます。
@@ -327,7 +337,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **同じAppのウインドウにも別々の位置:** App内の順番で各ウインドウを追跡し、複数の配置と全画面だった対象を保持します。読めない配置がひとつあっても他のワークスペースを消さず、古い配置は自動移行します。
- **並べ替えと削除確認:** サイドバーでドラッグしてワークスペースを並べ替えられます。ワークスペースの削除やAppの取り除きには確認画面を表示します。
-
+
### 修正
- **最近のウインドウを復元:** 複数のウインドウを持つAppへ `⌥Tab` で戻ると、任意のものではなく最後にフォーカスしたウインドウへ移ります。
- **有効化時に正しいAppを最前面へ:** Appから領域を呼び出したとき、その領域の常時起動Appが最前面を奪わなくなりました。
@@ -343,7 +353,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **移動元の画面でフォーカスを案内:** 画面をまたいだ移動を出発側に表示し、フォーカスがどこへ行ったかわかりやすくします。
- **感度スライダーを滑らかに:** ドラッグの各段階で設定フォーム全体を再描画しなくなりました。
-
+
### 修正
- **ウインドウのフォーカス追跡を改善:** 新しく開いたウインドウ、再選択したウインドウ、閉じた後に残るタイルへフォーカスが移ります。Macが高負荷でもマウスの下にある実際のウインドウを追従します。アクセシビリティの役割が一時的に変わるウインドウも保持します。
- **起動の遅いAppの最初のウインドウを配置:** Electronなどでアクセシビリティの準備が遅れても、最初のウインドウを見逃さずタイル表示します。
@@ -370,7 +380,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
## 1.4.2 (2026-06-19)
-
+
### 修正
- **閉じた後も最近の順でフォーカス:** フォーカス中のウインドウを閉じると、直前の対象ではなく先頭のタイルへ移る場合がありました。2つ目の作成直後に別のAppのタイル表示を素早く切り替えると顕著でした。ワークスペースごとの使用順をたどり、次に画面上にあるウインドウを選びます。
@@ -396,7 +406,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **検索できるApp選択:** 実行中のAppを検索し、ファイルから直接追加できます。
- **ショートカット記録を刷新:** 配列に依存しない記号(どの配列でも⌘Sなど)を表示し、1クリックで記録できます。競合する操作名を示し、記録中はグローバルキーを停止するため、押した組み合わせは実行されず入力欄へ入ります。内部ではMagnet(Carbon)を使用します。
-
+
### 修正
- **ネイティブタブの切り替えを安定化:** macOSのネイティブタブを使うAppがウインドウIDを変えても、前のワークスペースへ戻らなくなりました。ghosttyなどではタブ切り替え時にBSPツリーが一時的に空になり、「最近のワークスペース」が発動していました。切り替える前に現在の画面上のウインドウを再確認します。
- **管理対象のウインドウだけに追従:** Tatamiが管理するウインドウだけへ移るため、通知や操作フィードバックがフォーカスを奪いません。
@@ -412,7 +422,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **ポインタの画面に切り替えを表示:** ワークスペースの操作フィードバックをポインタのあるディスプレイへ表示します。以前はキーウインドウを追っていたため、切り替え後に別の画面へ出ることがありました。
- **診断ログを拡充:** デバッグ記録を有効にすると、ショートカット受信、ジェスチャー認識とスワイプが*実行されなかった*理由、ミラーのライフサイクル、表示・非表示の概要、BSP操作、ドラッグの確定を `tatami.log` に記録します。
-
+
### 修正
- **入力監視の権限を不要に:** イベントタップはアクセシビリティ権限だけを使います。「すべてのアプリケーションからキー入力を受信」の画面は表示されず、以前拒否した入力監視によってマウス追従やスワイプが停止することもありません。古いTatamiの項目が「プライバシーとセキュリティ → 入力監視」に残っている場合は「−」で削除できます。
- **空のワークスペース切り替えを安定化:** Appが動いていないワークスペースへ切り替えても、元に戻らなくなりました。以前は元のウインドウを隠すとmacOSが直前のAppを復帰させ、Appフォーカス追従が追いかけていました。空のデスクトップでそのまま留まります。
@@ -428,7 +438,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **ワークスペース切り替えを高速化:** 毎回すべてのウインドウをアクセシビリティ経由で調べず、キャッシュ済みのIDを読みます。切り替え中の新しい要求が古い要求を置き換えるため、前後を素早く押しても遅いワークスペースで止まりません。
- **高負荷のAppを保持:** アクセシビリティの応答が時間内に戻らなくても「ウインドウなし」と見なさず、最後の情報を保持します。一時的に忙しいAppがタイル、ミラー、印から消えず、ひとつの停止したAppが配置中にメインスレッドを数秒止めることもありません。
-
+
### 修正
- **ミラーキャプチャを適切に終了:** 競合によってScreenCaptureKitのストリームと画面収録の表示が長く残る問題を修正しました。開始と終了の順序を厳密に保ちます。
- **Electronのウインドウ監視を安定化:** 最初の監視登録に失敗すると、一部のサイズ変更や終了イベントを取り逃していました。他の登録と同様に再試行し、空のタイルが残らないようにしました。
@@ -445,7 +455,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **空になった領域から自動で戻る:** 既定でオフの `settings.switching.switchToRecentWhenEmpty` を有効にすると、最後のウインドウを閉じた際に最近の領域へ戻ります。共有Appは全領域にあるため内容に数えません。意図的に空の領域を開いても戻らず、実際に閉じた場合だけ切り替えます。
- **App内で失敗を確認:** `config.toml` の構文・キーの不備、`layouts.json` の読み書き失敗、CLIサーバー起動失敗、ミラー利用不可、ログイン登録失敗を詳細付きの警告で表示します。メニューバーには⚠️と問題一覧を出し、解決すると確認通知とともに印を消します。
-
+
### 修正
- **ミラーのマウス追従動作:** 追従がオフならホバーでフォーカスを奪いません。スクロール、クリック、ドラッグを実際のウインドウへ渡し、クリック時にフォーカスを移します。オンなら従来どおりホバーで移します。
- **手前表示のちらつきを修正:** マウス追従がオフのとき、隣のフローティングウインドウがクリックしたタイルの後ろへ一瞬落ちる問題と、ポインタが離れるとフォーカス中のウインドウが重なる別のウインドウの後ろへ落ちる問題を修正しました。
@@ -472,14 +482,14 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **固定サイズのウインドウも手前表示:** iOSの**Simulator**など、サイズ固定のウインドウもフローティング表示できます。サイズ変更への対応が必要なのはタイル表示だけです。
- **フローティングの印を常時表示:** フォーカス中だけでなくすべてのフローティングウインドウに点を表示し、ドラッグにも滑らかに追従します。
-
+
### 修正
- **通知のフェードアウトを安定化:** ウインドウ透明度のアニメーションが起動後1回しか正しく動かず、突然消える場合がありました。内容ビューでフェードするよう変更しました。
## 1.2.1 (2026-06-02)
-
+
### 修正
- **閉じると隠れるウインドウを検出:** DiscordなどのElectron Appは破棄イベントを送らずにウインドウを隠すため、空のタイルが残っていました。画面から消えたウインドウを取り除き、残りを再配置します。
@@ -507,7 +517,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **同梱CLIのインストール:** **設定 → コマンドライン**から `tatami` をインストール・削除でき、Homebrewも検出します。アクセシビリティの権限状態と許可ボタンは**設定 → 権限**にあります。
- **App内のキー・画面案内:** わかりにくいショートカットを説明し、ワークスペースの画面設定に固定と動的の違いを表示します。
-
+
### 修正
- **全画面の隙間でのフォーカスを保護:** タイルの隙間に見える全画面ウインドウへ、マウス追従のフォーカスが移らなくなりました。
- **割り当てキーを即時登録:** ワークスペースの**割り当て**ショートカットを記録するとすぐ登録し直します。再起動は不要です。
@@ -539,7 +549,7 @@ Tatamiの主な変更点です。このファイルをウェブサイトとGitHu
- **フォーカスと配置の応答を高速化:** マウス追従とタイル表示のデバウンス時間を短くしました。
- **BSP操作を刷新:** 挿入、入れ替え、移動、均等配置の動作規則を見直しました。
-
+
### 修正
- **タイル表示のショートカットを修正:** 一般的な配置で `grow` / `shrink` / `balance` が動作します。
- **設定の増減ボタンを安定化:** 間隔や点のサイズを1回押しただけで、値が変わり続けることがなくなりました。
diff --git a/docs/ko/CHANGELOG.md b/docs/ko/CHANGELOG.md
index f568f19..312da40 100644
--- a/docs/ko/CHANGELOG.md
+++ b/docs/ko/CHANGELOG.md
@@ -7,12 +7,22 @@
Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Releases에 표시하는 릴리즈 노트의 기준이며, 배포 과정에서 설치·업데이트 안내를 덧붙여요. Sparkle 업데이트 창은 같은 마이너 버전의 모든 패치 내역을 모아 보여주므로 각 섹션에는 해당 버전의 변경만 적어요.
+
+## 1.14.2 (2026-09-17)
+
+창 포커스와 설정 안내를 더 안정적으로 다듬었어요.
+
+
+### 수정 사항
+- **메뉴를 사용한 뒤에도 마지막 창으로 돌아가요:** 앱 메뉴를 사용하거나 같은 앱의 창을 전환한 뒤 작업 공간으로 돌아와도 마지막으로 선택한 창에 포커스를 맞춰요.
+- **설정 안내를 끝까지 적용해요:** 다시 실행한 뒤에도 저장한 설정 초안을 올바르게 복원하고 적용해요. 적용을 확인하면 안내 창을 닫고 완료한 초안을 정리해요.
+
## 1.14.1 (2026-09-11)
레이아웃 복원, 창 전환, 권한 변경 처리를 더 안정적으로 다듬었어요.
-
+
### 수정 사항
- **창을 다시 열어도 배치를 유지해요:** 앱을 다시 실행하거나 macOS가 창을 복원할 때 분할 방향과 비율, 전체화면 확대 상태를 유지해요. 창이 하나씩 열려도 아직 열리지 않은 창의 저장된 배치를 덮어쓰지 않아요.
- **디스플레이가 바뀌어도 배치를 보호해요:** 디스플레이가 일시적으로 감지되지 않으면 마지막 작업 공간 배치를 유지하고, 더 이상 유효하지 않은 디스플레이 변경은 적용하지 않아요. 창 식별자가 바뀌어도 저장된 분할 비율로 복원해요.
@@ -36,7 +46,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **목적별로 설정 찾기:** 사이드바에서 일반, 타일링, 작업 공간, 작업 공간 키, 포커스와 마우스, 제스처, 모양, 훅을 나눠 볼 수 있어요. 확인 설정도 대상 동작별로 묶었어요.
- **5개 언어로 사용법 읽고 보기:** 앱 내 문서는 선택한 언어로 표시되며 제목 이동, 표, 링크가 정상 동작해요. 웹사이트에는 전체 작업 흐름과 기능별 데모 모음을 추가했고, 기본 재생 컨트롤, 키보드 탐색, 관련 설정 링크를 제공해요.
-
+
### 수정 사항
- **항상 위 창에 첫 클릭·드래그 전달하기:** 창 활성화와 미러 전환 중에도 첫 마우스 입력을 유지해요. 키보드 포커스를 옮기지 않고 뒤쪽 창을 스크롤할 수 있으며, 마우스를 올렸을 때의 동작은 FFM 설정을 따라요.
- **창을 잠시 찾을 수 없어도 배치 보존하기:** 배치 읽기가 실패하거나 불완전하다고 해서 저장된 위치를 빈 배치로 덮어쓰지 않아요. 작업 공간 복원은 필요한 창을 확인할 수 있을 때까지 유효한 배치 정보를 유지해요.
@@ -61,7 +71,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **앱·창 전환에 공용 앱 포함:** 빌려오기 중에도 원래 공간과 빌려온 타일 영역 뒤에 공용 항상 위·그대로 두기 창을 보여줘요. 기본으로 켜진 설정을 끄면 더 좁은 목록에서 공용 앱을 제외할 수 있어요.
- **앱별 항상 위 동작 문제 해결:** 새 안내에서 플로팅 컨트롤 앱을 언제 등록해야 하는지, 브라우저 화면 속 화면이 왜 타일링에서 자동 제외되는지, 작업 공간을 바꿔도 유지하려면 언제 등록이 필요한지 설명해요.
-
+
### 수정 사항
- **브라우저 화면 속 화면 타일링 제외:** Chrome·Dia의 PiP 창을 WindowServer 레이어로 구분해 BSP 타일에 넣지 않아요. 메타데이터 조회가 실패해도 정상적인 일반 창은 계속 유지해요.
- **직접 조절한 분할 비율 유지:** 타일의 논리적 구성원이 같다면 포커스 동기화나 창 표면 교체가 비율을 50:50으로 초기화하지 않아요. 실제 창 추가·제거에는 설정에 따라 자동 균등 배치를 적용해요.
@@ -87,7 +97,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **앱 가까이에서 명령어 안내 확인:** 설정에서 번들 CLI 안내를 열거나 pangmo5.dev/Tatami에서 `docs/CLI.md`으로 만든 안내를 읽을 수 있어요. 선택자, JSON 규약, 훅 동작, 종료 상태, 스크립트 예제를 다뤄요.
- **어떤 너비에서도 단축키 충돌 확인:** 기록기 크기와 관계없이 같은 작은 경고를 보여주고, 충돌한 전체 동작은 팝오버와 VoiceOver로 확인할 수 있어요.
-
+
### 수정 사항
- **프로필 경계를 지키는 작업 공간 단축키:** 서로 다른 프로필에서 같은 대표 키나 명시적 단축키를 재사용해도 잘못된 충돌로 보지 않아요. 전역 단축키는 모든 프로필과 계속 비교해요.
- **복사·복제로 단축키 충돌 방지:** 미리보기에서 충돌하는 선택을 알려주고 저장 전에 현재 설정을 다시 검사해요. 실제 충돌이 있으면 일부만 복사하지 않고 전체 변경을 거절해요.
@@ -107,7 +117,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.11.4 (2026-08-11)
-
+
### 수정 사항
- **공용 앱도 공간별 최근 창 유지:** 돌아온 공간에서 마지막으로 포커스한 창을 복원해요. 다른 공간을 거치며 선택한 공용 타일 앱이 대신 포커스를 받지 않아요.
@@ -123,7 +133,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **최근 작업 공간을 디스플레이 전체에서 기억:** 새 설치에서는 최근에 머문 작업 공간을 모니터별이 아닌 전체 데스크톱 기준으로 다뤄요. 기존 설정은 유지해요.
- **레이아웃 명령을 따라 포인터 이동:** 분할 방향을 바꾸거나 전체 화면 확대를 켜고 끄면 포커스한 창과 함께 포인터를 옮겨요. 창이 떠난 예전 타일에 포인터가 남지 않아요.
-
+
### 수정 사항
- **동적 작업 공간이 다시 포인터를 따라가요:** 한 번 표시한 뒤 마지막 모니터에 고정되던 문제를 수정했어요. 동적 작업 공간을 활성화하면 포인터가 있는 디스플레이로 가져와요. 이미 그 디스플레이에 있다면 진행 중인 빌려오기 구성을 유지해요.
- **여러 디스플레이에서 잠금 해제 후 복원:** 잠금 화면 뒤에서 macOS가 모니터를 제거·추가할 때 중간 상태마다 처리해 화면 할당이 풀리고, 화면 수 규칙으로 프로필이 바뀐 채 저장될 수 있었어요. 이제 화면 구성이 안정된 뒤 반영해 잠깐 사라졌다 돌아온 모니터는 그대로 유지하고 실제 분리는 한 번만 처리해요.
@@ -138,7 +148,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.11.2 (2026-08-04)
-
+
### 수정 사항
- **화면 잠금 중 레이아웃 보존:** 잠금 중 일시적인 손쉬운 사용·WindowServer 조회 결과로 창이 BSP에서 빠지지 않아요. 잠금 화면이 나타나기 전에 소속 제거를 멈추고, 겹친 잠자기·세션 전환이 모두 끝난 뒤 잠금 해제 시 전체 레이아웃을 연결해요.
- **화면 간 작업 공간 알림 완성:** 다른 화면에 이미 보이는 공간으로 포커스해도 빌려오기를 깨뜨리지 않고 알림을 표시해요. 떠난 화면에는 대상 공간과 모니터 이름을 함께 알려줘 전환 결과가 분명해요.
@@ -146,7 +156,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.11.1 (2026-08-02)
-
+
### 수정 사항
- **네이티브 탭 변경 중 레이아웃 유지:** 탭을 만들거나 닫거나 바꿀 때 임시 WindowServer 표면 ID를 별도 창으로 BSP에 넣지 않아요. 빠른 탭 변경 중에도 실제 표면만 바꾸며 기존 타일·포커스 이력·확대·표시 상태를 유지해요.
@@ -163,7 +173,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **더 명확하고 정확한 창 전환기:** 앱 아이콘마다 포커스·빌려옴·공용 앱·항상 위·전체 화면 상태를 표시해요. 포인터를 올리면 실제 선택도 바뀌므로, 같은 앱의 창이 여러 개여도 Return이나 보조 키 해제로 강조한 창을 정확히 선택해요. 배치는 더 작아지고 동작 줄이기를 반영해요.
- **레이아웃 설정을 따르는 균등 배치:** 균등 배치 명령이 지정한 자동 균등 배치 축을 적용해요. 자동 옵션을 끄면 이미 불균형한 트리 안에서 비율만 같게 하는 대신 기본 BSP 트리를 다시 만들어요.
-
+
### 수정 사항
- **늦게 뜨거나 다시 나타나는 창 안정화:** WindowServer의 표시 변화를 즉시 반영하고, 창의 정체성을 기억한 채 숨긴 표면을 제거해요. 다시 나타난 앱이 나중에 예전 프레임을 복원해도 계속 올바른 타일로 맞춰요. 느린 앱의 첫 창도 관찰 준비가 되면 원래 포커스·전체 화면 자리·프레임을 복원해요.
- **빌려오기 완료·포커스 안정화:** 늦게 실행된 앱의 첫 창도 나타나는 즉시 배치하고 포커스해요. 구성 중 원래 포커스와 창 표시를 유지하며, 전체 활성화 전에는 오래된 표시를 지워요. 다른 디스플레이로 포커스를 옮기거나 이미 보이는 원래 공간으로 돌아와도 빌려오기 구성을 유지해요.
@@ -188,14 +198,14 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.9.2 (2026-07-27)
-
+
### 수정 사항
- **MFF·FFM 함께 사용 시 안정화:** 포인터로 옮긴 포커스의 손쉬운 사용 알림이 MFF로 되돌아와 포인터를 다시 옮기지 않아요. 자체 포인터 이동의 합성 이벤트와 오래된 포커스 알림을 제외하고, 빌려오기 레이아웃을 복구할 때도 사용자가 옮긴 포인터를 되찾지 않아요.
## 1.9.1 (2026-07-23)
-
+
### 수정 사항
- **알림으로 활성화해도 빌려오기 배치 유지:** 빌려온 앱의 알림을 클릭했을 때 앱이 짧은 저장 프레임을 복원해 아래에 빈 공간이 생기지 않아요. 포커스 창이 안정되면 빌려온 영역 전체 배치를 다시 적용해요.
@@ -215,14 +225,14 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **빌려오기·메뉴 막대 반응 개선:** 영역을 먼저 배치한 뒤 실제 프레임에 맞춰 키보드 포커스와 포인터 이동을 순서대로 처리해요. 중복 AX 쓰기를 생략하고 알려진 숨김 임시 창은 다시 열지 않고 사용해요. App Nap 중에도 메뉴 막대 실행의 반응성을 유지해요.
- **내용에 맞는 화면 알림:** 작은 스프링 전환으로 알림을 표시하고 숨겨요. 내용에 맞춰 크기를 바꾸고, 이미 보이는 알림은 전체 표시 과정을 다시 실행하지 않고 갱신해요.
-
+
### 수정 사항
- **타일이 아닌 창 전환에도 포인터 이동:** 항상 위·공용 항상 위·그대로 두기 창으로 전환하면 포커스 적용 후 실제 창 위치를 읽고 포인터를 가운데로 옮겨요.
## 1.8.1 (2026-07-20)
-
+
### 수정 사항
- **다른 프로필 전용 앱도 임시 배치:** 비활성 프로필에만 등록한 앱을 현재 프로필에서 열어도 일반적으로 타일링해요. 접근할 수 없는 공간의 앱으로 처리하지 않아요.
@@ -239,7 +249,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **선택 가능한 전역 최근 작업 공간:** 모든 화면에서 하나의 최근 이력을 쓸 수 있어요. 공간을 포인터 화면으로 가져오는 대신 이미 있는 화면에서 포커스해요. 기본값은 기존 디스플레이별 동작을 유지해요.
- **다시 빌려오면 닫기:** 현재 디스플레이에 이미 빌려온 작업 공간을 다시 호출하면 기본적으로 빌려오기를 해제하고 원래 작업 공간을 복원해요. 다시 배치하는 기존 동작을 원하면 이 옵션을 끌 수 있어요.
-
+
### 수정 사항
- **같은 앱의 정확한 창 복원:** 공간을 떠나기 전에 실제 포커스 창을 보이는 레이아웃과 대조해요. 같은 앱의 다른 창에 오래된 최근 순서가 있거나 알림을 놓쳐도 실제 사용하던 창으로 돌아와요.
@@ -252,7 +262,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **포인터 기준 빌려오기:** 빌려오기·최근·다음·이전·방향 선택·해제를 모두 포인터 화면에서 처리해요. 방향 선택도 시작한 디스플레이를 기억해요.
- **작업 공간 활성화 비용 감소:** 중복된 손쉬운 사용 프레임 쓰기를 생략하고, 프로세스나 창이 사라지면 캐시에서 즉시 제거해요. 새 요청으로 대체된 활성화·포커스·미러 작업도 취소해요.
-
+
### 수정 사항
- **앱 사이 마우스 포커스:** 다른 앱의 창으로 포커스를 옮기면 창을 올리는 것과 함께 최전면 앱도 바꿔요. 창들이 다른 디스플레이에 있어도 동작해요.
- **창을 닫은 뒤 정확히 포커스·중앙 이동:** 창 목록이 안정된 뒤 의도한 최근 창을 선택하고 실제 프레임 가운데로 포인터를 옮겨요.
@@ -262,7 +272,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.7.2 (2026-07-15)
-
+
### 수정 사항
- **디스플레이를 넘는 창 전환:** 1.7.0부터 기본으로 켜진 alt/opt+tab 창 전환이 두 창 사이에 갇히거나 다른 모니터의 공간에서 동작할 수 있었어요. 이제 손쉬운 사용으로 창을 올리는 데 그치지 않고 WindowServer로 최전면 앱을 바꿔 앱·디스플레이 사이를 올바르게 전환해요.
- **디스플레이 변경 알림 묶기:** 운영체제가 같은 화면 설정 알림을 연속으로 보내도 묶어서 처리해요. 바뀌지 않은 구성을 반복해서 평가하지 않아요.
@@ -279,7 +289,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **전역 공용 앱 사이드바:** 공용 앱은 모든 프로필의 모든 공간에 참여하므로, 특정 프로필 아래에서 사이드바의 **모든 곳** 섹션으로 옮겼어요.
- **디스플레이별 프로필 전환 알림:** 전체 목록 하나 대신 각 모니터에 그곳에 표시될 작업 공간을 알려줘요.
-
+
### 수정 사항
- **연결 해제된 화면의 고정 공간 유지:** 고정 모니터가 없는 상태에서 공간을 열고 프로필을 바꿨다 돌아와도 다른 공간으로 바뀌지 않아요. 마지막 위치를 유지하다가 모니터를 다시 연결하면 제자리로 돌려보내요.
@@ -298,7 +308,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **설정 재구성:** 대표 키는 **작업 공간 키**, 트랙패드 제스처는 **제스처** 화면으로 옮겼어요. 창 전환 설정·단축키도 함께 묶었어요. 공간의 파생 단축키는 작업 공간 키로 바로 연결하고, 읽기 전용 일반 텍스트로 보여 다른 곳에서 설정한다는 점을 분명히 했어요.
- **새 설치 기본값 개선:** 새 설정에는 추천 단축키를 넣고, 앱을 활성화하면 해당 작업 공간으로 전환하는 *앱 포커스 따라가기*를 기본으로 켜요. 기존 설정은 그대로 둬요.
-
+
### 수정 사항
- **여러 공간 소속 앱의 포커스 안정화:** 앱이 여러 공간에 속해 있어도 그중 하나에 이미 있다면 앱을 클릭할 때 다른 공간으로 이동하지 않아요.
- **메인 창을 확실히 앞으로:** Tatami 창을 열어도 다른 앱의 창 뒤로 내려가지 않아요.
@@ -306,7 +316,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.6.1 (2026-07-10)
-
+
### 수정 사항
- **화면 재연결 후 확대 상태 복원:** 디스플레이를 닫았다 열어도 작업 공간 확대가 풀리지 않아요. 화면 변경 중 창이 잠깐 숨겨지면 확대가 영구 해제되던 문제를 수정했어요. 같은 창은 다시 확대되어 돌아오며, 실제로 창을 닫으면 확대를 해제하고 다시 열 때 새로 시작해요.
@@ -327,7 +337,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **같은 앱의 창에도 각각 자리 기억:** 앱 창 목록의 위치로 각 창을 추적해 여러 창을 개별 배치하고 전체 화면이던 창도 기억해요. 읽지 못하는 레이아웃 항목 하나가 모든 공간을 초기화하지 않으며, 이전 레이아웃은 자동 변환해요.
- **작업 공간 순서 변경·삭제 확인:** 사이드바에서 드래그해 순서를 바꿀 수 있어요. 작업 공간을 삭제하거나 앱을 제거하기 전에 확인해요.
-
+
### 수정 사항
- **최근 창 복원:** 창이 여러 개인 앱으로 `⌥Tab`을 통해 돌아오면 임의의 창 대신 최근 포커스한 창을 열어요.
- **공간 활성화 시 올바른 최전면 앱:** 앱을 활성화해 작업 공간을 앞으로 가져와도 그 안의 상시 실행 앱이 최전면을 가져가지 않아요.
@@ -343,7 +353,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **떠난 디스플레이에서 포커스 이동 알림:** 모니터를 넘겨 포커스하면 떠난 화면에 알려줘요. 여러 화면에서 포커스가 어디로 갔는지 알기 쉬워요.
- **부드러운 제스처 민감도 슬라이더:** 설정에서 끌 때 매 단계마다 전체 양식을 다시 그리지 않아요.
-
+
### 수정 사항
- **창 포커스 추적 안정화:** 새로 열거나 다시 선택한 창, 닫힌 창 대신 남은 타일로 포커스가 이어져요. 시스템이 바쁠 때도 마우스 포커스는 실제 포인터 아래 창을 따라가요. 손쉬운 사용 역할이 잠깐 바뀌는 창도 유지해요.
- **늦게 실행되는 앱의 첫 창 배치:** Electron 같은 무거운 앱의 손쉬운 사용 준비가 늦어도 첫 창을 놓치지 않고 찾아 배치해요.
@@ -370,7 +380,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
## 1.4.2 (2026-06-19)
-
+
### 수정 사항
- **창을 닫은 뒤 최근 순서로 포커스:** 포커스한 창을 닫으면 최근 창 대신 첫 타일로 이동할 수 있었어요. 두 번째 창을 만든 직후 다른 앱의 타일링을 빠르게 켰다 끌 때 특히 두드러졌어요. 이제 작업 공간의 최근 사용 순서를 따라 화면에 남은 다음 창을 선택해요.
@@ -396,7 +406,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **검색 가능한 앱 선택기:** 실행 중인 앱을 검색하고 파일에서 바로 추가할 수 있어요.
- **단축키 기록기 개편:** 키보드 배열과 무관한 기호(항상 ⌘S 등)를 표시하고 한 번 클릭해 기록해요. 다른 단축키와 충돌하면 이름으로 알려줘요. 기록 중에는 전역 단축키를 멈춰 누른 조합이 실행되지 않고 입력란에 들어가요. 전역 단축키는 Magnet(Carbon)을 사용해요.
-
+
### 수정 사항
- **네이티브 탭 전환 안정화:** macOS 네이티브 탭 앱이 창 ID를 바꿔도 작업 공간 전환이 되돌아가지 않아요. ghostty 같은 앱은 탭 전환 시 ID가 바뀌어 BSP 트리가 잠깐 비고, 최근 작업 공간 동작이 이전 공간으로 돌아갈 수 있었어요. 이제 전환 전에 현재 작업 공간의 화면상 창을 다시 확인해요.
- **관리 창으로만 마우스 포커스:** Tatami가 관리하는 창만 따라가므로 알림이나 화면 알림 패널이 포커스를 가져가지 않아요.
@@ -412,7 +422,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **포인터 디스플레이에 작업 공간 알림 표시:** 포인터가 있는 디스플레이에 화면 알림을 보여줘요. 이전에는 키 윈도우를 따라가서 전환 후 보고 있던 모니터와 다른 곳에 나타날 수 있었어요.
- **진단 기록 확장:** 디버그 기록을 켜면 단축키 수신, 제스처 인식과 *실행되지 않은* 이유, 항상 위 미러의 수명 주기, 표시·숨김 요약, BSP 작업, 드래그 적용 결과를 모두 `tatami.log`에 기록해요.
-
+
### 수정 사항
- **입력 모니터링 권한 요구 제거:** 이벤트 탭은 손쉬운 사용 권한만 사용해요. 모든 앱의 키 입력을 수신한다는 대화상자가 더는 뜨지 않고, 예전에 거절한 입력 모니터링 권한 때문에 마우스 포커스나 스와이프가 멈추지 않아요. 이전 버전의 Tatami 항목이 개인정보 보호 및 보안 → 입력 모니터링에 남아 있다면 ‘−’로 제거할 수 있어요.
- **빈 작업 공간 전환 안정화:** 앱이 실행되지 않는 작업 공간으로 전환해도 이전 공간으로 돌아가지 않아요. 이전 창을 숨기면 macOS가 직전 앱을 되살리고 앱 포커스 따라가기가 이를 따라가는 문제가 있었어요. 이제 빈 바탕 화면에서 그대로 유지해요.
@@ -428,7 +438,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **더 빠른 작업 공간 전환:** 전환 경로에서 모든 창을 손쉬운 사용으로 조회하는 대신 캐시된 창 ID를 읽어요. 전환 중 새 요청이 오면 이전 요청을 대체하므로, 이전·다음을 빠르게 눌러도 느린 작업 공간에 멈추지 않고 진행해요.
- **바쁜 앱의 창 유지:** 앱이 바빠 손쉬운 사용 조회에 제때 답하지 못해도 ‘창 없음’으로 판단하지 않고 마지막 창 정보를 유지해요. 잠깐 바쁜 앱이 타일·미러·표시 점에서 빠지지 않으며, 응답 없는 앱 하나가 타일링 중 메인 스레드를 몇 초씩 멈추지도 않아요.
-
+
### 수정 사항
- **미러 캡처를 제때 종료:** 여러 경합으로 ScreenCaptureKit 스트림과 화면 기록 표시가 의도보다 오래 유지되던 문제를 수정했어요. 이제 캡처 시작·종료 순서를 엄격하게 지켜요.
- **Electron 창 관찰 안정화:** 첫 관찰 등록이 실패하면 일부 창의 크기 변경·닫기 이벤트를 놓쳤어요. 이제 다른 등록처럼 재시도해 빈 타일이 남지 않아요.
@@ -445,7 +455,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **빈 작업 공간에서 자동 돌아가기:** 기본으로 꺼진 `settings.switching.switchToRecentWhenEmpty`을 켜면 현재 공간의 마지막 창을 닫을 때 최근 공간으로 전환해요. 공용 앱은 모든 곳에 있으므로 내용으로 세지 않아요. 일부러 빈 공간을 열었을 때는 돌아가지 않고 실제 닫기만 전환을 일으켜요.
- **앱에서 실패 확인:** `config.toml` 문법·단축키 오류, `layouts.json` 읽기·쓰기 실패, CLI 서버 시작 실패, 미러 사용 불가, 로그인 실행 등록 실패를 오류 설명과 경고 알림으로 보여줘요. 메뉴 막대에는 ⚠️와 문제 목록이 나타나요. 해결하면 확인 알림과 함께 표시를 지워요.
-
+
### 수정 사항
- **미러의 마우스 포커스 동작:** 마우스 포커스를 끄면 포인터를 올려도 포커스를 가져가지 않아요. 미러의 스크롤·클릭·드래그를 실제 창에 전달하며 클릭하면 포커스를 옮겨요. 마우스 포커스를 켜면 이전처럼 포인터를 올릴 때 전달해요.
- **항상 위 창 깜빡임 수정:** 마우스 포커스를 껐을 때 다른 항상 위 창이 클릭한 타일 뒤로 잠깐 내려가거나, 포인터가 떠나면 포커스 창이 겹친 다른 항상 위 창 뒤로 내려가던 두 문제를 수정했어요.
@@ -472,14 +482,14 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **고정 크기 창도 항상 위로:** iOS **Simulator**처럼 크기가 고정된 창도 띄울 수 있어요. 크기 조절은 타일링할 때만 필요해요.
- **항상 위 창의 지속 표시:** 포커스한 창뿐 아니라 모든 항상 위 창에 점을 보여주고, 창을 끌면 점도 부드럽게 따라가요.
-
+
### 수정 사항
- **알림 페이드아웃 안정화:** 창 투명도 애니메이션이 실행 후 한 번만 제대로 동작해 알림이 즉시 사라지곤 했어요. 이제 콘텐츠 뷰에서 페이드를 처리해요.
## 1.2.1 (2026-06-02)
-
+
### 수정 사항
- **닫을 때 숨기는 창 감지:** Discord 같은 Electron 앱은 창을 닫아도 손쉬운 사용의 창 삭제 이벤트 없이 숨기기만 해서 빈 타일이 남았어요. 이제 화면에서 사라진 창을 타일에서 제거하고 나머지를 다시 배치해요.
@@ -507,7 +517,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **번들 CLI 설치기:** **설정 → 명령줄**에서 `tatami` CLI를 설치·제거할 수 있고 Homebrew 설치도 감지해요. 손쉬운 사용 권한 상태와 허용 버튼은 **설정 → 권한**에서 제공해요.
- **앱 안의 단축키·디스플레이 안내:** 헷갈리기 쉬운 단축키를 설명하고, 작업 공간의 디스플레이 섹션에서 고정·동적의 차이를 안내해요.
-
+
### 수정 사항
- **전체 화면 틈새 포커스 보호:** 타일 사이로 보이는 전체 화면 창에 마우스 포커스가 넘어가지 않아요.
- **할당 단축키 즉시 등록:** 작업 공간의 **할당** 단축키를 기록하면 바로 다시 등록해요. 다시 실행할 필요가 없어요.
@@ -539,7 +549,7 @@ Tatami의 주요 변경 사항이에요. 이 파일은 웹사이트와 GitHub Re
- **더 빠른 포커스·타일링 반응:** 마우스 포커스와 타일링 디바운스 시간을 줄였어요.
- **BSP 작업 개편:** 삽입·교환·옮기기·균등 배치의 동작 규칙을 전반적으로 정리했어요.
-
+
### 수정 사항
- **타일링 단축키 수정:** 일반적인 레이아웃에서 `grow` / `shrink` / `balance`가 동작해요.
- **설정 증감 버튼 안정화:** 간격과 점 크기 버튼을 한 번 눌러도 값이 계속 바뀌지 않아요.
diff --git a/docs/zh-Hans/CHANGELOG.md b/docs/zh-Hans/CHANGELOG.md
index 94bcde9..41e7ba7 100644
--- a/docs/zh-Hans/CHANGELOG.md
+++ b/docs/zh-Hans/CHANGELOG.md
@@ -7,12 +7,22 @@
Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的权威来源,发布流程会追加安装与更新说明。Sparkle 的应用内更新窗口汇总同一小版本系列的所有补丁,因此各节只需记录自身版本的变化。
+
+## 1.14.2 (2026-09-17)
+
+改进窗口焦点和引导设置。
+
+
+### 修复
+- **使用菜单后仍返回最后选择的窗口:** 使用应用菜单并切换同一应用的窗口后,返回工作区时仍会聚焦最后选择的窗口。
+- **可靠地完成引导设置:** 重新启动后,正确恢复并应用已保存的设置草稿。确认应用设置后,引导窗口会关闭,并清除已完成的草稿。
+
## 1.14.1 (2026-09-11)
改进布局恢复、窗口切换和权限变更处理。
-
+
### 修复
- **重新打开窗口时恢复布局:** 应用重启或 macOS 恢复窗口时,保留分割方向、比例和全屏放大状态。窗口逐个打开时,不再覆盖尚未打开窗口的已保存布局。
- **显示器变化时保护布局:** 暂时未检测到显示器时,保留最近的工作区布局,并忽略已被后续变化取代的显示器更新。窗口标识变化后,仍按已保存的分割比例恢复。
@@ -36,7 +46,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **按任务查找设置:** 分类侧栏将通用、平铺、工作区、工作区按键、焦点与鼠标、手势、外观和钩子分开。确认偏好也按其控制的操作分组。
- **以五种语言阅读和观看工作流程:** 应用内文档以所选语言显示,标题、表格和链接均可正常使用。网站提供完整工作流程及专题演示集,支持原生播放控件、键盘导航和相关设置链接。
-
+
### 修复
- **将首次点击或拖动传递给始终置顶窗口:** 在激活和镜像交接期间保留初始鼠标输入。后台滚动无需取得键盘焦点即可到达真实窗口,悬停行为遵循焦点跟随鼠标设置。
- **窗口暂时不可用时保留布局:** 布局读取失败或不完整时,不再用空布局替换保存的位置。工作区恢复会保留有效布局信息,直到能够找到所需窗口。
@@ -61,7 +71,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **应用与窗口切换包含共享应用**:借用期间,共享浮动及保持原样窗口会排在主区域和借用平铺区域之后。该设置默认开启,也可关闭以排除共享应用,缩小切换列表。
- **排查应用浮动行为**:新指南说明何时需要登记带浮动控件的应用、浏览器画中画为何会自动排除在平铺之外,以及何时仍需登记才能让它跨工作区保持可见。
-
+
### 修复
- **将浏览器画中画排除在布局外**:通过 WindowServer 层级识别 Chrome 和 Dia 的 PiP 窗口,不再将它们作为 BSP 平铺窗口;元数据查询失败时仍保留有效的普通窗口。
- **保留手动调整的分割比例**:逻辑平铺成员未变化时,焦点协调和窗口表面替换不再把工作区重置为 50:50。真实插入和移除仍按设置应用自动均衡。
@@ -87,7 +97,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **随时查看命令文档**:在设置中打开内置 CLI 指南,或在 pangmo5.dev/Tatami 阅读由 `docs/CLI.md` 生成的在线参考。内容包括选择器、JSON 约定、钩子行为、退出状态及脚本示例。
- **任意宽度都能读取快捷键冲突**:记录控件在各种尺寸下显示一致的紧凑警告,并通过弹出框和 VoiceOver 提供完整的冲突操作。
-
+
### 修复
- **工作区快捷键遵循方案边界**:不同配置方案可重用同一工作区键或显式快捷键,不再误报冲突。全局快捷键仍与全部方案比较。
- **复制不会静默引入快捷键冲突**:预览会指出冲突选项,并在保存前重新验证当前配置。真正发生冲突时拒绝整个修改,而不应用部分复制结果。
@@ -107,7 +117,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.11.4 (2026-08-11)
-
+
### 修复
- **共享应用保留各工作区最近窗口**:返回工作区时恢复在那里最后聚焦的窗口,不再改为经过其他工作区时聚焦的共享平铺应用。
@@ -123,7 +133,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **默认跨显示器记忆最近工作区**:新安装将“刚才所在的工作区”视为整个桌面的统一记录,而非每台显示器各自记录。现有配置保持不变。
- **指针跟随改变焦点窗口形状的布局命令**:切换分割方向或进入、退出全屏缩放时,指针会随焦点窗口移动,不再留在窗口已离开的平铺位置。
-
+
### 修复
- **动态工作区重新跟随鼠标**:修复动态工作区显示过一次后就停在最后一台显示器的问题。激活时会移到指针所在显示器;若本就在该显示器,则保留正在使用的借用组合。
- **多显示器解锁后正确恢复**:macOS 会在锁屏背后移除并重新加入显示器,过去逐次处理所有中间状态,可能破坏分配、触发显示器数量规则切换方案并保存错误结果。现在等待拓扑稳定后再协调,短暂消失又返回的显示器不改变状态,真正拔出则只处理一次。
@@ -138,7 +148,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.11.2 (2026-08-04)
-
+
### 修复
- **锁屏期间保留布局**:锁屏时的临时辅助功能或 WindowServer 快照不再从活动 BSP 布局中移除窗口。锁屏遮罩出现前冻结破坏性的成员变更,等待所有重叠睡眠或会话转换结束,再在解锁后重新连接完整布局。
- **完整的跨显示器工作区反馈**:移动焦点到其他显示器上已可见的工作区时,再次显示反馈而不打乱借用组合。来源显示器同时显示目标工作区与显示器名称,使每次跨屏切换结果清楚。
@@ -146,7 +156,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.11.1 (2026-08-02)
-
+
### 修复
- **原生标签页变化时保持布局**:创建、关闭或切换标签页时,临时 WindowServer 表面标识不再作为独立窗口进入 BSP 树。即使快速变动,也在实际表面替换时保留原平铺位置、焦点历史、缩放及呈现状态。
@@ -163,7 +173,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **更清晰准确的窗口切换器**:各应用图标会显示焦点、借用、共享应用、置顶和全屏状态。悬停会更新真实选择,即使同一应用有多个窗口,Return 或松开修饰键也会确认当前高亮窗口。布局更紧凑,并遵循减少动态效果设置。
- **均衡遵循布局设置**:均衡命令现在应用配置的自动均衡轴。关闭自动均衡时,会重建标准 BSP 树,而不只是在已有的不均衡拓扑内均分比例。
-
+
### 修复
- **可靠处理延迟、隐藏和重现的窗口**:立即响应 WindowServer 可见性变化,移除隐藏表面但保留身份,并在应用重现后继续校正其稍后恢复的旧尺寸。慢启动应用的首个窗口也会在观察就绪后立即恢复预期焦点、全屏位置和尺寸。
- **稳定借用完成与焦点**:冷启动应用的首个窗口在借用开始后出现,也会立即平铺并聚焦。借用稳定过程中保留精确的主区域焦点和窗口标记,在完整激活前清除旧标记,并在焦点转到其他显示器或返回已可见主区域时保持组合。
@@ -188,14 +198,14 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.9.2 (2026-07-27)
-
+
### 修复
- **稳定 MFF 与 FFM 的交互**:同时启用时,指针触发的焦点通知不会再反馈到鼠标跟随焦点并再次移动指针。Tatami 会忽略自身跳转产生的合成移动、丢弃旧焦点回声,并允许借用修复布局而不抢回用户已经移动的指针。
## 1.9.1 (2026-07-23)
-
+
### 修复
- **通知激活后保持借用布局**:点击借用区域内已可见应用的通知,不再让应用恢复较短的保存尺寸并在下方留白。焦点窗口稳定后,会重新应用完整借用区域。
@@ -215,14 +225,14 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **更快的借用与菜单栏交互**:先布局区域,再根据实际尺寸依序转移键盘焦点和 MFF 指针。跳过冗余辅助功能写入,复用已知的隐藏暂存窗口而不重新打开,并在 App Nap 下维持菜单栏运行时的低延迟。
- **自适应操作反馈**:反馈以紧凑的弹簧过渡进入和退出,随内容调整大小,并直接更新已显示的反馈,不重播整个呈现过程。
-
+
### 修复
- **非平铺切换目标也支持鼠标跟随焦点**:切换到浮动、共享浮动或忽略模式窗口后,会读取其实际位置并将指针移到中央,不再留在原处。
## 1.8.1 (2026-07-20)
-
+
### 修复
- **跨方案临时平铺应用**:仅分配到非活动方案的应用,在当前方案打开时也会正常平铺,不再被视为属于不可访问的工作区。
@@ -239,7 +249,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **可选的全局最近工作区**:最近工作区操作可使用跨所有显示器的统一历史,在工作区原位置聚焦,而不是拉到指针显示器。默认仍是原有逐显示器行为。
- **再次借用即可收起**:重复调用当前显示器上已借用的工作区,默认会结束借用并恢复主工作区。关闭此选项则继续重新停靠借用区域。
-
+
### 修复
- **准确恢复同应用窗口**:离开工作区前,将精确焦点窗口与可见布局核对。即使同应用另一窗口保留较旧的最近使用位置,或漏掉焦点通知,返回时也会恢复真正使用过的窗口。
@@ -252,7 +262,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **按指针范围借用**:借用、最近及前后借用、方向选择和收起统一作用于鼠标所在显示器,方向选择也记住开始时的显示器。
- **降低工作区激活开销**:跳过冗余辅助功能尺寸写入,进程或窗口消失时立即清除缓存,并取消已被新请求取代的激活、焦点和镜像任务。
-
+
### 修复
- **跨应用焦点跟随鼠标**:在不同应用的窗口间移动焦点时,既置前窗口也转移最前台应用,窗口位于不同显示器时同样适用。
- **正确处理关闭后的焦点与居中**:关闭焦点窗口后,待窗口列表稳定再选中预期的最近窗口,并将指针置于其实际位置中央。
@@ -262,7 +272,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.7.2 (2026-07-15)
-
+
### 修复
- **跨显示器切换窗口**:自 1.7.0 默认开启的 alt/opt+tab 可能困在两个窗口之间,或操作错误显示器的工作区。现在通过窗口服务器转移最前台应用,而不只是执行辅助功能置前,从而正确跨应用和显示器切换。
- **合并显示器重配通知**:操作系统连续发送相同屏幕参数通知时会合并处理,不再反复评估未变化的显示器配置。
@@ -279,7 +289,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **全局共享应用侧边栏**:共享应用加入所有方案的所有工作区,因此从单个方案下移到了侧边栏的**所有位置**区段。
- **逐显示器的方案切换反馈**:切换方案时,各显示器分别显示落在其上的工作区,而不是单个反馈列出全部内容。
-
+
### 修复
- **保留断开显示器的固定工作区**:固定显示器未连接时激活工作区,再切换方案离开并返回,不会变成其他工作区。Tatami 保留最后位置,显示器重连后再送回原屏幕。
@@ -298,7 +308,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **重新组织设置**:工作区对应键移到独立的**工作区键**面板,触控板移到**手势**面板,窗口切换设置与快捷键集中显示。派生快捷键直接链接到工作区键,并以只读普通文本呈现,明确它们在其他位置配置。
- **更友好的初始默认值**:全新配置会包含推荐快捷键,并默认开启*跟随应用焦点*,激活应用时切换到它所属的工作区。已有配置不变。
-
+
### 修复
- **稳定多工作区应用的焦点**:应用属于多个工作区时,若已位于其中一个,点击该应用不会跳到其他工作区。
- **可靠置前主窗口**:打开 Tatami 窗口时不再沉到其他应用窗口后方。
@@ -306,7 +316,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.6.1 (2026-07-10)
-
+
### 修复
- **显示器重连后恢复全屏缩放**:关闭并重新打开显示器不再丢失工作区缩放。过去显示器变动导致窗口短暂隐藏时,会永久清除缩放;现在同一窗口回来后继续保持缩放。真正关闭窗口仍会取消缩放,重新打开则从新状态开始。
@@ -327,7 +337,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **同应用窗口保留独立位置**:布局按窗口在应用中的位置进行跟踪,使多个窗口各有可排列的位置,并记住哪个处于全屏。布局记忆也得到加固:单个不可读条目不再清空全部工作区,旧布局会自动迁移。
- **工作区排序与删除确认**:可在侧边栏拖动工作区来排序。删除工作区或移除应用时会请求确认。
-
+
### 修复
- **恢复最近使用的窗口**:通过 `⌥Tab` 返回拥有多个窗口的应用时,会定位到最近聚焦的窗口,而不是随机窗口。
- **工作区激活时保持正确前台应用**:激活应用带出其工作区时,该工作区中始终打开的应用不再抢到前台。
@@ -343,7 +353,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **在来源显示器提示焦点移动**:跨显示器移动焦点时,会在离开的显示器上提示,让多屏环境中的焦点去向更清楚。
- **更流畅的手势灵敏度滑块**:在设置中拖动时,不再每一步都重绘整个表单。
-
+
### 修复
- **更可靠的窗口焦点跟踪**:焦点会跟随新开或重新选中的窗口,并在窗口关闭后移到剩余平铺窗口。即使系统繁忙,焦点跟随鼠标也会定位到实际位于指针下的窗口。辅助功能角色短暂变化的窗口不会被移除。
- **平铺慢启动应用的首个窗口**:Electron 等大型应用的辅助功能层较晚就绪时,也能发现并平铺第一个窗口,不再漏掉。
@@ -370,7 +380,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
## 1.4.2 (2026-06-19)
-
+
### 修复
- **关闭窗口后按最近使用顺序聚焦**:关闭焦点窗口后可能跳到第一个平铺窗口,而非最近使用的窗口,尤其是在新建第二个窗口后快速切换其他应用的平铺状态时。现在按各工作区的最近使用顺序查找下一个仍在屏幕上的窗口。
@@ -396,7 +406,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **可搜索的应用选择器**:支持搜索运行中的应用,也可直接从文件添加。
- **重做快捷键录制**:记录器显示与键盘布局无关的符号,例如始终显示 ⌘S,单击即可记录,并按名称提示冲突。录制时暂停全局快捷键,使按键组合进入输入框而非执行操作。全局快捷键底层改用 Magnet(Carbon)。
-
+
### 修复
- **稳定原生标签页切换**:使用 macOS 原生标签页的应用改变窗口 ID 时,工作区不会再跳回。ghostty 等应用切换标签页会交换窗口 ID,曾导致 BSP 树暂时为空,使“切换到最近工作区”返回上一工作区。现在切换前会重新检查当前工作区的屏幕窗口。
- **仅跟随管理窗口**:焦点跟随鼠标只进入 Tatami 管理的窗口,通知和反馈面板不再抢走焦点。
@@ -412,7 +422,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **在指针显示器上显示工作区反馈**:反馈现在出现在指针所在显示器。过去跟随键窗口,切换后可能显示在另一台并非正在注视的显示器上。
- **更丰富的诊断**:开启调试日志后,快捷键接收、手势识别及滑动*未触发*的原因、置顶镜像生命周期、显示与隐藏摘要、BSP 操作和拖动提交都会记录到 `tatami.log`。
-
+
### 修复
- **不再要求输入监控权限**:事件监听现在只依赖辅助功能权限,不再显示“接收来自任何应用的按键”对话框。此前拒绝输入监控也不会破坏焦点跟随鼠标和滑动手势。如旧版 Tatami 仍列在隐私与安全性 → 输入监控中,可用“−”移除该项目。
- **稳定切换空工作区**:切换到应用尚未运行的工作区时,不再跳回。过去隐藏原窗口会让 macOS 恢复先前的应用,焦点跟随应用又会追随它回到原工作区。现在空工作区会停留在空桌面。
@@ -428,7 +438,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **更快的工作区切换**:激活时从缓存读取窗口标识,不再在关键路径上逐个查询辅助功能窗口。切换期间的新请求会取代进行中的请求,因此快速前后切换可越过响应缓慢的工作区,不会停在那里。
- **保留繁忙应用**:应用负载过高、辅助功能查询超时时,会保留最后已知窗口,而不视为“没有窗口”。短暂繁忙的应用不再从平铺、浮动镜像或标记点中消失;单个挂起应用也不会在平铺时冻结主线程数秒。
-
+
### 修复
- **及时停止浮动镜像采集**:修复多种竞争条件导致 ScreenCaptureKit 流和录屏指示器保留过久的问题。采集现在按严格顺序启动和停止。
- **更可靠地观察 Electron 窗口**:首次观察失败时,部分窗口的尺寸变化和关闭事件会丢失。现在会像其他订阅一样重试,不再留下无效平铺位置。
@@ -445,7 +455,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **自动离开变空的工作区**:启用默认关闭的 `settings.switching.switchToRecentWhenEmpty` 后,关闭活动工作区最后一个窗口会切换到最近工作区。共享应用遍布所有工作区,不算作内容。刻意打开空工作区不会被弹回,只有真实关闭窗口才触发切换。
- **应用内错误报告**:`config.toml` 的语法或快捷键错误、`layouts.json` 读写失败、CLI 服务器无法启动、浮动镜像不可用及登录启动登记失败,会显示包含详情的警告反馈,并在菜单栏显示 ⚠️ 和问题区段。问题修复后会清除标记并显示确认反馈。
-
+
### 修复
- **浮动镜像的焦点跟随鼠标行为**:关闭此功能时,悬停镜像不再抢焦点。滚动、点击和拖动会传到真实窗口,点击时转移焦点;开启时仍像以前一样通过悬停移交焦点。
- **修复浮动窗口闪烁**:关闭焦点跟随鼠标时,修复了兄弟浮动窗口短暂落到被点击的平铺窗口后方,以及指针离开焦点浮动窗口后它落到重叠兄弟窗口后方的问题。
@@ -472,14 +482,14 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **固定尺寸窗口也可浮动**:iOS **Simulator** 等固定尺寸窗口现在可浮动显示。只有平铺才要求窗口可调整大小。
- **持续显示浮动窗口标记**:标记点始终显示,不只出现在焦点窗口上,并平滑跟随窗口拖动。
-
+
### 修复
- **可靠的反馈淡出**:面板窗口透明度动画每次启动后只有第一次可靠,导致后续反馈有时直接消失。现在改为对内容视图执行淡出。
## 1.2.1 (2026-06-02)
-
+
### 修复
- **识别关闭后隐藏的窗口**:Discord 等 Electron 应用关闭窗口时只会隐藏,不发送辅助功能销毁事件,过去会留下空白平铺位置。现在窗口离开屏幕后会被移除,其余窗口重新排列。
@@ -507,7 +517,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **内置 CLI 安装器**:在**设置 → 命令行**安装或卸载 `tatami` CLI,并识别 Homebrew 安装。辅助功能权限状态及一键授权位于**设置 → 权限**。
- **应用内快捷键与显示器说明**:界面解释不直观的快捷键,并在工作区显示器区段说明固定与动态的区别。
-
+
### 修复
- **保护全屏间隙中的焦点**:焦点跟随鼠标不再选中从平铺窗口间隙中露出的全屏窗口。
- **立即登记分配快捷键**:记录工作区的**分配**快捷键后立即重新注册,无须重启。
@@ -539,7 +549,7 @@ Tatami 的主要变化。本文件是网站和 GitHub Releases 发行说明的
- **更快的焦点与平铺响应**:缩短焦点跟随鼠标及平铺防抖的时间。
- **重构 BSP 操作**:全面调整插入、交换、移动和均衡的操作语义。
-
+
### 修复
- **修复平铺快捷键**:`grow` / `shrink` / `balance` 现在可在常见布局中正常工作。
- **稳定设置步进按钮**:间距和圆点大小的步进按钮不再因单击而持续变化。
diff --git a/docs/zh-Hant/CHANGELOG.md b/docs/zh-Hant/CHANGELOG.md
index 4fce3f7..d8e2d45 100644
--- a/docs/zh-Hant/CHANGELOG.md
+++ b/docs/zh-Hant/CHANGELOG.md
@@ -7,12 +7,22 @@
Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的權威來源,發布流程會附加安裝及更新說明。Sparkle 的 App 內更新視窗彙整同一次要版本系列的所有修補,因此各節只需記錄自身版本的變更。
+
+## 1.14.2 (2026-09-17)
+
+改善視窗焦點與引導設定。
+
+
+### 修正
+- **使用選單後仍回到最後選取的視窗:** 使用 App 選單並切換同一 App 的視窗後,返回工作空間時仍會聚焦最後選取的視窗。
+- **順利完成引導設定:** 重新啟動後,正確還原並套用已儲存的設定草稿。確認套用設定後,引導視窗會關閉,並清除已完成的草稿。
+
## 1.14.1 (2026-09-11)
改善配置還原、視窗切換與權限變更處理。
-
+
### 修正
- **重新開啟視窗時還原配置:** App 重新啟動或 macOS 還原視窗時,保留分割方向、比例與全螢幕放大狀態。視窗逐一開啟時,不再覆寫尚未開啟視窗的已儲存配置。
- **顯示器變動時保護配置:** 暫時未偵測到顯示器時,保留最近的工作空間配置,並忽略已被後續變動取代的顯示器更新。視窗識別碼變更後,仍依已儲存的分割比例還原。
@@ -36,7 +46,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **依任務尋找設定:** 分類側邊欄將一般、平鋪、工作空間、工作空間按鍵、焦點與滑鼠、手勢、外觀和掛鉤分開。確認偏好也依其控制的操作分組。
- **以五種語言閱讀和觀看工作流程:** App 內文件以所選語言顯示,標題、表格和連結均可正常使用。網站提供完整工作流程及主題示範集,支援原生播放控制項、鍵盤導覽和相關設定連結。
-
+
### 修正
- **將首次點按或拖移傳遞給保持最上層視窗:** 在啟用和鏡像交接期間保留初始滑鼠輸入。背景捲動不必取得鍵盤焦點即可到達實際視窗,游標停留行為遵循焦點跟隨滑鼠設定。
- **視窗暫時無法使用時保留佈局:** 佈局讀取失敗或不完整時,不再用空佈局取代已儲存的位置。工作空間復原會保留有效佈局資訊,直到能夠找到所需視窗。
@@ -61,7 +71,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **App 與視窗切換包含共用 App**:借用期間,共用浮動及維持原狀視窗會排在主區域與借用並排區域之後。此設定預設開啟,也可關閉以排除共用 App,縮小切換列表。
- **排查 App 浮動行為**:新指南說明何時需要登錄帶浮動控制項的 App、瀏覽器子母畫面為何會自動排除於並排之外,以及何時仍需登錄才能讓它跨工作空間保持可見。
-
+
### 修正
- **將瀏覽器子母畫面排除於配置外**:透過 WindowServer 層級識別 Chrome 與 Dia 的 PiP 視窗,不再將它們列為 BSP 並排視窗;中繼資料查詢失敗時仍保留有效的一般視窗。
- **保留手動調整的分割比例**:邏輯並排成員未變更時,焦點協調與視窗表面替換不再把工作空間重設為 50:50。實際插入及移除仍依設定套用自動平均分配。
@@ -87,7 +97,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **隨時查看指令文件**:在設定中開啟內建 CLI 指南,或在 pangmo5.dev/Tatami 閱讀由 `docs/CLI.md` 產生的線上參考。內容包含選擇器、JSON 規約、掛鉤行為、結束狀態及腳本範例。
- **任何寬度都能讀取快速鍵衝突**:記錄控制項在各種尺寸下顯示一致的精簡警告,並透過彈出視窗與 VoiceOver 提供完整的衝突操作。
-
+
### 修正
- **工作空間快速鍵遵循組合邊界**:不同設定組合可重用同一工作空間鍵或明確指定的快速鍵,不再誤報衝突。全域快速鍵仍與全部組合比對。
- **複製不會默默引入快速鍵衝突**:預覽會指出衝突選項,並在儲存前重新驗證目前設定。真正發生衝突時拒絕整個修改,而非套用部分複製結果。
@@ -107,7 +117,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.11.4 (2026-08-11)
-
+
### 修正
- **共用 App 保留各工作空間最近視窗**:返回工作空間時還原在該處最後聚焦的視窗,不再改為經過其他工作空間時聚焦的共用並排 App。
@@ -123,7 +133,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **預設跨顯示器記住最近工作空間**:新安裝將「剛才所在的工作空間」視為整個桌面的統一記錄,而非每台顯示器各自記錄。現有設定維持不變。
- **游標跟隨改變焦點視窗形狀的配置指令**:切換分割方向或進入、離開全螢幕縮放時,游標會隨焦點視窗移動,不再留在視窗已離開的並排位置。
-
+
### 修正
- **動態工作空間重新跟隨滑鼠**:修正動態工作空間顯示過一次後就停在最後一台顯示器的問題。啟用時會移到游標所在顯示器;若本就在該顯示器,則保留正在使用的借用組合。
- **多顯示器解鎖後正確還原**:macOS 會在鎖定畫面背後移除並重新加入顯示器,過去逐次處理所有中間狀態,可能破壞指派、觸發顯示器數量規則切換組合並儲存錯誤結果。現在等待拓樸穩定後再協調,短暫消失又返回的顯示器不改變狀態,真正拔除則只處理一次。
@@ -138,7 +148,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.11.2 (2026-08-04)
-
+
### 修正
- **鎖定螢幕期間保留配置**:鎖屏時暫時的輔助使用或 WindowServer 快照不再從作用中 BSP 配置移除視窗。鎖屏遮罩出現前凍結破壞性的成員變更,等待所有重疊睡眠或工作階段轉換結束,再於解鎖後重新連接完整配置。
- **完整的跨顯示器工作空間回饋**:移動焦點至其他顯示器上已可見的工作空間時,再次顯示回饋而不打亂借用組合。來源顯示器同時顯示目標工作空間與顯示器名稱,讓每次跨螢幕切換結果清楚。
@@ -146,7 +156,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.11.1 (2026-08-02)
-
+
### 修正
- **原生分頁變動時保持配置**:建立、關閉或切換分頁時,暫時的 WindowServer 表面識別不再作為獨立視窗進入 BSP 樹。即使快速變動,也在實際表面替換時保留原並排位置、焦點歷程、縮放及呈現狀態。
@@ -163,7 +173,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **更清楚準確的視窗切換器**:各 App 圖示會顯示焦點、借用、共用 App、置頂及全螢幕狀態。游標停留會更新實際選取,即使同一 App 有多個視窗,Return 或放開修飾鍵也會確認目前反白的視窗。配置更精簡,並遵循減少動態效果設定。
- **平均分配遵循配置設定**:平均分配指令現在套用設定的自動平均分配軸。關閉自動平均分配時,會重建標準 BSP 樹,而非只在既有不平均的拓樸內均分比例。
-
+
### 修正
- **可靠處理延遲、隱藏與重現的視窗**:立即回應 WindowServer 可見性變更,移除隱藏表面但保留身分,並在 App 重現後持續校正稍後還原的舊尺寸。慢啟動 App 的首個視窗也會在觀察就緒後立即還原預期焦點、全螢幕位置與尺寸。
- **穩定借用完成與焦點**:冷啟動 App 的首個視窗在借用開始後出現,也會立即並排並聚焦。借用穩定過程中保留精確的主區域焦點及視窗標記,在完整啟用前清除舊標記,並在焦點轉至其他顯示器或返回已可見主區域時保持組合。
@@ -188,14 +198,14 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.9.2 (2026-07-27)
-
+
### 修正
- **穩定 MFF 與 FFM 的互動**:同時啟用時,游標觸發的焦點通知不會再回饋至滑鼠跟隨焦點並再次移動游標。Tatami 會忽略自身跳轉產生的合成移動、捨棄舊焦點回音,並允許借用修復配置而不搶回使用者已經移動的游標。
## 1.9.1 (2026-07-23)
-
+
### 修正
- **通知啟用後保持借用配置**:點選借用區域內已可見 App 的通知,不再讓 App 還原較短的儲存尺寸並在下方留白。焦點視窗穩定後,會重新套用完整借用區域。
@@ -215,14 +225,14 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **更快的借用與選單列互動**:先配置區域,再依實際尺寸依序轉移鍵盤焦點與 MFF 游標。略過多餘的輔助使用寫入,重用已知隱藏的暫存視窗而不重新開啟,並在 App Nap 下維持選單列執行時的低延遲。
- **自適應操作回饋**:回饋以精簡的彈簧過渡進入與離開,隨內容調整大小,並直接更新已顯示的回饋,不重播整個呈現過程。
-
+
### 修正
- **非並排切換目標也支援滑鼠跟隨焦點**:切換到浮動、共用浮動或忽略模式視窗後,會讀取其實際位置並將游標移到中央,不再留在原處。
## 1.8.1 (2026-07-20)
-
+
### 修正
- **跨組合暫時並排 App**:僅指派至非作用中組合的 App,在目前組合開啟時也會正常並排,不再被視為屬於無法存取的工作空間。
@@ -239,7 +249,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **可選的全域最近工作空間**:最近工作空間操作可使用跨所有顯示器的統一歷程,在工作空間原位置聚焦,而非拉至游標顯示器。預設仍是原有逐顯示器行為。
- **再次借用即可收起**:重複呼叫目前顯示器上已借用的工作空間,預設會結束借用並還原主工作空間。關閉此選項則繼續重新停靠借用區域。
-
+
### 修正
- **準確還原同 App 視窗**:離開工作空間前,將精確焦點視窗與可見配置核對。即使同 App 另一視窗保留較舊的最近使用位置,或漏掉焦點通知,返回時也會還原真正使用過的視窗。
@@ -252,7 +262,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **依游標範圍借用**:借用、最近及前後借用、方向選擇和收起統一作用於滑鼠所在顯示器,方向選擇也記住開始時的顯示器。
- **降低工作空間啟用負擔**:略過多餘的輔助使用尺寸寫入,程序或視窗消失時立即清除快取,並取消已被新請求取代的啟用、焦點與鏡像任務。
-
+
### 修正
- **跨 App 焦點跟隨滑鼠**:在不同 App 的視窗間移動焦點時,既置前視窗也轉移最前方 App,視窗位於不同顯示器時同樣適用。
- **正確處理關閉後的焦點與置中**:關閉焦點視窗後,待視窗列表穩定再選取預期的最近視窗,並將游標置於其實際位置中央。
@@ -262,7 +272,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.7.2 (2026-07-15)
-
+
### 修正
- **跨顯示器切換視窗**:自 1.7.0 預設開啟的 alt/opt+tab 可能困在兩個視窗之間,或操作錯誤顯示器的工作空間。現在透過視窗伺服器轉移最前方 App,而非只執行輔助使用置前,從而正確跨 App 與顯示器切換。
- **合併顯示器重設通知**:作業系統連續傳送相同螢幕參數通知時會合併處理,不再反覆評估未變更的顯示器設定。
@@ -279,7 +289,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **全域共用 App 側邊欄**:共用 App 加入所有組合的所有工作空間,因此從單一組合下移至側邊欄的**所有位置**區段。
- **逐顯示器的組合切換回饋**:切換組合時,各顯示器分別顯示落在其上的工作空間,而非單一回饋列出全部內容。
-
+
### 修正
- **保留中斷顯示器的固定工作空間**:固定顯示器未連接時啟用工作空間,再切換組合離開並返回,不會變成其他工作空間。Tatami 保留最後位置,顯示器重新連接後再送回原螢幕。
@@ -298,7 +308,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **重新組織設定**:工作空間對應鍵移至獨立的**工作空間鍵**面板,觸控板移至**手勢**面板,視窗切換設定與快速鍵集中顯示。衍生快速鍵直接連結至工作空間鍵,並以唯讀一般文字呈現,明確表示它們在其他位置設定。
- **更友善的初始預設值**:全新設定會包含建議快速鍵,並預設開啟*跟隨 App 焦點*,啟用 App 時切換到所屬工作空間。既有設定不變。
-
+
### 修正
- **穩定多工作空間 App 的焦點**:App 屬於多個工作空間時,若已位於其中一個,點選該 App 不會跳至其他工作空間。
- **可靠置前主視窗**:開啟 Tatami 視窗時不再沉至其他 App 視窗後方。
@@ -306,7 +316,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.6.1 (2026-07-10)
-
+
### 修正
- **顯示器重新連接後還原全螢幕縮放**:關閉並重新開啟顯示器不再遺失工作空間縮放。過去顯示器變動造成視窗短暫隱藏時,會永久清除縮放;現在同一視窗返回後繼續保持縮放。真正關閉視窗仍會取消縮放,重新開啟則從新狀態開始。
@@ -327,7 +337,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **同 App 視窗保留獨立位置**:配置依視窗在 App 中的位置追蹤,讓多個視窗各有可排列的位置,並記住哪個處於全螢幕。配置記憶也獲得強化:單一無法讀取的項目不再清空全部工作空間,舊配置會自動移轉。
- **工作空間排序與刪除確認**:可在側邊欄拖移工作空間來排序。刪除工作空間或移除 App 時會要求確認。
-
+
### 修正
- **還原最近使用的視窗**:透過 `⌥Tab` 返回擁有多個視窗的 App 時,會定位到最近聚焦的視窗,而非任意視窗。
- **工作空間啟用時保持正確前景 App**:啟用 App 帶出所屬工作空間時,該工作空間中始終開啟的 App 不再搶到前景。
@@ -343,7 +353,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **在來源顯示器提示焦點移動**:跨顯示器移動焦點時,會在離開的顯示器上提示,讓多螢幕環境中的焦點去向更清楚。
- **更流暢的手勢靈敏度滑桿**:在設定中拖移時,不再每一步都重繪整個表單。
-
+
### 修正
- **更可靠的視窗焦點追蹤**:焦點會跟隨新開或重新選取的視窗,並在視窗關閉後移到剩餘並排視窗。即使系統忙碌,焦點跟隨滑鼠也會定位到實際位於游標下的視窗。輔助使用角色短暫變動的視窗不會被移除。
- **並排慢啟動 App 的首個視窗**:Electron 等大型 App 的輔助使用層較晚就緒時,也能找到並排第一個視窗,不再遺漏。
@@ -370,7 +380,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
## 1.4.2 (2026-06-19)
-
+
### 修正
- **關閉視窗後依最近使用順序聚焦**:關閉焦點視窗後可能跳到第一個並排視窗,而非最近使用的視窗,尤其是在新建第二個視窗後快速切換其他 App 的並排狀態時。現在依各工作空間的最近使用順序尋找下一個仍在螢幕上的視窗。
@@ -396,7 +406,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **可搜尋的 App 選擇器**:支援搜尋執行中的 App,也可直接從檔案新增。
- **重做快速鍵錄製**:記錄器顯示與鍵盤配置無關的符號,例如始終顯示 ⌘S,按一下即可記錄,並依名稱提示衝突。錄製時暫停全域快速鍵,讓按鍵組合進入輸入欄而非執行操作。全域快速鍵底層改用 Magnet(Carbon)。
-
+
### 修正
- **穩定原生分頁切換**:使用 macOS 原生分頁的 App 改變視窗 ID 時,工作空間不會再跳回。ghostty 等 App 切換分頁會交換視窗 ID,曾造成 BSP 樹暫時為空,使「切換到最近工作空間」返回上一個工作空間。現在切換前會重新檢查目前工作空間的螢幕視窗。
- **僅跟隨管理視窗**:焦點跟隨滑鼠只進入 Tatami 管理的視窗,通知與回饋面板不再搶走焦點。
@@ -412,7 +422,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **在游標顯示器上顯示工作空間回饋**:回饋現在出現在游標所在顯示器。過去跟隨鍵視窗,切換後可能顯示在另一台並非正在注視的顯示器上。
- **更完整的診斷**:開啟偵錯記錄後,快速鍵接收、手勢辨識及滑動*未觸發*的原因、置頂鏡像生命週期、顯示與隱藏摘要、BSP 操作和拖移提交都會記錄到 `tatami.log`。
-
+
### 修正
- **不再要求輸入監控權限**:事件監聽現在只依賴輔助使用權限,不再顯示「接收來自任何 App 的按鍵」對話框。先前拒絕輸入監控也不會影響焦點跟隨滑鼠與滑動手勢。若舊版 Tatami 仍列在隱私權與安全性 → 輸入監控中,可用「−」移除該項目。
- **穩定切換空工作空間**:切換到 App 尚未執行的工作空間時,不再跳回。過去隱藏原視窗會讓 macOS 還原先前的 App,焦點跟隨 App 又會追隨它回到原工作空間。現在空工作空間會停留在空白桌面。
@@ -428,7 +438,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **更快的工作空間切換**:啟用時從快取讀取視窗識別,不再於關鍵路徑逐一查詢輔助使用視窗。切換期間的新請求會取代進行中的請求,因此快速前後切換可略過反應緩慢的工作空間,不會停在原處。
- **保留忙碌的 App**:App 負載過高、輔助使用查詢逾時時,會保留最後已知的視窗,而非視為「沒有視窗」。短暫忙碌的 App 不再從並排、浮動鏡像或標記點中消失;單一停止回應的 App 也不會在並排時凍結主執行緒數秒。
-
+
### 修正
- **及時停止浮動鏡像擷取**:修正多種競爭條件造成 ScreenCaptureKit 串流與螢幕錄製指示器保留過久的問題。擷取現在依嚴格順序啟動及停止。
- **更可靠地觀察 Electron 視窗**:首次觀察失敗時,部分視窗的尺寸變更與關閉事件會遺失。現在會像其他訂閱一樣重試,不再留下無效並排位置。
@@ -445,7 +455,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **自動離開變空的工作空間**:啟用預設關閉的 `settings.switching.switchToRecentWhenEmpty` 後,關閉作用中工作空間最後一個視窗會切換到最近工作空間。共用 App 遍布所有工作空間,不算作內容。刻意開啟空工作空間不會被跳回,只有實際關閉視窗才觸發切換。
- **App 內錯誤回報**:`config.toml` 的語法或快速鍵錯誤、`layouts.json` 讀寫失敗、CLI 伺服器無法啟動、浮動鏡像無法使用及登入啟動登錄失敗,會顯示包含詳細資訊的警告回饋,並在選單列顯示 ⚠️ 和問題區段。問題修正後會清除標記並顯示確認回饋。
-
+
### 修正
- **浮動鏡像的焦點跟隨滑鼠行為**:關閉此功能時,游標停留不再搶焦點。捲動、點選和拖移會傳至實際視窗,點選時轉移焦點;開啟時仍如以往透過游標停留移交焦點。
- **修正浮動視窗閃爍**:關閉焦點跟隨滑鼠時,修正兄弟浮動視窗短暫落到被點選的並排視窗後方,以及游標離開焦點浮動視窗後,它落到重疊兄弟視窗後方的問題。
@@ -472,14 +482,14 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **固定尺寸視窗也可浮動**:iOS **Simulator** 等固定尺寸視窗現在可浮動顯示。只有並排才要求視窗可調整大小。
- **持續顯示浮動視窗標記**:標記點始終顯示,不只出現在焦點視窗上,並平滑跟隨視窗拖移。
-
+
### 修正
- **可靠的回饋淡出**:面板視窗透明度動畫每次啟動後只有第一次可靠,導致後續回饋有時直接消失。現在改為對內容視圖執行淡出。
## 1.2.1 (2026-06-02)
-
+
### 修正
- **辨識關閉後隱藏的視窗**:Discord 等 Electron App 關閉視窗時只會隱藏,不傳送輔助使用的銷毀事件,過去會留下空白並排位置。現在視窗離開螢幕後會被移除,其餘視窗重新排列。
@@ -507,7 +517,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **內建 CLI 安裝工具**:在**設定 → 命令列**安裝或移除 `tatami` CLI,並辨識 Homebrew 安裝。輔助使用權限狀態及一鍵授權位於**設定 → 權限**。
- **App 內快速鍵與顯示器說明**:介面解釋不直觀的快速鍵,並在工作空間顯示器區段說明固定與動態的差異。
-
+
### 修正
- **保護全螢幕間隙中的焦點**:焦點跟隨滑鼠不再選取從並排視窗間隙露出的全螢幕視窗。
- **立即登錄指派快速鍵**:記錄工作空間的**指派**快速鍵後立即重新註冊,無須重新啟動。
@@ -539,7 +549,7 @@ Tatami 的主要變更。本文件是網站與 GitHub Releases 版本說明的
- **更快的焦點與並排反應**:縮短焦點跟隨滑鼠及並排防抖的時間。
- **重構 BSP 操作**:全面調整插入、交換、移動與平均分配的操作語意。
-
+
### 修正
- **修正並排快速鍵**:`grow` / `shrink` / `balance` 現在可在常見配置中正常運作。
- **穩定設定增減按鈕**:間距與圓點大小的增減按鈕不再因按一下而持續變動。