阿烬 Ajin — Codex Pet

阿烬是一只由温暖火焰凝成的幼态小墨凰：安静、好奇，会轻轻陪在主人身边。

Ajin is a warm little ink-phoenix made of fire—a calm, curious companion for Codex.

动画预览 / Animation preview

闲置 / Idle	打招呼 / Waving	跳跃 / Jumping

向右移动 / Move right	工作中 / Working	查看结果 / Review

等待输入 / Waiting	任务失败 / Failed	向左移动 / Move left

查看完整 11 行动画图集 / Full 11-row contact sheet

在线浏览与下载 / Browse & download online

无需克隆 GitHub 仓库，也可以在 Codex Pets 社区页面预览、分享并下载阿烬：

在 Codex Pets 查看并下载阿烬 →

1. 打开页面，查看动画预览，然后点击 Download sprite kit 下载 .codex-pet.zip 安装包。
2. 解压安装包，把其中的 pet.json 和 spritesheet.webp 放进 ~/.codex/pets/ajin/；Windows 对应 %USERPROFILE%\.codex\pets\ajin\。
3. 重新打开 Codex，在宠物列表中选择 Ajin / 阿烬。网页也提供可复制的终端安装命令。

You can also preview, share, and download Ajin from the Codex Pets community page. Download the .codex-pet.zip package, extract pet.json and spritesheet.webp into ~/.codex/pets/ajin/, then restart Codex and select Ajin from the pet list.

安装 / Install

Windows（PowerShell）

git clone https://github.com/HeftyL/CodexPet_Ajin.git
cd CodexPet_Ajin
powershell -ExecutionPolicy Bypass -File .\install.ps1

macOS / Linux

git clone https://github.com/HeftyL/CodexPet_Ajin.git
cd CodexPet_Ajin
chmod +x install.sh
./install.sh

安装脚本会把 pet.json 和 spritesheet.webp 复制到：

• Windows：%USERPROFILE%\.codex\pets\ajin\
• macOS / Linux：${CODEX_HOME:-$HOME/.codex}/pets/ajin/

也可以手动创建上述目录并复制这两个文件。安装后如果 Codex 没有立即刷新宠物列表，请重新打开 Codex。

The installers copy pet.json and spritesheet.webp into your Codex pets directory. Restart Codex if the pet list does not refresh immediately.

观察方向 / Look directions

阿烬支持 16 个顺时针观察方向。四个基准方向为：

• 000°：上 / up
• 090°：屏幕右侧 / screen-right
• 180°：下 / down
• 270°：屏幕左侧 / screen-left

动画状态 / Animation states

图集行	状态	帧数	用途
0	idle	6 + neutral	呼吸、眨眼、安静陪伴
1	running-right	8	向右拖动 Codex 窗口
2	running-left	8	向左拖动 Codex 窗口
3	waving	4	打招呼或吸引注意
4	jumping	5	轻盈跳跃
5	failed	8	任务失败、取消或受阻
6	waiting	6	等待用户输入或授权
7	running	6	正在处理任务
8	review	6	等待查看或确认结果
9–10	look directions	16	顺时针观察方向

技术规格 / Technical details

• Codex pet schema：spriteVersionNumber: 2
• 图集：8 列 × 11 行
• 单元格：192 × 208
• 总尺寸：1536 × 2288
• 格式：RGBA WebP
• 透明背景，无隐藏 RGB 残留
• 已通过 v2 图集、透明度、方向语义、连续性和独立视觉 QA
• Packaged validation result: 0 errors, 0 warnings

仓库根目录中的 pet.json 与 spritesheet.webp 是完整安装包；assets/ 只用于 README 演示。

卸载 / Uninstall

删除对应目录即可：

~/.codex/pets/ajin/

Windows 路径为 %USERPROFILE%\.codex\pets\ajin\。

License

代码、配置与视觉资源以 MIT License 发布。欢迎个人使用、修改与再分发；保留许可证文本即可。

Code, configuration, and visual assets are released under the MIT License.