桌面宠物 60fps r0setan79/dsh-pet-60fps

dsh-pet 60fps 改版 🐾

一只住在 DeepSeek Harness 里的桌面宠物，全部 106 段动作重制成 60fps，换动作不再硬切。

非官方改版 / unofficial fork：基于 PC2005-cloud/dsh-pet v0.3.7（MIT）重制素材帧率并调整动画调度。本仓库只做素材与调度层改动，插件功能与原版一致。

这个版本改了什么

相对上游 dsh-pet@0.3.7，改动集中在两处：素材帧率 与 动画调度。

1. 106 段素材全部运动插帧到 60fps

| 项目 | 上游 0.3.7 | 本改版 |
| 帧率 | 24 fps | 60 fps |
| 单段循环 | 约 240 帧 | 598 帧 / 9.967 s |
| 分辨率 | 640×360 | 640×360（未变） |
| 编码 | VP9 + alpha | VP9 + alpha（alpha_mode=1 保持不变） |
| 素材数 | 106 | 106（一一对应，无增删） |

24fps 到 60fps 之间缺的是中间帧——抬手、转头、呼吸的过渡过程和插值帧，现在都补上了。插帧只做运动补偿，不改画风、不改时长、不加速。

2. 换层交叉淡入从 0.18 s 提到 0.35 s

runtime/electron-helper/index.html:51 的 transition: opacity 由 0.18s 改为 0.35s，段与段之间的过渡更柔和，不再有那种「啪」一下换图的感觉。（更长的淡入会把旧姿势从新图的透明区透出来，0.35s 是实测的可用上限。）

3. 段间停顿改成随机待机，不再定格

sprite.js 里的 IDLE_GAP_MS = 2000：一段动作播完的间隙不再定在最后一帧当「静止画」，而是循环播一段随机的待机动作，整只宠物任何时候都在动。

4. 提前预解码下一段，消掉切换瞬间的卡帧

sprite.js 新增 preloadInto() + switchTo() 里的缓存命中快路径（el.dataset.animUrl === url && el.readyState >= 2）：one-shot 开播后约 270 ms 就把下一段要用的素材预解码进空闲的 ，切过去时不再等首帧。

5. 随机链防重复（8 段窗口）

构造器新增 this.recent = [] / recentMax = 8，notePlayed() 在每次切换时记账，pickFresh() 优先抽不在最近窗口里的动作；分类动作另有最多 6 次拒绝采样。不会再连着三次抽到同一个动作。

6. 拖拽 / 点击仍是同帧硬切

换层分两类：段间切换走 150 ms 短交叉淡入，拖拽、点击这类交互走同帧硬切（switchTo(next, nextOnce, hardCut) 第三参数），保证手感跟手，同时避免两个图层同时可见。

目录结构与改动位置

dsh-pet-60fps/
├─ assets/
│ ├─ webm/ ← 106 段素材，全部换成 60fps 版（1.7 MB × 106） │ ├─ config.jsonc ← 动画/权重配置（未改） │ ├─ fonts/ memes/ pic/ ← 原版素材（未改） │ └─ logo.png ├─ runtime/electron-helper/ ← 桌面窗口渲染层（改动的核心） │ ├─ index.html ← 交叉淡入时长 0.18s → 0.35s │ ├─ sprite.js ← 预解码 / 防重复窗口 / 停顿时随机待机 │ ├─ main.js shared-core.js events.js ... ├─ lib/ ← 构建产物（宿主半侧 + 浏览器半侧 + 独立模式 CLI） ├─ src/ ← 源码 ├─ cordis.patch.yml ← 插件挂载声明 ├─ package.json ← dsh-pet 0.3.7 清单（未改版本号） └─ LICENSE ← MIT，原作者 PC2005-cloud

安装

前置：Node.js ≥ 22.12，以及一个能跑 dsh-pet 的 DSH 版本（原版声明 0.2.0-rc.1 / 0.2.0-rc.2 兼容）。

方式 A：覆盖进已有 DSH 插件目录（最省事）

1. 先备份原来的插件 Copy-Item "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-pet" "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-pet.bak" -Recurse

2. 用本仓库内容覆盖（把仓库解压后的内容整个拷进原目录，保持 package.json 在根） robocopy "<解压目录>" "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-pet" /MIR /XD .git

3. 重启 DSH Desktop

注意：/MIR 会删掉目标里多出来的文件，所以第 1 步的备份别省。

方式 B：独立模式（不装 DSH，直接跑桌面宠物）

npm install --omit=dev # 只装 @electron/get 这类运行依赖
node lib/standalone.js --check # 体检：打印配置来源、宠物清单、Electron 状态
node lib/standalone.js # 启动，默认端口 3080，被占用时自动顺延
首次运行会把 Electron 43.3.0 下载到 %USERPROFILE%\.dsh\electron。想复用已有 Electron，设环境变量 DSH_PET_ELECTRON_PATH 指向 electron.exe。

独立模式下，余额、碎碎念、对话、系统通知这些依赖 DSH 服务的功能不可用。这是上游的设计，不是本改版的问题。

方式 C：当本地依赖装进 profile

// ~/.dsh/profiles/desktop/package.json
{
"dependencies": { "dsh-pet": "file:E:/dsh-pet-60fps" },
"dsh": { "profile": { "bundles": ["...", "dsh-pet"] } }
}

改完 pnpm install，重启 DSH。

相关配置

动画池与权重在 ~/.dsh/dsh-pet/main-config.jsonc（独立模式是 $DSH_HOME/dsh-pet/main-config.jsonc）的 animations / animationWeights。改完不用杀进程，POST http://127.0.0.1:3080/dsh-pet-7340/reload 会重新同步。

display 字段只允许 none / desktop / both。已经有独立桌宠在跑时，DSH 侧那份必须保持 none，否则会同时出现两只。

已知限制

- 仓库约 190 MB，几乎全是 60fps 素材（106 × ~1.7 MB）。这是插帧后码率上升的必然结果，不是仓库里塞了无关文件。
- 60fps 只在渲染层真的按 60Hz 刷新时有意义；远程桌面 / 省电模式下可能被降到 30fps 显示。
- 素材是 VP9 + alpha 的 WebM。Safari 对 VP9 alpha 支持不完整，上游也是同样限制。
- 本改版只改素材与 runtime/electron-helper 里的调度逻辑；package.json 版本号仍是 0.3.7，方便和上游对照。

许可与致谢

- 原项目：PC2005-cloud/dsh-pet，MIT License，Copyright (c) 2026 PC2005-cloud。
- 本仓库沿用同一份 MIT 许可，见 LICENSE。素材与代码版权归原作者；本仓库的改动是帧率重制与调度层补丁。
- 插帧后的素材仍受原项目许可约束，转载/二次分发请一并保留 LICENSE 与出处。