跳过主要内容
F

dshpet-dshwe

fish-under-sea/dshpet-dshwe

住在 DeepSeek Harness 的蓝色大肥鱼桌宠:漫游、拖拽、打盹、聊天,爱玩魔方吃零食,也帮打理余额钱包。

安装

dsh plugin --profile web add github:fish-under-sea/dshpet-dshwe

README

dshpet-dshwe
dshpet-dshwe 🐟

一只住在 DeepSeek Harness 里、会帮你拉开侧边栏的桌面宠物 —— DSHWE 联动版

npm version npm downloads license platform assets

简介 · 三段联动 · 安装 · 参数面板 · 素材与来源 · 致谢与许可


简介

本项目是 dsh-pet 的 DSHWE 联动版(下游 fork,包名 dshpet-dshwe)。

原版 dsh-pet 是一只独立的桌面宠物:待机呼吸、随机动作、屏幕漫游、点击 Q 弹、拖拽甩抛。本 fork 保留了它的全部能力,并在此基础上增加了一套 与 DSH Wallpaper Engine 的联动演出——宠物会走到屏幕右缘把侧边栏拉出来、抓住吉祥物往下拽、被弹飞后落地,全程由 dsh-wallpaper-engine 的 pet-link 模块指挥。

[!NOTE] 联动是可选的:没装 dsh-wallpaper-engine、或联动开关关掉时,它就是原版 dsh-pet,行为完全不变。

它多了什么

能力说明
🎬 九段专属演出走位、蓄力、后拉、踢腿、被弹飞、落地、抓绳、哈气、半身转向——全部为联动单独制作
🧠 按段计时每段动作按固定时长推进(与旧版内置实现同源),不依赖素材是否播完,节奏稳定可预期
🔒 动画白名单锁联动执行期间只放行联动点播的动画;碎碎念、随机链、点击、拖拽等其它动画一律不插队
🖥️ 双端感知display 为 both 时只操控网页端那只;单端激活时操控那一端(含桌面独立窗口)
💬 原生气泡走 /broadcast 让宠物自己说话,样式与位置与本体一致,可带表情包
🎛️ 49 个可调参数走位时长、贴边比例、下拉距离、缓动、气泡时间线……全部面板可视化调,改完即时生效

三段联动

① 拉出侧边栏

走位贴边 → 蓄力预备 → 后拉 → 侧边栏展开 → 等待关闭 → 回程原位

宠物从当前位置走到屏幕右缘(手要贴着边缘,用 handRightRatio 精确对齐),播「蓄力」与「后拉」把侧边栏拽开,然后等你用完关掉侧栏,再走回原位。

[!TIP] 等待期间锁会主动放开——那段时间其它动画可以正常播,宠物不会僵着。

② 抓绳吉祥物

走到绳下 → 手指尖对准绳顶 → 跳抓 → 下拉 → 脱手落地 → 侧栏展开

站位口径与旧版一致:按原片「双手最高处 x=312、指尖 y=36」把指尖对准绳子顶部,不是“头顶贴屏幕”。吉祥物(绳)会跟着往下拉再弹回,落地后自动展开侧栏。

③ 彩蛋:踢腿与弹飞

踢腿 → 被弹飞(原生物理抛掷 + 三段回弹)→ 落地气泡 → 侧栏展开

安装

作为 DSH 插件

# 在 DSH profile 里安装
dsh plugin add dshpet-dshwe

或指向本地源码(开发用):

git clone https://github.com/Fish-under-sea/dshpet-dshwe.git
cd dshpet-dshwe
node node_modules/tsdown/bin/tsdown.js   # 构建客户端产物到 lib/

配合联动使用

  1. 安装联动方 dsh-wallpaper-engine(含 pet-link 模块)
  2. 在 WE 的设置 → 扩展模块里打开「桌面宠物联动」开关
  3. 保存后宠物即接管;关掉开关则立刻退回原版行为

[!IMPORTANT] 联动依赖 pet-link 的桥接能力(能力版本 ≥ 4)。运行时版本过旧会在 WE 面板提示 runtime-too-old,升级本插件即可。


参数面板

所有参数都在 WE 的「桌面宠物联动」面板里,改完即时生效,并持久化到浏览器本地。

分组关键参数作用
贴边handRightRatio、edgeGapPx右手横向位置比例 / 与屏幕边缘的间距。比值越大,宠物越靠左(center = W − size×(ratio−0.5)),调的时候注意方向
走位sidebarWalkMs、followSpeed走位总时长 / 跟随速度
逻辑二mascotTopOffsetPx、mascotRopeDownPx抓绳站位的头顶偏移(正=往下)/ 吉祥物下拉距离
彩蛋egg1FlingPx、egg1FlingMs弹飞距离与时长
气泡bubbleTiming气泡出现/隐藏的锚点时间线(按段偏移毫秒)

[!TIP] handRightRatio 的刻度是 每 0.01 ≈ 4.6px(宠物尺寸 462 时)。本仓库用真实素材逐像素量测过:走位段「通用-右侧螃蟹步」的可视右界是 0.597,取该值时宠物右缘与屏幕右缘误差 0 像素。


素材与来源

内置素材

类型数量说明
联动动画9 段assets/webm/*-dshwe.webm,640×360,命名即动画名
表情包5 张assets/memes/*.png,由气泡的 image 字段引用

动画与表情都已打包在包内,无需额外注入工具;宿主通过 assets/config.jsonc 的 animations.events.DSHWE 池识别它们。

目录结构

dshpet-dshwe/
├── assets/
│   ├── config.jsonc        # 动画池与表情池登记(DSHWE 池在此)
│   ├── webm/               # 118 个动画(含 9 段联动专属)
│   └── memes/              # 32 张表情(含 5 张联动专用)
├── src/
│   ├── client/             # 渲染端:宠物本体、动画链、联动控制面
│   └── host/               # 宿主端:/anim、/position、/broadcast 等路由
└── lib/                    # 构建产物(client.js 等)

致谢与许可

上游与联动方

角色项目说明
原始作者PC2005-cloud/dsh-pet桌面宠物本体、动画链、宿主路由、素材体系
联动方elysia395/dsh-wallpaper-enginepet-link 桥接、侧栏控制、吉祥物、参数面板
本 forkFish-under-sea/dshpet-dshwe联动演出、白名单动画锁、按段计时、双端感知

原始 README 完整保留在 README.upstream.md,未作任何删改。

本 fork 相对上游的改动

  • 新增 9 段联动动画与 5 张联动表情,并登记进 animations.events.DSHWE 池
  • 新增 link.surface(显示端解析)与 link.allowedAnim(动画白名单)两个控制面字段
  • 动画链支持「来源标记」:区分联动点播与自主动画,锁只拦后者
  • 段推进改为固定时长(与旧版内置实现 petLinkDrain 的 readyAt 口径一致)
  • 修复:碎碎念在联动执行期间抢动画、上锁时暂停画面导致“动画被锁住”等问题

许可

沿用上游许可,详见 LICENSE。

相关插件