项目概览
Petdex 是一个面向 OpenAI Codex CLI 的动画宠物公共画廊平台，由 crafter-station 组织维护。它解决了 Codex 宠物散落在 GitHub、Reddit 等各处，缺乏统一浏览、预览和安装入口的问题。平台提供公共画廊，支持按类型、颜色、风格分类浏览，每个宠物可预览所有动画状态。用户可通过 npx petdex install <name> 一行命令安装宠物。宠物由社区创作和提交，平台提供自动审核（OpenAI LLM）与人工审核双重机制。此外，平台支持合集（Collections）、排行榜、个人图鉴以及社区宠物请求匹配功能。技术栈为 Next.js 15 + TypeScript + Bun + Drizzle ORM + Neon Postgres + Cloudflare R2 + Clerk 认证，采用 MIT 开源协议。截至 2026 年 5 月，平台已收录 1146+ 个社区提交的宠物。
解决什么问题
Petdex 主要解决 OpenAI Codex CLI 自定义动画宠物缺乏集中浏览和分发平台的问题。在 Petdex 出现之前，Codex 宠物的获取方式非常原始：用户需要在 GitHub 搜索 "codex pets" 从零散仓库手动下载，或通过 Reddit/X、Discord 等社交媒体分享，手动复制文件到 Codex 配置目录，缺乏版本管理和来源追溯。具体痛点包括：没有集中的宠物市场导致发现困难；下载前无法预览宠物动画效果；安装需要手动下载 ZIP、解压、放到配置目录、修改配置文件，步骤多且容易出错；没有审核机制，用户可能下载到格式错误、动画损坏甚至包含恶意代码的宠物包；创作者缺乏展示平台和安装量统计，创作动力不足；宠物被反复传播后原始创作者信息丢失，缺乏来源标注和署名机制。
工作方式
Petdex 是一个社区驱动的平台，宠物由社区创作和提交。每个 Codex 宠物是标准化的 ZIP 包，包含 config.json（宠物元数据）、spritesheet.png（精灵图）、states/（动画状态定义）和 meta.json（创作者信息）。宠物提交后，前端先进行格式校验，然后写入 submitted_pets 表（status: pending），接着由 OpenAI LLM 自动审核格式合规性和内容安全性，审核结果分为 approve、reject 或 needs_review，后者需要管理员人工审核。审核通过后写入公共宠物表，并触发请求匹配：用 Gemini Embedding 计算向量相似度（阈值 0.70），匹配 Top 5 开放请求，管理员从候选队列中确认最终匹配。安装机制为 npx petdex install <name>，CLI 查询 API 获取宠物包 URL（存储在 Cloudflare R2），下载 ZIP、解压验证、复制到 Codex 配置目录并更新配置。技术栈包括 Next.js 15 + React + Tailwind + shadcn/ui、Bun、Drizzle ORM、Neon Postgres、Clerk 认证、Cloudflare R2 存储、Upstash Redis 限流、OpenAI API 审核、Gemini Embedding 匹配、Resend 邮件通知以及 Discord Bot。项目提供三种开发模式：Mock（零配置，用 PGlite 和 Clerk Stub）、Docker（接近真实环境）、Full（完整服务）。
核心能力
- 公共画廊，按类型/颜色/风格分类浏览
- 每个宠物可预览所有动画状态
- 一行命令
npx petdex install <name>安装 - 支持社区提交、自动审核与人工审核
- 支持合集（Collections）、排行榜、个人图鉴
- 支持宠物请求与自动匹配（Gemini Embedding）
- 提供三种开发模式（Mock/Docker/Full），贡献门槛低
- 采用 MIT 开源协议
使用前需要了解
- AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
- Petdex 仅支持 OpenAI Codex CLI，不支持 VS Code、Cursor 等其他编辑器。平台上的宠物多为用户创作的同人作品，Petdex 明确声明不声称拥有底层 IP，因此不适合需要商用级别 IP 授权的场景。LLM 自动审核可能漏判，人工审核依赖维护者时间。项目为 MIT 开源且无明显商业模式，长期维护存疑。目前社区规模较小（11 个贡献者），活跃度集中在少数人。本质上是个"皮肤商店"，功能天花板明显，不适合对编程环境严肃性有极高要求的场景。
