DeepSeek Harness 桌面端卸载不干净怎么清?DSH plugin 桌面版残留目录与重装异常

卸载与清理发布于 2026-10-04作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin桌面端卸载卸载不干净残留清理junction软链接
DeepSeek Harness 桌面端卸载不干净,残留多半在壳层:Electron 用户数据、更新产物缓存、NSIS 安装临时解压目录,以及 macOS / Linux 的目录软链接与 Windows 的 junction。本文给出逐目录定位命令、清理顺序,以及何时该改用重置而不是反复卸载。

DeepSeek Harness 桌面端「卸载不干净」,残留几乎都在壳层:Electron 用户数据、更新产物缓存、NSIS 安装临时解压目录,以及桌面端接共享模块用的目录软链接(macOS / Linux)与 junction(Windows)。其中最容易被误判的是共享链接——官方明确清理时只移除链接、不删除它的目标,所以「目录看着删了、目标还在」是正常现象,不是没删掉。

这篇按「有哪些壳层残留 → 共享链接为什么像没删 → 逐目录定位与清理顺序 → 何时改用重置」四步讲。卸载的正常范围与命令注册迁移见《DeepSeek Harness 桌面端怎么卸载》。

DeepSeek Harness 桌面端卸载后会留下哪些壳层残留

官方写明 Windows 卸载会删除 Electron 用户数据目录、%APPDATA% 下的产品目录、%LOCALAPPDATA% 下的更新下载缓存,并清理 %APPDATA% 之下普通且已空的作用域目录;安装阶段还会清理 NSIS 安装用的临时解压目录——但安装失败时这些临时目录会留下来(来源)。

按下面四类逐一定位,用命令确认到底留了什么:

  1. Electron 用户数据 — macOS / Linux 跑 ls -la ~/Library/Application\ Support/ | grep -i deepseek,Windows 跑 dir "%APPDATA%" | findstr /i deepseek。预期:能看到桌面端的浏览器存储、缓存等目录。
  2. 更新产物缓存 — Windows 跑 dir "%LOCALAPPDATA%" | findstr /i deepseek 与 dir "%LOCALAPPDATA%" | findstr /i updater。预期:能看到更新下载缓存目录。
  3. NSIS 安装临时解压目录 — Windows 跑 dir "%TEMP%" | findstr /i deepseek。预期:安装成功时为空;安装失败时这里会留下解压出来的文件。
  4. 共享链接 — macOS / Linux 跑 find ~/.dsh -type l -maxdepth 4,Windows 跑 dir /S /AL "%DSH_HOME%"。预期:列出所有软链接 / junction,这是下一节的重点。

第 3 类是「卸载不干净」的常见来源:安装失败留下的临时解压目录不在正常卸载清单里,因为正常流程会在安装阶段清掉它,失败路径才会残留。重装前先看一眼 %TEMP%。

共享链接是残留的关键:清理只移除链接、不删除目标

桌面端用共享链接把共享模块接进应用——macOS 与 Linux 是目录软链接、Windows 是 junction;官方明确清理时只移除链接、不删除它的目标(来源)。所以「目录看着删了、目标还在」不是没清理干净。

先用命令把链接和真身分清楚:

  1. 列链接 — macOS / Linux 跑 ls -la 看 -> 指向,或 find ~/.dsh -type l;Windows 跑 dir /AL(只列重解析点)或 dir /S /AL。预期:每个链接都有明确的 -> 目标 或 <JUNCTION> 标注。
  2. 确认目标仍在 — 顺着 -> 或 junction 目标去看真实目录。预期:目标目录还在且内容完整,说明删的是链接不是数据。
  3. 只删链接 — macOS / Linux 用 rm <链接路径>(不加 -r 追进目标);Windows 对 junction 用 rmdir <链接路径>,不要加 /S。预期:链接消失、目标保留。
  4. 再核对 — 回到 DSH Plugin Hub 的已安装列表看插件是否还在。预期:插件仍在(目标没被删)说明只动了链接;插件没了说明误删了目标,要从备份或重装恢复。

第 3 步的写法差别就是误删与否的分水岭:Windows 上 rmdir 删 junction 只移除链接,rmdir /S 会跟进去删目标;Unix 上 rm link 删链接,rm -r link/ 会递归目标。这正是官方强调「只移除链接、不删除其目标」的原因。

DeepSeek Harness 桌面端卸载不干净:逐目录定位、清理顺序与重装异常

「卸载不干净」导致重装仍是旧状态,说明残留的壳层数据或链接还在被复用;按「先列链接 → 清链接 → 清壳层数据 → 必要时重置」的顺序处理,比对着一堆目录一顿删更有效。

