AI/claude-pet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 12 Wiki Activity
18 Commits 1 Branch 12 Tags
cd4b618be059ef6b0ce48711906e3a5c7aef62c5
Commit Graph
4 Commits
Author SHA1 Message Date
JianMiauandClaude Fable 5 93f635dd01 氣泡改成兩行，第一行顯示對話名稱或專案名 
摘要：
氣泡上方加一行標題（/rename 設的對話名稱，沒設就用專案資料夾名），訊息移到第二行。

根本原因：
原本把專案名以「（專案名）」的形式接在訊息尾巴，訊息本身就短，
加了括號後更容易被氣泡的單行省略號截掉，而且同時開多個 session 時
要看到最後才知道是哪一個在叫你。

影響：
多 session 並行時不容易分辨氣泡是哪個專案發出的；訊息也被括號擠掉。

修法：
- index.html 氣泡內加 #bubble-title；style.css 把單行限制從 #bubble 移到
  #bubble-title 與 #bubble-text 各自身上，兩行各自省略，
  並以 :empty 讓沒有標題時整行收起來，不留空白。
- say() 增加第四個參數 title，事件處理處的八個呼叫點改傳標題、移除 suffix。
- main.js 的 latestNarration 改名為 readTranscript，同一次反向掃描同時取出
  助理說明與 custom-title（/rename 會把它寫進 transcript），兩者都拿到就提早結束；
  收到事件時把 sessionTitle 一併併進 payload。
- 標題優先序：對話名稱 > 專案資料夾名 > 不顯示。

驗證：
- 單元測試以真實 transcript 執行 readTranscript：取到對話名稱 "claude-pet"、
  同時取到助理說明、快取一致、路徑不存在或為 null 時回 null，6 項全過。
- 實機截圖確認兩行版面正確。截圖當下剛好收到另一個 session 的真實事件，
  標題顯示 "telegram-codex-bot"、第二行是該 session 的助理說明，
  等於用實際流量驗證了多 session 下的標題辨識。
- 以 ELECTRON_RUN_AS_NODE 讀打包後 app.asar，確認版本 2.0.5 與十項改動都在出貨檔案裡，
  包含舊的 suffix 已完全移除。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 12:09:01 +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 f886df554e 逐項對照 Codex 校正所有行為邏輯 
摘要：
從 Codex app 的 app.asar 讀出寵物的完整行為邏輯（狀態決策、優先序、到期、hover 版面、
初次問候、拖曳、reduced motion），逐項對照後校正本程式。

根本原因：
先前只對齊了動畫時序，狀態機本身仍是自訂的，與 Codex 有多處不一致：
1. 跨 session 優先序是 waiting>running>review>idle，但 Codex 的 Ai() 是
   waiting>failed>review>running，review 其實高於 running。
2. Stop 用 jumping 一次 + 6 秒 review，Codex 是 review 持續狀態直到該 thread 被讀取。
3. StopFailure 用 failed 播兩次就回 idle，Codex 的 failed 是持續狀態。
4. 工具失敗（PostToolUseFailure）會播 failed，Codex 中單一工具失敗不改變 turn 狀態。
5. 每個 hook 事件都重播動畫，Codex 只在狀態改變時重播（effect 相依只有 state）。
6. hover 是「跳躍」，Codex 實際的 respondToHover 全 app 沒人開啟；真正的 hover 行為是
   proximity 版面：40px 內人物縮 0.9、下移、露出控制鈕，56px 外退出。
7. 追視綁滑鼠且預設開，但 Codex 的追視來源是 quick chat 文字游標／computer-use 游標，
   不是滑鼠。
8. 沒有 first-awake 問候；狀態到期時間、拖曳方向閾值、reduced motion、預設位置也都沒對齊。

影響：
多 session 時顯示的狀態可能不對（running 蓋掉 review）；完成與失敗的表現和 Codex 差很多；
待機期間仍可能因連續事件一直重播；hover 行為與 Codex 完全不同。

修法（數值皆取自 codex-pet-assets / avatar-overlay-native-frame / 主程序）：
- 優先序改為 waiting(4)>failed(3)>review(2)>running(1)>idle(0)（對應 Ai()）。
- 到期改為 failed 1h、waiting 24h、review 7d、running/idle 不到期（對應 Ei()），
  另保留一個 Codex 沒有的安全網：running 30 分鐘無事件視為終端機關閉。
- Stop→review 持續狀態；StopFailure→failed 持續狀態；PostToolUseFailure 只給氣泡不改狀態；
  idle_prompt 不再算 waiting。
- 動畫只在狀態改變時重播（移除 pulse）。
- hover 改為 proximity 版面：enter 40px / exit 56px，人物縮 0.9、下移 14px、
  200ms 過渡，上方露出 24px 選單鈕（對應 hoverControlSize/hoverOffsetY/hoverControlGap）。
- 追視改為選配、預設關；first-awake 問候每隻寵物一次（記在設定檔 greetedPetIds）；
  拖曳方向改為單次位移 >= 4px 才決定（對應 Codex 的取樣邏輯）；
  reduced motion 只顯示第一格；預設位置改為工作區右下各 24px；尺寸檔位對齊 80–224px 範圍。
- README 新增「與 Codex 的對照」整節，逐項列出相同與刻意不同之處。

驗證：
- baseState 單元測試：優先序（review>running、waiting>failed、failed>review）與各狀態
  到期（failed 1h、waiting 24h、review 7d、running 安全網、idle 清理）全數通過。
- 啟動實機以 HTTP /event 灌事件、/state 讀回：Stop→review、review 蓋過 running、
  授權→waiting、waiting>failed、failed>running、工具失敗不改狀態，皆正確。
- 桌面截圖：寵物正常顯示；滑鼠移到人物 40px 內時人物縮小下移、上方浮出圓形選單鈕，
  與 Codex 的 hover 版面一致。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 15:11:56 +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