一只住在 DeepSeek Harness Web 界面里的桌面宠物：待机呼吸、随机动作（含打瞌睡）、偶尔转向、屏幕漫游、点击反应、可拖拽——还能实时展示 LLM 服务商的余额/额度（余额动画 + 头顶联想气泡）。
这不是一个普通插件，而是完整的三件套项目：
① 提示词（配方） → ② 素材生成链（引擎） → ③ 插件（成品）
AI 生成动画的配方 源视频 → 透明动画的管线 运行在 DSH 里的宠物
任何人 clone 本仓库，都可以从零生成自己的桌面宠物——换角色、换动作、换风格，全流程可复现。
以下命令都在你的命令行终端（PowerShell / CMD 等）中运行。前提是 DSH 环境已就绪：
# ① 前置要求：确认 Node.js 已安装
node -v
# ② 安装 DSH 启动器与 pnpm（已装可跳过；装完请重新打开终端）
npm install -g @deepseek-ai/dsh pnpm
dsh --version # 验证 dsh 命令可用
# ③ 安装本插件
dsh plugin --profile web add dsh-pet重启 dsh web，宠物出现在右下角。
兼容性：本插件在 dsh
0.1.1-rc.1下开发并测试（dsh --version可查看你的版本）。建议使用相同版本；其他版本如遇问题欢迎反馈。
用 AI 视频生成工具（如可灵、Runway、豆包等，本项目素材即由豆包生成），按 prompts/桌面宠物 10 秒动作提示词.md 的配方，一个动作生成一段 10 秒绿幕视频：
- 视频比例 16:9，背景纯绿幕（#00FF00）
- 人物位置/大小固定（头顶 ~20% 高度、脚底 ~85% 高度）
- 动作全程在画幅内，首尾帧为标准正面站立
- 每段动画按秒分解（0-10s 各阶段动作）
生成结果按动作各存一个 mp4，放入 video/。
源视频获取：为控制仓库体积，
video/源视频不入 git。Releases 提供打包压缩包，浏览器直接下载即可：
assets-videos.zip—— 全部源视频压缩包（中文名 mp4，解压后放入video/）pr-project.zip—— PR 手工抠像工程（.prproj+ 遮罩缓存，可选，供参考路线 B 的手工抠像做法）解压：
Expand-Archive assets-videos.zip（Windows）或unzip assets-videos.zip，把 mp4 放回video/即可运行素材链。
step02（透明视频）有两条路线，按需二选一（默认自动、人人可复现；效果不佳可用 PR 手工抠像覆盖）：
cd scripts
# 路线 A（默认）：自动绿幕抠像（HSV 色相，无需人工）
python watermark_step01.py # 水印遮罩填充 → step01/
python chroma_step02.py # 绿幕抠像转透明 → step02/
# 路线 B（可选）：PR 手工抠像覆盖（针对含第三方物品/自动抠像效果不佳的动作）
# 1. 在 PR 里手工抠像，导出带 alpha 的透明 .mov（如 ProRes 4444 with Alpha）
# 2. 放入 pr/，文件名与动作名一致（如 吃白饭.mov）
python pr_import_step02.py # pr/*.mov → step02/（透明 webm，覆盖该动作自动抠像结果）
# 后续步骤两条路线共用：
python normalize_step03.py # 归一化 2160×1215 统一站立居中 → step03/
python encode_thumbs.py # 转码 640×360 播放变体 → step04/依赖：Python 3 + ffmpeg + numpy + scipy（素材链脚本自动用工作区 .tools/ 下的 ffmpeg）。
本项目全部采用路线 B（97 个动作均为 PR 手工抠像）：对"含第三方物品/透明边缘复杂"的动作，自动 HSV 抠像易残边或误抠，PR 手动遮罩更精细。两条路线产出同一级
step02/，后续步骤完全一致；chroma_step02.py保留为自动化兜底，任何动作仍可一键自动生成。
# 把 step04 的播放变体同步进插件包
cp step04/*.webm dsh-pet/assets/thumb/
# 本地安装插件
dsh plugin --profile web add file:D:/path/to/dsh-pet中间产物（step01-04）由脚本生成、不入仓库；
video/源视频和脚本是成果、入库维护。
├── prompts/ # ① 各动作的生成提示词（绿幕规范 + 按秒分解）
├── scripts/ # ② 素材生成链（Python：水印/抠像/归一化/转码，含 PR 导入）
├── video/ # ② 源视频（绿幕 mp4 + 水印 mask，一动作一文件；不入库，Releases 有压缩包）
├── pr/ # ② 路线 B 输入：PR 导出的透明 .mov（本地工作数据，不入库）
├── prproj/ # ② PR 工程目录（.prproj + 遮罩缓存 + 自动保存，本地不入库）
├── tools/ # 开发工具：preview.html（素材链各阶段效果预览）
├── dsh-pet/ # ③ 插件（可独立 npm 发布）
│ ├── src/ # TS 源码（host 半侧 /pet 路由 + client 半侧动画链）
│ ├── lib/ # tsdown 构建产物（prepare 自动构建，lib/*.js 不入库）
│ ├── assets/thumb/ # 640×360 透明播放动画
│ ├── assets/preview/ # GIF 预览（README 展示用，拼音命名）
│ └── scripts/prepack-check.js # 发布前健康检查
├── DESIGN.md # 设计与实现文档
└── LICENSE # MIT
- 纯粹的桌宠：核心就是陪你——没有天气查询、系统监控、Agent 状态感知等花活；唯一的"业务功能"是可选的余额展示（见下节）。零核心改动（不碰 DSH 内核）
- 余额展示：实时显示当前 LLM 服务商的余额/额度——DeepSeek 官方显示账户余额（¥），OpenCode Zen Go 显示 5h/周/月 三个额度窗口中最紧张的一个；每次刷新按档位播放余额动画，头顶弹出联想气泡（随宠物大小等比缩放，10 秒后自动消失）；每只宠物可独立开关（
balanceEnabled） - 动画链：每个动画（含待机）播完立即按权重选下一个（权重配置于
config.jsonc，默认 idle 10 / turn 5 / move 5 + 动作分类权重），首尾相接永不停止 - 多开：可配置同时显示多个宠物，每只宠物独立的大小与位置（设置页「桌宠配置」添加/删除）
- 屏幕漫游：朝 facing 方向行走，先检查空间、不走出屏幕
- 点击/拖拽：点击有回应动画，可拖到任意位置
- 左右朝向：所有动画可镜像，人物可朝左/朝右
- 落地对齐：动画统一脚底线，宠物始终站在地面上
- 流畅切换：双缓冲交叉淡入，切换无空白帧
余额是"事件动画"的一种：运行时按 eventsRefreshSec.balance（秒）周期拉取当前服务商（跟随 agent-default-model 的 provider）的余额/用量数据，每次刷新按档位触发一次余额动画，并在宠物头顶弹出联想气泡（气泡为角色"思考"式白泡，随宠物大小等比缩放，10 秒后自动消失）：
- DeepSeek 官方（
deepseek-official）：气泡显示账户余额（如余额 ¥8.79）；余额按 ¥20 满额折算成已用百分比，分 6 档播放动画（钱袋满溢 → 金袋叮当 → 钱袋如常 → 数金皱眉 → 袋空如洗 → 分文不剩） - OpenCode Zen Go（
opencode-go）：气泡显示 5h/周/月 三个额度窗口中最先告急的一个（如周额度已用 88%/2.5 天重置），同样按已用百分比分档 - 按宠物开关：
pets[i].balanceEnabled（必填布尔）控制该宠物是否触发余额动画/显示气泡；全部宠物关闭时自动跳过余额轮询 - 所需凭据：对应 provider 的 API key（
deepseek-official→DEEPSEEK_API_KEY；opencode-go→OPENCODE_GO_API_KEY），在 DSH 凭据中配置后启用；未匹配的服务商按设计不触发动画、不显示气泡
桌宠的大小、位置、多开均可配置，两条途径：
DSH 设置 → 「桌宠配置」：
- 大小：宽度 px（高度自动 = 宽度 × 9/16）
- 位置：四角（corner）＋ 水平/垂直边距（marginX / marginY）
- 余额功能：勾选后该宠物才会触发余额动画并显示余额气泡
- 多开：添加/删除宠物，每只宠物独立 id、大小、位置
- 点「保存」即时生效（无需刷新）；「恢复默认」回到 config.jsonc 默认
插件包内 dsh-pet/assets/config.jsonc 的 pets 数组定义默认宠物：
- 每只宠物：
id（标识）／size（宽度 px）／balanceEnabled（是否启用余额功能，必填布尔）／position（corner 四角之一 + marginX/marginY 边距） - 余额刷新周期：
eventsRefreshSec.balance（秒）——余额数据刷新与余额动画触发的间隔，启动时立即触发一次，之后按此周期循环（默认 180） - 设置页的修改保存到用户层
$DSH_HOME/dsh-pet/main-config.json（完整宠物列表，覆盖包内默认）；「恢复默认」即清除用户层、回落 config.jsonc
宠物实际运行在 DSH Web 界面中的样子：
全部动画（640×360，插件实际播放用的资源）——GIF 预览存放于仓库 dsh-pet/assets/preview/（raw 直链渲染，文件名采用拼音便于跨平台）；完整透明视频见 dsh-pet/assets/thumb/：
待机 / 转向
移动
小动作
玩耍
吃什么
时节
文字
点击回应
拖拽
余额事件（按余额已用百分比分档，满格 → 告急 → 耗尽）
注：动画为透明背景；GIF 预览中透明部分显示为页面底色，实际 webm 播放为透明。
- 设计与实现 —— 架构、动画链模型、素材链
- 代码：MIT
- 素材（动画/提示词/源视频）：允许开源使用，禁止商用