按顺序执行,每步都有可核对的预期:

  1. 先备份要保的数据 — 确认 ~/.dsh(会话、设置、凭据、插件)不在清理目标里。预期:清理范围只限壳层,共享数据不被碰。
  2. 清共享链接 — 用上一节的方式移除软链接 / junction。预期:链接消失、目标保留。
  3. 清壳层数据 — 删除 Electron 用户数据、%APPDATA% / %LOCALAPPDATA% 下的产品目录与更新缓存、%TEMP% 下的安装临时目录。预期:dir / ls 再查已无对应目录。
  4. 重装并核对 — 重装桌面端,回 DSH Plugin Hub 已安装列表确认插件恢复。预期:列表显示正常,重装后不再是旧状态;若仍是旧状态,说明问题在 profiles/desktop 这一层,改走第 5 步。
  5. 必要时改用重置 — 桌面端自己的可执行层有问题时用重置。预期:重置删除 profiles/desktop 中除事务锁外的所有条目并重新初始化内置 profile,但共享任务、设置与 Harness-home 的 .env 不变。

为什么第 5 步比反复卸载更对症:反复卸载清的是应用与壳层,从来不动 $DSH_HOME/profiles/desktop 这一层;桌面端配置与第三方包留在这里,重装自然还是旧状态。只有当残留确实在系统壳层时才靠卸载 + 手动清,否则用重置。

DeepSeek Harness 桌面端卸载清理的注意事项

  1. 删链接别跟目标:Unix 用 rm <link>、Windows 对 junction 用 rmdir,都不加递归跟随参数,避免误删真实数据。
  2. 临时目录别忘查:NSIS 安装失败会在 %TEMP% 留下解压目录,正常卸载清单不含它。
  3. 共享数据不在清理范围:~/.dsh 的会话、设置、凭据、插件保留;要彻底清需自己确认后删除。
  4. 壳层问题才靠卸载:桌面上不来的根因在 profiles/desktop 时,重置比卸载重装更直接。
  5. 清理顺序:先列链接、再清链接、后清壳层,最后才重装核对,顺序反了容易把目标一起删掉。

清完残留重装 DSH插件时,用 DSH Plugin Hub 在已安装列表里一眼确认哪些插件恢复了、哪些要补装,比一条条记包名省事。

dsh-plugin-hub · 已安装插件列表

来源:DeepSeek Harness 桌面端 README(官方仓库)、DeepSeek Harness 源码仓库、dshplugin/dsh-plugin-hub

常见问题

DeepSeek Harness 桌面端卸载后,哪些壳层目录最容易留下?

DeepSeek Harness 桌面端卸载后,最容易留下的是壳层目录:Electron 用户数据、更新产物缓存,以及 NSIS 安装阶段用的临时解压目录。官方说明 Windows 卸载会清 Electron 用户数据、%APPDATA% 产品目录与 %LOCALAPPDATA% 更新缓存,安装阶段也会清理临时解压目录,但安装失败时这些临时目录会留下来。

DeepSeek Harness 桌面端卸载后目录看着删了、目标却还在,是为什么?

这是共享链接的机制造成的:DeepSeek Harness 桌面端在 macOS 与 Linux 上用目录软链接、在 Windows 上用 junction 把共享模块接进应用,官方明确清理时只移除链接、不删除它的目标。所以删掉链接后目标目录(真实数据)还在原地,「卸载不干净」的观感就来自这里。

清理 DeepSeek Harness 桌面端残留链接时,会误删真实数据吗?

只要按链接的方式删除就不会误删目标。macOS 与 Linux 上用 ls -la 能看到 -> 指向,Windows 上用 dir /AL 能列出 junction 等重解析点;删链接时不要加递归跟随(Windows 用 rmdir 而不是 rmdir /S 去跟目标),链接本身被移除,目标目录保留。这正是官方所说的「只移除链接、不删除其目标」。

DeepSeek Harness 桌面端卸载不干净导致重装还是旧状态,怎么清?

重装还是旧状态说明残留的配置或链接还在被复用。建议按「逐目录定位 → 清链接 → 清壳层数据 → 必要时重置」的顺序处理:先用 dir /AL、find -type l 找出共享链接,再清 Electron 用户数据、更新缓存与安装临时目录,最后若桌面端仍异常,用桌面端的重置把 profiles/desktop 恢复初始,而不是反复卸载重装。

DeepSeek Harness 桌面端卸载不干净时,什么情况该用重置而不是反复卸载?

当问题出在桌面端自己的可执行层而不是系统里还有文件时,应该用重置。官方说明重置会删除 $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

来源