dsh-pet：开源DSH WebUI桌面宠物插件
一、dsh-pet是什么
dsh-pet 是面向 DeepSeek Harness（简称DSH）WebUI 的桌宠插件，依托DSH插件体系运行，属于网页内悬浮虚拟桌面宠物组件，并非独立系统级悬浮程序。
项目附带一套完整、可复现的动画素材生产流水线，普通用户不仅可以直接使用成品桌宠，开发者也可以按照流程自制透明动画素材，打包成适配DSH生态的桌宠插件，项目代码采用MIT协议开放，动画素材拥有独立的素材许可文件。
二、功能特色
内置25组透明背景动画资源，包含待机、移动、点击反馈等多种动作，动画循环流畅，无黑底干扰
支持桌宠自由屏幕漫游，会在WebUI可视区域内随机移动，碰到边界自动换向
鼠标拖拽交互，按住桌宠可以自由拖动位置，点击桌宠触发配套反馈动画
配套完整素材制作链路：AI提示词生成画面 → 输出绿幕源视频 → 处理得到透明动画素材 → 打包为DSH插件，全流程可复现
适配DSH插件标准规范，支持dsh1024命令行一键安装、卸载、管理，和DSH WebUI环境深度融合
轻量加载，不占用大量系统资源，仅在DSH网页面板内渲染，不会全局覆盖电脑桌面窗口
三、技术细节
dsh-pet 基于前端Web技术开发，遵循DSH插件开发标准，使用npm进行包管理与分发。
动画素材采用透明序列帧格式，在浏览器Canvas或者DOM元素中渲染；位置信息使用前端本地存储持久化，刷新页面后桌宠位置不会重置。
项目工程使用Node.js环境，源码克隆后执行依赖安装与打包命令，即可编译产出插件产物，编译完成后链接到DSH web配置目录实现本地调试。
插件运行时挂载在DSH WebUI的页面上下文，接收DSH插件调度器统一管理，无法脱离DSH WebUI独立运行；项目仓库单独区分代码许可证MIT与素材许可，动画素材版权规则独立于源码协议，二次分发素材需要阅读ASSET_LICENSE.md。
四、应用场景
DSH WebUI日常使用场景：作为AI开发、代码调试、提示词测试时的网页陪伴小宠物，缓解长时间操作的枯燥感
DSH插件二次开发学习：参考项目的素材流水线，学习DSH生态UI类插件的开发、素材制作、打包流程
自定义桌宠创作：创作者按照项目给出的素材流程，制作专属角色动画，打包成属于自己的DSH桌宠插件分享
演示与生态展示：用于DSH插件生态的功能演示，向其他DSH用户展示Web悬浮交互插件的实现效果
五、使用方法
前置条件
本地已经部署好 DSH / dsh1024 工具链，环境支持npm命令。
在线一键安装（推荐）
npm install -g dsh1024 dsh plugin --profile web add dsh-pet
源码本地编译安装
git clone https://github.com/PC2005-cloud/dsh-pet.git cd dsh-pet npm install npm run build
编译成功后，将产物链接到DSH web配置profile目录，重启DSH WebUI，插件即可加载生效。
安装完成后打开DSH WebUI，桌宠默认在页面内加载，支持拖拽、点击、自动漫游。
六、竞品对比
选取 dsh-whale-pet、Bongo Cat Mver、dsh-pet 三款产品对比
| 项目名称 | 运行载体 | 是否DSH插件 | 素材自定义流水线 | 交互特点 |
|---|---|---|---|---|
| dsh-pet | DSH WebUI网页内 | 是 | ✅ 提供完整可复现素材制作流程 | 基础拖拽、点击反馈、区域漫游，内置25组动画 |
| dsh-whale-pet | DSH WebUI网页内 | 是 | ❌ 无标准化素材流水线 | 动画数量更多，支持AI任务状态联动，动作随大模型执行状态切换 |
| Bongo Cat Mver | 系统级桌面悬浮窗口 | 否 | ❌ 无配套素材生产教程 | 全局桌面悬浮，同步键盘鼠标动作，独立exe程序，和DSH无关 |
七、常见问题解答
问：dsh-pet 可以脱离DSH直接在电脑桌面显示吗？
答：不可以。dsh-pet属于DSH WebUI插件，渲染范围仅限DSH网页面板，不是系统顶层悬浮程序；网上部分衍生版本dsh-dafeiyu等是改造后的系统置顶窗口版本，和原版dsh-pet不是同一个项目。
问：安装插件之后DSH页面看不到桌宠怎么办？
答：先确认dsh1024环境正常、插件安装命令执行无报错；安装完成后需要刷新或者重启DSH WebUI；浏览器需要关闭广告拦截类脚本，部分脚本会拦截页面悬浮DOM元素渲染。
问：我可以拿里面的动画素材做商用吗？
答：源码是MIT协议，但是动画素材拥有独立许可，需要仔细阅读仓库内 ASSET_LICENSE.md 文件，素材使用规则和代码协议分开，商用前确认许可范围。
问：怎么自己制作新的桌宠动画给dsh-pet使用？
答：按照项目文档的素材流水线操作：使用AI生成绿幕视频素材，抠图去除背景得到透明动画序列，再按照插件的素材目录结构替换、打包，重新编译插件即可。
问：dsh-pet支持多宠物同时显示吗？
答：原版仓库默认单只桌宠，原生不支持多宠；想要多桌宠可以安装DSH生态里其他不同的桌宠插件，部分第三方桌宠插件支持多实例。
八、相关链接
项目GitHub仓库：https://github.com/PC2005-cloud/dsh-pet
九、总结
dsh-pet 是轻量化、开源免费的DSH WebUI桌宠插件，兼顾趣味交互和教学价值，既有开箱即用的网页虚拟宠物陪伴能力，也提供一套完整透明动画素材制作方案，适合DSH用户休闲使用，同时也为想要开发DSH生态UI插件的开发者提供了清晰的工程参考。
版权及免责申明：本文由@AI工具箱原创发布。该文章观点仅代表作者本人，不代表本站立场。本站不承担任何相关法律责任。
如若转载，请注明出处：https://www.aipuzi.cn/ai-news/dsh-pet.html
