卸载 deepseek harness 前要先卸插件吗：DSH plugin 与本体卸载顺序、残留与重装

卸载 deepseek harness 之前，真正要先定的不是顺序，而是这次卸到哪一层。 只清插件、重置 profile、卸本体、清残留，是四种深浅不同的动作，混着做就容易误删会话。先选层，顺序自然就出来了。

先选卸载深度：deepseek harness 到底有哪几层

顺序不是规则而是结果；说清楚要保留什么，顺序就唯一了。

插件层动的是已装的 DSH plugin，profile 层换的是配置组合，本体层移除的是命令，残留层处理的是数据目录、缓存与构建产物。 四层影响的范围不同，能恢复的东西也不同。把它们当成一件事做，最后往往说不清哪一步弄丢了数据。

先把目标说出来：只是插件装乱了、想换一套干净配置、还是彻底换环境。 三种目标对应不同的深度，没有哪一层天然更正确。目标说不清，任何顺序都像是在碰运气。

再记清单：用 dsh plugin list 导出包名与版本，确认 DSH_HOME 的位置，并回忆当初是用 npx、全局 npm 还是源码跑起来的。 这三样决定你后面能恢复什么、该删什么。清单最好落在文件里，而不是只留在记忆中。

判断标准很朴素：你能用一句话说出「这次保留什么、删掉什么」，再动手。 说不出来就还没准备好，先补信息比先删文件划算。后面每一步验证，也都围绕这句话展开。

插件层：把 DSH plugin 摘掉，本体和会话都不动

插件层是最浅的一层，适合「插件装乱了」，不适合「环境不要了」。

先用 dsh plugin list 记下要卸的包名，再到 DSH Plugin Hub 对照条目确认身份。 中文搜索里写 DSH插件 或 DeepSeek插件 都能找到东西，但最终仍以包名为准。名称相近的条目，发布者可能完全不同。

卸载走 dsh plugin remove <包名>，不要直接删插件目录。 直接删目录会留下注册信息、构建产物和缓存，下一次启动时可能报一个你没见过的错。用命令卸载，至少让状态和配置一起更新。

卸载后重启客户端，让加载列表重新计算。 然后新建一个会话，再打开一个旧会话，确认本体与会话数据都没被牵连。两件事都正常，这一层才算做完。

这一层做完，DSH_HOME 里的会话与配置都还在，重装插件的成本最低。 如果目标只是换掉某一个插件，做到这里就可以停。继续往下走之前，先问自己是否真的需要更深的清理。

profile 层：换一套 DeepSeek Harness 的配置组合

profile 层解决的是「插件没删干净、配置又乱了」，用一套新配置换干净起点。

动手前把旧 profile 整目录复制一份，别只复制配置文件。 凭据、路径、插件参数常常分散在多个文件里，只挑一个拷，等于没备份。备份完成后再做任何改动，心里才有底。

新建一套干净 profile，只保留本体运行所需的最小配置。 在新 profile 里启动，确认插件列表为空，或者只剩你明确要保留的那几个。这一步能验证「干净」是不是真的干净。

接着拿旧 profile 逐项对照，看有没有漏掉必要的凭据与路径设置。 旧 profile 先留一段时间，确认新环境稳定后再删。急着删掉旧目录，等于把回退的路一起堵上。

重置 profile 不等于卸载本体，也不等于清空数据目录。 它只改变「加载哪些插件与参数」，这是它最有价值的地方。理解这一点，就不会把一次配置调整做成一次环境重装。

本体层：卸掉 DeepSeek Harness 命令之前先备份

到了本体层才开始动命令，顺序是备份、卸载、验命令、再决定数据去留。

先把会话记录、配置、插件清单三样导出。 它们决定了重装后能不能回到原来的状态，也决定了你是否有资格清空数据目录。备份不需要多复杂，能读出来、能对上版本就够了。

再按当初的安装方式卸载：npx 的临时缓存、npm 全局包、源码目录，各有各的移除方式。 用错方式时，命令可能还在，包却已经换了一层。卸载前确认路径，比卸载后到处找残留省事。

先别删 DSH_HOME。卸载本体通常不会动它，而你很可能还需要里面的会话与凭据。 确认新环境不需要这些数据之后，再决定保留还是清空。顺序反过来，数据就回不来了。

最后检查命令：which dsh 应该找不到，或指向一个已经不存在的位置。 新开一个终端执行 dsh --version，应当提示命令不存在，而不是跑出旧版本。命令还能运行，大概率是 PATH 里还有另一个安装，不是卸载失败。

残留层：dsh plugins 留下的目录与缓存

残留集中在命令路径、包管理器缓存、数据目录与构建产物，一处一处清。

先用 which -a dsh 列出所有同名命令，逐个确认来源。 有的来自旧全局安装，有的来自版本管理器，还有的只是某个项目里的本地依赖。来源不同，清理方式也不同。

npx 与 npm 的缓存可能保留旧包，按需清理即可。清缓存之前先确认它确实指向旧版本，别把还要用的离线包一起删掉。缓存清理通常最安全，但也最容易被当成万能解药。

DSH_HOME 里的配置、会话与插件数据混在一起，必须先确认内容再删除。 整目录删除是不可逆的，尤其是会话记录。想保留会话时，可以只清插件相关目录，把凭据与历史留在原处。

原生模块与构建缓存有时散落在数据目录之外，按安装方式回头找一遍。 重装之前，命令路径、缓存、数据目录三处都查不到旧版本痕迹，才算清干净。留下任何一处，重装后都可能看到旧版本或旧插件。

重装：按清单把 dsh plugins 装回来

重装是反向操作，但不是把旧目录拷回来；按清单逐条装，版本才对得上。

先装本体，确认版本与记录一致，或者明确这次要升到哪一版。版本含糊时，后面插件出问题就无法判断是谁引入的。本体版本定下来，再开始装插件。

然后按清单里的包名与版本逐条安装，不要凭记忆挑「差不多的版本」。 清单上每一条都对应一个使用场景，漏装和装错都会在真实会话里暴露。顺序也尽量与清单一致，出问题时好回看是哪一步开始偏的。

1. 安装本体，并用 dsh --version 确认版本与记录一致。
2. 按清单逐条执行 dsh plugin add <包名>@<版本>。
3. 用 dsh plugin list 与清单逐行比对，差异要能解释。
4. 按需导入凭据、路径与 profile 设置，不要整目录覆盖。
5. 跑一次真实会话，确认工具调用、消息收发与记忆读写。

清单、插件列表、实际行为三处一致，重装才算完成。 只看安装成功的提示不够，那只证明包下载完了，不证明环境能用。把这次清单留好，下一次卸载或迁移会轻松很多。

来源：deepseek-harness CLI README、DeepSeek Harness 快速开始、npm @deepseek-ai/dsh。