點穿改由主程序決定並加入滑鼠診斷：修不能拖曳、不能右鍵

根本原因：點穿狀態一直是 renderer 判定後再用 IPC 叫主程序切換。renderer 只要例外、卡住或狀態錯亂（例如視窗永遠不取得焦點、Windows 對背景視窗的 capture 有限制，放開的那一下落在視窗外就收不到 mouseup，pressed 從此卡在 true），主程序就再也收不到切換指令，寵物永遠點不到。另外 2.0.8 起每 2 秒的置頂重宣告會在右鍵選單開著時把寵物視窗抬到選單上面，2.0.10 改成整個方框接滑鼠後，被蓋住的選單項目就點不到了。影響：偶發「不能拖曳、不能右鍵」，而且發生時沒有任何可查的狀態或紀錄。修法： 1. 主程序每 50 ms 自己輪詢游標，對照 renderer 回報的人物方框與氣泡矩形（pet:hit-rects）直接呼叫 setIgnoreMouseEvents；決策邏輯抽成 lib/hit-test.js。 renderer 沒回報或掛掉時用版面公式算方框當備援，並自動重載。 2. 拖曳不管因 mouseup、逾時（20 秒）或其他原因結束，都送 pet:drag-ended 讓 renderer 清掉按住／拖曳狀態。 3. 右鍵選單開著時暫停置頂重宣告。 4. /state 回傳 bounds 與 mouse 診斷（是否點穿、游標相對座標、是否在方框／氣泡、矩形來源、切換與輪詢次數、renderer 錯誤、拖曳結束原因）；renderer 例外、拖曳開始／結束、選單開關寫入事件紀錄。版號 2.0.11。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-25 14:15:29 +08:00
parent a9497cc123
commit bf059b19cf
7 changed files with 191 additions and 55 deletions
@@ -221,14 +221,14 @@ Claude Code ──hook（stdin JSON）──▶ hook/claude-pet-hook.js ──PO
                                                                                   │  視窗 / 系統匣 / 游標輪詢 / 拖曳 / 設定
                                                                                   ▼  IPC
                                                                          renderer/renderer.js
