多只桌宠同屏不打架:dsh-pet 多开配置与大小位置自由摆放完全手册

原创2026-10-13 21:44:245,171 阅读
文章标签:dsh-plugin桌面应用前端AI 插件AI 应用

多只桌宠同屏不打架:dsh-pet 多开配置与大小位置自由摆放完全手册

dsh-pet 是一款透明动画桌面宠物插件,支持多开——同一屏幕同时养多只桌宠,每只可以独立设置大小(宽度像素)、位置(四角 + 边距)和显示端(浏览器 / 桌面 / 双端)。本手册带你从零完成多只桌宠的同屏摆放,从设置页一键添加,到 config.jsonc 手写配置全覆盖。

dsh-pet 多只桌宠同屏运行效果

为什么多只桌宠能同屏不打架?

dsh-pet 的每只桌宠都是一个独立实例,核心靠四个字段区分(见 config.jsonc 的 pets 数组):

字段 作用 说明
id 唯一标识 素材、记忆、API 都按它定位,不能重复
name 显示名 悬浮提示用,可省略(省略时按 id 显示)
size 宽度(px) 高度自动 = 宽度 × 9/16
position 角落 + 边距 corner 四角之一,marginX / marginY 距角落偏移

此外每只还有必填的 balanceEnabled(余额开关)与 display(显示端:web / desktop / both / none)。因为各实例大小、位置完全独立,同屏自然互不干扰;即使把多只摆得很近,它们也只会"友好路过"——宠物间的碰撞默认是关闭的。

方式一:设置页「桌宠配置」一键多开(推荐新手)

新手不用碰文件,设置页就能完成全部多开操作:

  1. 打开 DSH 设置 → 左侧「桌宠配置」
  2. 顶部是宠物标签页,每只宠物显示 id (宽度px),点「+ 添加宠物」复制一只新实例
  3. 选中要调整的宠物标签,修改三项:
    • 大小:填宽度 px,右侧实时提示"高度自动 = 宽度 × 9/16"
    • 位置:下拉选四角(右上角 / 左上角 / 左下角 / 右下角)
    • 水平偏移 / 垂直偏移:marginX / marginY,微调离角落的距离
  4. 按需勾选「余额功能」,点「保存」即时生效(无需刷新页面)

dsh-pet 设置页桌宠配置面板多开大小位置调节

设置页还能图形化调整拖拽抛掷的物理手感(重力 / 弹性 / 摩擦 / 宠物互撞等,逻辑在 physics.ts),以及「同步」按钮——把包内默认配置原文整份写入用户配置,既回到默认,又留下一份带注释、可直接编辑的完整文件。

大小怎么调:一个 size 管全身

大小只有一个输入:宽度像素,高度按 9:16 自动算。想养"一大一小"的对比感,直接给不同宠物填不同 size 即可——上面的设置页截图里就有 462px 的大女仆配 110px 的小跟班。

小提醒:屏幕漫游的移动距离会按 实际 size / 462 等比缩放,小宠物挪小步、大宠物迈大步,动作永远与体型匹配,不会出现"小宠物一步跨半屏"的违和感。

dsh-pet 桌宠自定义位置左下角小尺寸摆放

位置怎么摆:四角 + 双偏移精确定位

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:纯后台,不显示

桌面模式下多开同样生效——每只宠物各占一个小窗,行为与浏览器端严格一致。右键菜单在桌面端还有「打开网站」「查看余额」「重载配置」等专属项:

dsh-pet 桌面模式透明置顶小窗右键菜单

dsh-pet 桌面应用内两只桌宠同屏多开效果

多屏用户还可以看全局字段 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 } }
]

三条硬性规则,踩了会加载时报错而不是静默跑残缺:

  1. id 数组内必须唯一,且不能与 pet pack 种类里的实例 id 冲突
  2. balanceEnabled 是必填布尔(每只宠物独立控制余额动画与气泡)
  3. display 必须是 web / desktop / both / none 之一

改完配置文件:桌面端右键菜单「重载配置」一键刷新全部桌宠,浏览器端刷新页面即可。

dsh-pet 多只桌宠同屏余额气泡独立显示

多开常见问题速查

问题 原因与解决
保存后没变化 「添加宠物」的模板取自 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 视频生成自己的专属桌宠
登录后查看全文
dsh-pet