Codex Pets × Kimi Work · 开源安装器

Kimi Work 桌宠

精选 14 款 Codex Pets 社区形象,自动转换精灵表、注入悬停招手与视线跟随,兼容 macOS 与 Windows,随时回滚默认桌宠。

14内置宠物
2桌面平台
1 条命令安装
MIT代码开源

Overview

从社区画廊到桌面伙伴

Kimi Work 除默认 Rive 形象外,还支持与 Codex 同源的精灵表(8×9 网格、192×208 单元格)。本仓库补齐转换、安装、回滚与互动补丁。

1

取材社区

从 Codex Pets 画廊挑选形象。仓库已预置 14 款,也可自行下载任意社区包。

2

一键注入

install.py 负责转换清单、写入应用数据、备份原桌宠,失败可随时 restore。

3

桌面互动

安装即带悬停招手、视线跟随、拖动奔跑。重启 Kimi 后,桌宠会看向你。

Interactions

安装即用的四种互动

由三个幂等补丁自动注入,无需额外配置;restore.py 会一并撤销。

01

悬停招手

鼠标悬停时播放 idle_random_1 一个循环后回到待机,6 秒冷却,不影响工作或等待状态。Hiyuki 挥剑,Dimo 挥爪。

02

视线跟随

鼠标在附近移动时,精灵图宠物平滑向光标倾斜;离开后回正。Rive 默认形象自带眼动,补丁会自动跳过。

03

拖动奔跑

拖动桌宠时沿方向播放左右奔跑帧,这是 Kimi Work 的原生行为,安装后继续保留。

04

更大的响应范围

默认 2 倍显示;可点区域在轮廓外再扩 24px,不用对准像素。由页面主动上报可交互区域实现。

Gallery

宠物画廊

14 款预置形象。可按来源筛选,或搜索名字与作者。右侧进入视口后才播放动作 GIF。

显示 14 / 14 款

Dimo(迪莫) 桌宠预览图 Dimo(迪莫) 逐行动作演示
IP 二创洛克王国

Dimo(迪莫)

《洛克王国》光属性明星宠物(社区二创)

作者 swrited · 画廊

形象源自腾讯《洛克王国》

python3 scripts/install.py pets/dimo
Siam(暹罗猫) 桌宠预览图 Siam(暹罗猫) 逐行动作演示
社区原创

Siam(暹罗猫)

小体型暹罗猫

作者 allen · 画廊

python3 scripts/install.py pets/siam
Maomao(大开门) 桌宠预览图 Maomao(大开门) 逐行动作演示
社区原创

Maomao(大开门)

戴蓝色钩针帽的三花猫

作者 kyle · 画廊

python3 scripts/install.py pets/maomao
Hiyuki 桌宠预览图 Hiyuki 逐行动作演示
社区原创

Hiyuki

持冰剑的银发红瞳 Q 版少女

作者 foxibu · 画廊

python3 scripts/install.py pets/hiyuki
Feixue(绯雪) 桌宠预览图 Feixue(绯雪) 逐行动作演示
社区原创

Feixue(绯雪)

冷艳巫女风 Q 版少女

作者 Akira97 · 画廊

python3 scripts/install.py pets/feixue
GUGUGAGA 桌宠预览图 GUGUGAGA 逐行动作演示
社区原创

GUGUGAGA

企鹅装 Q 版少女

作者 Hibik1 · 画廊

python3 scripts/install.py pets/endminguga
Round Cola Hatch 桌宠预览图 Round Cola Hatch 逐行动作演示
社区原创

Round Cola Hatch

喝可乐的蓝色圆滚滚机器人

作者 tsang · 画廊

python3 scripts/install.py pets/round-cola-hatch
胡桃(Hu Tao) 桌宠预览图 胡桃(Hu Tao) 逐行动作演示
IP 二创原神

胡桃(Hu Tao)

《原神》往生堂堂主,带小幽灵

作者 Barometer · 画廊

形象版权归米哈游

python3 scripts/install.py pets/hu-tao-pet
Flamy 桌宠预览图 Flamy 逐行动作演示
社区原创

Flamy

