澄境筆記 0.5.6

這次最重要的更新

0.5.6 專門處理「滑鼠點選單列瞬發，但全域按鍵仍慢半拍」的最後一段延遲：全域熱鍵不再交給 Electron／Chromium 轉譯，而由極小的 macOS 原生 Helper 在實體按鍵按下時直接觸發。

原生 Carbon Hotkey Helper

• 新增 34KB、arm64、無額外 Runtime 的 ChengJingHotkey Mach-O Helper。
• Helper 使用 Carbon RegisterEventHotKey，預設 ⌘\ 直接對應實體 key code 42 與 Command modifier。
• 觸發後只向澄境主程序 stdout 管線寫入 trigger，不載入 UI、資料庫或其他功能。
• Helper 不讀取輸入文字、不監聽未註冊按鍵，不要求輸入監控或輔助使用權限。

安全回退與自訂快捷鍵

• 字母、數字、常用符號、方向鍵與功能鍵均有 macOS 實體 key code 對照。
• 使用者重新錄製快捷鍵時，澄境會停止舊 Helper、註冊新組合，再更新選單列顯示。
• 若按鍵無法原生對照、Helper 缺失或 OS 拒絕註冊，會自動退回 Electron globalShortcut；原本功能不會消失。

建置與封裝驗收

• 每次建置都會編譯 Helper，並以低衝突組合自測 ready → Carbon hotkey event → trigger；失敗就中止 DMG。
• 正式 App 內 Helper 為 arm64 Mach-O、具有 ad-hoc 簽章，整個 App 深度簽章驗證通過。
• 封裝啟動後必須回報 shortcutBackend=native-carbon；自訂快捷鍵與恢復預設也必須保持原生後端。
• 預熱 Panel、全螢幕 Space、背景 accessory agent、Command+W 與設定頁回歸測試全部通過。

安裝提醒

目前仍是 ad-hoc 簽章、尚未使用 Apple Developer ID 公證。若 macOS 阻擋，請先嘗試開啟一次，再到「系統設定 → 隱私權與安全性」按「強制打開（Open Anyway）」，並在再次出現警告時確認「打開」。