dsh-pet 🐾

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

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

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

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

快速开始（安装插件）

dsh plugin --profile web add dsh-pet

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

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

① 提示词 → 源视频

用 AI 视频生成工具（如可灵、Runway 等），按 prompts/桌面宠物 10 秒动作提示词.md 的配方生成 25 个 10 秒绿幕视频：

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

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

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

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）。

③ 动画 → 插件

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

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

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

项目结构

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