首要检查
- 重启桌面端并等待健康检查。
- 确认回环端口未被安全软件阻止。
- 检查首次运行下载是否完成。
- 打开应用数据
logs目录中的服务日志。 - 记录桌面版本、系统、活动 Profile 与内核来源。
常见问题
安装下载失败
安装下载失败
确认可访问 Node.js、npm registry 和 GitHub Releases。瞬时故障后重试；企业代理或 TLS 拦截可能需要管理员配置。
Harness 无法打开
Harness 无法打开
其他进程可能占用端口。应用通常会自动选择更高的可用端口；查看
logs/dsh-web.log 获取准确错误。Linux 黑屏或崩溃
Linux 黑屏或崩溃
Wayland 下优先
.deb；AppImage 可尝试：无法识别 dsh
无法识别 dsh
启用 CLI 集成并打开全新终端，确认平台 shim 目录位于
PATH。插件损坏
插件损坏
打开插件设置并记录错误，再对可选插件执行升级、恢复或卸载；必需内部插件会在启动时恢复。