dsh-client-ui-pet

DSH（DeepSeek Harness）Web 界面的 Q 桌宠插件：以单张图集帧动画渲染一个 Q 版角色， 跟随当前会话的活动状态（思考 / 阅读 / 编辑 / 工作中 / 回复 / 完成 / 出错）自动切换 表情与动作，并轮换显示对应阶段的对话气泡文案。

双面插件（一个包同时提供宿主与浏览器能力）：

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

安装

# 从 npm 安装
dsh plugin --profile web add dsh-client-ui-pet

# 或从 GitHub 安装
dsh plugin --profile web add github:qweqwe12382/dsh-client-ui-pet

# 或本地目录安装
dsh plugin --profile web add ./dsh-client-ui-pet

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

使用

• 桌宠跟随会话活动自动变化：空闲时 resting，思考 / 阅读 / 编辑 / 工作时对应状态动画， 任务完成庆祝，出错沮丧；每个状态轮换多句对话气泡。
• 气泡与动画帧全部来自内置图集（图片以 base64 内联进 bundle，无静态文件路由）。
• 偏好（显示 / 隐藏）保存在浏览器 localStorage（dsh.ui-pet.v1）。

工作原理

• 宿主：空 apply，仅让组合行可解析。
• 浏览器：通过标准 API client（ctx.get('slots') 等）注册 shell.overlay 插槽； 会话活动经 conversationViews 私有视图投影为纯展示状态（模式 + 阶段 + 语音种子）， 组件只消费该投影，不接触会话原文。产物为 tsdown 生成的闭包工厂 bundle （window.__ModuleLoader__.load），图片与样式全部内联，外部依赖仅 react 与 @deepseek-ai/dsh-client-runtime/client（官方 Web 平台模块）。

License

MIT