dsh-web-pets

使用

并入 dsh-web-ui 的 pet 界面（单宠物切换器）

本插件并入 dsh-web-ui 的宠物入口，而不是独立的第二个 webpet：先安装 dsh-web-ui（@linxin666/dsh-web-ui-all，内置鲸鱼宠物 dsh-pet），再安装本插件后，设置 → Web UI 插件 → 宠物区域会出现本插件的「宠物选择」卡片（与上游鲸鱼卡片同一槽位 web-ui.plugin.item，紧随其后）。卡片内：

• 宠物切换：列出 鲸鱼娘（上游 dsh-pet）、豆豆（demo）、雷米埃尔（remiel） 以及你添加的自定义宠物，点击即切换——任意时刻只显示一只宠物：
  • 选我们的宠物 → 自动关闭上游鲸鱼（写 dsh-pet 的 pet 设置命名空间 enabled=false），我们的宠物在右下角显示；
  • 选鲸鱼 → 本插件 enabled=false（完全不渲染，连召唤按钮都不出现），鲸鱼由上游插件正常显示；
• 调整参数与官方 dsh-pet 一致（同名同界）：
  • 大小：− / ＋ 调节（32–512px）；
  • 位置：右 / 下 − / ＋ 调节（0–10000px）；
  • 名称：输入自定义名（≤20 字符）保存；
  • 镜像：↔ 水平 / ↕ 垂直 切换按钮（与原生 desktop-pets 的 mirror_x/mirror_y 语义一致）；
  • 显示 / 隐藏：开关我们的宠物（隐藏后右下角保留 🐾 召唤按钮）；
• 底部状态行：当前显示哪只宠物 + 表情状态/气泡（运行中会显示如「🖥 命令 · ls -la」的工具气泡）。
• 首次加载防双宠：若检测到上游鲸鱼活跃且本插件 enabled 从未被显式配置，会自动隐藏本插件宠物（持久化），安装后默认仍显示鲸鱼，由你在 pet 界面切换。

卡片自包含：我们的宠物状态直接读写 /api/web-pets/*；对上游鲸鱼的启停经 pet 设置命名空间（webUiSettings/settingsScope 绑定器——'pet' 在 dsh-web-ui 家族桥接白名单内，可写 enabled），不 fork、不复制、不修改上游代码。rc.6 官方 settings 白名单硬编码、第三方 namespace 不可写，因此我们自己的配置不走命名空间。

若只想用我们的宠物、彻底不要鲸鱼，也可在 profile 的 cordis.patch.yml 加 - disable: pet；反之 - disable: web-pets 可只留鲸鱼。

悬浮桌宠（我们的宠物被选中时）

• 拖拽移动：按住桌宠拖动即可换位置（与官方 dsh-pet 一致，松手自动持久化 right/bottom）。
• 右键桌宠 → 菜单：切换宠物（内置 demo / remiel）、缩小 / 放大、↔ 水平镜像 / ↕ 垂直镜像、隐藏宠物。
• 隐藏后：右下角出现 🐾 召唤按钮，点击召回。
• 点击桌宠：摸头互动气泡。
• 会话开始工作后桌宠会自动进入对应状态表情。
• 当上游鲸鱼被选中时，本插件悬浮层完全不渲染。

兼容性契约（上游 dsh-web-ui 更新时保持兼容）

本插件只依赖以下稳定公开接口；任一项在上游更新后变化，对应功能降级、其余照常工作：

依赖接口	用途	上游变化时的降级
web-ui.plugin.item 槽位（dsh-web-ui 设置组声明）	宠物选择器卡片展示	卡片不显示；悬浮宠 + 右键菜单照常
pet 设置命名空间 + webUiSettings/settingsScope 绑定器	切换鲸鱼 enabled	无法切换鲸鱼 → 鲸鱼选项隐藏并提示；我们的宠物照常
/api/pet/state（dsh-pet 路由）	探测鲸鱼是否活跃	探测失败 → 鲸鱼选项隐藏
dsh 官方 dsh.client 机制 + __ModuleLoader__ bundle 形态	插件装载	随 dsh 生态演进，按官方形态适配

本插件单装（无 dsh-web-ui）也可独立工作：右下角一只悬浮宠 + 右键菜单 + 自有设置卡片（若装有设置组）。