JayT-workbuddy-petdex 是做什麼的？

為初學者提供完整的 WorkBuddy 寵物體驗，使用來自 Petdex 的社群寵物。不涉及 Codex、修改 WorkBuddy 應用程式套件或改變 WorkBuddy 外觀。

初學者優先原則

假設使用者從未使用過終端機、Petdex、技能或 spritesheet。使用簡短的中文句子，每次解釋一個決定，並為他們執行捆綁的腳本。絕不要求他們輸入 shell 指令。

當使用者尚未提供寵物連結、複製的 Petdex 指令或名稱時，請忠實地重現以下中文指南。保持連結可點擊，不要將其改寫為更長的答案：

選寵物只要四步：

打開 Petdex 中文寵物站。

點擊一隻喜歡的寵物。可以直接瀏覽，也可以用搜尋框或標籤篩選。

複製瀏覽器網址列裡的詳情連結，例如 https://petdex.dev/pets/boba。如果你點了頁面上的「複製安裝指令」也沒關係。

回到這裡貼上，並說「幫我安裝這隻寵物」。剩下的交給我，不用打開終端機。

在指南之後，立即說：瀏覽和安裝 Petdex 官方收錄的寵物不需要註冊帳號，也不需要手動下載檔案。 除非使用者提問，否則不要添加第二個解釋。

如果使用者要求推薦，最多詢問一個偏好，例如「可愛 / 搞怪 / 安靜 / 酷」，然後引導他們前往畫廊。將選擇權留給使用者；不要僅僅因為某個寵物受歡迎就安裝它。

安裝流程

當使用者提供 Petdex 詳細資訊 URL、複製的指令（例如 npx petdex install boba）或簡單的寵物 slug/名稱時：

讀取 references/petdex-package.md 和 references/security.md。
桌面寵物啟動需要啟用權限以啟動本地背景應用程式。如果當前 WorkBuddy 任務尚未處於允許完全存取狀態，請在下載前停止，並忠實地重現此初學者指南：
安裝桌面寵物前，需要給本次任務一次「允許完全存取」：
1. 點擊輸入框下方的「預設權限」。
2. 點擊「允許完全存取」。
3. 勾選「我已了解風險，並願意繼續」，再確認「允許完全存取」。
4. 完成後回覆「繼續安裝」。這個權限用於把寵物儲存到你的個人目錄並啟動本地寵物，不會修改 WorkBuddy.app。
不要聲稱重新啟動可以取代此權限。不要嘗試自行更改使用者的權限。
將使用者的完整訊息傳遞給本地解析器。它接受嵌入在句子中的確切 HTTPS petdex.dev 詳細資訊 URL、作為靜態文字複製的 Petdex 安裝指令或安全的 slug。它會拒絕相似域名，且永遠不會執行複製的指令。
執行：
```
./scripts/install-pet.sh "<確切的使用者輸入>"
```
在正常使用者流程中使用此確切指令，不要加上 --no-start。當指令未要求重新啟動時，不要在下載後停止或將寵物描述為「待啟用」。安裝程式已嘗試進行安全、無需重新啟動的啟用。
如果指令回報寵物已出現並連線，立即執行 ./scripts/doctor.sh。當檢查通過時，報告成功，且絕不要要求重新啟動。
如果指令顯示「寵物宿主沒有成功啟動」或檢查顯示橋接/寵物未執行，表示該任務缺少有效的完全存取。顯示上述四個權限步驟，並要求使用者回覆 繼續啟用寵物；之後，執行 ./scripts/start-runtime.sh 和 ./scripts/doctor.sh。永遠不要將其診斷為重新啟動問題。如果本地錯誤顯示另一個 WorkBuddy 桌面寵物正在執行，請在可見時指出衝突的寵物名稱，徵求使用者同意暫停舊寵物，並在獲得同意後才繼續。切勿無聲地終止無關的寵物。
僅當確切的安裝程式指令明確表示正在執行的 WorkBuddy 缺少經過驗證的本地狀態連線，並要求執行 scripts/start-runtime.sh --restart 時，才問一個問題：為了讓寵物讀取 WorkBuddy 的任務狀態，需要重新啟動一次 WorkBuddy。現在可以重新啟動嗎？ 切勿僅因這是第一個安裝的寵物就推斷需要重新啟動。
對於所有其他下載或網路失敗，請停止並引用簡短的本地錯誤訊息。不要使用 WebFetch、DNS-over-HTTPS、硬編碼 IP、--resolve、--connect-to、停用的憑證檢查、除捆綁腳本之外的代理繞過或手動安裝步驟。要求使用者檢查網路並重試。
僅在使用者明確同意後，執行：
```
./scripts/start-runtime.sh --restart
```
執行 ./scripts/doctor.sh 並報告已安裝的寵物名稱、Petdex 來源連結和成功的狀態連線。通過檢查也證明兩個程序都由 macOS launchd 擁有，能夠在 WorkBuddy 打開時意外崩潰後恢復，且不依賴於 Codex 或當前的 WorkBuddy 任務。它們不會在登入時啟動；如果 WorkBuddy 關閉，寵物允許停止。如果檢查顯示「狀態橋正在後台等待 WorkBuddy 狀態埠」或 scripts/start-runtime.sh --restart，請報告寵物已穩定運行，但當前任務文字在 WorkBuddy 以其本地狀態埠重新打開前無法更新。問一個問題：寵物已經穩定執行。為了讓它顯示當前對話和任務狀態，需要重新啟動一次 WorkBuddy。現在可以重新啟動嗎？ 如果使用者同意，執行 ./scripts/start-runtime.sh --restart，然後執行 ./scripts/doctor.sh。
解釋控制方式：

