  JianMiauandClaude Fable 5
|
d78f99fcc7
|
游標離開人物時立刻中斷跳躍，不再播完三次
摘要：
hover 跳躍改為「游標一離開就停」，而不是不管游標在哪都把 3 次播完。
根本原因：
把 hover 跳躍實作成一次性 overlay，播放長度固定為 STATE_REPEATS 輪，
setHovered(false) 只更新 hovered 旗標、不動 overlay，所以游標即使馬上移開，
跳躍仍會自顧自播完約 2.5 秒才回到基礎狀態。
這其實也偏離 Codex：Codex 的顯示狀態是 `hovered ? "jumping" : state`，
游標一離開就翻回原狀態並重跑動畫，本來就不會把跳躍播完。
影響：
只是游標經過或很快移開時，寵物還會繼續跳完，反應顯得遲滯、不跟手。
修法：
- play() 之後把該 overlay 標記 fromHover。
- setHovered(false) 時若目前 overlay 是 hover 觸發的就直接清掉，
下一個 tick 會依 resolveAnim 回到當下的基礎狀態。
只清 fromHover 的，初次問候揮手等其他一次性動作不受影響。
- README 的日常使用、行為對照表、與 Codex 的對照三處同步更新，
對照表新增「hover 離開」一列。
保持不變：
進入時最多跳 3 次、游標持續停留不重複觸發（使用者已確認要這個行為）。
驗證：
以 DOM stub 載入完整 renderer.js 執行 13 項測試全過，涵蓋：
進入觸發 jumping 且序列為 15 幀、標記 fromHover、離開後 overlay 立刻為 null、
resolveAnim 立刻回 idle、工作中離開回到 running 而非 idle、
問候揮手不會被離開中斷、既有 overlay 期間不觸發跳躍、
持續停留不重複觸發、拖曳中不觸發。
另以 ELECTRON_RUN_AS_NODE 讀打包後 app.asar 確認版本 2.0.3 與六項改動都在出貨檔案裡，
exe FileVersion 為 2.0.3。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 16:58:57 +08:00 |
|
|
JianMiauandClaude Fable 5
|
7e2f689f26
|
修正開啟追視後 renderer 崩潰，追視改為只在待機時生效
摘要：
startAnim 對 look 會丟 TypeError 導致動畫迴圈整個死掉；另把追視改成只在 idle 時覆蓋。
根本原因：
1. 追視是單一靜態擺姿，TIMINGS 裡沒有 look 這個動作。但序列模型改寫後，
tick 在動畫改變時無條件呼叫 startAnim(anim)，傳入 "look" 時會走到
cycleOf("look") → TIMINGS["look"].map → TypeError。
例外從 requestAnimationFrame 的 callback 拋出，迴圈就此中止，
整隻寵物凍結，也不再回應任何 hook 事件——就是使用者回報的「直接沒反應」。
2. 對照 Codex 時把 lookFrame 改成覆蓋所有狀態。但 Codex 的追視來源是 quick chat 的
文字游標，只有使用者真的在打字時才存在；滑鼠卻是一直都在，照搬會讓工作中的
running / waiting / review 動畫永遠被靜態擺姿蓋掉，寵物失去反映狀態的作用。
影響：
選單一勾「跟著游標看」，游標一動寵物就完全凍結，且不會恢復。
修法：
- startAnim 開頭對 look 早退，直接設成空的幀序列（靜態擺姿），
不進入 cycleOf / baseSequence。draw 本來就單獨處理 look，tick 的推幀也已排除 look。
- resolveAnim 先取 baseState()，只有 base 為 idle 時才回傳 look；
一併避免原本重複呼叫 baseState() 的副作用。
- README 的特色、行為對照表、與 Codex 的對照三處同步更新，
對照表把「追視」拆成來源與優先序兩列並說明為何刻意不同。
不動的部分：
hover 跳躍維持進入時播 3 次、之後停住不再跳（使用者確認就是要這個行為）。
另已確認跳躍結束後會回到當下的基礎狀態而非一律 idle。
驗證：
- 單元測試（抽出實際程式碼執行）：修正前 startAnim("look") 拋
TypeError: Cannot read properties of undefined (reading 'map')，修正後回傳空序列；
idle 6 幀、running 24 幀正常；resolveAnim 在追視開啟下
idle→look、running→running、waiting→waiting、review→review，
hover 跳躍優先於 look 與 running，跳躍結束回到 running 而非 idle，共 11 項全過。
- 實機開啟 followCursor 啟動：/state 持續回應且 anim 為 look（修正前此處即崩潰），
log 無任何例外；灌入事件後 running / waiting 正確蓋過追視。
- 以 ELECTRON_RUN_AS_NODE 讀打包後 app.asar：版本 2.0.2、崩潰修正與追視優先序都在，
hover 跳躍、矩形判定、右鍵選單未受影響；exe FileVersion 為 2.0.2。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 16:48:43 +08:00 |
|
|
JianMiauandClaude Fable 5
|
3f92e102cc
|
打包時自動遞增版號，避免同版號重包
摘要：
dist 與 dist:portable 掛上 pre 腳本自動執行 npm version patch，版本 2.0.0 → 2.0.1。
根本原因：
產物檔名帶版號（Claude Pet-<版本>-setup.exe），但版號要靠人記得改。
實際上 2.0.0 被重包了兩次而版號沒動：一次沒有 hover 跳躍、一次有，
使用者回報「滑鼠停上面沒有 jump」時，無法從檔名判斷手上是哪一份，
必須另外比對檔案時間才能確認。
影響：
同一個版號可能對應內容不同的散布檔，回報問題與確認修正都會失準。
修法：
- package.json 新增 predist 與 predist:portable，內容為
`npm version patch --no-git-tag-version`；npm 會在對應的 dist 腳本前自動執行。
- pack 不掛（它只產 win-unpacked 供開發驗證，不是散布檔）。
- README 的「打包成 exe」補上說明：版號自動遞增、不要繞過、
要升 minor/major 就先手動 npm version。
驗證：
執行 npm run dist，package.json 由 2.0.0 自動變成 2.0.1，
產物檔名同步為 Claude Pet-2.0.1-*；以 ELECTRON_RUN_AS_NODE 讀打包後的 app.asar
確認內含版本為 2.0.1，exe 的 FileVersion 亦為 2.0.1，
且 hover 跳躍、矩形判定、右鍵選單都還在。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 16:29:15 +08:00 |
|
|
JianMiauandClaude Fable 5
|
6da4775867
|
移除 hover 浮出的選單鈕，版本升到 2.0.0
摘要：
拿掉游標靠近時人物縮小讓位、上方浮出圓形選單鈕的整套 hover 版面，選單只留右鍵與系統匣。
根本原因：
上一版照 Codex 的 petControlsAppearance 做了 proximity 版面，但那顆控制鈕的作用就是開選單，
而本程式的右鍵與系統匣已經有同樣的選單，多一顆按鈕沒有增加任何功能，
反而讓游標經過時人物會縮小位移。
影響：
滑鼠靠近時人物無謂地縮小、下移，並蓋出一顆重複功能的按鈕。
修法：
- renderer：移除 HOVER_SCALE / HOVER_OFFSET_Y / PROXIMITY_ENTER / PROXIMITY_EXIT 常數，
以及 updateProximity / setNear / overControls / distanceToRect 與 near 狀態、
applyScale 裡的控制鈕定位、menu-btn 的事件繫結；mousemove 的點穿判定回到人物與氣泡兩者。
- index.html 移除 #controls；style.css 移除 body.near 的縮放位移與 #controls 樣式。
- package.json 版本 0.1.0 → 2.0.0。
- README 的日常使用、行為對照表、與 Codex 的對照三處同步更新，
對照表標明此項未採用及原因。
保留不變：
右鍵與系統匣選單、idle 放慢 6 倍、狀態優先序與到期、look 列縮放補正、
first-awake 問候、拖曳 4 px 方向閾值、reduced motion。
驗證：
- 三個 js 檔語法檢查通過，全專案 grep 確認 controls / menu-btn / HOVER_ / PROXIMITY_ /
body.near / setNear 等皆無殘留。
- 實機啟動：/health 正常，events.log 顯示 look rows rescaled 8 cells 仍正常觸發；
把游標移到人物上截圖，人物維持原尺寸原位置、無按鈕浮出（測後游標已復位）。
- 以 ELECTRON_RUN_AS_NODE 讀打包後 app.asar：版本 2.0.0、html 無 menu-btn、
css 無 body.near、js 無 proximity 邏輯，且右鍵選單、idle 放慢、look 補正、
狀態優先序都還在；exe 版本資訊為 2.0.0。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 15:18:30 +08:00 |
|
|
JianMiauandClaude Fable 5
|
e591475d4c
|
加上免安裝版，寵物來源改成執行目錄的 pets
摘要：
新增 portable 單檔與 zip 資料夾兩種免安裝產物；寵物一律從執行目錄的 pets/ 掃，設定檔不再累積程式自己算出來的路徑。
根本原因：
1. 只有 NSIS 安裝檔，沒有點兩下就能跑的版本。
2. 內附寵物被 asarUnpack 埋在 resources/app.asar.unpacked/pets，使用者要新增寵物得先鑽進 resources 資料夾。
3. loadConfig 會把算出來的來源路徑寫回 config.json，程式一搬家或在安裝版與 portable 之間切換，petSources 就越積越多失效的絕對路徑（實際已累積出 dist/win-unpacked/resources/app.asar.unpacked/pets 這種殘留）。
4. CODEX_PETS_DIR 用到 HOME，但 const HOME 宣告在它下面，會在啟動時就 TDZ ReferenceError。
影響：
沒有免安裝選項；新增寵物的路徑不直覺；設定檔會長出一堆死路徑；且上一版打包後的程式其實一啟動就會崩潰。
修法：
- win target 加上 portable 與 zip；portable 設 unpackDirName=ClaudePet、requestExecutionLevel=user。
- pets/ 改用 extraFiles 放到 exe 旁邊（不再進 asar），APP_ROOT 打包後取 process.execPath 的目錄。
- portable 的 NSIS 外殼每次啟動都重解壓、結束就刪整個目錄，因此：hook 腳本另外複製到 ~/.claude-pet/hook/ 並註冊該穩定路徑（否則寵物沒開時 Claude Code 每次觸發 hook 都找不到檔案）；使用者寵物放那顆 exe 旁邊；開機自動啟動改用 PORTABLE_EXECUTABLE_FILE。
- petSources 語意改為「只存使用者自己加的額外路徑」；執行目錄的 pets 與 ~/.codex/pets 為隱含來源，由 petSearchDirs() 組出實際掃描清單，載入時剔除隱含項與不存在的路徑。同 id 以使用者自己放的優先。
- 把 HOME/CONFIG_DIR 移到常數區最前面，修掉 TDZ。
- 內附第二隻寵物 xiao-nian-realistic。
驗證：
以 ELECTRON_RUN_AS_NODE 執行打包後的 exe（不開視窗）：
- 一般模式與模擬 portable 模式下的 pets 路徑、hook 路徑、autostart 指令皆正確。
- 用假的 USERPROFILE 實跑 install/uninstall：hook 腳本確實複製、指令含空白路徑會加引號、其他人的 Stop/PreToolUse hook 與 model 設定在安裝與移除後都完整保留、備份有產生。
- 帶殘留路徑的設定檔會被正確清理，掃描順序為「使用者 pets → 內附 pets → ~/.codex/pets → 額外路徑」。
- 從 app.asar 讀回 main.js 確認出貨的程式碼順序正確。
- 以純 node 載入 main.js，確認常數區與 loadConfig 不再有 TDZ。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 14:11:20 +08:00 |
|
|
JianMiauandClaude Fable 5
|
56fd8448ba
|
用 electron-builder 打包成 Windows exe
摘要：
加上 electron-builder 設定，`npm run dist` 產出 NSIS 安裝檔與免安裝版，並修正打包後才會出現的路徑問題。
根本原因：
原本三處路徑都假設程式是攤在資料夾裡跑的，打包成 asar 後會壞：
1. hook 腳本路徑會落在 app.asar 內，而 Claude Code 是用 `node <路徑>` 執行它，node 讀不到 asar 裡的檔案，hook 會直接失敗。
2. pets 資料夾同樣在 asar 內，使用者無法自己丟寵物進去，選單「開啟寵物資料夾」也開不起來。
3. 開機自動啟動寫入的是 `electron.exe + 專案路徑`，打包後沒有 node_modules，登錄值會指向不存在的檔案。
影響：
沒有可散佈的執行檔；直接打包的話 hook、換寵物、開機啟動三個功能都會壞掉。
修法：
- 新增 lib/paths.js：unpacked() 把 app.asar 換成 app.asar.unpacked，isPackaged() 以 process.defaultApp 判斷是否為打包版。
- build.asarUnpack 把 hook/ 與 pets/ 解到 asar 外，hooks-installer 與 main.js 的 PETS_DIR 都改走 unpacked()。
- autostart 打包後改用 process.execPath，並跳過開發版才需要的 electron.exe 存在檢查。
- NSIS 設為 per-user、可改安裝路徑、建立桌面與開始選單捷徑，解除安裝不刪 ~/.claude-pet。
- 新增 build/icon.ico（16–256，七種尺寸），取自小念 spritesheet 第 0 列第 6 欄的頭肩方形裁切。
- dist/ 加入 .gitignore；README 補上「打包成 exe」一節與安裝檔的使用方式。
驗證：
以 ELECTRON_RUN_AS_NODE 執行打包後的 exe（不開視窗）載入打包內的 lib，確認 isPackaged 為 true、hook 路徑指到 app.asar.unpacked 且檔案存在、autostart 指到 exe 本身、pets 掃得到 xiao-nian、renderer 讀得到 asar 內的 index.html；另確認 exe 版本資訊與七種尺寸圖示皆已嵌入。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 11:03:11 +08:00 |
|
|
JianMiauandClaude Fable 5
|
b1d57249f8
|
初始提交：Codex Pets 相容的 Claude Code 桌面寵物
摘要：
Electron 桌面寵物，透過 Claude Code hooks 即時反映工作狀態（思考、等待授權、失敗、完成），並支援 16 方向追視游標。
根本原因：
專案尚未納入版控，需要建立初始 repo 以便後續追蹤與協作。
影響：
建立 main 分支的第一個版本，包含完整可執行的程式碼與內附寵物「小念」。
修法：
納入以下內容：
- main.js / preload.js：Electron 主程序、透明置頂視窗、系統匣選單、HTTP 事件伺服器、游標輪詢與拖曳
- renderer/：Codex V2 spritesheet 幀動畫播放器、session 狀態機、氣泡、alpha 點穿判定
- hook/claude-pet-hook.js：Claude Code hook 端，stdin → POST /event，永遠 exit 0
- lib/、scripts/：hooks 安裝／移除、Windows 開機自動啟動
- pets/xiao-nian：內附寵物包（pet.json + spritesheet.webp）
- README.md、docs/states.png：使用說明與狀態總覽圖
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 10:32:39 +08:00 |
|