dsh-pets

English | 中文

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

完全兼容 codex-pets 宠物包格式——任何 V1/V2 精灵图宠物（pet.json + spritesheet.webp）开箱即用。去 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。宠物可拖动到任意位置（视口内夹紧，含气泡空间），位置持久化。

设置

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

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

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

Model Experience

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

KV Cache 影响

无。