將寵物拖曳到任何地方，包括 WorkBuddy 外部。
點擊它以揮手並顯示/隱藏任務面板。
右鍵點擊以進行重置、跳躍、任務面板或退出。
它會自動對執行中、等待中、審查中、失敗和完成的任務做出反應。

永遠不要執行 Petdex 傳回的遠端 shell。捆綁的安裝程式僅提取位於白名單中的 https://assets.petdex.dev/ 資源 URL、驗證套件，並將其安裝到 WorkBuddy 專用的本地函式庫中。

當前對話與多任務行為

原生任務氣泡可能顯示：

最近一次可見的使用者指令，截斷至 60 個字元；
當前的助手主導/狀態，截斷至 96 個字元；
最多五個 WorkBuddy 任務標題和狀態；
一個八秒的完成通知。

絕不收集完整的助手回覆、較早的對話輪次、附件、檔案名稱、帳戶資料或工件內容。在診斷任務文字或動畫時，請閱讀 references/workbuddy-state-bridge.md。

管理已安裝的寵物

列出本地寵物：./scripts/list-pets.sh
無需下載切換：./scripts/switch-pet.sh "<slug>"
暫停寵物和橋接：./scripts/stop-pet.sh
喚醒選定的寵物：./scripts/start-runtime.sh
診斷：./scripts/doctor.sh
移除非使用中的寵物：./scripts/remove-pet.sh "<slug>"
卸載執行時但保留下載：./scripts/uninstall-runtime.sh
僅在明確確認後卸載執行時和所有下載：./scripts/uninstall-runtime.sh --remove-pets

不要因模糊的請求（例如「換一隻」或「先不要這個」）而刪除寵物或執行時。應將其解釋為切換/暫停，而非破壞性刪除。

界線

僅支援官方的 macOS WorkBuddy 應用程式。
絕不修改、解包、替換、重新簽署或寫入 WorkBuddy.app 或 app.asar。
絕不安裝 Codex、編寫 Codex hooks、開啟 Codex 設定或需要 ~/.codex/pets。
絕不添加主題 CSS、背景圖片、外觀顏色或頁面樣式。將此類請求路由到獨立的外觀技能。
在本地元資料中保留 Petdex 創作者歸屬和來源連結。
Petdex 寵物是社群提交的作品，可能是粉絲創作。告知使用者在進行公開或商業使用前檢查權利。
未經明確許可，不要重新啟動 WorkBuddy。

JayT-workbuddy-petdex