Petdex

Petdex官网,专为Codex 编程助手打造的动画伙伴图鉴与创作平台

什么是Petdex?

Petdex 是一个专为Codex 编程助手打造的动画伙伴图鉴与创作平台，你可以把它理解为编程桌面宠物的“精灵宝可梦图鉴”。其核心特色是拥有超过1997只由社区贡献的、可立即安装的动画宠物，涵盖从皮卡丘、哆啦A梦到原创像素精灵等丰富主题。用户只需在Codex中通过简单命令或一键安装，就能让这些拥有9种状态动画的迷你伙伴漂浮在编程界面旁，在你写代码时提供趣味反馈，例如测试通过时开心雀跃、卡住时做出沮丧表情，甚至进行任务提醒和背景陪伴。Petdex的主要功能包括：通过图库按类型、颜色或主题筛选并发现宠物；利用内置的“孵化宠物”技能，仅需一段文字描述即可在几分钟内通过AI生成专属宠物的完整动画精灵表；提交并托管你的作品供全球用户安装；以及浏览宠物合集，用一条命令行即可批量安装同系列伙伴。它还计划推出网页版宠物创作器，让你无需离开平台即可制作动画。无论是为了增加编程乐趣、寻找陪伴感，还是展示创意，Petdex都将桌面宠物文化与AI开发工具巧妙融合，提供了一个充满活力的数字伙伴生态。

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

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

---

什么是 Petdex

2026 年 5 月，OpenAI 为旗下编程工具 Codex 悄悄上线了一个令人意想不到的功能——桌面像素宠物。你可以在桌面上养一只会动的赛博小伙伴，它不只是摆设，还能实时反映 Codex 的工作状态，让你不用频繁切窗口就能掌握任务进展。

随着这项功能的火爆，宠物社区生态迅速膨胀。Petdex（petdex.crafter.run）就是在这股浪潮中应运而生的核心平台——一个专注于 Codex 像素宠物的开源社区图鉴与分发中心，中文名可以叫”宠物图鉴”。 截至 2026 年 5 月，平台已收录超过 1880 只可免费下载的开源宠物，从哆啦 A 梦到 NieR:Automata 的 2B，从泡泡茶水獭到像素风克里比，应有尽有。

---

核心功能与特色

一、海量宠物图鉴，免费开源

Petdex 的核心价值在于它的开放生态。 平台目前已有 1880+ 只宠物入库，全部开源、免费使用，任何人都可以浏览、预览动画状态，并通过一行命令完成安装。 宠物按照角色（Character）、生物（Creature）、物体（Object）等类型分类，同时支持标签筛选，例如 #cozy、#playful、#edgy、#heroic 等，帮你快速找到最符合自己气质的桌面伙伴。

精选宠物中，部分作品安装量已相当可观，例如水獭”Boba”安装量超过 1600 次，哆啦 A 梦达到 788 次，都是出自社区创作者之手的像素精品。

二、实时状态反馈，告别无效等待

Codex 宠物最实用的地方不是颜值，而是它的状态感知能力。宠物会根据 Codex 当前工作阶段改变动画表现：任务运行中、等待用户输入、可以复核等不同状态，宠物会有对应的表情和动作变化，相当于一个浮在桌面上的轻量级灵动岛。 这样你大可放心做其他事，无需反复切回 Codex 窗口盯着进度转圈。

宠物悬浮于所有窗口之上，不干扰正常操作，旁边会实时显示当前任务的执行状态提示文字。

三、社区投稿与宠物审核机制

Petdex 不只是一个下载站，还是一个创作者社区。任何人都可以制作自己的像素宠物，提交到 Petdex 平台后，经管理员审核通过即可上线，供全世界所有人安装使用。 创作者的名字会显示在宠物详情页，作品贡献直接计入社区图鉴编号（目前编号已超过 1800）。

平台配有专属的网页控制台，投稿者可以在上面实时查看宠物的审核状态，免去反复询问的麻烦。

四、Petdex Desktop 客户端

除了网页图鉴，Petdex 还推出了独立的 Desktop 客户端应用，可以直接在本地浏览、管理和切换宠物，不依赖浏览器操作。 客户端与 Codex 深度整合，可以直接同步本地宠物配置，体验更加流畅。

