前言¶
在 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
