你的网页宠物图鉴来了！Codex 动画宠物的开源资源宝库

你是否曾想为自己的网站、博客或开发项目添加一只活灵活现的像素风小宠物？Petdex 就是这样一个专为 Codex 动画宠物生态打造的公共图鉴平台——它不是游戏，也不是插件，而是一个由开发者共建、人人可浏览、可预览、可下载的高质量动画宠物资源站。它解决了「找宠物难、验效果慢、集成不统一」三大痛点，让前端开发者、独立创作者和网页设计师能一键获取开箱即用的交互式宠物资源，真正实现「拖进来就能动」。

核心功能

• 海量精选宠物包在线浏览：所有提交并通过审核的 Codex 兼容宠物均分类展示，支持按名称、作者、风格快速筛选
• 全状态动画实时预览：无需下载即可在浏览器中查看宠物的 idle（待机）、walk（行走）、jump（跳跃）、interact（互动）等全部动画帧与过渡效果
• 灵活下载选项：支持单个宠物 ZIP 包下载（含 JSON 配置+PNG 序列帧），也提供「全图鉴打包下载」，方便本地离线使用或批量集成
• 零门槛提交验证：普通用户也能通过网页表单上传自制宠物包，系统自动校验格式规范（如帧命名、JSON 结构、尺寸一致性），即时反馈错误提示
• 静态站点友好架构：基于 Bun 构建，输出纯静态 HTML + JS 资源，可直接部署到 GitHub Pages、Vercel 或任意 CDN，无后端依赖
• 开箱即用的资源组织：所有宠物文件存于 public/pets/ 目录，打包 ZIP 自动同步至 public/packs/，结构清晰，便于二次开发或自动化集成

适合哪些人用

前端工程师可以用它快速为个人作品集或管理后台添加趣味性交互元素；独立游戏开发者（尤其是像素风或 Web 游戏）可将其作为宠物资源池，节省美术制作时间；UI/UX 设计师能从中获取动效参考与设计语言灵感；教育工作者可借助这些可视化、模块化的动画案例，向学生讲解前端动画原理与资源管理实践；当然，也欢迎所有热爱像素艺术与 Web 创意的爱好者来逛一逛、下一套、传一个——你提交的宠物，明天就可能出现在首页推荐位！

快速上手

如果你只是普通用户，直接访问线上站点（项目已部署为公开网站）即可免费使用：无需安装、无需注册、不收集数据。若你想本地运行、二次开发或贡献代码，只需三步：

1. 确保已安装 Bun（比 npm 更快的 JavaScript 运行时）
2. 克隆项目：git clone https://github.com/crafter-station/petdex.git
3. 启动开发服务器：bun install && bun dev，打开 http://localhost:3000 即可本地体验完整功能

生产构建同样简单：bun run build 生成静态文件，可一键部署至任意托管平台。

项目信息

编程语言：TypeScript｜GitHub Star 数：783｜开源协议：MIT｜GitHub 项目地址

这是一个轻量却充满温度的开源项目——没有复杂配置，只有干净代码、活跃社区与会呼吸的像素宠物。