五、多维度筛选与搜索

对于一个已经收录近两千只宠物的平台，搜索能力至关重要。Petdex 提供了按类型（Type）、颜色（Color）、年代（Era）等维度的筛选功能，配合关键词搜索，可以迅速定位目标。 比如你只想要蓝色系的生物类宠物，或者 2026 年 5 月入库的新宠，都能快速筛出来。

---

使用教程：从零到一养起你的赛博宠物

第一步：确认 Codex 版本并安装 hatch-pet 技能

首先确保你的 Codex 桌面端已更新到支持宠物功能的版本（2026 年 5 月 2 日或以后的版本）。 在 Codex 的对话框内输入以下命令安装 hatch-pet 技能（注意：要在 Codex 聊天界面内运行，而非系统终端）：

$skill-installer hatch-pet

安装完成后重启 Codex。

第二步：唤醒官方内置宠物

Codex 内置了 8 款像素风宠物，无需任何额外操作即可直接使用。 你有三种方式唤醒它们：

• 在对话框输入 /pet 命令
• 进入 Settings > Appearance > Pets 选择并启用
• 使用快捷键：Mac 下 Cmd + K，Windows 下 Ctrl + K 打开命令菜单

宠物被唤醒后会悬浮在桌面上，跟随你的工作状态实时变化动画。

第三步：从 Petdex 图鉴安装社区宠物

打开 Petdex 网站（petdex.crafter.run/zh），在图鉴中浏览或搜索你喜欢的宠物。 找到心仪的宠物后：

1. 点击进入宠物详情页，预览它的各种状态动画
2. 复制页面上提供的 AI 安装提示词（Setup Prompt）
3. 将该提示词粘贴到 Codex 聊天框运行，系统会自动完成宠物包的下载与本地安装
4. 回到 Settings > Appearance > Pets 切换到新宠物即可

第四步：用 AI 自定义专属宠物

这是 Petdex 生态中最有趣的玩法。hatch-pet 技能集成了 AI 图像生成能力，你只需要用自然语言描述你想要的宠物形象，或者直接上传一张照片，AI 就会生成一套像素风格的精灵表格（Spritesheet）：

$hatch-pet 一只穿黑色西装的赛博朋克猫咪，戴墨镜，会抽雪茄

你也可以发一张自己的照片或者宠物照片，让 AI 帮你生成专属像素形象。

制作宠物的技术要点：

Spritesheet 有一个关键技术要求：所有动画帧的背景必须是纯 Magenta（洋红色），不能有任何噪点、渐变或透明通道残留，因为 Petdex 会在运行时把 Magenta 色抠掉变成透明。 AI 一般会自动处理这个要求，手动制作时需要注意。

第五步：投稿到 Petdex 社区

完成宠物制作后，可以选择提交给 Petdex 社区：

1. 登录 Petdex 网站并进入控制台
2. 上传宠物的 Spritesheet 文件、填写宠物名称、类型、标签和描述
3. 提交后等待管理员审核
4. 审核通过后，你的宠物会获得一个专属编号，出现在全球用户的图鉴中

---

深度测评

实用性：★★★★☆

最初看到”桌面宠物”这个词，很多人的第一反应可能是”噱头”，但实际上手后会发现它的状态指示功能相当实用。在跑一个耗时较长的 AI 任务时，不需要每隔几分钟就切回 Codex 窗口查看——宠物的动画变化本身就是一个低打扰的进度信号。 这种设计理念和 iPhone 的灵动岛如出一辙，用”外围感知”代替”主动查看”。

不过，目前宠物功能仍处于实验性阶段，与 Codex 的深度联动还有提升空间，状态反馈的精细度相比于真正的灵动岛还略显粗糙。

社区活跃度：★★★★★

从数据来看，Petdex 社区的增长速度非常惊人。功能发布于 2026 年 5 月初，短短两周内图鉴就从 0 膨胀到 1880+，说明创作者社区的参与热情极高。 从哆啦 A 梦、NieR:Automata 2B、少女前线 AK-15，到原创 IP 机甲 GRAYCRAFT6，创作者们的想象力和技术水准都令人印象深刻。

