思诺 · Sinuo — Codex 桌面伙伴

一只免费开源的动画桌面宠物。她住在你的编辑器里,和你在 Codex 里一起写代码 —— 你写码她忙活、等你拍板、构建挂了会失落、跑完一起 review,开心了还会唱给你听。

欢迎大家提建议 / PR！

形态展示 / Showcase

Name	思诺 · Sinuo · Codex Desktop Pet
On codex-pets.net	codex-pets.net/#/pets/sinuo
Install	npx codex-pets add sinuo

Action	Idle	Waving	Running	Waiting	Review
Preview

Action	Running →	← Running	Failed	Singing 🎤
Preview

宣传片(33s · 1080p · 含配乐):renders/sinuo-promo.mp4

---

这是什么

思诺是一只 Codex / AI 编程 agent 桌面宠物:一张 8×9 的精灵图集(sprite atlas)+ 一个 pet.json,共 9 个状态,每个状态一段逐帧动画。它遵循 Codex 的 pet 契约,因此可被 Codex 桌面端的宠物 webview、以及 petdex / clawd-on-desk 这类读取 ~/.codex/pets/ 的桌面悬浮挂件直接渲染。

状态	含义	触发(由 agent 状态驱动)
idle	待机	空闲
running-right / running-left	向右 / 向左跑	移动
waving	打招呼	问候
jumping	(本仓库做成)唱歌 🎤	hover / 互动
failed	失败、失落	构建/任务出错
waiting	等待输入	等你批准/决定
running	工作中	跑任务 / 写代码
review	检查	review 阶段

渲染原理:webview 用 CSS background-position 在固定的 8 列 × 9 行(每格 192×208)上逐帧/逐行播放。状态切行,帧扫列。

安装这只宠物

已上线 codex-pets.net,推荐直接用它的一键命令:

npx codex-pets add sinuo

或从 codex-pets.net 下载并解压到 Codex 目录:

curl -L "https://codex-pets.net/api/pets/sinuo/download" -o /tmp/sinuo.codex-pet.zip \
  && mkdir -p ~/.codex/pets/sinuo \
  && unzip -o /tmp/sinuo.codex-pet.zip -d ~/.codex/pets/sinuo

或从本仓库装 / 手动拷:

# 一键(本仓库脚本)
curl -fsSL https://raw.githubusercontent.com/KillerQueen-Z/sinuo-codex-pet/main/scripts/install-pet.sh | bash
# 或手动
mkdir -p ~/.codex/pets/sinuo
cp pet/sinuo/pet.json pet/sinuo/spritesheet.webp ~/.codex/pets/sinuo/

然后刷新 / 重开 Codex,在宠物选择处选「思诺」。 桌面悬浮挂件(petdex / clawd-on-desk)同样读取 ~/.codex/pets/,装好其一即可让她出现在桌面。

目录结构

.
├── pet/
│   ├── sinuo/                # ★ 可直接安装的宠物
│   │   ├── pet.json
│   │   └── spritesheet.webp  # 1536×1872 · 8×9 · 透明
│   └── preview/              # 各状态预览 GIF
└── scripts/
    └── install-pet.sh        # 一键安装到 ~/.codex/pets/

贡献

欢迎 issue / PR:新动作、表情、配色、其它角色皮肤都行。有任何建议尽管提!

License

代码与脚本以 MIT 开源(见 LICENSE)。

角色「思诺 / Sinuo」属于其原创作者(枝江娱乐);本仓库中的精灵图为 AI 生成的粉丝向二次创作,仅供学习与非商业用途。如有侵权请提 issue,我会处理。