其他分类 · 4 11 月, 2026 0

DeepSeek Harness因工作区无法访问而启动失败的修复方法

本文适用于官方 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)让程序重建配置,但会丢失所有会话与工作区记录。