先保留错误和日志，每次只改变一个条件。不要把删除数据作为第一步。
首要检查
- 从帮助 → 运行日志复制日志，或打开应用数据中的
logs/dsh-web.log。
- 记录桌面版本、系统与架构、活动档案、内核版本和来源。
- 确认首次运行下载已完成，检查界面显示的实际服务地址。
- 保存活动任务和仓库修改后，再重启应用并等待健康检查。
按症状处理
插件恢复与安全模式
- 有单插件快照时，恢复页提供从快照还原；没有快照时不要假定可以回滚。
- 卸除此插件并继续检测针对列出的插件，不等于删除工作区或清空会话。
- 仍不能启动时可使用安全模式切到
safe 档案，只加载核心与内置插件。
安全模式用于启动排障，不是安全沙箱。它会移除 safe 档案中的非内置插件，并把无法解析的补丁改名为 .broken-<时间戳>。恢复后切回原档案；重置、删除或覆盖还原前先备份。
Linux 黑屏
Wayland 下可先尝试 .deb。AppImage 仍黑屏时尝试：
区分开发与正式环境
Debug 使用 ~/.dsh.dev（忽略继承的 DSH_HOME）及应用数据的 dev/ 运行目录。服务日志为 dev/logs/dsh-web.dev.log，首选端口 3081；正式版首选 3080。两者都可能回退到其他端口，排障时不要混用日志和目录。
获取帮助
提供复现步骤、版本信息和最小相关日志；先移除密钥、令牌、私人路径、提示、仓库内容与个人数据。 
