dsh-pets

Readme

# dsh-pets

[English](README.en.md) | 中文

![dsh-pets 桌面宠物](assets/dsh-pets-demo.png)

Codex Pets 集成插件：一只透明可拖动的桌面宠物，跟随当前会话的工作状态，加一个设置分区用来从本地 pets 目录挑选形象。

**完全兼容 [codex-pets](https://codex-pets.net/) 宠物包格式**——任何 V1/V2 精灵图宠物（`pet.json + spritesheet.webp`）开箱即用。去 [codex-pets.net](https://codex-pets.net/) 发现和安装宠物，然后 `npx codex-pets add <pet-id>`，重启服务后即可在设置分区看到。

节点半边把 `~/.codex/pets`（`codex-pets` CLI 的目录布局，`CODEX_HOME` 可覆盖）服务到 `/ui-pets`：一个清单端点列出已安装宠物，每条精灵图一个路由。浏览器半边从这些同源资源渲染——无 CDN、无 CORS、离线可用。

宠物是标准 Codex V1 精灵图（8 列、192x208 格子、9 个状态行），用 CSS `steps()` 播放：思考显示 `waiting`，工作轮换 `running`/`review`/`running-right`，完成挥手，阻塞失败，空闲轮换小动作。白色气泡显示状态行（思考中、会话标题作为任务内容、或空闲吐槽），下方芯片显示会话的 agent preset。宠物可拖动到任意位置（视口内夹紧，含气泡空间），位置持久化。

## 设置

![dsh-pets 设置分区](assets/dsh-pets-settings.png)

设置分区（导航项"宠物"）分两部分：

- **选择形象** —— 每只已安装宠物一张卡片：带实时动画预览、显示名和宠物 id，选中项有"当前"角标。点击卡片切换桌面宠物；新安装的形象在重启服务后出现。
- **气泡文案** —— 覆盖各状态的气泡文案：思考中、干活中（无任务）、正在（`{task}` 会被替换为任务内容）、需要你、完成，以及空闲吐槽（每行一条）。保存后生效，"恢复默认"还原。

选中项、气泡文案和宠物位置都存于一个 localStorage 键（`dsh-pets.v1`）。

## Model Experience

无：插件只把会话快照投影为悬浮层，不产生提示词内容，也不写任何会话事件。

#### KV Cache 影响

无。