Discord 社区同步活跃，也是宠物设计师交流像素艺术技巧的重要阵地。

上手难度：★★★★☆

对于普通用户，从 Petdex 下载现成宠物的流程非常简单，基本上是”点击 – 复制提示词 – 粘贴到 Codex – 完成”。 但如果想自己从头创作宠物，需要掌握一定的像素艺术知识，Spritesheet 的行列规范、Magenta 背景要求等细节对新手来说有一定门槛。 AI 辅助的 hatch-pet 流程大幅降低了这一门槛，但 AI 生成的结果质量参差不齐，有时需要手动调整。

稳定性：★★★☆☆

作为一个刚上线半个多月的新功能，偶有用户反馈宠物在切换应用时会出现渲染闪烁或位置漂移的问题。Codex 官方表示仍在持续迭代，稳定性会逐步提升。整体而言，作为实验性功能，当前表现在合理预期内。

创意与可玩性：★★★★★

这是 Petdex 最大的加分项。1880+ 只宠物本身就是一部赛博文化图鉴——你能在里面找到几乎所有流行文化的缩影，而且所有作品都是社区在短短两周内自发创作的。这种充沛的创造力让 Petdex 不只是一个工具，更像是一场持续进行的像素艺术展览。

---

同类产品对比

在”桌面宠物/虚拟伙伴”这个品类里，Petdex 并不是唯一的玩家。以下是五款主要同类产品的详细对比：

1. Shimeji（桌面精灵）

Shimeji 是一款起源于日本的经典桌面宠物程序，历史悠久，已有超过十年的社区积累。 宠物（Shimeji）可以在桌面上爬行、攀爬窗口边框、互动，支持大量动漫角色形象，在二次元爱好者群体中有很高的知名度。

维度	Petdex	Shimeji
定位	Codex AI 工具专属桌宠 + 工作状态指示	纯娱乐向桌面精灵，无功能性
宠物数量	1880+，快速增长	社区长年积累，数量庞大但分散
AI 集成	深度集成，宠物反映 AI 任务状态	无 AI 集成
自定义方式	AI 生成 + 手动制作	手动制作为主，需 Java 环境
跨平台	macOS / Windows（随 Codex）	Windows / macOS / Linux
互动性	工作状态感知，低打扰	随机行走、爬窗、相互克隆，娱乐性强

Shimeji 的优势在于纯粹的娱乐性和更强的互动感，但它没有任何实用的状态反馈功能，更多是视觉点缀。

---

2. Desktop Goose（桌面鹅）

Desktop Goose 是 2019 年爆火的恶作剧桌面宠物，以”捣乱”闻名：它会抢走你的鼠标、在屏幕上乱画、用嘴巴拖动窗口。 在 B 站和 Twitter 上掀起过一阵”上班被鹅骚扰”的整活热潮，但本质上是一个恶搞工具。

维度	Petdex	Desktop Goose
核心玩法	工作状态指示 + 社区宠物	故意捣乱，娱乐性恶作剧
生产力影响	正向辅助（减少窗口切换）	负向影响（干扰正常操作）
可定制程度	高（1880+ 宠物选择 + AI 生成）	低（仅一只鹅，少量自定义）
社区生态	活跃，持续增长	基本停止更新
适用场景	日常编程工作、长任务监控	录屏整活、整蛊朋友

Desktop Goose 更适合当作表情包和整活道具，不适合真正的工作场景。

---

3. Tamagotchi（拓麻歌子）/ 数字宠物类 App

Tamagotchi 是 1996 年由万代推出的经典电子宠物，近年来以 App 形式回归移动端。核心玩法是喂食、养育、照顾宠物的生命周期，强调情感连接与责任感。

维度	Petdex	Tamagotchi
主要平台	桌面端（macOS / Windows）	移动端 App + 实体设备
与工作的关系	直接服务于工作效率	独立于工作，需要额外注意力
成长机制	无（宠物形象固定）	有（会成长、死亡、进化）
使用目的	工作状态可视化 + 陪伴感	电子宠物养成，情感投入
社区生态	开源创作者社区	品牌运营为主，UGC 有限

