多只桌宠同屏不打架:dsh-pet 多开配置与大小位置自由摆放完全手册
多只桌宠同屏不打架:dsh-pet 多开配置与大小位置自由摆放完全手册
dsh-pet 是一款透明动画桌面宠物插件,支持多开——同一屏幕同时养多只桌宠,每只可以独立设置大小(宽度像素)、位置(四角 + 边距)和显示端(浏览器 / 桌面 / 双端)。本手册带你从零完成多只桌宠的同屏摆放,从设置页一键添加,到 config.jsonc 手写配置全覆盖。
为什么多只桌宠能同屏不打架?
dsh-pet 的每只桌宠都是一个独立实例,核心靠四个字段区分(见 config.jsonc 的 pets 数组):
| 字段 | 作用 | 说明 |
|---|---|---|
id |
唯一标识 | 素材、记忆、API 都按它定位,不能重复 |
name |
显示名 | 悬浮提示用,可省略(省略时按 id 显示) |
size |
宽度(px) | 高度自动 = 宽度 × 9/16 |
position |
角落 + 边距 | corner 四角之一,marginX / marginY 距角落偏移 |
此外每只还有必填的 balanceEnabled(余额开关)与 display(显示端:web / desktop / both / none)。因为各实例大小、位置完全独立,同屏自然互不干扰;即使把多只摆得很近,它们也只会"友好路过"——宠物间的碰撞默认是关闭的。
方式一:设置页「桌宠配置」一键多开(推荐新手)
新手不用碰文件,设置页就能完成全部多开操作:
- 打开 DSH 设置 → 左侧「桌宠配置」
- 顶部是宠物标签页,每只宠物显示
id (宽度px),点「+ 添加宠物」复制一只新实例 - 选中要调整的宠物标签,修改三项:
- 大小:填宽度 px,右侧实时提示"高度自动 = 宽度 × 9/16"
- 位置:下拉选四角(右上角 / 左上角 / 左下角 / 右下角)
- 水平偏移 / 垂直偏移:
marginX/marginY,微调离角落的距离
- 按需勾选「余额功能」,点「保存」即时生效(无需刷新页面)
设置页还能图形化调整拖拽抛掷的物理手感(重力 / 弹性 / 摩擦 / 宠物互撞等,逻辑在 physics.ts),以及「同步」按钮——把包内默认配置原文整份写入用户配置,既回到默认,又留下一份带注释、可直接编辑的完整文件。
大小怎么调:一个 size 管全身
大小只有一个输入:宽度像素,高度按 9:16 自动算。想养"一大一小"的对比感,直接给不同宠物填不同 size 即可——上面的设置页截图里就有 462px 的大女仆配 110px 的小跟班。
小提醒:屏幕漫游的移动距离会按 实际 size / 462 等比缩放,小宠物挪小步、大宠物迈大步,动作永远与体型匹配,不会出现"小宠物一步跨半屏"的违和感。
位置怎么摆:四角 + 双偏移精确定位
position 由三个值组成:
corner:top-right/top-left/bottom-left/bottom-right四选一,宠物以所属角落为基准定位marginX:水平偏移(px)marginY:垂直偏移(px)
例如 top-right + marginX 24 + marginY 100 就是"右上角往左 24px、往下 100px"。想让它贴屏边就填小值,想让它在窗口中部就把两个 margin 都调大。保存后宠物立刻出现在新位置,拖拽、漫游、反弹等行为都照常。
display 显示开关:浏览器、桌面还是两边都要
每只桌宠的 display 决定它住在哪:
web:只在 DSH 网页 overlay 里显示desktop:只开一个独立透明置顶小窗(Electron 局部窗,跟随宠物移动、不铺满屏幕)both:两边同显none:纯后台,不显示
桌面模式下多开同样生效——每只宠物各占一个小窗,行为与浏览器端严格一致。右键菜单在桌面端还有「打开网站」「查看余额」「重载配置」等专属项:
多屏用户还可以看全局字段 confineToScreen:设为 true 后,甩出去的宠物只在松手的那块屏幕内弹(屏缝当墙),不会飞到隔壁屏。
方式二:config.jsonc 手写 pets 数组(完全自由)
两条途径最终都是同一份用户配置($DSH_HOME/dsh-pet/main-config.jsonc),手写时照着包内默认 dsh-pet/assets/config.jsonc 的结构写即可,缺的字段自动回落默认。多开的本质就是往 pets 数组里加条目:
"pets": [
{ "id": "main", "size": 462, "balanceEnabled": true, "display": "both",
"position": { "corner": "top-right", "marginX": 24, "marginY": 100 } },
{ "id": "pet-2", "size": 110, "balanceEnabled": false, "display": "web",
"position": { "corner": "bottom-left", "marginX": 40, "marginY": 40 } }
]
三条硬性规则,踩了会加载时报错而不是静默跑残缺:
id数组内必须唯一,且不能与 pet pack 种类里的实例 id 冲突balanceEnabled是必填布尔(每只宠物独立控制余额动画与气泡)display必须是web / desktop / both / none之一
改完配置文件:桌面端右键菜单「重载配置」一键刷新全部桌宠,浏览器端刷新页面即可。
多开常见问题速查
| 问题 | 原因与解决 |
|---|---|
| 保存后没变化 | 「添加宠物」的模板取自 pets[0];设置页保存即时生效,改配置文件则需重载/刷新 |
| 加载报错被跳过 | 通常是 id 冲突或 balanceEnabled / display 缺失,按 shared/types.ts 里的结构补全 |
| 想删到只剩一只 | 至少保留 1 只桌宠,删最后一只时设置页会弹说明 |
| 桌宠自己走来走去占位 | 给该只开启 fixedEnabled(宠物固定):随机动画链不再抽转向/移动,只播原地待机与小动作;右键点播不受限 |
| 甩出去的宠物撞同伴 | 设置页物理区开启「宠物互撞」:飞行中按动量守恒弹开(质量 ∝ size²) |
进阶:用 pet pack 摆上"不同种类"的桌宠
pets 数组多开的是同一种类的多个实例(共用一份动画池)。想同屏摆放完全不同形象的桌宠,用 pet pack:在用户数据根下建 pet/ 目录,放 种类名-config.json + 种类名-animation/ 素材即自动发现,该种类可再开任意多只实例,且与主宠物素材严格隔离、绝不混用。
小结
- 多开 =
pets数组多条目,每只独立id/size/position/display - 新手走设置页「桌宠配置」:添加宠物 → 调大小位置 → 保存,全程不碰文件
- 老手写 config.jsonc 同构结构,注意 id 唯一、两个必填布尔
- 想换形象再上 pet pack,还能接着 README.md 的 DIY 素材链用 AI 视频生成自己的专属桌宠





