前言¶
DeepSeek Harness（DSH）把对话、工具与插件叠在同一套 Web 界面里，长时间盯屏写 prompt、跑任务时，界面往往只有日志和输入框。若你希望在不动核心业务的前提下给工作区加一点「存在感」——待机动画、可拖拽的小窗、偶尔一句碎碎念——需要一种只挂插件、不改 DSH 核心的做法。社区目录里的 dsh-pet（维护者 ggxx001，分类 趣味换装）就是面向这类需求的桌宠插件：默认是一只「吃白饭的蓝色大肥鱼」，赖在 Harness 里，也能 optionally 跑到桌面透明置顶小窗。
下面介绍它是什么、能做什么，以及如何按官方文档安装与日常使用。
这是什么¶
dsh-pet 是发布在 npm 上的 DSH 插件包（当前资料中版本 0.3.8），定位为 DeepSeek Harness Web UI 上的浮动桌面宠物：待机呼吸、随机动作（资料称约 97 段透明动画，如打瞌睡、玩魔方、写代码、吃火锅等）、屏幕漫游、点击与拖拽物理、右键菜单点播动作，并可配合余额展示、系统通知、碎碎念与对话。插件声明 platform: DeepSeek Harness Web，与 Cordis 插件机制集成；浏览器端与可选的 Electron 桌面 Helper 共用 src/shared/ 里的逻辑，行为对齐。
社区插件目录页：https://www.skillhub.cn/plugins/ggxx001/dsh-pet。源码与详细说明见 GitHub：https://github.com/ggxx001/dsh-pet（package 元数据中 homepage 亦指向同名文档仓库 lineage）。DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
动画与交互¶
- 透明动画链：段与段按权重衔接（默认 idle / turn / move 与随机动作池），双缓冲 video 交叉淡入；Chrome / Edge / Firefox 与桌面模式（Electron）播放包内 VP9-alpha
.webm。 - 漫游与朝向：沿 facing 方向行走并做边界检查；动画 CSS 镜像支持左右朝向。
- 点击与拖拽：点击有随机回应与 Q 弹挤压；拖拽为过阻尼弹簧跟手，松手后可按轨迹估速甩抛、碰壁反弹、落地摩擦；物理参数可在配置
physics段调整（资料 0.2.5 起），设置页提供图形化编辑。 - 右键菜单：浏览器与桌面共用菜单组件；可回到初始位置、重载配置（桌面）、按分类点播动作；桌面端另有打开 DSH 站点 / 查看余额等项（具体文案随宿主略有差异）。
碎碎念、对话与余额¶
- 碎碎念：按
eventsRefreshSec.whisper周期（默认 300 秒）调用当前会话所用模型生成，默认开启，可按宠物关闭pets[].whisperEnabled；右键可立即催一句。 - 对话：右键「对话」或
/chat <消息>；记忆写在$DSH_HOME/dsh-pet/memory.json，浏览器与桌面共享。 - 余额展示：可按档位播动画并显示联想气泡，每只宠物可独立开关。
- 模型成本：资料明确——除主动开启碎碎念或发起对话外，运行时默认 零 LLM/API 调用；表情包配图开关
whisperImageEnabled/chatImageEnabled会增加 prompt 体量，需自行权衡。
多开、桌面模式与扩展¶
- 多宠物：设置页可配置多只，各自 id、大小、位置、显示位置（仅浏览器 / 仅桌面 / 两者 / 隐藏）。
- 桌面模式：默认
display: "both"时，浏览器 overlay 与透明置顶小窗各一份；本机无 Electron 时插件可能从~/.dsh/electron拉取运行时（仅影响桌面端，浏览器端仍可用）。 - pet pack：可在
pet/下增加新种类；自定义动画可放入main-animation/webm/（用户目录优先于包内素材）。 - 独立运行：不打开 DSH 时可用
npx dsh-pet-standalone（见 README「独立运行」章节）。
macOS Safari 透明通道¶
Safari / WKWebView 对 webm alpha 支持不足时，需将 HEVC-with-Alpha 的 .mov 放入 $DSH_HOME/dsh-pet/main-animation/mov/（素材发布页见 README 中 assets-mov release）；未放置时退回 webm（可能黑底但不停播）。
安装与启用¶
桌面应用（Electron 版）：在应用内「插件管理」安装框填写包名，无需开终端：
dsh-pet
dsh web 用户在终端执行（资料原文命令）：
dsh plugin --profile web add dsh-pet
装完后必须重开桌面应用或重启 dsh web 才生效。宠物默认出现在界面右上角（角落可在设置页修改）；动画开箱即用，无需额外生成流程。
首次启用且选择「浏览器 + 桌面」时，可能先看到浏览器内宠物，桌面 Helper 在后台准备 Electron 后再出现第二份实例；若只想保留一处，在设置页或宠物右键「显示位置」中切换即可。
典型用法¶
- 安装并重开 DSH，确认 Web 角落实体可点、可拖。
- 右键宠物 → 动作，按分类点播移动或随机动作，观察漫游与边界行为。
- 需要陪聊时：右键「对话」或输入
/chat 你好；不需要模型消耗时，在设置里关闭对应宠物的whisperEnabled。 - 只看余额：右键「查看余额」（桌面）或等待周期触发，确认气泡与档位动画。
- 长期桌面陪伴、不开 Harness：按 README 使用
npx dsh-pet-standalone（需自行阅读该节环境与限制）。 - Safari 用户：按上文路径补全
.mov后刷新页面。
配置持久化在 DSH 用户目录下（如 $DSH_HOME/dsh-pet/）；改动物理、多宠物、通知开关等以设置页与 README「配置」章节为准。
适用场景与注意¶
适合谁：希望在 DSH 工作或调试 Agent 时保留轻量陪伴感、又不把天气/监控等业务塞进插件的开发者；需要余额一眼可见、偶尔跟宠物对话的用户也可选用。
使用前请知悉：
- 插件随 当前 DSH 进程权限 运行，安装前建议阅读源码与许可证（资料中 LICENSE 链至 GitHub 仓库）。
- 碎碎念、对话会走当前会话模型，注意额度与隐私；对话记忆默认全量落盘，仅请求时截取最近
chatMemoryRounds轮。 - 桌面模式涉及 Electron 下载与透明窗交互，失败时通常只影响桌面端，不影响浏览器内宠物。
- 社区目录信息与 npm 包 dsh-pet 以 README / package 为准；勿凭插件名自行拼接未在文档出现的
dsh plugin add github:...安装串。
结尾¶
dsh-pet 把透明动画桌宠、可选桌面置顶窗、余额与轻量 LLM 互动收进一个 DSH 插件，默认不打扰核心工作流，又能在空闲时提供可配置的陪伴与展示。若要从目录了解归类与简介，可打开 SkillHub 插件页；实现细节、配置字段与进阶定制见 GitHub 仓库 README。
