Petdex

Petdex官网,为Codex提供动画伙伴的宠物合集平台

什么是Petdex?

Petdex是一个专为AI编程助手Codex设计的动画伙伴平台，收录了近2000只由社区创作的像素风格桌面宠物。其核心特色在于每只宠物都拥有完整的9种状态动画（待机、开心、沮丧等），能实时响应你的编码状态——测试通过时它会雀跃庆祝，遇到bug卡壳时它会流露出“烦恼”表情，还能在后台代理工作时静静陪伴。用户可以通过官网图库按类型、颜色或主题筛选宠物，从宝可梦、咒术回战等IP同人到原创的“珍珠奶茶水獭”或“侦探蜘蛛”，只需一行命令即可安装到Codex中。更独特的是，任何人都能利用内置的“Hatch Pet”技能，通过一段文字描述在五分钟内孵化出专属宠物，并提交到Petdex供全球用户安装使用。平台还提供了精选合集（如“猫猫宇宙”、“开发者专注”系列），让用户能一键安装整套主题宠物，将冰冷的代码环境变成充满生命力的陪伴空间。

Petdex官网: https://petdex.crafter.run/

Petdex github项目地址: https://github.com/crafter-station/petdex

---

Petdex 深度测评：1880+ 只像素桌宠任你挑，Codex 开发神器

2026 年 5 月，程序员圈子里掀起了一阵”桌宠热”——不是那种贴在屏幕角落没有意义的装饰品，而是真正能和你的 AI 编程工具联动、实时反映工作状态的像素小伙伴。而这场热潮背后，有一个名字频繁出现在 V2EX、掘金、CSDN、X（推特）等各大技术社区：Petdex。

如果你还不了解它，这篇文章会带你从零认识 Petdex——它是什么、有哪些核心功能、怎么用、好不好用，以及和同类产品相比有什么优势与不足。

---

什么是 Petdex？

Petdex 是一个面向 AI 编程助手（尤其是 Codex）的公开开源像素宠物图库平台，官网地址是 petdex.crafter.run。你可以把它理解为宠物版的 Pokédex——一本囊括了数千只动画小伙伴的图鉴，每只都可以用一行命令安装到你的开发环境里，陪你敲代码。

这个平台由 Crafter Station 社区团队开发和维护，定位非常清晰：不是商业产品，没有广告，没有付费墙，纯粹的开发者社区项目。所有宠物免费下载，平台本身也是开源的。截至 2026 年 5 月中旬，平台已收录超过 1880 只开源动画宠物，涵盖动漫角色、原创生物、像素物件等各种类型，安装量最高的单只宠物已突破 1600 次。

它的诞生有一个清晰的背景：OpenAI 在 2026 年 5 月 2 日为 Codex 桌面端上线了”桌面宠物”功能，内置了 8 款基础像素宠物，宠物会悬浮在桌面上方，通过不同动作实时反映 Codex 的工作状态（挠头 = 思考中、挥手 = 完成任务、跳跃 = 需要你做决定）。这个功能一上线，开发者们立刻开始疯狂折腾——怎么装更多宠物？怎么用自己喜欢的角色？Petdex 就是这个需求最直接的解决方案。

---

核心功能与特色

海量开源宠物图库

Petdex 最核心的价值就是它的宠物图库。目前已有 1880+ 只宠物，覆盖面极广：

• 动漫角色：哆啦 A 梦、2B（尼尔：机械纪元）、Asuna（SAO）、AK-15（少女前线）等
• 原创生物：泡泡茶水獭 Boba、黑色侦探蜘蛛 Noir Webling、各种奇幻小怪兽
• 像素物件：法拉利赛车、复古 X 图标、各种日系 Q 版物件
• 网络 IP：Labubu、瑞星小狮子、奥特曼系列……用户提交的什么都有

每只宠物都有详细页面，标注了类型（character / creature / object）和 vibe 标签（cozy / playful / focused / mystical / edgy 等），方便按心情筛选。

精细的多维度筛选系统

图库不止于”堆数量”，Petdex 在发现体验上下了功夫。你可以按以下维度过滤：

• Type（类型）：character（角色）、creature（生物）、object（物件）
• Color（颜色）：按主色系筛选
• Era（时代风格）：复古、现代、赛博等
• Vibe（氛围标签）：cozy（治愈）、focused（专注）、playful（活泼）、mystical（神秘）、edgy（酷）、heroic（热血）……

还有”精选合集”专区，由平台编辑人工挑选推荐，比如”适合深夜 coding 的 cozy 宠物”这类主题集合，解决了”选择困难症”的痛点。

