🍵🐊 MatchaDandan

会陪你一起写代码的抹茶绿色 Codex 桌面宠物

😏 Cheeky · 🌿 Gentle · ☀️ Sunny

MatchaDandan（抹茶旦旦）是一只抹茶绿色、圆滚滚的小鳄鱼。这个仓库收录它的不同性格分支；每个版本都是可独立安装的 Codex v2 动画宠物。

✨ 选择你的旦旦

风格	气质	显示名	Pet ID
😏 Cheeky v1	慵懒、微丧，还有一点欠欠的可爱	MatchaDandan	matchadandan-cheeky
🌿 Gentle v1	温柔快乐、轻松治愈	MatchaDandan · Gentle	matchadandan-gentle
☀️ Sunny v1	明朗呆萌、欢快又有活力	MatchaDandan · Sunny	matchadandan-sunny

😏 Cheeky v1 — 慵懒微丧

经典的抹茶旦旦：半眯眼、慢节奏，偶尔露出一点欠欠的神情。

打开版本目录

🌿 Gentle v1 — 温柔治愈

自然腮红、奶油抹茶绿和柔和手绘质感，让工作过程更轻松。

打开版本目录

☀️ Sunny v1 — 明朗欢快（最新）

大圆眼、桃色腮红和开心小笑是默认表情；挥手与跳跃高潮会短暂露齿。

打开版本目录

📦 安装到 Codex

先下载或克隆本仓库，然后选择一个版本。Codex 运行宠物时只需要该目录中的 pet.json 和 spritesheet.webp；两者必须来自同一个版本。

风格	$variant	$petId
😏 Cheeky v1	MatchaDandan-Cheeky-v1	matchadandan-cheeky
🌿 Gentle v1	MatchaDandan-Gentle-v1	matchadandan-gentle
☀️ Sunny v1	MatchaDandan-Sunny-v1	matchadandan-sunny

🪟 Windows（PowerShell）

在仓库根目录打开 PowerShell。下面默认安装 Sunny v1；安装其他风格时替换前两行即可。

$variant = "MatchaDandan-Sunny-v1"
$petId = "matchadandan-sunny"
$target = Join-Path $HOME ".codex\pets\$petId"

New-Item -ItemType Directory -Force -Path $target | Out-Null
Copy-Item ".\$variant\pet.json", ".\$variant\spritesheet.webp" -Destination $target -Force

🐧 macOS / Linux

variant="MatchaDandan-Sunny-v1"
pet_id="matchadandan-sunny"
target="$HOME/.codex/pets/$pet_id"

mkdir -p "$target"
cp "$variant/pet.json" "$variant/spritesheet.webp" "$target/"

✅ 完成安装

1. 完全退出并重新打开 Codex，让应用重新扫描自定义宠物。
2. 打开宠物选择器，选择对应的 MatchaDandan、MatchaDandan · Gentle 或 MatchaDandan · Sunny。
3. 更新已有版本时，请同时覆盖 pet.json 和 spritesheet.webp，然后再次重启 Codex。

preview.png、validation.json 和版本目录中的 README.md 用于预览与质量说明，不是运行必需文件。

🎬 动画与格式

每个版本都包含：

• 9 个标准状态：idle、running-right、running-left、waving、jumping、failed、waiting、running、review
• 顺时针连续的 16 个注视方向
• Codex pet v2 RGBA 图集：8 列 × 11 行，1536 × 2288 px
• 单格尺寸：192 × 208 px
• 确定性验证报告与完整预览

🗂️ 目录结构

MatchaDandan/
├── MatchaDandan-Cheeky-v1/
│   ├── pet.json
│   ├── spritesheet.webp
│   ├── preview.png
│   ├── validation.json
│   └── README.md
├── MatchaDandan-Gentle-v1/
│   └── ...
├── MatchaDandan-Sunny-v1/
│   └── ...
├── LICENSE
└── README.md

📄 License

本项目使用 MIT License。