zealot00/dsh-pet

Name: zealot00/dsh-pet
Author: zealot00

Desktop桌面端 Native原生 ⭐ 3 Pets & Fun桌宠与娱乐 Clients & Launchers客户端与启动器 UI & Themes界面与主题

面向DeepSeek Harness Web UI的桌面宠物：精灵动画、代理状态联动、拖拽、闹钟和番茄钟小部件、皮肤分离

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-pet is a native plugin built exclusively for the DeepSeek Harness (DSH) WebUI client. It adds an interactive desktop pet to the bottom right corner of the DSH web interface, combining cute pet companionship with several small practical productivity tools. To install the plugin, users can run the included install.sh script in their terminal. If they use a custom DSH profile, they can set the DSH_PROFILE environment variable before running the script to point to the correct profile location. The script automatically copies the plugin package, handles dependencies, registers the plugin, and verifies loader parsing.

This plugin is designed for DSH users who want a little bit of companionship while working with their AI agent, plus lightweight productivity tools to organize their daily routine. The pet’s animation automatically syncs with the agent’s current status: when the agent starts a task, the pet switches to thinking animation, then working, then celebration once the task is complete. When left idle for the configured number of seconds (default 60), the pet goes to sleep, and can be woken up with a click or drag. Users can left-click the pet to see a random line of dialogue, right-click to open the settings panel, and drag the pet anywhere on the screen.

The plugin is entirely front-end driven, and all user settings are stored in the browser’s localStorage, so it does not require any backend services or external dependencies from DSH beyond what is already included in the base installation. The default skin included with the plugin is from a user-contributed source, and it is marked for personal non-commercial use only. Users who want to create custom skins can use the provided Python scripts to generate their own sprite sheets, which follow a 32 column by 5 row grid format matching the five pet states. To uninstall the plugin, users can run the included uninstall.sh script and then restart the DSH web client.

dsh-pet 是专为 DeepSeek Harness（DSH）WebUI 客户端开发的原生插件，在界面右下角添加了一只桌面宠物，实现宠物陪伴与实用工具二合一。支持精灵图多帧动画，能和 agent 运行状态联动，支持自由拖拽，还内置闹钟、番茄钟、便签、久坐喝水提醒等工具。用户可通过项目自带的 install.sh 脚本一键安装，脚本会自动完成插件复制、依赖处理和注册，操作简单。

该插件专为 DSH 用户打造，适合想要在使用 DSH 时获得陪伴感，同时需要日常效率小工具的用户。它的交互逻辑清晰：左键点击宠物触发随机台词气泡，右键唤出设置面板，按住宠物可任意拖拽到界面任意位置，闲置达到设定时间后宠物会自动进入睡眠，点击或拖拽即可唤醒。插件支持皮肤自定义，用户可更换符合版权要求的自制皮肤。

插件完全纯前端驱动，所有设置都存储在浏览器的 localStorage 中，不依赖后端服务。默认皮肤素材来自用户贡献，仅限个人非商用使用，更换皮肤时请使用自身拥有合法使用权的素材。插件目前支持五种状态共 32 帧动画，除部分 AI 生成帧外，其余为程序化生成，用户可通过项目提供的 Python 脚本自行生成新的精灵图皮肤。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-pet（zealot00/dsh-pet）
仓库：https://github.com/zealot00/dsh-pet
本站详情页：https://www.yhbd.top/plugins/zealot00-dsh-pet/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 3 · 最近提交 2026-08-14 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
Only 3 stars - very few users, little community feedback星标只有 3，几乎没人在用，遇到问题缺少社区反馈
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 github:zealot00/dsh-pet

把 zealot00/dsh-pet 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.4 KB · 缓存于 2026-08-23 03:42:26 · 4.4 KB

dsh-pet — 桌面宠物插件（宠物 + 实用工具）

一个 DeepSeek Harness (dsh) WebUI 客户端插件：右下角桌面宠物，宠物陪伴 + 实用工具二合一——精灵图多帧动画、agent 状态联动、自由拖拽、闹钟、番茄钟、皮肤分离。

⚠️ 皮肤版权：assets/zhuangfangyi.png 与 zhuangfangyi.sheet.png 为默认皮肤（来自用户提供的图片，透明化 + AI 动作帧处理）。若为游戏官方立绘/同人图，仅限个人使用，勿商用。换皮肤时请使用你有权使用的素材。

效果图

精灵图动画系统

使用场景

特性

精灵图动画：5 状态 × 32 帧（idle/thinking/working/done/sleeping），canvas 逐帧渲染（无重影闪烁），帧率可调 1-32
agent 状态联动：agent 开始 → 思考（1.8s）→ 工作（弹跳）→ 完成（庆祝跳跃）
自由拖动：pointer events 拖拽，松手自动保存位置
闹钟：每天/一次两种模式；"已触发"标记持久化，重启不重复响
番茄钟：工作/休息循环，宠物脚下倒计时，到点通知+宠物说话；状态持久化（墙钟时间驱动，刷新/重启不重置）
便签：国风祥云告示牌（白底绿框+四角祥云），宠物侧边循环显示
久坐/喝水提醒：间隔提醒（持久化防重置），到点通知+宠物说话
提醒互斥：闹钟/番茄钟/提醒共用 10s 冷却，防通知轰炸
右键设置面板：启用/大小/位置/透明度/皮肤下拉+预览/台词/帧率/入睡秒/闹钟/番茄钟/便签/提醒
皮肤分离：素材走 /pet-assets/<文件名>，皮肤下拉选择 + 自定义输入 + 实时预览
纯前端驱动：设置存 localStorage，不依赖 host settings 服务

安装

./install.sh && dsh web
# 或 DSH_PROFILE=~/.dsh/profiles/其他名字 ./install.sh

install.sh 自动：复制插件包到 profile 的 node_modules → 从 dsh 安装树复制依赖（schemastery 零依赖叶子）→ 注册插件行 → 验证 loader 解析。

包声明 dsh.bundle.patch，未来 npm 发布后可直接 dsh plugin --profile web add dsh-pet。

交互

左键点击：说话（随机台词气泡）
右键：设置面板
拖拽：任意位置
agent 跑任务：思考→工作→庆祝动画
闲置 60s（可配）：入睡；点击/拖拽唤醒

配置项（localStorage: `dsh-pet:settings`）

字段	默认	说明
enabled / width / right / bottom / opacity	true / 180 / 24 / 20 / 1	基础外观
image	zhuangfangyi.sheet.png	皮肤（下拉 + 自定义）
lines	默认台词	随机台词
fps	6	精灵图帧率
sleepAfter	60	闲置入睡秒（0=禁用）
alarmEnabled / alarmTime / alarmMessage / alarmMode	false / 09:00 / 默认 / repeat	闹钟（repeat=每天 / once=一次）
pomodoroEnabled / pomodoroWork / pomodoroBreak	false / 25 / 5	番茄钟

项目结构

dsh-pet/
├── package.json        # dsh.client + dsh.bundle.patch
├── cordis.patch.yml    # bundle patch（插件行）
├── lib/
│   ├── index.js        # host 半部：/pet-assets 素材路由
│   └── client.js       # 浏览器半部：宠物/动画/拖拽/闹钟/番茄钟/设置面板
├── assets/             # 皮肤（zhuangfangyi.png 单图 + zhuangfangyi.sheet.png 精灵图）
├── scripts-gen-sheet.py # 程序化生成精灵图（Pillow）
├── prepare_sheet.py    # AI 动作条拆帧拼精灵图
├── deps-copy.py        # 依赖复制助手
├── install.sh / uninstall.sh
└── README.md