桌面不显示与启动
先按具体症状选页；历史报告与主线文档的适用范围在各页注明。
桌宠装好了但桌面上不显示？先查这三处
dsh-pet 桌面模式不显示的排查方法：确认 helper 进程是否启动、查看日志找真实报错、区分 ELECTRON_RUN_AS_NODE 污染和窗口未显示两种原因。
Mac / Linux 下载 Electron 后桌宠仍起不来怎么办
把错误平台的运行时与 ZIP 解压失败分开排查；网页正常时先使用仅网页模式。
桌面 helper 秒退、无输出或疑似权限受限
桌面 helper 秒退、无输出或疑似权限受限：区分历史报告与当前版本，按症状恢复、复测并保留可用的替代显示方式。
装了虚拟显示器后网页正常、桌面宠物不显示
装了虚拟显示器后网页正常、桌面宠物不显示：区分历史报告与当前版本，按症状恢复、复测并保留可用的替代显示方式。
无头服务器 / 容器运行桌宠，助手反复崩溃怎么办
没有图形桌面的服务器优先使用网页模式；先停止崩溃循环，再检查磁盘占用。
桌面红条 config http 403，网页宠物正常
0.2.2 报告 DSH Desktop advanced 模式下网页 overlay 正常，桌面 helper 每隔数秒显示配置加载失败 config http 403。