- Inicio
- Plugins
- Solo por diversión
- dshpet-dshwe
dshpet-dshwe
fish-under-sea/dshpet-dshwe
Un pez azul y regordete que come arroz blanco se instala en DeepSeek Harness y no piensa irse. Le gustan el cubo de Rubik, los aperitivos y alguna siesta. Cuando se aburre pasea por el escritorio; ni arrastrarlo y zarandearlo lo hace marcharse. Si estás ocupado, se mueve contigo y también ayuda a gestionar tu monedero de saldo. En sus ratos libres murmura y te hace compañía charlando.
Instalar
dsh plugin --profile web add github:fish-under-sea/dshpet-dshweREADME

dshpet-dshwe 🐟
一只住在 DeepSeek Harness 里、会帮你拉开侧边栏的桌面宠物 —— DSHWE 联动版
简介
本项目是 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/
配合联动使用
- 安装联动方
dsh-wallpaper-engine(含pet-link模块) - 在 WE 的设置 → 扩展模块里打开「桌面宠物联动」开关
- 保存后宠物即接管;关掉开关则立刻退回原版行为
[!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-engine | pet-link 桥接、侧栏控制、吉祥物、参数面板 |
| 本 fork | Fish-under-sea/dshpet-dshwe | 联动演出、白名单动画锁、按段计时、双端感知 |
原始 README 完整保留在 README.upstream.md,未作任何删改。
本 fork 相对上游的改动
- 新增 9 段联动动画与 5 张联动表情,并登记进
animations.events.DSHWE池 - 新增
link.surface(显示端解析)与link.allowedAnim(动画白名单)两个控制面字段 - 动画链支持「来源标记」:区分联动点播与自主动画,锁只拦后者
- 段推进改为固定时长(与旧版内置实现
petLinkDrain的readyAt口径一致) - 修复:碎碎念在联动执行期间抢动画、上锁时暂停画面导致“动画被锁住”等问题
许可
沿用上游许可,详见 LICENSE。
Plugins relacionados
dsh-web-ui (dsh-pet)
zhu1090093659/dsh-web-ui
dsh-pet (dsh-pet)
pc2005-cloud/dsh-pet
dsh-tavern (dsh-tavern)
flizzywine/dsh-tavern
dsh-tavern (dsh-profile-bridge)
flizzywine/dsh-tavern