完成時氣泡改顯示最後一句回覆，不再延到下一輪才出現

根本原因：
Stop 事件時 main.js 已從 transcript 附上最後一句助理訊息（narration），
但 renderer 的 Stop 分支寫死顯示「完成！」沒使用它，也沒把 narrationId
標記為已顯示；下一輪第一個工具事件呼叫 sayActivity 時，transcript 裡
最新的助理訊息仍是上一輪結尾、id 又沒被消費過，就被當成新話顯示出來。

影響：
對話收尾只看得到「完成！」，看不到 AI 的最後一句回覆；等使用者送出
下一句指令後，寵物反而冒出上一輪的舊訊息，時序錯亂。

修法：
Stop 時若帶有 narration，氣泡直接顯示「✅ 最後一句」並消費 narrationId，
沒有才退回「完成！」；UserPromptSubmit 也先把當下 narrationId 標記為已
顯示，雙重保險。另修 release.js 只挑檔名含當前版本的產物，避免 dist/
殘留的舊版檔案混進新 release。版號 2.0.9。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -241,8 +241,9 @@ Claude Code ──hook（stdin JSON）──▶ hook/claude-pet-hook.js ──PO
 
 設計重點：
 
-- **點穿**：視窗預設 `setIgnoreMouseEvents(true, { forward: true })`，renderer 在 mousemove 時讀 canvas 該點 alpha（或是否在氣泡上）來即時切換，所以透明處永遠點得到底下的視窗。
+- **點穿**：視窗預設 `setIgnoreMouseEvents(true, { forward: true })`，renderer 讀 canvas 該點的 alpha（或是否壓在氣泡上）來即時切換，所以透明處永遠點得到底下的視窗。判定的座標有兩個來源：renderer 自己的 mousemove，以及**主程序每 50 ms 的游標輪詢**。後者是必要的——視窗處於點穿狀態時 Electron 的 `forward` 不保證會把 mousemove 轉發進來（游標直接跳到寵物上常常收不到），只靠 mousemove 會在「游標還停在寵物身上時進入點穿」之後再也收不到事件，變成永遠卡在點穿、按不下去也拖不動。另外每一格畫完也會用最後已知座標重驗一次，因為換格會改變游標底下的像素。
 - **拖曳**：由主程序用 `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-的對照)。
 - **顯示尺寸與 sprite 來源尺寸分開**：`CELL_W/CELL_H`（192 × 208）只用來從 spritesheet 取格子，畫到畫面上的是 `PET_W/PET_H`（126 × 137，Codex 的 mascot 尺寸）。視窗寬度另有 `MIN_WIN_W = 240` 的下限，免得寵物變小後氣泡被截掉。
 - **Spritesheet 以 data URL 傳給 renderer**，避免 `file://` 跨來源污染 canvas 導致 `getImageData` 失敗。

main.js

@@ -37,6 +37,7 @@ const PAD_BOTTOM = 8;
 const MIN_WIN_W = 240; // 視窗最小寬度，保留氣泡的可讀寬度（Codex 的氣泡也遠寬於寵物本身）
 // Codex 的 mascot 寬度可調範圍是 80–224 px（ike() 的 clamp）；以 126 為 100%，這幾檔都落在範圍內
 const SCALES = [0.65, 0.8, 1, 1.25, 1.5, 1.75];