一行命令安装，极度开发者友好

这是 Petdex 最受称赞的设计之一。安装任意一只宠物只需一条 npx 命令：

npx petdex install boba

CLI 工具会自动从 R2 存储拉取宠物文件，放置到 ~/.codex/pets/<slug>/ 目录下，并告知 Codex 使用该宠物。支持 macOS、Linux 和 Windows（PowerShell）三大平台，无需任何手动文件操作。

跨助手兼容性

Petdex Desktop 版本的一大亮点是跨 AI 助手响应能力。通过写入 hooks，宠物不仅能响应 Codex，还能联动：

• Claude Code
• Codex CLI
• Gemini CLI
• OpenCode

也就是说，你不必绑定某一个 AI 工具——无论你今天用哪个助手敲代码，你的像素小伙伴都会陪在旁边，实时反应。

宠物包结构：简洁而完备

每一只 Petdex 宠物本质上只有两个文件：

• pet.json：定义元数据——宠物名称、9 种动画状态（idle、working、sleeping 等）、每帧时长
• spritesheet.webp：水平排列的像素艺术帧，包含所有动画状态

Codex 在启动时加载这两个文件，根据当前会话状态自动切换动画。这个极简的设计让制作和分享宠物变得非常容易，也是社区快速增长的基础。

社区投稿与审核机制

任何人都可以向 Petdex 提交自己制作的宠物：

npx petdex login       # 登录账号
npx petdex submit ./my-pet/  # 提交宠物文件夹

提交后由管理员审核，通过后即可在全球图库中公开展示。也可以通过网页端 /submit 页面提交。所有宠物保留原作者署名，版权归创作者所有。

---

上手教程：从零开始养一只 Petdex 宠物

前置条件

• 已安装 Codex 桌面端（更新到最新版本）
• 系统已安装 Node.js（推荐 18+）
• 终端环境正常

第一步：进入 Petdex 图库挑选宠物

打开 petdex.crafter.run/zh 进入中文图库页面。你会看到当前 1880+ 只宠物按编号排列，页面顶部可以切换 Type、Color、Vibe、Era 等筛选条件。

找到喜欢的宠物后，点进详情页，就能看到安装命令，格式统一为：

npx petdex install <宠物名称>

比如安装人气最高的泡泡茶水獭 Boba：

npx petdex install boba

第二步：执行安装命令

打开终端，粘贴执行上面的命令。Petdex CLI 会自动完成以下操作：

1. 从云端拉取宠物的 pet.json 和 spritesheet.webp
2. 将文件存放到 ~/.codex/pets/boba/ 目录
3. 通知 Codex 切换到新宠物

整个过程通常在 5 秒内完成。

第三步：在 Codex 中激活宠物

打开 Codex 桌面端，进入 Settings → Appearance → Pets，你会看到刚刚安装的宠物已经出现在列表中。选中它，然后在对话框中输入：

/pet

宠物就会出现在你的桌面上方，开始悬浮陪伴你工作了。

第四步：一键接入多个 AI 助手（可选）

如果你同时使用多个 AI 编程工具，可以运行：

npx petdex init

这条命令会自动检测你系统中安装的 AI 助手（Claude Code、Codex、Gemini CLI、OpenCode），并写入相应的 hooks 配置，让宠物在所有助手中都能正常响应工作状态。

第五步：制作并上传自己的宠物

如果你有艺术细胞，或者想用 Codex 的 /hatch 指令生成专属宠物，完成后可以直接提交到 Petdex：

1. 准备好 pet.json（9 种状态配置）和 spritesheet.webp（水平像素帧）
2. 注意：spritesheet 背景必须是纯色 Magenta（#FF00FF），Petdex 运行时会将其抠成透明
3. 运行 npx petdex login 登录，然后 npx petdex submit ./你的宠物目录/
4. 等待管理员审核（通常 24 小时内），通过后全球可见

---

实测体验

笔者在 macOS 环境下对 Petdex 进行了完整体验测试，以下是几点直观感受：

安装流畅度：★★★★★
npx petdex install 命令响应速度极快，从图库到桌面不超过 10 秒，零学习成本。

图库丰富度：★★★★★
1880+ 只宠物已经覆盖了大部分主流动漫、游戏 IP 和原创风格，哆啦 A 梦、2B、赛马娘、甚至海洋传说里的波塞冬都有，基本可以满足 99% 的个性化需求。

筛选体验：★★★★☆
多维度标签筛选逻辑清晰，Vibe 标签设计很有意思，能根据当天心情快速缩小范围。唯一不足是目前搜索功能只支持英文名搜索，中文关键词匹配偏弱。