-                                                                          狀態機 + 幀動畫 + 追視 + 氣泡 + 方框點穿判定
+                                                                          狀態機 + 幀動畫 + 追視 + 氣泡 + 矩形回報
 ```

 | 檔案 | 職責 |
 |---|---|
 | `main.js` | Electron 主程序：透明置頂視窗、系統匣選單、HTTP 伺服器、游標輪詢（50 ms）、拖曳（60 fps）、設定讀寫、寵物掃描 |
 | `preload.js` | 以 contextBridge 暴露白名單 IPC 頻道給 renderer（sandbox 模式） |
-| `renderer/renderer.js` | Codex V2 幀時序播放器、session 狀態彙整、一次性動作、看向方向計算（含遲滯防抖）、氣泡、滑鼠方框判定 |
+| `renderer/renderer.js` | Codex V2 幀時序播放器、session 狀態彙整、一次性動作、看向方向計算（含遲滯防抖）、氣泡、hover 判定與人物／氣泡矩形回報 |
 | `renderer/index.html`、`style.css` | 版面與氣泡樣式（CSP 僅允許 self / data:） |
 | `hook/claude-pet-hook.js` | Claude Code hook 端：讀 stdin → 擷取欄位 → POST；800 ms 逾時、永遠 exit 0 |
 | `lib/hooks-installer.js` | 安全地合併 / 移除 `~/.claude/settings.json` 的 hooks（保留其他設定與其他 hooks，先備份） |
@@ -241,7 +241,10 @@ Claude Code ──hook（stdin JSON）──▶ hook/claude-pet-hook.js ──PO

 設計重點：

- **點穿**：視窗預設 `setIgnoreMouseEvents(true, { forward: true })`，renderer 依游標是否在**人物方框**或氣泡上即時切換，方框以外永遠點得到底下的視窗。判定用方框而不是讀 canvas 該點的 alpha：人物的手腳與邊緣會隨動畫在透明／不透明之間切換（以小念為例，hover 時只有 44% 的人物像素每一幀都不透明），逐像素判定會讓點穿狀態跟著動畫高速抖動，按下去那一瞬間剛好是透明格，滑鼠事件就穿到底下的視窗去了。判定的座標有兩個來源：renderer 自己的 mousemove，以及**主程序每 50 ms 的游標輪詢**。後者是必要的——視窗處於點穿狀態時 Electron 的 `forward` 不保證會把 mousemove 轉發進來（游標直接跳到寵物上常常收不到），只靠 mousemove 會在「游標還停在寵物身上時進入點穿」之後再也收不到事件，變成永遠卡在點穿、按不下去也拖不動。
+- **點穿由主程序決定**：視窗預設 `setIgnoreMouseEvents(true, { forward: true })`；主程序每 50 ms 自己輪詢游標（`screen.getCursorScreenPoint()`），對照 renderer 回報的**人物方框**與（顯示中的）氣泡矩形，游標在上面就接滑鼠、否則穿透（`lib/hit-test.js`，純邏輯可單元測試）。決策不經過 renderer：以前是 renderer 判定再用 IPC 叫主程序切，renderer 一旦例外、卡住或狀態錯亂（例如放開事件沒送到、`pressed` 一直是 true），點穿就永遠不會再更新，寵物就點不到了。renderer 沒回報矩形或掛掉時，主程序用版面公式算方框當備援；renderer 掛掉會記錄並自動重載。判定用方框而不是讀 canvas 該點的 alpha：人物的手腳與邊緣會隨動畫在透明／不透明之間切換（以小念為例，hover 時只有 44% 的人物像素每一幀都不透明），逐像素判定會讓點穿狀態跟著動畫高速抖動，按下去那一瞬間剛好是透明格，滑鼠事件就穿到底下的視窗去了。主程序輪詢也是必要的——視窗處於點穿狀態時 Electron 的 `forward` 不保證會把 mousemove 轉發進來（游標直接跳到寵物上常常收不到）。
+- **拖曳結束一定通知 renderer**：視窗永遠不取得焦點，Windows 對背景視窗的滑鼠 capture 有限制，放開的那一下若落在視窗外 renderer 收不到 mouseup。主程序不管因為 mouseup、逾時（20 秒）或其他原因結束拖曳，都送 `pet:drag-ended` 讓 renderer 清掉按住／拖曳狀態。
+- **右鍵選單開著時暫停置頂重宣告**：否則 `moveTop()` 會把寵物視窗抬到選單上面，人物方框整塊接滑鼠，被蓋住的選單項目就點不到。
+- **診斷**：`GET /state` 除了動畫狀態，還會回 `bounds` 與 `mouse`（目前是否點穿、游標的視窗相對座標、是否在方框／氣泡內、矩形來源是 renderer 還是備援、切換次數、輪詢次數、renderer 錯誤數、最近幾次拖曳結束的原因）；renderer 的例外、拖曳開始／結束、選單開關都會寫進事件紀錄。
 - **拖曳**：由主程序用 `screen.getCursorScreenPoint()` 每 16 ms 更新視窗位置，游標離開視窗也不會掉；方向由水平位移決定。
 - **置頂要定期重新宣告**：Windows 有時候會把視窗踢出 topmost band，卻留著 `WS_EX_TOPMOST` 樣式位元——從外部檢查看到 `TOPMOST=true`，但 z-order 排在一般視窗（例如 VS Code）之下，寵物就被蓋住，而 Electron 這邊仍以為自己是置頂的，不會自己修好。所以每 2 秒重新宣告一次，並在螢幕配置變動時立刻補一次。`setAlwaysOnTop` 在狀態沒變時可能不會真的呼叫 `SetWindowPos`，因此再補一個 `moveTop()` 強制插回 topmost band 最上面；視窗是 `WS_EX_NOACTIVATE` + `focusable: false`，不會搶焦點。
 - **行為邏輯以 Codex 為準**，細節見[與 Codex 的對照](#與-codex-的對照)。