English | 简体中文
一个会跟着 Kimi Code 一起上班的 3D 桌面宠物。
KPet 读取 Kimi Code 的会话与工具事件，把终端里的工作过程变成桌面角色的动作和状态。它既是陪伴型桌宠，也是一个随手可用的 Kimi Code 会话入口：单击会话就能唤起终端，或在浏览器里打开 Kimi 的 Web 界面。
- 空闲时进入
Idle，随机眨眼、东张西望，偶尔悄悄看向鼠标。 - 提交请求后进入
Working，用工作动画回应 Kimi Code 的执行状态。 - 支持多个会话同时运行：只要任一会话仍在工作，宠物就保持忙碌；全部结束后回到待机状态。
- 会话或渲染进程短暂断开时保留最后状态，重新连接后自动恢复。
- 单击宠物打开或收起会话面板；面板为网页 UI（基于 CEF 渲染），展示历史会话与活跃会话，并标记工作状态和未读回复。
- 单击任意会话即可打开到对应的 Kimi Code 上下文：按「打开会话方式」设置唤起终端，或在浏览器中打开 Kimi Web 界面。
- 面板跟随宠物定位，在屏幕边缘自动调整方向，并适配多显示器与 DPI 缩放。
Ctrl+,打开或收起设置面板（光标需停在宠物本体上）。- 打开会话方式：
CLI（唤起 kimi 终端）或Web（用系统默认浏览器打开 Kimi Web 界面）。 - 面板主题三选一：深色玻璃
dark-glass、浅色极简light-minimal、可爱宠物cute-pet。 - 显示帧率：在宠物旁浮层分别展示 3D 渲染与页面 UI 的实时帧率。
| 操作 | 效果 |
|---|---|
| 左键单击宠物 | 打开或收起会话面板 |
| 左键拖拽宠物 | 移动桌面位置 |
| 长按（约 0.8 秒且未拖动） | 不触发任何动作 |
R 加左键拖动 |
调整观察角度 |
R 加鼠标滚轮 |
拉近或拉远观察距离 |
ESC 加左键单击 |
关闭宠物 |
Ctrl + , |
打开或收起设置面板 |
宠物窗口始终置顶，但不会抢走当前应用的焦点。只有角色实际显示的像素会接收鼠标操作，周围透明区域可以直接点击穿透到桌面。
- 随 Kimi Code 会话按需启动，不注册系统服务，也不需要手动维护后台进程。
- 宿主事件转发失败时不会阻塞会话，事件暂存到
%TEMP%\kpet-events，恢复后继续处理。 - 渲染进程失联时自动重连；异常退出由守护进程按 1s / 2s / 4s / 8s（封顶 8s）退避重启，60 秒窗口内最多重启 5 次。
- Windows Terminal 不可用时，自动回退到
cmd打开会话。
| 组成 | 主要技术 |
|---|---|
| 桌宠渲染 | Unreal Engine 5.8、C++、Scene Capture、RHI、GPU Readback |
| 界面 | Slate、WebUI |
| 进程间通信 | Windows 命名管道、UTF-8 JSON、协议版本 1 |
系统采用「事件转发器 → 守护进程 → UE5 渲染进程」三进程结构：转发器（kpetd.exe --relay）生命周期极短，负责把插件事件转发给常驻的守护进程（kpetd.exe --daemon）；守护进程维护会话状态，并拉起与守护渲染进程（Pet.exe）。渲染链路、插件事件、通信协议与源码结构见 技术文档。
KPet 面向 Windows 11，并与 Kimi Code 集成，支持 Windows 原生与 WSL 两种部署形态。
原生支持。解压插件包后，在插件根目录内运行：
powershell -NoProfile -ExecutionPolicy Bypass -File deploy.ps1脚本会自检包完整性并停止旧版守护进程。随后在 Kimi Code 会话里执行：
/plugins install <插件目录>
之后 /reload 或开新会话即可生效。
若你在 Windows 的 Git Bash / MSYS 环境里，
deploy.sh会提示改用原生入口deploy.ps1。
「形态一」指：你在 WSL 里使用 Kimi Code，但桌宠的守护进程、渲染进程和宠物窗口都运行在 Windows 桌面上。两端通过 WSL interop 打通，不需要在 WSL 里装任何图形环境。
按以下步骤安装：
-
准备插件包。两种位置都可以，二选一：
- 在 Windows 侧解压（例如解压到
C:\kpet），WSL 里通过/mnt/c/kpet访问； - 或把
kpet.zip拷进 WSL 后用unzip解压到家目录等 WSL 本地路径。
- 在 Windows 侧解压（例如解压到
-
运行部署脚本。在 WSL 终端里进入插件根目录（即含
deploy.sh的那一层），执行：sh deploy.sh
脚本会依次完成：自检包完整性（
bin/kpetd.exe、renderer/Pet.exe等是否存在）、给bin/kpet-relay.sh补可执行位（zip 解压会丢失权限位）、把 WSL 版插件清单kimi.plugin.wsl.json就位为kimi.plugin.json（原 Windows 版备份为kimi.plugin.json.bak）、停止旧版守护进程。脚本幂等，可重复运行。 -
安装插件。在 WSL 的 Kimi Code 会话里执行（路径用 WSL 内看到的路径）：
/plugins install <插件目录>例如在 Windows 解压到
C:\kpet，则填/plugins install /mnt/c/kpet。随后/reload或开新会话生效。
生效后的运行链路：Kimi Code 的事件 hook 执行 WSL 侧的 bin/kpet-relay.sh，脚本经 WSL interop 直接启动 Windows 侧的 bin/kpetd.exe 守护进程；守护进程首次拉起 renderer/Pet.exe，宠物随即出现在 Windows 桌面。如果希望单击会话时唤起 WSL 终端，把配置项 terminal 设为 wsl（见「配置说明」）。
- macOS：目前只有 Windows 构建产物，部署脚本会明确拒绝。
- 普通 Linux：KPet 是 Windows / WSL（形态一）产品，不支持直接部署。
打开会话方式、面板主题、帧率浮层这三项常用设置，直接在设置面板（Ctrl+,）里修改即可，改动会自动写回 %KIMI_CODE_HOME%\kpet\config.json（未设置 KIMI_CODE_HOME 时路径回退到 %USERPROFILE%\.kimi-code\kpet\config.json）。
设置面板未覆盖的配置项仍需手动编辑该文件（文件不存在或字段缺失、类型非法时逐项使用默认值）：
terminal：唤起终端的方式，wt（Windows Terminal）、cmd（传统控制台）或wsl（WSL 终端，见上文 WSL 部署）。open_web_url：web 目标下的 URL 模板，支持{session_id}占位符；指向回环地址时，会确保本地kimi web服务可用（端口空闲则自动拉起，被占用则校验为同一 home 实例后直接进入；异构占用自动顺延端口），并拼上#token=免密进入 Web UI。renderer_path、心跳与重启参数、session.staleMinutes/cleanupMinutes、log_level等。
完整配置项、默认值及运行时文件位置（日志、宠物窗口状态、事件暂存）见 技术文档 的「数据与配置」章节。
KPet 由 bridge/（TypeScript 转发器与守护进程）和 Pet/（UE 5.8 C++ 工程）两部分构成。源码结构、开发环境要求、构建与测试步骤见 技术文档 的「源码结构」「开发环境」「构建与测试」章节。
基于 MIT 发布。
K 仔（KPet）为社区开源项目，与所使用技术栈、大模型无隶属关系。
Linux.do：感谢社区提供的交流平台。