dsh-pet 🐾

一只住在 DeepSeek Harness Web 界面里的桌面宠物：待机呼吸、随机动作（含打瞌睡）、偶尔转向、屏幕漫游、点击反应、可拖拽。

这不是一个普通插件，而是完整的三件套项目：

① 提示词（配方）    →  ② 素材生成链（引擎）  →  ③ 插件（成品）
AI 生成动画的配方     源视频 → 透明动画的管线    运行在 DSH 里的宠物

任何人 clone 本仓库，都可以从零生成自己的桌面宠物——换角色、换动作、换风格，全流程可复现。

---

快速开始（安装插件）

dsh plugin --profile web add dsh-pet

重启 dsh web，宠物出现在右下角。

从零生成你自己的宠物（完整流程）

① 提示词 → 源视频

用 AI 视频生成工具（如可灵、Runway、豆包等，本项目素材即由豆包生成），按 prompts/桌面宠物 10 秒动作提示词.md 的配方生成 51 个 10 秒绿幕视频：

• 视频比例 16:9，背景纯绿幕（#00FF00）
• 人物位置/大小固定（头顶 ~20% 高度、脚底 ~85% 高度）
• 动作全程在画幅内，首尾帧为标准正面站立
• 每段动画按秒分解（0-10s 各阶段动作）

生成结果放入 video/（51 个 mp4）。

源视频获取：为控制仓库体积，video/ 源视频不入 git。需要复现素材链时，从 Releases assets-videos 下载 51 个 mp4（拼音文件名），放入 video/ 即可。一键批量下载（需 gh CLI）：

mkdir -p video && cd video && gh release download assets-videos --repo PC2005-cloud/dsh-pet

② 源视频 → 透明动画（素材链）

cd scripts
python watermark_step01.py   # 水印遮罩填充 → step01/
python chroma_step02.py      # 绿幕抠像转透明（HSV 色相）→ step02/
python normalize_step03.py   # 归一化 2160×1215 统一站立居中 → step03/
python encode_thumbs.py      # 转码 640×360 播放变体 → step04/

依赖：Python 3 + ffmpeg + numpy + scipy（素材链脚本自动用工作区 .tools/ 下的 ffmpeg）。

③ 动画 → 插件

# 把 step04 的播放变体同步进插件包
cp step04/*.webm dsh-pet/assets/thumb/

# 本地安装插件
dsh plugin --profile web add file:D:/path/to/dsh-pet

中间产物（step01-04）由脚本生成、不入仓库；video/ 源视频和脚本是成果、入库维护。

---

项目结构

├── prompts/                 # ① 51 个动作的生成提示词（绿幕规范 + 按秒分解）
├── scripts/                 # ② 素材生成链（7 个 Python 脚本）
├── video/                   # ② 源视频（51 个绿幕 mp4 + 水印 mask）
├── tools/                   # 开发工具：preview.html（素材链各阶段效果预览）
├── dsh-pet/                 # ③ 插件（可独立 npm 发布）
│   ├── lib/index.js         #   host 半侧：/pet 视频路由
│   ├── lib/client.js        #   浏览器半侧：动画链 + 双缓冲播放
│   └── assets/thumb/        #   640×360 播放动画（51 个，~36MB）
├── DESIGN.md                # 设计与实现文档（含踩坑记录）
└── LICENSE                  # MIT

插件功能

• 纯粹的桌宠：不掺任何业务功能——没有天气查询、系统监控、Agent 状态感知，就一件事：陪你。零核心改动（不碰 DSH 内核）、零模型成本（运行时不需要调用任何 LLM 或 API）
• 动画链：每个动画（含待机）播完立即按概率选下一个——30% 待机 / 10% 转向 / 40% 动作 / 20% 移动，首尾相接永不停止
• 屏幕漫游：朝 facing 方向行走，先检查空间、不走出屏幕
• 点击/拖拽：点击有回应动画，可拖到任意位置
• 左右朝向：所有动画可镜像，人物可朝左/朝右
• 落地对齐：动画统一脚底线，宠物始终站在地面上
• 流畅切换：双缓冲交叉淡入，切换无空白帧

运行效果

宠物实际运行在 DSH Web 界面中的样子：

效果预览

全部 51 个动画（640×360，插件实际播放用的资源）——GIF 预览存放于仓库 dsh-pet/assets/preview/（raw 直链渲染，文件名采用拼音便于跨平台）；完整透明视频见 dsh-pet/assets/thumb/：

待机 / 转向

移动

动作

点击回应

拖拽

注：动画为透明背景；GIF 预览中透明部分显示为页面底色，实际 webm 播放为透明。

文档

• 设计与实现 —— 架构、动画链模型、素材链、踩坑记录

许可

• 代码：MIT
• 素材（动画/提示词）：见仓库说明