dsh-pet-companion：DeepSeek Harness 的悬浮桌面宠物

它是做什么的？

DSH Pet Companion 是 DeepSeek Harness（DSH）的桌面宠物插件，把 Agent 的运行状态变成一只悬浮在桌面上的可动宠物。它解决的是「Agent 在后台跑任务时看不见状态」的问题：宠物会在独立的透明窗口里随 DSH 事件切换待机、工作、等待或审核、出错等姿态，即使 DSH 窗口被最小化也依然可见。插件由 hasan-aghayev 维护，采用 JavaScript 编写，内置宠物 Lokki，并支持通过文件夹方式不断扩充本地宠物库。

核心功能

• 独立桌面窗口：宠物拥有自己的可移动透明窗口，DSH 最小化时仍持续显示，并随 Agent 生命周期事件切换姿态。
• 悬浮控件与右键菜单：悬停可打开设置、文本输入框和关闭宠物；右键菜单提供设置、下一只宠物、关闭宠物。
• 侧边栏显隐开关：DSH 侧边栏的 Show pet 可隐藏或恢复宠物而不停用插件，关闭宠物时该开关也会自动关闭。
• 外观与行为设置：可调外观、语言、尺寸、透明度、置顶、减少动效和漫游等选项，默认跟随 DSH 的中英文语言环境。
• 免重装扩充宠物库：把新宠物文件夹放进 Pet library 目录即可自动发现，无需重新构建或重装插件。
• 两种素材格式：支持 Hatch-Pet v2 动画图集，也支持单张透明 PNG/WebP 立绘并附带轻微呼吸动效。

怎么使用这个插件？

在 DSH 中启用后，宠物会以独立桌面窗口出现，需要图形桌面环境，WSL2 用户需启用 WSLg。点击齿轮按钮或双击宠物打开设置，用侧边栏的 Show pet 找回被隐藏的宠物；文本输入框会把消息通过 DSH 公开的 Agent API 发给最近活跃的会话，回车发送、Shift+回车换行。要添加新宠物，从设置里打开 Pet library 文件夹，每只宠物建一个子文件夹，放入 pet.json 清单与素材，文件夹名必须与清单中的 id 一致，几秒内会自动发现，也可点 Refresh 立即重扫。图集需使用 1536×2288 像素、8 列 11 行的规格并声明对应版本号；立绘则声明 portrait 格式与图片路径，图片不超过 25 MiB、尺寸上限 4096×4096。宠物素材、偏好、窗口位置与会话 ID 都保存在本机，插件只观察 Agent 生命周期与审批、提问事件，不读取对话文本、文件或凭据。

报错怎么排查？

宠物窗口打不开时，先确认当前处于图形桌面环境，WSL2 用户需按官方说明启用 WSLg。 新加的宠物没有出现时，检查文件夹名是否与清单里的 id 完全一致、图片路径是否留在宠物文件夹内、图片是否超出体积与尺寸限制，然后点 Refresh 重新扫描。 宠物被隐藏后找不到时，用 DSH 侧边栏的 Show pet 开关恢复；关闭宠物会同时关掉该开关，但插件本身仍处于启用状态。