戴破碎眼镜敲笔记本的红色小火龙

作者 inwizzy · 画廊

python3 scripts/install.py pets/flamy
Kimlet Move Wave 桌宠预览图 Kimlet Move Wave 逐行动作演示
戏仿

Kimlet Move Wave

像素风挥手人物

作者 kimehwa · 画廊

⚠️ 真人形象戏仿,介意请勿安装

python3 scripts/install.py pets/kimlet-move-wave
Kimlet 桌宠预览图 Kimlet 逐行动作演示
戏仿

Kimlet

带光环挥手人物

作者 kimehwa · 画廊

⚠️ 真人形象戏仿,介意请勿安装

python3 scripts/install.py pets/kimlet
星见雅(Miyabi) 桌宠预览图 星见雅(Miyabi) 逐行动作演示
IP 二创绝区零

星见雅(Miyabi)

《绝区零》对空六课狐耳剑士

作者 Eric-Terminal · 画廊

形象版权归米哈游

python3 scripts/install.py pets/miyabi
薇尔莉特(Violet) 桌宠预览图 薇尔莉特(Violet) 逐行动作演示
IP 二创京阿尼

薇尔莉特(Violet)

《紫罗兰永恒花园》自动手记人偶

作者 Lazenca · 画廊

形象版权归京都动画

python3 scripts/install.py pets/violet
咕嘎(Guga) 桌宠预览图 咕嘎(Guga) 逐行动作演示
社区原创

咕嘎(Guga)

圆润版企鹅装连帽少女

作者 CIRCUS · 画廊

python3 scripts/install.py pets/guga

Install

三步装上桌宠

需要 Kimi Work 桌面端与 python3。Windows 按 Electron 惯例定位 %APPDATA%\kimi-desktop;找不到时加 --appdata

  1. 克隆仓库
    git clone https://github.com/caseclose/kimi-work-pets.git
  2. 安装一只宠物(可换成 pets/ 下任意目录)
    python3 scripts/install.py pets/dimo
  3. 重启 Kimi,或重新开关桌宠。悬停试试招手,移动鼠标看它转头。

Bring your own pet

安装画廊里的其他宠物

社区包通常含 pet.jsonspritesheet.webp。转换器会统计每行帧数,并把原清单备份为 pet.codex.json

  1. CodexPets.net 或 petdex.dev 下载并解压宠物包。
  2. 转换:
    python3 scripts/convert-codex-pet.py <目录>
  3. 安装:
    python3 scripts/install.py <目录>
社区语义Kimi Work 状态
0idle空闲
1running_right向右拖动
2running_left向左拖动
3waving空闲彩蛋 1
4jumping空闲彩蛋 2
5failed失败
6waiting等待确认
7running工作中
8review未映射

布局不符时,用 scripts/inspect_spritesheet.py 逐行确认后再改 pet.json。机制说明见 桌宠机制调研

FAQ

常见问题

装完没有变化?

完全退出并重启 Kimi Work,或先关掉再打开桌宠。渲染器只在加载时读取配置。

如何回到默认形象?

运行 python3 scripts/restore.py。脚本会使用安装前自动备份,并撤销互动补丁。

Windows 找不到目录?

手动指定应用数据目录:--appdata %APPDATA%\kimi-desktop。各脚本均支持该参数。

能装画廊里没预置的宠物吗?

可以。先 convert-codex-pet.py,再 install.py。标准 9 行精灵表即可自动映射。

License

版权与使用边界

本仓库与 Moonshot AI、OpenAI 无隶属或授权关系。素材仅供个人非商业使用。

代码 · MIT

安装器、转换器与补丁脚本按 MIT 开源,详见仓库 LICENSE。

社区原创

siam / maomao / hiyuki / feixue / endminguga / round-cola-hatch / flamy / guga 来自 Codex 社区,版权以各画廊页为准。

第三方 IP

迪莫(腾讯《洛克王国》)、胡桃与星见雅(米哈游)、薇尔莉特(京都动画)均为二创展示,权利归原版权方。

戏仿内容

kimlet 与 kimlet-move-wave 含真实公众人物形象。介意者请跳过,勿作商业使用。