Codex-Cirno

一个适用于 Codex Desktop 的琪露诺（Cirno）动态桌面宠物。

本项目提供可直接安装的 Codex v2 宠物包，以及制作过程中使用的高清角色图、动作序列和方向素材。

这是非官方同人项目，与 OpenAI、上海爱丽丝幻乐团或 ZUN 无官方关联。

预览

动作总览

观察方向

特点

• Codex 宠物图集协议 v2
• 9 组标准状态动画
• 16 个顺时针观察方向
• 每侧 3 片独立冰翼，共 6 片
• 透明 WebP 精灵图
• 针对 192 × 208 单帧尺寸优化的高对比轮廓

安装

Windows（PowerShell）

克隆仓库后，在仓库根目录运行：

$petDir = "$env:USERPROFILE\.codex\pets\cirno"
New-Item -ItemType Directory -Path $petDir -Force | Out-Null
Copy-Item -LiteralPath ".\pet.json", ".\spritesheet.webp" -Destination $petDir -Force

然后重新打开 Codex，或在宠物选择界面重新选择琪露诺。

手动安装

将以下两个文件复制到 %USERPROFILE%\.codex\pets\cirno\：

pet.json
spritesheet.webp

最终目录应为：

%USERPROFILE%\.codex\pets\cirno\
├─ pet.json
└─ spritesheet.webp

宠物规格

项目	值
宠物 ID	cirno
显示名称	琪露诺
图集协议	spriteVersionNumber: 2
图集尺寸	1536 × 2288
单帧尺寸	192 × 208
图集布局	8 列 × 11 行
标准状态	9 组
观察方向	16 个，每步 22.5°

动画状态

行	状态	使用帧数	用途
0	idle	6	待机、呼吸与眨眼
1	running-right	8	向右移动
2	running-left	8	向左移动
3	waving	4	挥手
4	jumping	5	起跳、腾空与落地
5	failed	8	失败或沮丧反应
6	waiting	6	等待用户输入或批准
7	running	6	正在处理任务
8	review	6	检查结果
9–10	look directions	16	连续的顺时针观察方向

目录结构

Codex-Cirno/
├─ README.md
├─ LICENSE
├─ pet.json                 # Codex 宠物元数据
├─ spritesheet.webp         # 可直接安装的 v2 动画图集
└─ assets/
   ├─ previews/             # README 展示图
   │  ├─ contact-sheet.png
   │  └─ look-directions.png
   ├─ design/               # 高清制作素材
   │  ├─ reference/         # 原始参考图
   │  ├─ character/         # 高清主造型
   │  ├─ animations/        # 9 组动作横条
   │  └─ directions/        # 四向锚点与 16 方向横条
   └─ qa/
      └─ validation.json    # 最终精灵图结构检查报告

高清设计素材

assets/design/ 中保存的是生成和组装宠物时使用的高分辨率素材。Codex 实际运行时不会读取这些文件，只使用根目录中的 pet.json 与 spritesheet.webp。

• reference/：用户提供的角色参考图
• character/：统一风格后的角色主造型
• animations/：待机、移动、挥手、跳跃、失败、等待、工作与审阅动作
• directions/：四个基本方向和两组连续方向图

验证

assets/qa/validation.json 是最终图集的结构检查报告。当前图集应满足：

• ok: true
• WebP RGBA 透明格式
• 8 列 × 11 行
• 1536 × 2288
• spriteVersionNumber: 2
• 无结构错误或警告

该报告用于制作和排错，不参与 Codex 动画播放。

更新与卸载

更新时重新复制根目录的 pet.json 和 spritesheet.webp，覆盖本地宠物目录中的旧文件即可。

卸载时删除：

%USERPROFILE%\.codex\pets\cirno

许可与声明

仓库中的代码和项目文件按 MIT License 提供。

琪露诺是《东方Project》系列角色。本项目为个人制作的非官方同人作品；原角色及相关权利归其各自权利人所有。请在再分发角色美术素材前确认适用的同人创作与素材使用规则。