+const TOPMOST_REASSERT_MS = 2000;   // 多久重新宣告一次置頂（見 reassertTopmost）
 
 const DEFAULT_CONFIG = {
   activePetId: "xiao-nian",
@@ -55,6 +56,7 @@ let tray = null;
 let pets = [];
 let dragTimer = null;
 let cursorTimer = null;
+let topmostTimer = null;
 let lastCursor = { x: NaN, y: NaN };
 let currentState = { anim: "idle", base: "idle", sessions: 0 };
 
@@ -279,7 +281,10 @@ function createWindow() {
   if (config.alwaysOnTop) win.setAlwaysOnTop(true, "screen-saver");
   win.setIgnoreMouseEvents(true, { forward: true });
   win.loadFile(path.join(APP_DIR, "renderer", "index.html"));
-  win.once("ready-to-show", () => win.showInactive());
+  win.once("ready-to-show", () => {
+    win.showInactive();
+    reassertTopmost();
+  });
   win.on("closed", () => { win = null; });
 }
 
@@ -326,13 +331,42 @@ function endDrag(save) {
 
 // ---------- cursor look ----------
 
+// Windows 有時候會把視窗踢出 topmost band，卻留著 WS_EX_TOPMOST 樣式位元：
+// 從外部檢查會看到 TOPMOST=true，但 z-order 排在一般視窗（例如 VS Code）之下，
+// 於是寵物就被蓋住，而 Electron 這邊仍以為自己是置頂的，不會自己修好。
+// setAlwaysOnTop 在狀態沒變時可能不會真的呼叫 SetWindowPos，所以再補一個 moveTop()
+// 強制重新插回 topmost band 的最上面（視窗是 WS_EX_NOACTIVATE + focusable:false，不會搶焦點）。
+function reassertTopmost() {
+  if (!win || win.isDestroyed() || !config.alwaysOnTop || dragTimer) return;
+  try {
+    win.setAlwaysOnTop(true, "screen-saver");
+    win.moveTop();
+  } catch { /* 視窗正在關閉就算了 */ }
+}
+
+function startTopmostGuard() {
+  topmostTimer = setInterval(reassertTopmost, TOPMOST_REASSERT_MS);
+  // 螢幕配置變動最容易觸發降級，變動後立刻補一次
+  screen.on("display-metrics-changed", reassertTopmost);
+  screen.on("display-added", reassertTopmost);
+  screen.on("display-removed", reassertTopmost);
+}
+
 function startCursorPolling() {
   cursorTimer = setInterval(() => {
-    if (!win || !config.followCursor || dragTimer) return;
+    if (!win || dragTimer) return;
     const p = screen.getCursorScreenPoint();
     if (p.x === lastCursor.x && p.y === lastCursor.y) return;
     lastCursor = p;
     const b = win.getBounds();
+    // 點穿判定不能只靠 renderer 的 mousemove。視窗處於點穿狀態時，Electron 的
+    // setIgnoreMouseEvents(true, { forward: true }) 並不保證一定會把 mousemove 轉發進來
+    // （游標直接跳到寵物上常常收不到，慢慢移過去才會）。一旦在游標還停在寵物身上時
+    // 進入點穿，就再也收不到事件、ignoringMouse 永遠是 true，滑鼠按下也傳不進視窗
+    // → 就是「有時候卡住無法拖曳」。主程序自己輪詢絕對不會漏，所以改由這裡把
+    // 視窗相對座標送過去，讓 renderer 重新做一次判定。
+    send("pet:cursor-pos", { x: p.x - b.x, y: p.y - b.y });
+    if (!config.followCursor) return;
     const cx = b.x + b.width / 2;
     const cy = b.y + BUBBLE_H + (PET_H * config.scale) / 2; // 人物方框的中心，與 Codex 相同
     send("pet:cursor", { dx: p.x - cx, dy: p.y - cy });
@@ -480,6 +514,7 @@ function buildMenu() {
         config.alwaysOnTop = item.checked;
         saveConfig();
         win?.setAlwaysOnTop(item.checked, "screen-saver");
+        if (item.checked) reassertTopmost();
       },
     },
     {
@@ -597,6 +632,7 @@ if (!app.requestSingleInstanceLock()) {
     createTray();
     startServer();
     startCursorPolling();
+    startTopmostGuard();
     appendLog(`started pet=${activePet()?.id || "none"} scale=${config.scale} port=${config.port}`);
   });
 
@@ -606,6 +642,7 @@ if (!app.requestSingleInstanceLock()) {
 
   app.on("before-quit", () => {
     if (cursorTimer) clearInterval(cursorTimer);
+    if (topmostTimer) clearInterval(topmostTimer);
     endDrag(false);
   });
 }

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "claude-pet",
-  "version": "2.0.5",
+  "version": "2.0.9",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "claude-pet",
-      "version": "2.0.5",
+      "version": "2.0.9",
       "devDependencies": {
         "electron": "^43.4.1",
         "electron-builder": "^26.0.12"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pet",
-  "version": "2.0.5",
+  "version": "2.0.9",
   "description": "Codex Pets 相容的 Claude Code 桌面寵物（spriteVersionNumber 2：9 個動作列 + 16 方向追視）",
   "main": "main.js",
   "private": true,

preload.js

@@ -20,6 +20,7 @@ const ON = new Set([
   "pet:settings",
   "pet:event",
   "pet:cursor",
+  "pet:cursor-pos",
   "pet:drag-move",
 ]);
 

renderer/renderer.js

@@ -150,6 +150,7 @@ let bubbleTimer = null;
 let bubbleSticky = false;
 let ignoringMouse = true;
 let hovered = false;          // 游標是否壓在人物的不透明像素上
+let lastPoint = null;         // 最後已知的游標位置（視窗相對），主程序輪詢或 mousemove 都會更新
 let pressed = null;
 let lastReported = "";
 
@@ -408,6 +409,9 @@ function handleEvent(p) {
       break;
     case "UserPromptSubmit":
       setState(s, "running");
+      // 這時 transcript 裡最新的助理訊息還是上一輪的結尾，
+      // 先標記成已顯示，免得接下來的工具事件把它當成新話講出來
+      if (p.narrationId) lastNarrationId = p.narrationId;
       hideBubble();
       break;
     case "PreToolUse":
@@ -428,11 +432,11 @@ function handleEvent(p) {
     case "PostToolUseFailure":
       // Codex：單一工具失敗不會改變 turn 的狀態（turn 還在跑），寵物維持 running，只給個氣泡
       setState(s, "running");
-      say(`😵 ${p.toolName || "工具"} 失敗了`, 4000);
+      say(`😵 ${p.toolName || "工具"} 失敗了`, 4000, false, title);
       break;
     case "PermissionRequest":
       setState(s, "waiting");
-      say(`🔐 需要你授權${p.toolName ? `：${p.toolName}` : ""}`, 0, true);
+      say(`🔐 需要你授權${p.toolName ? `：${p.toolName}` : ""}`, 0, true, title);
       break;
     case "Notification": {
       const t = p.notificationType;
@@ -446,7 +450,7 @@ function handleEvent(p) {
         setState(s, "waiting");
         say("❓ 有問題想問你", 0, true, title);
       } else if (p.message) {
-        say(`💬 ${p.message}`, 4000);
+        say(`💬 ${p.message}`, 4000, false, title);
       }
       break;
     }
@@ -455,12 +459,18 @@ function handleEvent(p) {
       // Codex：turn 完成且未讀 → review（播 review 3 次後沉澱），直到使用者回到該 thread 才回 idle。
       // 這裡對應成：維持 review 直到該 session 有下一個動作（UserPromptSubmit）、結束或 7 天到期。
       setState(s, "review");
-      say("✅ 完成！", 8000, false, title);
+      // 收尾時把最後一句回覆講出來，而不是只說「完成」
+      if (p.narration) {
+        lastNarrationId = p.narrationId || lastNarrationId;
+        say(`✅ ${firstSentence(p.narration)}`, 8000, false, title);
+      } else {
+        say("✅ 完成！", 8000, false, title);
+      }
       break;
     case "StopFailure":
       // Codex：turn 失敗 → failed 狀態（播 failed 3 次後沉澱），維持到下一個 turn 或 1 小時到期
       setState(s, "failed");
-      say(`❌ ${p.error || "出錯了"}`, 8000);
+      say(`❌ ${p.error || "出錯了"}`, 8000, false, title);
       break;
     case "SubagentStart":
     case "SubagentStop":
@@ -468,13 +478,13 @@ function handleEvent(p) {
       break;
     case "PreCompact":
       setState(s, "running");
-      say("🗜️ 整理記憶中…", 3000);
+      say("🗜️ 整理記憶中…", 3000, false, title);
       break;
     case "SessionEnd":
       sessions.delete(p.sessionId || "default");
       if (sessions.size === 0) {
         hideBubble();
-        say("👋 掰掰", 2000);
+        say("👋 掰掰", 2000, false, title);
       }
       break;
     default:
@@ -494,7 +504,7 @@ function handleTest(p) {
   } else if (anim in PRIORITY) {
     const s = session("test");
     setState(s, anim);
-    if (anim === "waiting") say("🔐（測試）需要你授權", 0, true);
+    if (anim === "waiting") say("🔐（測試）需要你授權", 0, true, "動作測試");
     else if (anim === "idle") hideBubble();
   }
   report();
@@ -545,6 +555,9 @@ function tick(now) {
   prevBase = base;
 
   draw(anim);
+  // 換格會改變游標底下的像素。游標沒移動時主程序不會再送座標，
+  // 所以這裡自己重驗一次，否則會卡在點穿狀態動不了。
+  if (lastPoint && overPetArea(lastPoint.x, lastPoint.y)) refreshHitTest();
   requestAnimationFrame(tick);
 }
 
@@ -656,6 +669,15 @@ function setHovered(on) {
   if (overlay?.fromHover) overlay = null;
 }
 
+// 命中判定集中在這裡：mousemove 與主程序輪詢都走同一條路。
+// 主程序每 50 ms 一定會送座標過來，所以就算 mousemove 沒被轉發進來也能復原。
+function refreshHitTest() {
+  if (!lastPoint || pressed || drag) return;   // 拖曳中不要動點穿狀態
+  const { x, y } = lastPoint;
+  setHovered(overPetArea(x, y));
+  setIgnore(!(overSprite(x, y) || overBubble(x, y)));
+}
+
 function setIgnore(ignore) {
   if (ignore === ignoringMouse) return;
   ignoringMouse = ignore;
@@ -673,13 +695,13 @@ window.addEventListener("mousemove", (e) => {
     }
     return;
   }
-  setHovered(overPetArea(e.clientX, e.clientY));
-  // 點穿判定仍看實際像素，透明處要能點到底下的視窗
-  setIgnore(!(overSprite(e.clientX, e.clientY) || overBubble(e.clientX, e.clientY)));
+  lastPoint = { x: e.clientX, y: e.clientY };
+  refreshHitTest();
 });
 
 document.addEventListener("mouseout", (e) => {
   if (e.relatedTarget || pressed) return;
+  lastPoint = null;
   setHovered(false);
   setIgnore(true);
 });
@@ -707,6 +729,12 @@ window.addEventListener("mouseup", (e) => {
 
 window.addEventListener("contextmenu", (e) => e.preventDefault());
 
+// 主程序的游標輪詢：不管 mousemove 有沒有被轉發進來都會到
+window.pet.on("pet:cursor-pos", ({ x, y }) => {
+  lastPoint = { x, y };
+  refreshHitTest();
+});
+
 window.pet.on("pet:drag-move", ({ dx }) => {
   // Codex：單一取樣的水平位移 >= 4 才切 running-right，<= -4 才切 running-left
   if (drag && Math.abs(dx) >= 4) drag.dir = dx < 0 ? "left" : "right";

scripts/release.js

@@ -144,8 +144,9 @@ async function main() {
   console.log(`Tag     : ${TAG}`);
 
   if (!fs.existsSync(DIST_DIR)) throw new Error(`找不到 ${DIST_DIR}，先執行 npm run dist`);
+  // dist/ 可能留著前幾版的產物，只挑檔名含當前版本的，免得舊檔混進新 release
   const files = fs.readdirSync(DIST_DIR)
-    .filter((f) => ASSET_PATTERNS.some((re) => re.test(f)))
+    .filter((f) => ASSET_PATTERNS.some((re) => re.test(f)) && f.includes(pkg.version))
     .map((f) => path.join(DIST_DIR, f))
     .filter((f) => fs.statSync(f).isFile());
   if (!files.length) throw new Error(`${DIST_DIR} 裡沒有 .exe / .zip，先執行 npm run dist`);