前言¶
在 macOS 上給 WorkBuddy 配一隻桌面寵物，常見路徑是：自己找精靈表、按目錄解壓、再手動啓動進程，還要記得和 WorkBuddy 的會話狀態對齊動畫。從 codex.pet 或 codex-pets.net 導入時，往往還要處理下載 URL、curl 命令和安裝目錄。workbuddy-pet 是 SkillHub 社區 Skill（@user_c0cbf071/workbuddy-pet，v1.0.0），把「創建 / 安裝 / 啓動 / 切換 / 列出桌寵」收斂成對話觸發的一條龍流程。
這是什麼¶
workbuddy-pet 的定位是 WorkBuddy 桌寵工廠：你提供一張角色圖、一個 codex.pet 鏈接、一條 codex-pets.net 下載 URL、或一份現成的精靈表，Skill 會按流程完成下載、解壓、安裝與啓動。出品方爲 SkillHub 發佈者 user_c0cbf071，分類爲 dev-programming，來源標註爲 community，標籤 requires_api_key=false，即不依賴額外 API Key。
它與「只生成資源、不管本地運行」的做法不同：安裝後的桌寵會讀取 ~/.workbuddy/workbuddy.db 中的會話與自動化狀態，在揮手、思考、等待、慶祝、沮喪等動畫間自動切換，並針對 macOS 做了不搶鍵盤焦點、切換應用時不消失等行爲約束。
核心功能¶
下面介紹官方簡介中已寫明、可覈對的能力。
多種輸入源¶
- 本地角色圖（用戶說「用這張圖做桌寵」等）。
codex.pet鏈接（「從 codex.pet 安裝桌寵」等）。codex-pets.net下載 URL，或直接粘貼形如curl ... codex-pets.net/api/pets/<id>/download...的命令。- 現成的精靈表資源。
對話觸發的生命週期¶
當用戶說出創建、安裝、導入、召喚、啓動、停止、切換、列出等意圖時（例如「創建桌寵」「啓動 XX 桌寵」「切換到 XX 桌寵」「換成 XX」「列出所有桌寵」「裝一下 codex-pets.net 上的 XX」「導入 codex 桌寵 XX」），Skill 負責自動完成 下載 → 解壓 → 安裝 → 啓動。
桌面單例與狀態聯動¶
- 單例：桌面強制只保留一隻在跑；
start/switch會自動停掉其它實例。 - 狀態聯動：讀取
~/.workbuddy/workbuddy.db，根據 WorkBuddy 會話與自動化狀態切換動畫。 - macOS 交互：不搶鍵盤焦點；切換應用時桌寵不消失（官方說明針對 macOS）。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 SkillHub 安裝。官方頁面給出的安裝提示如下：先閱讀 SkillHub 安裝說明，再安裝本 Skill 座標。
在支持 SkillHub 的 AI 客戶端中，可將下面提示發給 Agent（與 SkillHub 頁面一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_c0cbf071/workbuddy-pet`。
安裝完成後，在對話裏用自然語言或粘貼 curl ... codex-pets.net/api/pets/<id>/download... 即可觸發 Skill；Cursor、Codex CLI、Claude Code 等平臺若已按 skillhub.md 接入 SkillHub，流程相同，具體客戶端差異以該安裝文檔爲準。
典型用法¶
先做安裝，再在對話中描述目標。下列表述均來自官方簡介，用於觸發同一套流水線。
-
從圖創建
例如：「做一隻桌寵」「用這張圖做桌寵」。 -
從 Codex 生態安裝
例如：「從 codex.pet 安裝桌寵」「導入 codex 桌寵 XX」「裝一下 codex-pets.net 上的 XX」。 -
直接給下載命令
粘貼完整curl命令（目標爲codex-pets.net/api/pets/<id>/download）。 -
運行中管理
- 啓動：「召喚新桌寵」「啓動 XX 桌寵」
- 停止：「停止 XX 桌寵」
- 切換：「切換到 XX 桌寵」「換成 XX」（會停掉其它實例）
- 枚舉：「列出所有桌寵」
經過上面的步驟，桌寵應已安裝並讀取 ~/.workbuddy/workbuddy.db；WorkBuddy 狀態變化時，動畫會隨之切換。
適用場景與注意¶
適合誰
- 已在 macOS 使用 WorkBuddy，希望桌寵與本地會話/自動化狀態同步的開發者。
- 需要從
codex.pet、codex-pets.net或精靈錶快速落地桌面寵物、又不想手寫下載解壓腳本的用戶。
限制與前提
- 官方說明中的焦點與「切 app 不消失」等行爲以 macOS 爲上下文；其它系統是否支持，資料未寫明，需自行驗證。
- 依賴本機存在
~/.workbuddy/workbuddy.db及 WorkBuddy 相關環境；無 WorkBuddy 時狀態聯動可能無效。 - SkillHub 頁面顯示版本 v1.0.0；評分與下載量會變動，撰寫時頁面爲社區來源、分類
dev-programming（具體數值以 SkillHub 爲準）。
結尾¶
workbuddy-pet 把桌寵的素材來源、安裝與啓停管理收成對話指令，並和 WorkBuddy 本地庫聯動動畫，適合作爲「桌寵工廠」類 Skill 使用。官方入口：
- SkillHub：https://www.skillhub.cn/skills/user_c0cbf071/workbuddy-pet
- API 座標頁：https://api.skillhub.cn/user_c0cbf071/workbuddy-pet
