前言¶

DeepSeek Harness（DSH）把智能体框架与 UI 分离，插件通过 slot 注入自己的界面。对开发者来说，这带来两点现实问题：一是需要在框架里自己实现 UI 挂载点与样式；二是想把界面做得贴合框架，又不想引入庞大的 UI 框架。dsh-pet 插件用一种更轻量的方式解决了这两点——它在 DSH 窗口右下角提供一个“桌宠”，既嵌入框架，又不干扰主会话。下面介绍这个插件。

这是什么¶

dsh-pet 是为 DeepSeek Harness 提供的桌面陪伴插件，由维护者 zuoyunlai 开发，在 DSH 网页界面右下角展示一只可交互的宠物。它提供四只超写实立绘，每只拥有不同的性格与台词，支持表情与动作切换、语音对话、独立输入框单聊。插件通过 slot 挂载到 shell.overlay 和 conversation.input.right，所有交互仅发生在 DSH 窗口内部。

核心功能¶

• 四只超写实立绘：薇（violet）、绯（crimson）、靛（indigo）、雪（silver）。每只立绘有 5 种表情：默认 / 开心 / 害羞 / 生气 / 睡觉。表情切换采用 240 ms 淡入淡出，而不是硬切。
• 动作序列：每只立绘包含舞蹈、甩发、行走三组动作，每组 3 帧以 340 ms 帧率播放。插件支持 WebM 动态视频剪辑作为动作源。
• 主动说话：插件按情绪（idle / walk / dance / shy / angry / sleep / talk / happy）加载台词包，支持气泡与语音双输出。情绪权重由每只立绘的 temper 表决定。
• 独立输入框：右下角提供小输入框，用于与宠物单独对话。输入内容通过 POST /dsh-pet/chat 发送给宿主，宿主用一次性 ctx.llm.stream() 调用，不写入任何 DSH 会话，也不会在会话日志中出现。默认模型为 deepseek-account / deepseek-flash，其余参数（provider、model、maxTokens、temperature）可在插件配置中调整。
• 语音：支持可选的神经语音与系统语音。如果宿主安装了 Python 与 edge-tts，插件通过 /dsh-pet/tts 合成语音并缓存；否则回退到浏览器的 speechSynthesis。插件本身不依赖运行时库。
• 鼠标跟随：瞳孔跟随鼠标移动，通过 CSS 变量实现，不触发重新渲染。
• 特效与事件钩子：支持墨水、彩带、云雾、炸弹与屏幕裂纹等视觉特效。彩带在单轮对话超过 4 秒时触发，工具调用失败时出现云雾。
• 语言支持：UI 面板、立绘标语与聊天提示语跟随浏览器语言，内置 en / zh / es / pt / hi。每只立绘还附带英文台词包，非中文 UI 会听到英文。
• 设置面板：分组（外观 / 语音 / 显示 / 动作 / 特效），使用自定义下拉与开关，固定在视口不跟随宠物移动。

安装与启用¶

插件通过 npm 发布为 dsh-pet-plugin，也可从本地目录安装。安装前请确保已安装 DeepSeek Harness 0.2.1-alpha.2 或更高版本。

从 npm 安装：

dsh plugin --profile desktop add dsh-pet-plugin

从本地检出安装：

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

安装前应先退出 DSH，因为配置文件需要 HMR 监听。安装完成后，插件会自动在 DSH 窗口右下角显示立绘入口。

启用神经语音需要宿主环境有 Python 并安装 edge-tts：

pip install edge-tts
export DSH_PET_PYTHON=/path/to/python

典型用法¶

• 切换立绘：在设置面板中从下拉列表选择薇、绯、靛或雪。
• 调整情绪：立绘会根据行为（行走、跳舞、害羞等）自动切换情绪，也可在面板中手动调整。
• 与宠物对话：点击右下角立绘旁的小输入框，输入内容后发送，宠物会用一次性 LLM 调用回复，不会影响当前会话。
• 开启语音：确保 Python 环境中安装了 edge-tts，插件会通过 /dsh-pet/tts 合成语音并缓存。

适用场景与注意¶

• 适合在 DSH 中增加陪伴感，但不影响主会话的稳定性。
• 插件以当前 DSH 进程权限运行，请从可信源安装并检查源码与许可证。
• 插件需要 DSH 0.2.1-alpha.2 及以上版本，以及 webServer 服务与 shell.overlay、conversation.input.right slot。
• 神经语音需要宿主 Python 环境支持，否则仅使用系统语音。
• 插件通过本地 HTTP 端点提供路由，安全模型对 Host、Origin 与 Sec-Fetch-Site 进行多重校验，防止外部调用。

小结¶

dsh-pet 通过 slot 注入的方式，在 DSH 窗口内提供一只可交互的桌面宠物，具备超写实立绘、表情与动作序列、主动说话、独立输入框与可选神经语音。它不占用主会话资源，适合希望在 DSH 中增加陪伴感的开发者与用户。

参考资料¶

• 插件目录：https://www.skillhub.cn/plugins/zuoyunlai/dsh-pet-plugin
• GitHub：https://github.com/zuoyunlai/dsh-pet-plugin