DeepSeek Harness 桌面端卸载不干净怎么清?DSH plugin 桌面版残留目录与重装异常
DeepSeek Harness 桌面端「卸载不干净」,残留几乎都在壳层:Electron 用户数据、更新产物缓存、NSIS 安装临时解压目录,以及桌面端接共享模块用的目录软链接(macOS / Linux)与 junction(Windows)。其中最容易被误判的是共享链接——官方明确清理时只移除链接、不删除它的目标,所以「目录看着删了、目标还在」是正常现象,不是没删掉。
这篇按「有哪些壳层残留 → 共享链接为什么像没删 → 逐目录定位与清理顺序 → 何时改用重置」四步讲。卸载的正常范围与命令注册迁移见《DeepSeek Harness 桌面端怎么卸载》。
DeepSeek Harness 桌面端卸载后会留下哪些壳层残留
官方写明 Windows 卸载会删除 Electron 用户数据目录、%APPDATA% 下的产品目录、%LOCALAPPDATA% 下的更新下载缓存,并清理 %APPDATA% 之下普通且已空的作用域目录;安装阶段还会清理 NSIS 安装用的临时解压目录——但安装失败时这些临时目录会留下来(来源)。
按下面四类逐一定位,用命令确认到底留了什么:
- Electron 用户数据 — macOS / Linux 跑
ls -la ~/Library/Application\ Support/ | grep -i deepseek,Windows 跑dir "%APPDATA%" | findstr /i deepseek。预期:能看到桌面端的浏览器存储、缓存等目录。 - 更新产物缓存 — Windows 跑
dir "%LOCALAPPDATA%" | findstr /i deepseek与dir "%LOCALAPPDATA%" | findstr /i updater。预期:能看到更新下载缓存目录。 - NSIS 安装临时解压目录 — Windows 跑
dir "%TEMP%" | findstr /i deepseek。预期:安装成功时为空;安装失败时这里会留下解压出来的文件。 - 共享链接 — macOS / Linux 跑
find ~/.dsh -type l -maxdepth 4,Windows 跑dir /S /AL "%DSH_HOME%"。预期:列出所有软链接 / junction,这是下一节的重点。
第 3 类是「卸载不干净」的常见来源:安装失败留下的临时解压目录不在正常卸载清单里,因为正常流程会在安装阶段清掉它,失败路径才会残留。重装前先看一眼 %TEMP%。
共享链接是残留的关键:清理只移除链接、不删除目标
桌面端用共享链接把共享模块接进应用——macOS 与 Linux 是目录软链接、Windows 是 junction;官方明确清理时只移除链接、不删除它的目标(来源)。所以「目录看着删了、目标还在」不是没清理干净。
先用命令把链接和真身分清楚:
- 列链接 — macOS / Linux 跑
ls -la看->指向,或find ~/.dsh -type l;Windows 跑dir /AL(只列重解析点)或dir /S /AL。预期:每个链接都有明确的-> 目标或<JUNCTION>标注。 - 确认目标仍在 — 顺着
->或 junction 目标去看真实目录。预期:目标目录还在且内容完整,说明删的是链接不是数据。 - 只删链接 — macOS / Linux 用
rm <链接路径>(不加-r追进目标);Windows 对 junction 用rmdir <链接路径>,不要加/S。预期:链接消失、目标保留。 - 再核对 — 回到 DSH Plugin Hub 的已安装列表看插件是否还在。预期:插件仍在(目标没被删)说明只动了链接;插件没了说明误删了目标,要从备份或重装恢复。
第 3 步的写法差别就是误删与否的分水岭:Windows 上 rmdir 删 junction 只移除链接,rmdir /S 会跟进去删目标;Unix 上 rm link 删链接,rm -r link/ 会递归目标。这正是官方强调「只移除链接、不删除其目标」的原因。
DeepSeek Harness 桌面端卸载不干净:逐目录定位、清理顺序与重装异常
「卸载不干净」导致重装仍是旧状态,说明残留的壳层数据或链接还在被复用;按「先列链接 → 清链接 → 清壳层数据 → 必要时重置」的顺序处理,比对着一堆目录一顿删更有效。
按顺序执行,每步都有可核对的预期:
- 先备份要保的数据 — 确认
~/.dsh(会话、设置、凭据、插件)不在清理目标里。预期:清理范围只限壳层,共享数据不被碰。 - 清共享链接 — 用上一节的方式移除软链接 / junction。预期:链接消失、目标保留。
- 清壳层数据 — 删除 Electron 用户数据、
%APPDATA%/%LOCALAPPDATA%下的产品目录与更新缓存、%TEMP%下的安装临时目录。预期:dir/ls再查已无对应目录。 - 重装并核对 — 重装桌面端,回 DSH Plugin Hub 已安装列表确认插件恢复。预期:列表显示正常,重装后不再是旧状态;若仍是旧状态,说明问题在
profiles/desktop这一层,改走第 5 步。 - 必要时改用重置 — 桌面端自己的可执行层有问题时用重置。预期:重置删除
profiles/desktop中除事务锁外的所有条目并重新初始化内置 profile,但共享任务、设置与 Harness-home 的.env不变。
为什么第 5 步比反复卸载更对症:反复卸载清的是应用与壳层,从来不动 $DSH_HOME/profiles/desktop 这一层;桌面端配置与第三方包留在这里,重装自然还是旧状态。只有当残留确实在系统壳层时才靠卸载 + 手动清,否则用重置。
DeepSeek Harness 桌面端卸载清理的注意事项
- 删链接别跟目标:Unix 用
rm <link>、Windows 对 junction 用rmdir,都不加递归跟随参数,避免误删真实数据。 - 临时目录别忘查:NSIS 安装失败会在
%TEMP%留下解压目录,正常卸载清单不含它。 - 共享数据不在清理范围:
~/.dsh的会话、设置、凭据、插件保留;要彻底清需自己确认后删除。 - 壳层问题才靠卸载:桌面上不来的根因在
profiles/desktop时,重置比卸载重装更直接。 - 清理顺序:先列链接、再清链接、后清壳层,最后才重装核对,顺序反了容易把目标一起删掉。
清完残留重装 DSH插件时,用 DSH Plugin Hub 在已安装列表里一眼确认哪些插件恢复了、哪些要补装,比一条条记包名省事。

