安装、更新与反代
先按具体症状选页；历史报告与主线文档的适用范围在各页注明。
桌宠安装失败：提示「没有声明组合包」怎么办
先区分输入的是仓库地址还是包名，再确认安装入口与宿主版本；不要反复重装整个 DSH。
桌面版安装桌宠报 desktop profile 错误怎么办
出现 managed exclusively by the Electron application 时，先查命令来自哪一份 DSH。
更新桌宠后 DSH 启动失败 / 宠物消失怎么办
先区分包更新失败、插件激活失败与旧配置不兼容，保留现场后再恢复。
DSH 启动提示 /pet 重复注册怎么办
日志出现 duplicate prefix route "/pet" 时，先恢复宿主启动，再定位冲突插件组合。
反代后桌宠 404 / 页面卡住怎么办
先分清子路径请求丢前缀与隧道高频请求，两种问题的证据和绕过方法不同。
右键打开 DSH 弹商店窗口或出现 401
#112 在 Windows 未注册 dsh:// 协议时打开菜单弹商店对话框；#87 则是浏览器打开裸地址后提示 web authentication required。
退出 DSH 后桌宠报 write EPIPE 或仍留后台
macOS 的 0.2.9 bridge 模式和 0.2.11 报告宿主退出后 helper 仍在，Electron 弹 Uncaught Exception: write EPIPE。
点“解决”后轨迹正常，对话区却空白
报告限定于 Windows 独立版 watchdog 与 dsh-pet-bridge，DSH 0.2.0-rc.2 / 0.2.1-alpha.1：点控制卡“解决”后所有会话对话区空白，轨迹仍可见。