本文适用于官方 Windows 桌面版 DeepSeek Harness(DSH)。若工作区中有不可达的路径(如断开的网络驱动器)时,程序可能会无法正常启动。此时可通过删除 workspace.json 中失效条目及 session 下对应会话目录来修复。文中含完整步骤与注意事项。
问题现象
- 工作区中有不可达的路径(如断开的网络驱动器)时,DSH 启动后仅在任务栏显示图标,界面不出现。
原因
DSH 启动时读取 storages\workspace.json 中的工作区列表并逐一加载。当某工作区指向的网络驱动器不可访问时,加载阻塞,程序无法完成启动。同时,session 目录下以该工作区路径命名的会话目录也参与启动恢复流程,需一并清理。
修复步骤
1. 完全退出 DSH
在任务管理器中确认无 DeepSeek Harness 相关进程残留。
2. 编辑 workspace.json,删除失效条目
- 打开
C:\Users\你的用户名\.dsh\storages\workspace.json(先备份)。 - 找到对应失效网络驱动器路径的条目并删除,注意保持 JSON 逗号格式正确。
- 保存为 UTF-8 无 BOM 编码,避免解析失败。
3. 删除 session 下对应的会话目录
- 进入
C:\Users\你的用户名\.dsh\session\。 - 目录命名规则:路径中特殊字符替换为
-,两端各加--。例如z:\xxx→--z-xxx--,D:\projects\demo→--D-projects-demo--。 - 删除对应目录(建议先备份)。
4. 重新启动 DSH
程序应正常加载,主界面正常显示。除被删除的工作区外,其他工作区中的会话均被保留。
注意事项
- 操作前备份
workspace.json和待删session目录。 - 编码务必为 UTF-8 无 BOM,否则 JSON 解析失败会引发新的启动问题。
- 尽量避免将不稳定的网络驱动器作为工作区;如需使用,确保 DSH 启动时始终可访问,或优先选用本地路径。
- 若使用本文介绍方法仍无法解决,可重命名整个
.dsh目录(如.dsh_old)让程序重建配置,但会丢失所有会话与工作区记录。
