网页 overlay 拖出窗口后宠物点不到

整理：大肥鱼桌宠排障手册 · 上线 2026-11-04 · 页面维护 2026-11-04 · 资料快照 2026-11-03

本页目录

• 按顺序恢复
• 怎样确认恢复
• 仍未恢复时
• 配置与版本边界
• 来源与反馈

#216 报告的是网页 overlay：把宠物拖到左／右侧窗口外，停约 0.2 秒再松手，点击区域留在视口外。实测版本为 0.3.6；报告者只核对了 0.3.8 源码，没有实机验证该版本；桌面模式是否同样受影响也未验证。

按顺序恢复

1. 先刷新当前网页，检查宠物是否回到可点击区域；刷新是原报告明确有效的恢复方式；扩大窗口只能作为尝试，原报告指出 resize 不会自动纠正越界。
2. 能点到宠物时，用菜单中的回到初始位置操作；完全点不到时进入 DSH 设置中的桌宠配置，把大小调小、位置改为留有边距的角落并保存。
3. 设置页也不可用时，备份用户配置，再只调整目标宠物的 pets[].position 和 size；正常重启宿主后重开网页。这是配置对照尝试，运行时拖拽位置可能优先于停靠角，不能保证找回；不要删整份数据或素材。

怎样确认恢复

在窗口中央拖动并松手，确认右键可用；缩小窗口后再次确认宠物可点击。恢复后避免再次执行“拖出边界、停住、松手”的触发动作。

仍未恢复时

暂时保留较小尺寸和较大边距；如仍无法恢复，记录浏览器窗口尺寸、宠物大小与位置，使用其他显示方式前先确认其可用。

配置与版本边界

优先使用设置页。手动修改前备份用户配置：默认通常是 ~/.dsh/dsh-pet/main-config.jsonc；若设置了 DSH_HOME，应使用 $DSH_HOME/dsh-pet/main-config.jsonc。位置在 pets[].position，显示方式在对应宠物的 display，不要用一个不完整的 pets 数组覆盖其他宠物。

本文依据历史 issue 和研究时取得的 main 文档快照。main 的能力、本地验证补丁、PR 与已安装 npm 发布版不同；升级前核对实际版本及发布说明，并保留配置备份。

来源与反馈

历史报告：#216。配置结构参见 上游 CONFIG.md；当前开发分支能力参见 README。反馈请附实际版本、系统、显示方式、最短复现步骤及脱敏日志。

资料来源（历史报告）：#216。整理日期：2026-11-03，适用版本及证据限制见正文。