来源:DeepSeek Harness 桌面端 README(官方仓库)、DeepSeek Harness 源码仓库、dshplugin/dsh-plugin-hub
常见问题
DeepSeek Harness 桌面端卸载后,最容易留下的是壳层目录:Electron 用户数据、更新产物缓存,以及 NSIS 安装阶段用的临时解压目录。官方说明 Windows 卸载会清 Electron 用户数据、%APPDATA% 产品目录与 %LOCALAPPDATA% 更新缓存,安装阶段也会清理临时解压目录,但安装失败时这些临时目录会留下来。
这是共享链接的机制造成的:DeepSeek Harness 桌面端在 macOS 与 Linux 上用目录软链接、在 Windows 上用 junction 把共享模块接进应用,官方明确清理时只移除链接、不删除它的目标。所以删掉链接后目标目录(真实数据)还在原地,「卸载不干净」的观感就来自这里。
只要按链接的方式删除就不会误删目标。macOS 与 Linux 上用 ls -la 能看到 -> 指向,Windows 上用 dir /AL 能列出 junction 等重解析点;删链接时不要加递归跟随(Windows 用 rmdir 而不是 rmdir /S 去跟目标),链接本身被移除,目标目录保留。这正是官方所说的「只移除链接、不删除其目标」。
重装还是旧状态说明残留的配置或链接还在被复用。建议按「逐目录定位 → 清链接 → 清壳层数据 → 必要时重置」的顺序处理:先用 dir /AL、find -type l 找出共享链接,再清 Electron 用户数据、更新缓存与安装临时目录,最后若桌面端仍异常,用桌面端的重置把 profiles/desktop 恢复初始,而不是反复卸载重装。
当问题出在桌面端自己的可执行层而不是系统里还有文件时,应该用重置。官方说明重置会删除 $DSH_HOME/profiles/desktop 中除事务锁外的所有条目、重新初始化内置 profile,但共享任务、设置与 Harness-home 的 .env 不变。反复卸载不会清这一层,重装后当然还是旧状态,这种场景用重置更对症。
相关术语
- 共享链接(shared link)
- 共享链接是 DeepSeek Harness 桌面端把共享模块接进应用时使用的目录链接,macOS 与 Linux 用目录软链接、Windows 用 junction,官方要求清理时只移除链接、不删除其目标。— DeepSeek Harness 桌面端 README
- junction
- junction 是 Windows 上的目录链接形式,DeepSeek Harness 桌面端在 Windows 用它在应用与共享模块之间建立链接,卸载与 smoke 验证都要确认它能被正确清理。— DeepSeek Harness 桌面端 README
- NSIS 安装临时解压目录
- NSIS 安装临时解压目录是 DeepSeek Harness 桌面端在 Windows 上用安装器解压产物时的临时目录,安装阶段会清理,但安装失败时会残留下来。— DeepSeek Harness 桌面端 README
- 更新产物缓存
- 更新产物缓存是 DeepSeek Harness 桌面端在 Windows 上 %LOCALAPPDATA% 下存放更新下载内容的缓存目录,卸载程序会连同它一起删除。— DeepSeek Harness 桌面端 README
来源
- DeepSeek Harness 桌面端 README· deepseek-ai
- DeepSeek Harness 源码仓库· GitHub
- dshplugin/dsh-plugin-hub GitHub 仓库· GitHub