1
取材社区
从 Codex Pets 画廊挑选形象。仓库已预置 15 款，也可自行下载任意社区包。
Overview
从社区画廊到桌面伙伴
Kimi Work 除默认 Rive 形象外，还支持与 Codex 同源的精灵表（v1 为 8×9，v2 为 8×11；192×208 单元格）。v2 的后两行可提供 16 个视线方向。本仓库补齐转换、安装、回滚与互动补丁。
2
一键注入
install.py 负责转换清单、写入应用数据、备份原桌宠，失败可随时 restore。
3
桌面互动
安装即带悬停招手、视线跟随、拖动奔跑。重启 Kimi 后，桌宠会看向你。
New · Codex Pet v2
两只真正会“看向你”的 v2 宠物
Dimo 已从 v1 升级,宵宫则作为全新的 Kimi Work 适配加入。两份包都保留 9 行标准动作,并用最后两行提供从正上方 0° 起、顺时针每 22.5° 一帧的完整方向环。
Dimo（迪莫）
《洛克王国》光属性明星宠物。升级后不再只做整体倾斜,而是直接切换与光标角度匹配的方向帧。
python3 scripts/install.py pets/dimo
Yoimiya（宵宫）
《原神》长野原烟花店店主。完整适配 Kimi Work 状态、互动动作与 16 方向视线跟随。
python3 scripts/install.py pets/yoimiya8 × 11图集网格
192 × 208单帧像素
16视线方向
22.5°方向步进
Interactions
安装即用的六种互动
由安装器自动注入的一组幂等补丁实现,无需额外配置；restore.py 会一并撤销。所有互动只在宠物空闲时触发,不影响工作/等待等任务状态。
01
开机问候
桌宠加载完成后，主动随机播放一个空闲彩蛋动作打招呼——Hiyuki 挥剑，Dimo 摇尾，胡桃眨眼逗幽灵。
02
悬停回应
鼠标悬停时，从素材拥有的空闲彩蛋里随机挑一个回应（招手 / 跳跃 / 眨眼互动），6 秒冷却。
03
点击跳跃
点击或轻点桌宠，它会兴奋地随机跳跃或眨眼，3 秒冷却；停留超过 2.6 秒不放，还会撒娇大哭。
04
气泡信息
任务运行时，头顶气泡追加"已用 N 种工具(Bash、WebSearch、Read…)"与"已工作 X 分钟"，每 15 秒自动刷新，不再只有"正在思考…"。
05
视线跟随
v2 精灵图宠物会根据光标角度切换 16 个方向帧；v1 宠物继续平滑倾斜。离开后回正，Rive 默认形象会自动跳过。
06
拖动奔跑
拖动桌宠时沿方向播放左右奔跑帧；默认 2 倍显示，可点区域在轮廓外再扩 24px，不用对准像素。
Gallery
宠物画廊
15 款预置形象。可按来源筛选，或搜索名字与作者。右侧进入视口后才播放动作 GIF。
显示 15 / 15 款
Dimo(迪莫)
《洛克王国》光属性明星宠物（社区二创）
形象源自腾讯《洛克王国》
python3 scripts/install.py pets/dimo
Siam(暹罗猫)
小体型暹罗猫
python3 scripts/install.py pets/siam
Maomao(大开门)
戴蓝色钩针帽的三花猫
python3 scripts/install.py pets/maomao
Hiyuki
持冰剑的银发红瞳 Q 版少女
python3 scripts/install.py pets/hiyuki
Feixue(绯雪)
冷艳巫女风 Q 版少女
python3 scripts/install.py pets/feixue
GUGUGAGA
企鹅装 Q 版少女
python3 scripts/install.py pets/endminguga
Round Cola Hatch
喝可乐的蓝色圆滚滚机器人
python3 scripts/install.py pets/round-cola-hatch
胡桃(Hu Tao)
《原神》往生堂堂主，带小幽灵
形象版权归米哈游
python3 scripts/install.py pets/hu-tao-pet
Flamy
戴破碎眼镜敲笔记本的红色小火龙
python3 scripts/install.py pets/flamy
Kimlet Move Wave
像素风挥手人物
⚠️ 真人形象戏仿，介意请勿安装
python3 scripts/install.py pets/kimlet-move-wave
Kimlet
带光环挥手人物
⚠️ 真人形象戏仿，介意请勿安装
python3 scripts/install.py pets/kimlet
星见雅(Miyabi)
《绝区零》对空六课狐耳剑士
形象版权归米哈游
python3 scripts/install.py pets/miyabi
薇尔莉特(Violet)
《紫罗兰永恒花园》自动手记人偶
形象版权归京都动画
python3 scripts/install.py pets/violet
咕嘎(Guga)
圆润版企鹅装连帽少女
python3 scripts/install.py pets/guga
宵宫(Yoimiya)
《原神》长野原烟花店店主与火花骑士
形象版权归米哈游
python3 scripts/install.py pets/yoimiyaInstall
三步装上桌宠
需要 Kimi Work 桌面端与 python3。Windows 按 Electron 惯例定位 %APPDATA%\kimi-desktop；找不到时加 --appdata。
- 克隆仓库
git clone https://github.com/caseclose/kimi-work-pets.git - 安装一只宠物（可换成
pets/下任意目录）python3 scripts/install.py pets/dimo - 重启 Kimi，或重新开关桌宠。悬停试试招手，移动鼠标看它转头。
Bring your own pet
安装画廊里的其他宠物
社区包通常含 pet.json 与 spritesheet.webp。转换器会统计每行帧数，并把原清单备份为 pet.codex.json。
- 从 CodexPets.net 或 petdex.dev 下载并解压宠物包。
- 转换：
python3 scripts/convert-codex-pet.py <目录> - 安装：
python3 scripts/install.py <目录>
| 行 | 社区语义 | Kimi Work 状态 |
|---|---|---|
| 0 | idle | 空闲 |
| 1 | running_right | 向右拖动 |
| 2 | running_left | 向左拖动 |
| 3 | waving | 空闲彩蛋 1 |
| 4 | jumping | 空闲彩蛋 2 |
| 5 | failed | 失败 |
| 6 | waiting | 等待确认 |
| 7 | running | 工作中 |
| 8 | react / review | 空闲彩蛋 3（互动，全部宠物已映射） |
布局不符时，用 scripts/inspect_spritesheet.py 逐行确认后再改 pet.json。机制说明见 桌宠机制调研。
FAQ
常见问题
装完没有变化？
完全退出并重启 Kimi Work，或先关掉再打开桌宠。渲染器只在加载时读取配置。
如何回到默认形象？
运行 python3 scripts/restore.py。脚本会使用安装前自动备份，并撤销互动补丁。
Windows 找不到目录？
手动指定应用数据目录：--appdata %APPDATA%\kimi-desktop。各脚本均支持该参数。
能装画廊里没预置的宠物吗？
可以。先 convert-codex-pet.py，再 install.py。转换器会自动识别标准 v1（9 行）与带 16 方向视线帧的 v2（11 行）精灵表。
License
版权与使用边界
本仓库与 Moonshot AI、OpenAI 无隶属或授权关系。素材仅供个人非商业使用。
代码 · MIT
安装器、转换器与补丁脚本按 MIT 开源，详见仓库 LICENSE。
社区原创
siam / maomao / hiyuki / feixue / endminguga / round-cola-hatch / flamy / guga 来自 Codex 社区，版权以各画廊页为准。
第三方 IP
迪莫（腾讯《洛克王国》）、胡桃、宵宫与星见雅（米哈游）、薇尔莉特（京都动画）均为二创展示，权利归原版权方。
戏仿内容
kimlet 与 kimlet-move-wave 含真实公众人物形象。介意者请跳过，勿作商业使用。