본문으로 건너뛰기
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。

관련 플러그인