陪你思考，也陪你发力。
一只绿眼睛、圆肚子、偶尔抱头抓狂的奶蛙，住进你的 Codex。
在线试玩与说明页 · 下载安装包 · 安装指南 · 制作过程
9 种动作 · 16 个看向 · Codex v2 资源包 · 无需 API Key
naiwa 是一个非官方的 Codex 自定义桌宠资源包，带完整的透明动画图集、离线安装脚本和交互预览页。形象参考了奶蛙表情包：黄色圆身体、奶油色肚皮、绿色眼睛、棕色手脚。动画由 AI 辅助生成，再经过固定网格裁切、透明边缘清理和逐帧检查。
它可以发呆、跑步、挥手、蹦跳、抱头抓狂、等你、思考、检查成果，也可以往 16 个方向看。在线页面可以直接切动作，打开「跟着鼠标看」试试它的眼神。
**这是宠物资源包与演示网页，不是独立的系统桌宠程序。**实际桌宠需要支持自定义 v2 宠物的 Codex 桌面应用。网页只演示动作，不读取你的 Codex 对话，也不与任务状态建立连接。
- 从 Releases 下载
naiwa-v1.0.0.zip，先完整解压。 - Windows 双击
install-naiwa.cmd；macOS/Linux 在解压目录运行sh install.sh，或手动复制naiwa文件夹。 - 重新打开 Codex，在支持该功能的宠物选择入口选择 naiwa。不同应用版本的入口可能不同。
默认安装位置是 ~/.codex/pets/naiwa/。设置了 CODEX_HOME 时使用 $CODEX_HOME/pets/naiwa/。重复安装会把旧文件夹备份到 pet-backups，无需管理员权限。
没有 Codex 也能玩：打开解压后的 index.html。请保留旁边的 naiwa 文件夹。详见 安装、更新、恢复与故障排查。
| 发呆 | 向右跑 | 向左跑 |
|---|---|---|
 |
 |
 |
| 挥手 | 蹦跳 | 抱头抓狂 |
|
 |
 |
| 等你 | 思考 | 检查成果 |
 |
 |
 |
| 动作键 | 行号（从 0 开始） | 帧数 | 设计 |
|---|---|---|---|
idle |
0 | 6 | 轻轻呼吸，眨眼发呆 |
running-right |
1 | 8 | 向屏幕右侧跑 |
running-left |
2 | 8 | 右跑逐帧镜像，保持播放次序 |
waving |
3 | 4 | 举手打个招呼 |
jumping |
4 | 5 | 蓄力、腾空、落地 |
failed |
5 | 8 | 抱头抓狂，再缓一缓 |
waiting |
6 | 6 | 等你做决定 |
running |
7 | 6 | 原地摸肚子、摸下巴思考 |
review |
8 | 6 | 抱臂、仔细看看成果 |
running 在这里是工作中动画，与左右移动的动作不同。实际状态调度由宿主应用决定；网页按钮只用来逐项展示。
以屏幕正上方为 0°，顺时针每 22.5° 一个方向；90° 为右、180° 为下、270° 为左。正面中性姿态单独保存在第 0 行第 6 列，不把向上看当成正面。
naiwa/
├── naiwa/ # 安装时只需要这个文件夹
│ ├── pet.json
│ └── spritesheet.webp
├── index.html # 在线 / 离线交互试玩与说明
├── install-naiwa.cmd # Windows 双击入口
├── install.ps1 # Windows 安装、备份与校验
├── install.sh # macOS / Linux 复制安装
├── assets/ # GIF、动作总览、看向总览
├── docs/ # 安装、图集、制作、QA、提示词配方
└── tools/ # 本地图集检查、发布包构建
图集为 1536 × 2288 px / 8 列 × 11 行 / 每格 192 × 208 px / 透明 WebP，清单使用 spriteVersionNumber: 2。共有 57 个标准动作帧、16 个方向帧，以及 1 个中性帧。完整布局与播放节奏见 图集说明。
演示网页不依赖框架、构建步骤或服务器。浏览器直接打开 index.html 即可；也可在仓库根目录启动静态服务：
python -m http.server 8000然后访问 http://localhost:8000。要运行资源检查与打包工具，需要 Python 3.10+ 与 Pillow：
python -m pip install -r requirements-dev.txt
python tools/validate.py
python tools/build_release.py检查工具验证清单、图集大小、使用单元格、透明空格和边缘留白。打包工具按明确的文件清单生成 ZIP 与 SHA-256 校验文件，固定 ZIP 时间戳，避免把本地临时文件带进发布包。仓库没有包含原始社交平台截图、个人路径或登录凭证。
原始 AI 生图具有随机性，不能承诺重新生成像素级相同的结果；对当前已提交素材的验证和发布打包可以重复执行。本仓库公开的是成品素材、预览与安装代码、维护工具和制作说明，未包含原本依赖本机技能环境的完整生图工具链。
- 最终 v2 图集经过格式检查、透明边缘检查和动画预览；跳跃保留了真实的垂直位移。
- 16 个方向进行了独立盲审与标注复核；少数斜向的上下差异比较细微，接受为当前版本风格。详情见 QA 记录。
- Windows 安装脚本经过临时目录中的首次安装、重复安装备份和异常输入检查；macOS/Linux 脚本尚未在真实宿主系统实测。
- 浏览器演示经过实际操作检查。Codex 安装目录已验证，但宿主选择、状态切换和各版本 UI 行为未做端到端验证；如无法显示，请附应用版本反馈。
- 不提供聊天、语音、系统级悬浮窗或后台监控。预览不上传用户数据；加载页面时只请求本站静态文件。
本项目自己的代码和文档使用 MIT License。角色图像为参考奶蛙形象的 AI 辅助同人素材，不纳入 MIT 许可；底层形象相关权利不因本仓库发布而转移，也不宣称拥有独占权或商业授权。详见 ASSETS-NOTICE.md。本项目与 OpenAI 或原角色权利方无官方关联。
欢迎改进预览、安装体验和文档，贡献方式见 CONTRIBUTING.md。
English: naiwa is an unofficial, fan-inspired Codex v2 pet resource pack with nine animation states, sixteen look directions, an offline preview, and backup-aware installers. Code and documentation are MIT-licensed; character artwork is excluded from MIT. Download a release, extract it, and install the naiwa/ folder into your Codex home. A compatible desktop app is required for the actual pet; the browser demo works independently.