qweqwe12382/dsh-client-ui-pet 预览 preview

qweqwe12382/dsh-client-ui-pet

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

catalog descriptioncatalog 简介 / catalog description:Q pet desktop companion overlay plugin for DeepSeek Harness web GUI (dsh bundle)

Project Overview项目介绍

This is a native desktop pet plugin built exclusively for the DeepSeek Harness (DSH) web interface, packaged with a valid DSH bundle manifest for direct installation. It renders an animated Q-version character that sits on top of the DSH UI, using an inline sprite sheet asset included directly in the bundle. The character automatically changes its expressions, animations, and dialogue bubbles to match the current conversation activity status, covering common states like thinking, reading, editing, working, completed, and error. It is structured as a dual-sided bundle that includes both host-side and browser-side code for DSH’s plugin system.

The plugin is designed for DSH users who want to add a lighthearted decorative element to their agent development interface. After installation, no extra configuration is required to start using the pet. It sits in the bottom right corner of the DSH web interface at all times, and passively senses the conversation state without accessing any raw conversation content. Whenever you run a new task or interact with your agent through DSH, the pet will automatically update its animation and dialogue to match the current step of your workflow.

The plugin is released under the open-source MIT license, with all assets and styles inlined directly into the final bundle as base64, so no external static file routing is needed. You can install it via three different methods: from the npm registry, directly from this GitHub repository, or from a local directory on your own machine. After installation, you will need to restart DSH, wait for hot reload to complete, and refresh your browser page to see the pet appear in the UI. It only depends on React and the official DSH client runtime, which are already included in standard DSH web installations.

这是专为 DeepSeek Harness(DSH)Web 界面开发的原生 Q 版桌宠插件,属于 DSH 生态的趣味功能扩展,自带完整的 DSH 包清单。它使用内置图集渲染帧动画角色,会跟随当前会话的活动状态自动切换角色表情、动作,同时轮换显示对应阶段的对话气泡文案,支持思考、阅读、编辑、工作、回复、完成、出错等多种状态匹配。它是双端一体的插件包,同时提供宿主端和浏览器端适配能力。

这款插件面向喜欢给开发工具添加趣味装饰的 DSH 用户,安装后无需额外配置即可使用。桌宠会常驻 DSH Web 界面右下角,用户使用 DSH 进行会话开发或交互时,桌宠会自动感知当前会话的进度状态切换动作,空闲时进入休息动画,任务完成会触发庆祝动作,出错则显示沮丧状态,每个状态有多句随机轮换的对话文案。用户的显示隐藏偏好会被自动保存。

这款插件采用 MIT 许可开源,所有动画帧和素材都以 base64 形式内联打包进产物,无需额外加载外部静态资源,也不需要额外配置路由。用户偏好设置会保存在浏览器的 localStorage 中,重启浏览器或 DSH 后会保留设置。安装支持 npm、GitHub 或本地目录三种方式,安装后需要重启 DSH 刷新页面才能生效,仅依赖 React 和 DSH 官方运行时。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-client-ui-pet

把 qweqwe12382/dsh-client-ui-pet 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-client-ui-pet

Q 桌宠效果图

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

← 上一个 Prev dsh-sshworkspaces 下一个 Next dsh-plugin-vetting →