装了虚拟显示器后网页正常、桌面宠物不显示

本页目录

#195 的个案环境为 Windows 11、DSH 0.2.1-rc.2、dsh-pet 0.3.8 和 Electron 43.3.0,装有多个虚拟显示适配器。报告把 helper 的 GPU 进程初始化失败与该环境关联;不能推断所有虚拟显示器都会导致崩溃。

按顺序恢复

  1. 先将显示方式设为网页并确认能出现;网页正常只能说明素材与网页路径可用,不能证明桌面 helper 已运行。
  2. 正常退出并重新打开 DSH 一次,查看日志是否同时出现 GPU process exited unexpectedly、GPU process isn’t usable 或同义英文原文,以及 helper 退出记录。
  3. 记录远程桌面、虚拟显示软件名称及是否正在使用。仅在本地操作且确认不会切断远程连接时,正常退出相关应用后复测;退出应用不等于卸载驱动,也不保证排除其影响。
  4. 核对已安装版本的发布说明,寻找明确针对该问题的修复。报告中的本地补丁和关联 PR #196 不等于已发布到 npm。

怎样确认恢复

重启后桌面宠物持续可见、可点击,日志不再连续重试才算恢复。单独看到退出码 0x80000003 不足以确定 GPU 根因。

仍未恢复时

使用 display: "web" 保持网页可用,并提交 GPU 日志与显示适配器信息。无需为此默认卸载驱动或关闭沙箱。

配置与版本边界

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

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

来源与反馈

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

为什么相似环境仍可能修不好

#244记录 GameViewer / Windows 11 环境下的后续失败,包含 0xC0000005,说明 #195 的实验方案不能覆盖所有机器。报告者对旧 Electron 的个案验证不是普遍降级建议。先保留当前运行时版本和日志,用网页模式绕过,不混装不同版本的 helper 文件。

资料来源(历史报告):#195、#244。整理日期:2026-11-03,适用版本及证据限制见正文。