zealot00/dsh-pet
Desktop pet for DeepSeek Harness Web UI: sprite animation, agent state linkage, drag, alarm & pomodoro widgets, skin separation
Listed
3
Ui
Bundle verified
What it does
Desktop pet for the DSH Web UI: sprite-sheet animation, agent state linkage, drag, alarm (daily/one-shot) and pomodoro widgets, skin picker with preview.
Best for
- DSH Web users who want agent activity represented by an animated, draggable desktop pet.
- Personal productivity workflows combining pomodoro cycles, alarms, notes, and sitting or hydration reminders.
- Users who want to select or supply sprite-sheet skins and preview them in the browser.
Not ideal for
- Minimal or shared work interfaces where decorative animation and personal reminders add little value.
- Users needing settings synchronized across browsers or devices; configuration is stored per browser in localStorage.
- Commercial use of the bundled default skin, whose documented licensing restricts it to personal use.
- Workflows requiring server-managed productivity state rather than browser-local persistence.
README
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
精灵图格式
- 网格：32 列 × 5 行（行 = 状态：idle/thinking/working/done/sleeping）
- 文件名含
.sheet.即视为精灵图（如xxx.sheet.png） - 生成：
python3 scripts-gen-sheet.py（程序化）或python3 prepare_sheet.py（AI 动作条拆帧） - AI 动作条生成：
gen_strips.sh（mmx + subject-ref + 自动质检重试）
卸载
./uninstall.sh && dsh web
已知说明
- 设置存 localStorage（按浏览器）；单机个人使用最佳
- 精灵图 thinking/done 为 AI 帧，其余程序化——后续可替换更高质量动作帧
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:zealot00/dsh-pet in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.