dsh-pet DSH plugin

dsh-pet adds a charming animated character to your DSH Web interface. It features 28 handcrafted animations such as breathing, yawning, walking, turning, click responses, and drag feedback. The pet uses a dual-buffer crossfade system for smooth transitions and a probabilistic animation chain to keep behavior unpredictable.

ui-productivity

How to install the dsh-pet DSH plugin

dsh plugin --profile web add dsh-pet

Copying does not run this command. Review the repository and version before installing the dsh-pet DSH plugin.

dsh-pet DSH plugin data source

dsh-pet DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-pet DSH plugin can do

28 unique animations including idle, movement, actions, click responses, and drag feedback
Screen roaming: walks toward facing direction without leaving the screen
Click reaction: responds with specific animations when clicked
Draggable: can be dragged to any position on screen
Left/right facing: all animations can be mirrored
Smooth transitions: dual-buffer crossfade eliminates blank frames

Where the dsh-pet DSH plugin fits

Add a cute desktop companion to your DSH Web interface
Make your development environment more lively and fun
Demonstrate the plugin capabilities of DeepSeek Harness
Serve as a base for learning how to create DSH plugins with custom assets

Who the dsh-pet DSH plugin is for

DSH users who want a playful desktop pet
Developers interested in animating UI elements in DSH

dsh-pet DSH plugin limitations

Only works in the DSH Web interface profile
Animations and behavior probabilities are hardcoded (no user configuration interface)
Customizing the pet requires running the full asset generation pipeline (Python + ffmpeg)

dsh-pet DSH plugin: from the repository README

Quoted from the PC2005-cloud/dsh-pet README, the upstream source of the dsh-pet DSH plugin. Copyright remains with the original authors.

一只住在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web 界面里的桌面宠物：待机呼吸、随机动作（含打瞌睡）、偶尔转向、屏幕漫游、点击反应、可拖拽。这不是一个普通插件，而是**完整的三件套项目**： ``` ① 提示词（配方） → ② 素材生成链（引擎） → ③ 插件（成品） AI 生成动画的配方源视频 → 透明动画的管线运行在 DSH 里的宠物 ``` 任何人 clone 本仓库，都可以**从零生成自己的桌面宠物**——换角色、换动作、换风格，全流程可复现。 --- ## 快速开始（安装插件） ```sh dsh plugin --profile web add dsh-pet ``` 重启 `dsh web`，宠物出现在右下角。 ## 从零生成你自己的宠物（完整流程） ### ① 提示词 → 源视频用 AI 视频生成工具（如可灵、Runway 等），按 `prompts/桌面宠物 10 秒动作提示词.md` 的配方生成 28 个 10 秒绿幕视频： - 视频比例 16:9，背景纯绿幕（#00FF00） - 人物位置/大小固定（头顶 ~20% 高度、脚底 ~85% 高度） - 动作全程在画幅内，首尾帧为标准正面站立 - 每段动画按秒分解（0-10s 各阶段动作）生成结果放入 `video/`（28 个 mp4）。 ### ② 源视频 → 透明动画（素材链） ```sh cd scripts python crop_step01.py # 裁掉左右绿幕边缘 → step01/ python chroma_step02.py # 绿幕抠像转透明 → step02/ python normalize_step03.py # 归一化 1200×1200 统一站立 → step03/ python encode_thumbs.py # 转码 360×360 播放变体 → step04/ ``` **依赖**：Python 3 + ffmpeg（素材链零第三方 pip 依赖，脚本自动用工作区 `.tools/` 下的 ffmpeg）。 ### ③ 动画 → 插件 ```sh # 把 step04 的播放变体同步进插件包 cp step04/*.webm dsh-pet/assets/thumb/ # 本地安装插件 dsh plugin --profile web add file:D:/path/to/dsh-pet ``` > 中间产物（step01-04）由脚本生成、不入仓库；`video/` 源视频和脚本是成果、入库维护。 --- ## 项目结构 ```

Read the full READMERepository license: MIT

dsh-pet DSH plugin questions

How do I install dsh-pet?

Run the command `dsh plugin --profile web add dsh-pet` in your terminal. Then restart the DSH web server (`dsh web`). The pet will appear in the bottom-right corner of the interface.

Can I change the pet's animations or behavior?

The plugin does not provide a configuration interface. To customize animations, you need to run the full asset generation pipeline described in the README: create green-screen videos using AI tools, then process them with Python scripts and ffmpeg to produce the final webm files.

Does dsh-pet work on mobile or in other browsers?

The plugin is designed for the DeepSeek Harness Web interface, which runs in a desktop browser. It has not been tested on mobile devices. The animations rely on WebM format and JavaScript, which are supported by modern desktop browsers.

Why doesn't the pet respond when I click on it?

The pet should respond with a click animation when you click on it. If it does not react, ensure the plugin is properly installed and the DSH web server is running. Also check that your browser supports WebM playback. If issues persist, try restarting the web server.

How can I uninstall dsh-pet?

Run `dsh plugin --profile web remove dsh-pet` and restart the DSH web server. The pet will no longer appear in the interface.