宠物动画质量：★★★★☆
不同宠物差异较大。头部精选作品（Boba、Doraemon、Noir Webling）动画帧数足够、状态切换自然，部分社区投稿作品帧数较少，idle 状态有些机械感。

跨助手联动：★★★★☆
Claude Code 和 Codex 的联动效果最好，Gemini CLI 有时 hooks 需要手动调整，OpenCode 支持仍处于 beta 阶段，偶有延迟。

社区活跃度：★★★★★
Discord、GitHub、X 上的社区相当活跃，每天都有新宠物提交，整体质量在管理员审核机制下保持在可接受水平以上。

---

五款同类产品详细对比

Petdex 不是唯一的桌宠解决方案，围绕 Codex 桌宠和泛桌面宠物生态，目前已经出现了多个竞争与互补产品。下面逐一分析：

---

1. Codex 原生内置宠物

平台：OpenAI Codex 桌面端
定位：基础桌宠功能，开箱即用

Codex 自带 8 款像素风宠物，通过 Settings → Appearance → Pets 直接选用，无需任何外部工具。这是最简单的入门方式——但也仅限于此。8 款选择空间极为有限，风格统一但个性化为零。

它的核心价值不在”丰富性”而在”原生性”：工作状态联动是直接写在 Codex 内核里的，响应最精准，没有任何延迟或兼容性问题。但如果你想要哆啦 A 梦或者 Labubu 陪你写代码，原生宠物就完全满足不了你了。

优点：零配置、状态响应最精准、无依赖
缺点：只有 8 款、无法扩展、不跨平台

---

2. OpenPet（开源桌宠运行时）

平台：独立开源项目
GitHub：RyanNiu/codexpet-nest
定位：让非 Codex 用户也能用上 Codex 宠物标准

OpenPet 是一个兼容 Codex 宠物标准的独立桌面宠物运行时，解决的问题是：如果我不用 Codex，能不能也养宠物？

它提供了一个独立的宠物运行环境，支持直接导入 Petdex 图库中的宠物，也支持自己创建。对于使用 Cursor、VS Code、Vim 等非 Codex 工具的开发者来说，这是目前最直接的替代方案。

项目是非商用开源的，但目前更新节奏相对较慢，宠物状态联动需要手动配置，不像 Codex 原生那样自动感知工作状态。UI 也比较朴素，缺少 Petdex 那样精致的图库前端。

优点：不依赖 Codex、开源免费、兼容 Petdex 宠物格式
缺点：配置较繁琐、状态联动不自动、更新频率低

---

3. codex-pets.net（社区宠物站）

平台：独立宠物收集网站
定位：另一个宠物图库平台，与 Petdex 定位相近

codex-pets.net 是另一个独立宠物收集站，同样收录了大量社区制作的 Codex 宠物，支持导入 OpenPet 等运行时使用。相比 Petdex，这个站点界面更简洁（某种程度上说也更朴素），没有 Vibe / Color 等多维度标签筛选，以列表方式展示为主。

它和 Petdex 更像是互补关系而非直接竞争——不少宠物创作者会同时在两个平台发布。但从规模和活跃度来看，Petdex 目前明显处于领先位置（1880+ vs 数百）。

优点：无需登录可浏览、简洁快速
缺点：收录量少、筛选功能弱、社区互动不足

---

4. Tamagotchi 系列（传统电子宠物）

平台：实体玩具 / App（iOS/Android）
定位：经典虚拟宠物养成游戏

提到桌宠，绕不开这个 1996 年诞生的祖师爷。Tamagotchi 是日本万代出品的电子宠物品牌，核心玩法是喂食、玩耍、睡眠、治病，宠物会成长也会死亡，强调情感投入和持续养成。

和 Petdex 相比，两者目标完全不同。Tamagotchi 是独立的娱乐产品，宠物是你花时间养的；Petdex 是开发工具的扩展，宠物是陪你工作的小助手。前者要求你主动照料，后者则完全被动陪伴。Tamagotchi 的情感深度更强，Petdex 的实用性更突出。

现代 Tamagotchi App 版本也支持在手机屏幕上显示宠物，但与 AI 编程工具零联动，无法感知你的工作状态，纯属娱乐范畴。

优点：情感养成体验深、品牌历史悠久、移动端体验成熟
缺点：与开发工具无联动、无工作状态响应、娱乐而非生产力工具

---

5. Desktop Goose（恶作剧桌面小鸡）

平台：Windows/macOS 桌面应用
定位：捣乱派桌面宠物，以破坏你工作为乐

