让白发星冠的小向导，陪你一起完成每一个任务。
以《原神》中的派蒙为原型制作的 非官方同人桌宠。包含 9 组动作、57 帧透明动画，可作为 Codex 的本地自定义宠物安装。素材通过 AI 生成并进行切帧、对齐、透明边缘处理；不包含游戏模型、音频或解包素材。
-
从 Releases 下载
paimon-codex-pet-v1.0.0.zip并解压。安装无需 Python、Node.js 或 API Key。 -
将解压后的整个
paimon文件夹放入以下目录；没有pets文件夹时自行新建：平台 默认位置 Windows %USERPROFILE%\.codex\pets\macOS ~/.codex/pets/如果设置了
CODEX_HOME，使用它下面的pets文件夹。安装后的结构应是：.codex/pets/paimon/ ├── pet.json └── spritesheet.webp -
打开 Codex 设置 → 宠物 → 刷新，选择 派蒙 Paimon，然后输入
/pet唤醒。操作入口以当前应用为准，参见 OpenAI 宠物文档。
也可以让 Codex 帮你安装，把这段话发给它：
请从 https://github.com/lengmodkx/paimon-codex-pet 安装派蒙桌宠。将仓库中的 paimon 文件夹放入我的 CODEX_HOME/pets 目录，默认是 ~/.codex/pets；如果已有同名宠物，请先备份。安装后告诉我如何在设置里选择它。
下载源码或克隆仓库后，在仓库根目录运行。脚本仅复制宠物文件，已有不同版本会先备份到 CODEX_HOME/pet-backups/；重复安装相同文件不会产生备份。脚本不下载或执行远程代码。
Windows PowerShell：
.\install.ps1
# 自定义位置（可选）
.\install.ps1 -CodexHome 'D:\my-codex'macOS：
sh install.sh
# 自定义位置（可选）
sh install.sh "$HOME/my-codex"如果本机策略不允许运行脚本，使用上面的手动复制方式即可。
| 待机 | 向右移动 | 向左移动 |
|---|---|---|
 |
 |
 |
| 挥手 | 跳跃 | 沮丧 |
 |
 |
 |
| 等待回应 | 专注思考 | 查看结果 |
 |
 |
 |
动作由 Codex 的任务状态与交互控制。预览 GIF 按固定顺序演示，不代表应用内所有状态都会连续播放。
- 此版本使用 v1 兼容格式：
spriteVersionNumber: 1，8 列 × 9 行。 - 图集尺寸为 1536 × 1872，单帧 192 × 208，无损透明 WebP。
- 57 个有效单元格，其余 15 个单元格完全透明。
- 不包含 v2 的 16 方向视线。项目版本
v1.0.0和图集格式版本是两个不同概念。 - 已在 Windows 上完成文件安装、图集验证与静态视觉检查；不同平台的实际播放效果欢迎反馈。需要支持本地自定义宠物的桌面应用。
源码包含最终 PNG 母版、生成提示词、离线安装脚本、预览与发布包构建工具。维护工具需要 Python 3.10+ 和 Pillow，普通安装不需要这些依赖。
git clone https://github.com/lengmodkx/paimon-codex-pet.git
cd paimon-codex-pet
python -m pip install -r requirements-dev.txt
python tools/pet.py validate
python tools/pet.py build
python tools/pet.py package --version 1.0.0编辑 assets/spritesheet.png 后运行 build，会重新导出透明 WebP 与预览。提示词和制作过程见 制作说明，贡献指南见 CONTRIBUTING.md。图像生成并非确定性过程；此工具从已提交的 PNG 母版构建，不会调用模型或收费 API。
列表里没有派蒙？ 检查是否多套了一层文件夹，确认 pet.json 直接位于 pets/paimon/ 内；点击刷新，必要时重新打开设置或重启应用。
为什么不动？ 检查操作系统的“减少动态效果”设置，以及当前任务状态。官方文档说明宠物会遵循减少动态效果设置。
怎么更新或卸载？ 更新时重新运行安装脚本，或先备份再替换 paimon 文件夹。卸载时先在应用中收起/切换宠物，再移除 pets/paimon 文件夹。
脚本、配置和文档采用 MIT。图像、动画与含角色形象的素材采用 CC BY-NC 4.0，具体范围见素材说明，允许在维护者可授予的权利范围内署名分享和非商业改作。图片不适用 MIT。
派蒙、《原神》及相关角色、名称和商标的权利属于 miHoYo / HoYoverse 及各自权利人。本项目不代表官方授权、合作或背书，也不授予原角色的知识产权。详见 CREDITS.md。