Chtholly for Codex

珂朵莉（Chtholly）Codex v2 桌面宠物。项目包含可直接安装的宠物包、动作与方向预览、完整性校验和自动安装脚本。

这是非官方同人项目，与 OpenAI、Codex 及《末日时在做什么？有没有空？可以来拯救吗？》的权利方无隶属或授权关系。

下载

从 Latest Release 下载 chtholly-codex-pet.zip。

安装

自动安装

克隆本仓库或下载 GitHub 的 Source code，在仓库根目录运行：

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

安装完成后重启 Codex，并在宠物选择界面选中“珂朵莉”。

手动安装

1. 解压 Release 中的 chtholly-codex-pet.zip。
2. 创建 %USERPROFILE%\.codex\pets\chtholly。
3. 将解压得到的 pet.json 和 spritesheet.webp 放入该目录。
4. 重启 Codex，然后选择“珂朵莉”。

目录应为：

%USERPROFILE%\.codex\pets\chtholly\
|-- pet.json
`-- spritesheet.webp

卸载

powershell -ExecutionPolicy Bypass -File .\scripts\uninstall.ps1

动画规格

• Codex 宠物格式：v2
• 图集：8 列 x 11 行
• 单格：192 x 208
• 总尺寸：1536 x 2288
• 标准状态：待机、向右跑、向左跑、挥手、跳跃、失败、等待、工作、检查
• 方向动作：16 个顺时针方向
• 背景：透明 WebP

已知限制

• 每帧播放时长由 Codex 客户端控制，pet.json 不能设置逐帧时长。
• 安装脚本只负责复制宠物文件，不修改 Codex 客户端。

验证

安装 Pillow 后运行：

python -m pip install -r requirements-dev.txt
python .\scripts\validate_pet.py .
powershell -File .\scripts\verify.ps1

当前发布图集已通过尺寸、透明度、有效帧、空白保留格和 SHA-256 校验。GitHub Actions 会在每次提交时重复这些检查。

仓库结构

.
|-- pet.json
|-- spritesheet.webp
|-- dist/
|   `-- chtholly-codex-pet.zip
|-- preview/
|   |-- contact-sheet.png
|   `-- look-directions.png
|-- qa/
|   `-- README.md
`-- scripts/
    |-- install.ps1
    |-- uninstall.ps1
    |-- validate_pet.py
    `-- verify.ps1

许可与权利

仓库中的工具脚本采用 MIT License。角色名称、角色设计和衍生美术不包含在 MIT 授权范围内，详见 ASSET_LICENSE.md。