Desktop Goose 是 2019 年爆火的一款恶搞桌面宠物——一只永远在乱跑、偷走你鼠标、拖拽窗口的捣乱大鹅。它在 YouTube 和 Reddit 上引发了大量整活视频，短暂成为病毒式传播的 meme。

和 Petdex 的设计哲学正好相反：Desktop Goose 的目标是打扰你，Petdex 的目标是陪伴你。前者是娱乐产品，后者是生产力工具的延伸。Desktop Goose 的可定制性很低，无法感知你的工作状态，更新也早已停滞，但它作为一种”减压神器”在特定人群中仍有市场。

优点：解压娱乐效果好、一键安装、操作简单
缺点：无工作联动、干扰性强（反生产力）、长期使用体验差

---

六产品横向对比表

维度	Petdex	Codex 原生宠物	OpenPet	codex-pets.net	Tamagotchi App	Desktop Goose
宠物数量	1880+（持续增长）	8 款固定	兼容导入	数百	固定内置角色	仅鹅
跨 AI 助手	✅ 4 种助手	❌ 仅 Codex	✅（手动配置）	❌	❌	❌
工作状态联动	✅ 自动	✅ 最精准	⚠️ 手动	❌	❌	❌
自定义/投稿	✅ 开放社区	❌	✅	✅	❌	❌
免费开源	✅	✅	✅	✅	❌（付费）	✅
筛选/发现体验	★★★★★	不适用	★★☆☆☆	★★★☆☆	不适用	不适用
安装难度	一行命令	零配置	中等	中等	应用商店下载	应用下载
生产力友好度	★★★★★	★★★★★	★★★★☆	★★★☆☆	★★☆☆☆	★☆☆☆☆

---

Petdex 的不足与局限

任何产品都不完美，Petdex 也有几个需要改进的地方：

中文支持偏弱：图库已有中文界面，但搜索功能目前对中文关键词匹配不够精准，搜索”水獭”和搜索”otter”的结果可能不一致，对中文用户造成一定不便。

宠物质量参差不齐：开放投稿是双刃剑。管理员审核虽然过滤了明显劣质内容，但社区宠物的动画帧数、风格统一性差异仍然很大。建议新用户优先从”精选”合集入手，而非直接在 1880 条记录里盲翻。

仅限 Codex 生态：尽管 npx petdex init 支持写入多个 AI 助手的 hooks，但核心体验仍然是围绕 Codex 设计的。对于纯用 VS Code + Copilot 的用户，宠物的工作状态联动几乎无效，使用价值大打折扣。

没有移动端：Petdex 目前是纯桌面产品，没有 iOS 或 Android 客户端，图库也没有响应式优化的移动版 App。如果你在 iPad 上用 Claude，暂时无法享受桌宠体验。

Windows 支持仍有小坑：macOS 和 Linux 体验非常顺畅，但 Windows 用户通过 PowerShell 安装时偶尔遇到路径权限问题，需要以管理员身份运行终端才能正常写入配置文件。

---

谁适合用 Petdex？

非常适合：

• 每天使用 Codex 或 Claude Code 的开发者，想要一个有趣的工作陪伴
• 喜欢个性化开发环境、对”桌面美化”有热情的程序员
• 动漫、游戏 IP 爱好者，想把自己的”老婆”或最爱角色搬到桌面
• 有像素艺术基础、想分享创作作品给全球开发者社区的设计师

不太适合：

• 对开发环境有严格”零干扰”要求的用户
• 不使用 Codex 类 AI 编程工具的用户（宠物状态联动意义不大）
• 追求深度情感养成体验的玩家（那还是回去玩 Tamagotchi 吧）

---

Petdex 背后的文化意义

值得注意的是，Petdex 的爆红不仅仅是因为”好玩”。它折射出 2026 年 AI 编程工具普及后，开发者心态的一种微妙转变：代码越来越多地由 AI 生成，人的角色越来越像”指挥官”而非”工匠”。在这个背景下，一只能感知工作状态、陪你”坐班”的像素小伙伴，提供了一种情感锚点——它让 AI 工具不再是冷冰冰的黑盒，而是有了某种”在场感”。

这也解释了为什么 Petdex 在技术社区传播速度如此之快：它击中的不只是”好玩”的需求，更是开发者在自动化浪潮中寻找人机连接感的心理需求。像素宠物在挠头，你知道 AI 正在思考；它挥手，你知道任务做完了。这种反馈，在某种程度上，比任何进度条都更有温度。

Petdex 用”宠物图鉴”的形式，把一个技术工具做成了一种文化现象。这也许才是它最了不起的地方。