前言¶

DSH 支持以插件扩展 Web 界面。dsh-client-ui-pet 是一个 DSH（DeepSeek Harness）Web GUI 插件，用于在页面中添加一个 Q 桌宠浮层。它把当前会话的活动状态映射为 Q 版角色的表情、动作和对话气泡，便于在 Web 页面中获得直观的状态提示。

这是什么¶

dsh-client-ui-pet 由 qweqwe12382 维护，许可证为 MIT。它定位为一枚 Q pet desktop companion overlay for DeepSeek Harness web GUI。

插件分为两半：

• 宿主（lib/index.js）：占位空插件，负责把组合行挂到 profile，无宿主行为。
• 浏览器（lib/client.js）：注册 shell.overlay 插槽的 Q 桌宠浮层，提供图片帧动画、对话气泡与本地偏好持久化。

核心功能¶

下面介绍已确认的能力：

• 以单张图集帧动画渲染一个 Q 版角色。
• 跟随当前会话的活动状态自动切换表情与动作。
• 空闲时显示 resting；思考 / 阅读 / 编辑 / 工作时切换到对应状态动画；任务完成庆祝；出错沮丧。
• 每个状态轮换多句对话气泡文案。
• 会话活动经 conversationViews 私有视图投影为纯展示状态；组件只消费该投影，不接触会话原文。
• 气泡与动画帧来自内置图集；图片以 base64 内联进 bundle，无静态文件路由。
• 显示 / 隐藏偏好保存在浏览器 localStorage，键为 dsh.ui-pet.v1。
• 外部依赖仅 react 与 @deepseek-ai/dsh-client-runtime/client。

安装与启用¶

已核实的安装命令为：

dsh plugin --profile web add github:qweqwe12382/dsh-client-ui-pet

安装后重启 DSH，或等待组合热加载，然后刷新 Web 页面。成功时，页面右下角会出现 Q 桌宠。

典型用法¶

1、安装完成后刷新 DSH Web 页面，在右下角查看 Q 桌宠。

2、观察桌宠随会话活动变化：空闲为 resting，思考 / 阅读 / 编辑 / 工作时切换到对应动画，任务完成显示庆祝，出错显示沮丧。

3、查看对话气泡。每个状态会轮换多句文案，文案与动画帧均来自内置图集。

4、切换显示 / 隐藏偏好后，偏好会保存在浏览器 localStorage 的 dsh.ui-pet.v1 中。

适用场景与注意¶

适合在 DSH Web GUI 中增加会话活动视觉反馈的使用者。它只提供展示状态，不接触会话原文。

使用前注意：

• 宿主半区没有宿主行为，主要能力在浏览器半区。
• 图片以 base64 内联进 bundle，无静态文件路由。
• 偏好保存在浏览器 localStorage，键为 dsh.ui-pet.v1。
• 外部依赖仅 react 与 @deepseek-ai/dsh-client-runtime/client。
• 插件以当前 dsh 进程权限运行；安装前应检查源码与 MIT 许可证。

结尾¶

dsh-client-ui-pet 的价值在于用一套内置图集帧动画，把 DSH 会话活动变成页面右下角的可读状态提示。仓库地址：https://github.com/qweqwe12382/dsh-client-ui-pet