更新桌宠后 DSH 启动失败 / 宠物消失怎么办
先区分包更新失败、插件激活失败与旧配置不兼容，保留现场后再恢复。
你会看到什么
- Windows 更新卡住，日志含
ERR_PNPM_EPERM、rename，下次启动提示无法解析 dsh-pet 包。 - DSH 启动提示
1 entry did not activate或dsh-pet: failed。 - DSH 正常启动，但升级后宠物全端消失，日志明确提示某只宠物缺少
display。
为什么会这样
#88 的 Windows 0.3.5 → 0.3.6 案例发现运行中的助手以包目录为工作目录，更新改名失败，旧目录被清空。#25 的 0.2.0 → 0.2.2 案例则是旧配置缺少必填字段。#80 只留下 0.3.1 在 Desktop 0.2.0-rc.2 激活失败的部分正文，没有完整根因或修复步骤，不能混为同一个故障。
解决步骤
- 启动都失败时先恢复宿主。
如果桌面端出现启动恢复助手，使用其中停用 dsh-pet 的操作再启动；#88 的报告者通过这个入口恢复。没有恢复入口时，不要猜改 profile 文件，保留错误并向宿主官方求助。
- 更新失败先退出，再重新安装。
保存工作，正常退出 DSH，确认相关桌面助手已经退出；通过桌面应用自带 CLI 或应用提供的受支持安装入口恢复插件。终端入口见桌面版 CLI 说明。如果必须重新打开应用才能安装，先保持桌宠停用。不要反复点击更新，也不要手动把临时目录覆盖回包目录。
- 只有明确缺少 display 时修旧配置。
正常退出 DSH 并备份日志指出的配置文件。#25 的旧文件是
~/.dsh/dsh-pet/main-config.json；后续环境可能使用 jsonc，按当前配置说明核对，别新建同名文件猜读取顺序。在原有pets数组中，只给缺少字段的宠物对象补上"display": "web"，逗号保持合法，保留其他内容。此值先用于网页验证。
怎么确认有效
重新启动能进入原工作区，日志不再有原来的包解析、激活或配置错误，再检查网页宠物。恢复桌面显示前先看桌面不显示排查。
如果还不行
还原自己修改的配置备份，保持插件停用，提交升级前后版本、错误全文与恢复助手结果。本文没有确认修复版本，原报告的「必然」描述不应推广到所有系统与版本。
来源与适用范围
原始报告：#88、#25、#80。本文依据已保存的 issue 正文整理，并对照官方 INSTALL 与 CONFIG 文档；未核查后续评论、当前源码与发布记录；报告中的分析和版本仅用于定位，不能据此认定当前版本仍有同样问题或已有修复。
官方参考：安装说明、配置说明（2026-11-03 查阅的上游快照）。配置和运行时目录应以该实例实际使用的 DSH_HOME 为准，~/.dsh 只是默认路径示例。官方安装文档要求安装后重开 DSH；网页实例则重启 dsh web。
首次自动下载 Electron 后，主窗口完全不开
#24记录插件 0.2.1 与旧 Desktop 环境：日志停在 ensure-electron，报告将其定位到使用宿主 process.execPath 运行下载脚本、引起重入和阻塞；还涉及自定义 DSH_HOME 与探测路径不一致。先使用受支持恢复入口停用插件，保留日志，再按同版本官方说明恢复。报告中的手动下载到默认目录只是旧环境旁路，不能推广为通用安装步骤。
想找应用内更新入口可参考#278：这是更新按钮需求，不能据此宣称已有自动更新功能。先备份并使用你版本实际提供的插件管理入口。
资料来源（历史报告）：#24、#25、#80、#88、#278。整理日期：2026-11-03，适用版本及证据限制见正文。