ASOUL Codex Pet

ASOUL 相关的 Codex pet 动画资源集合。

本仓库用于收集多个 ASOUL 相关 Codex pet 资源包。每个 pet 都放在独立目录中，可以直接安装到 Codex，不需要修改 Codex 应用本身。

快速安装

curl -fsSL https://raw.githubusercontent.com/1zumIQ/ASOUL-Codex-Pet/main/install.sh | bash

安装脚本会把仓库中所有有效的 pet 资源包安装到：

${CODEX_HOME:-$HOME/.codex}/pets/

当前资源

Pet ID	Display Name	Description	Status
diana-small_backpack	嘉然 小书包	嘉然 小书包皮肤	✅
bella-brave_newnew	贝拉 Q版奶牛	贝拉 Q版奶牛装	✅
diana-pajamas	嘉然 睡衣	嘉然 睡衣皮肤	☑️
.......

资源包结构

一个有效的 Codex pet 资源包是一个目录，目录内必须包含：

<pet-id>/
  pet.json
  spritesheet.webp

pet.json 中的 spritesheetPath 应指向同目录下的 spritesheet.webp：

{
  "id": "<pet-id>",
  "displayName": "<display name>",
  "description": "<description>",
  "spritesheetPath": "spritesheet.webp"
}

安装脚本会扫描仓库根目录下所有符合该结构的目录，因此新增 pet 时不需要修改脚本逻辑。

手动安装

也可以手动把任意 pet 资源包目录复制到 Codex pets 目录：

mkdir -p "${CODEX_HOME:-$HOME/.codex}/pets"
cp -R <pet-id> "${CODEX_HOME:-$HOME/.codex}/pets/"

如果安装后没有立刻看到新 pet，请重启 Codex 或刷新 pet 列表。

新增资源

1. 创建一个以 pet id 命名的新目录。
2. 在目录内放入 pet.json 和 spritesheet.webp。
3. 确保 spritesheetPath 为 spritesheet.webp。
4. 本地运行 bash install.sh 验证可以安装。
5. 把该 pet 追加到 README 的资源表格中。

License

本项目使用 MIT 协议发布，见 LICENSE。