  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 |
|