Tamagotchi 的养成机制带来更强的情感依附，但它会占用用户主动注意力，对工作效率是负担而非辅助。

---

4. Live2D 虚拟桌宠（如 VTube Studio 桌宠模式）

以 Live2D 技术驱动的桌面虚拟形象（常见于 VTuber 文化圈），可以实现流畅的 2D 骨骼动画，视觉效果远超像素风格。部分桌宠软件支持摄像头面部捕捉，让角色跟随你的面部运动。

维度	Petdex	Live2D 桌宠
视觉风格	复古像素风，小巧轻量	精细 2D 动画，视觉冲击强
资源占用	极低	较高（需 GPU 渲染）
AI 状态联动	是（核心功能）	否
制作门槛	低（AI 辅助生成）	极高（需专业 Live2D 建模）
开源程度	完全开源免费	商业模型为主，授权复杂
适用人群	程序员、AI 工具用户	VTuber、直播创作者

Live2D 桌宠在视觉表现上碾压像素风，但制作成本极高、资源占用大，与工作流的集成度几乎为零。

---

5. codexpets.org（Codex Pets 社区站）

与 Petdex 最直接的竞争者，同样是为 Codex 宠物功能服务的第三方社区平台。 codexpets.org 的思路有所不同，更侧重于宠物包的技术规范文档和安装流程指导，平台风格偏向开发者向。

维度	Petdex	codexpets.org
宠物数量	1880+，持续更新	较少，偏精选
界面风格	图鉴式，可视化浏览	文档式，偏开发者向
安装方式	AI 提示词一键安装	CLI 工具 + 手动文件操作
中文支持	有（/zh 路径）	无
内容生态	活跃社区，大量 UGC	相对安静，偏工具属性
独立桌面客户端	有（Petdex Desktop）	无

整体来看，Petdex 在内容规模、易用性和社区活跃度上均占优，codexpets.org 则更适合需要深度技术控制的高级用户。

---

背后的技术：像素宠物是如何运转的

Petdex 宠物的核心是一张叫做 Spritesheet 的精灵表格图片。 这张图把宠物所有动画状态的帧整齐排列在一张图里，每一行对应一种状态（如待机、运行中、等待输入、任务完成等），每一列对应该状态下的动画帧序列。

Codex 在运行时读取当前 AI 任务状态，映射到对应的动画行，然后按帧播放，实现宠物”活过来”的效果。 Magenta 背景在运行时被实时抠掉，宠物就变成了一个透明背景的浮层。

自定义宠物的整个 AI 生成流程如下：

1. 用户用自然语言描述宠物，或上传参考图片
2. hatch-pet 技能调用 Codex 的 $image-gen 插件工具
3. AI 按照 Spritesheet 的格式规范生成多状态动画帧
4. 自动打包成 Codex 可识别的宠物包格式，存入本地 Codex 目录
5. 用户在设置里选择即可激活

这套流程把原本需要像素艺术专业知识的创作过程压缩到了几分钟，是 Petdex 生态得以快速膨胀到 1880+ 宠物的根本原因。

---

Petdex 的文化意义

Petdex 的出现，某种程度上是对”工作软件必须严肃”这一默认设定的温柔反抗。在越来越多的工作被 AI 接管的今天，程序员们选择给自己的 AI 助手配一只哆啦 A 梦或者泡泡茶水獭，这件事本身就很有意思。

从更宏观的视角看，Petdex 是一个典型的”工具平台 + 创作者社区”飞轮案例。Codex 提供了技术基础，hatch-pet 降低了创作门槛，Petdex 提供了发行和分发渠道，创作者带来了内容，内容又吸引更多用户，用户中又孵化出更多创作者。这个飞轮在两周内就转到了 1880+，速度相当惊人。

对于长期在高压编程环境中工作的开发者来说，桌面上一只随任务呼吸跳动的像素小伙伴，或许真的能在某个疲惫的深夜带来一点微小的温暖。就像那只在深夜 coding 时陪着你的 QQ 宠物一样，哪怕它只是几十个像素点。