DSH Desktop 故障排查

当安装被拦截、应用意外重启或需要报告问题时，请参考本指南。

Windows SmartScreen 警告

预览版未签名。核对 SHA-256 校验值后，在 SmartScreen 弹窗中选择 更多信息 → 仍要运行。

macOS Gatekeeper 警告

右键点击应用选择打开，再确认打开。若 macOS 仍拦截，请先核对下载文件校验值再重试。

崩溃或反复重启

sidecar 监督整个 Harness 进程树，默认约 40 秒无心跳后自动重启。反复重启通常表示 Harness 事件循环被长任务阻塞。

收集诊断信息

打开 bootstrap 窗口，使用“复制诊断信息”按钮复制 JSON 快照。提交 issue 时附上该快照——它包含状态、版本与精确数据路径。

已知限制

GitHub 预览包尚未代码签名/公证；单独发行的 Windows 版支持签名且需用户确认的更新，Store 版交由 Microsoft Store 更新，macOS 仍需手动更新。GitHub Releases 发布 Windows x64 与 macOS Apple Silicon，Windows arm64 已为 Microsoft Store 准备。

排查 DSH Desktop 问题

确认症状：安装警告、崩溃、重启或功能缺失。
按本指南应用对应的处理步骤。
问题持续时，复制应用内诊断信息。
提交 GitHub issue 并附上诊断 JSON。