dsh purge 到底清什么？DeepSeek Harness 清数据与卸载 DSH plugin 的分界

dsh purge 不是 DeepSeek Harness 官方命令——官方 CLI 的入口里根本没有 purge 子命令；dsh-purge 是一个社区 DSH plugin，「清数据」意义上的 purge 指的则是删除 $DSH_HOME 下的数据目录（来源）。 搜这个词的人，十有八九把三样东西混成了一个：一条并不存在的命令、一个名字撞车的插件、一种「把数据清空」的直觉。这篇不重复卸载步骤（那些看《卸载 DeepSeek Harness 的完整命令》），只做一件事——把「purge 这类清数据操作」和「卸载 DSH plugin」的分界划清楚，再告诉你什么时候该清、文件层怎么清、清错了会怎样。想先弄懂 purge 这个概念，可对照《dsh purge 是什么》；要看插件本身，去 DSH Plugin Hub 按名字查。

三个同名物：dsh purge、dsh-purge（一个 DSH plugin）与「清数据」

dsh purge、dsh-purge 与「清数据」是三样不同的东西：dsh purge 是不存在的官方子命令，dsh-purge 是一个社区 DSH plugin（中文也常叫「DSH插件」「DeepSeek插件」），而「purge 一下数据」指的是删除 $DSH_HOME 这个动作。 三者的来历、官方 CLI 到底有哪些入口、dsh-purge 这个插件究竟做什么，都在《dsh purge 是什么》里逐条讲清了，本篇不重复。这里只记住一句：purge 不是官方命令——认准这点，后面的分界与实操才不会从错的前提开始。

purge 与卸载 DSH plugin 的分界线：清数据 ≠ 拆插件

清数据（purge）动的是数据目录里的内容，卸载 DSH plugin 动的是依赖清单与加载清单——两件事互不替代，谁也不能顶替谁。 把两者并排看，边界一目了然：

两条最容易踩的坑，恰好互为镜像：

1. 想摘一个插件，却去清数据：结果把会话、密钥、别的插件一起删了，代价远大于收益。摘插件只该走 remove；
2. 想回到全新状态，却只卸插件：remove 只摘掉那一个包，settings.yaml、会话日志、别的插件全都还在，根本「清不干净」，还会残留 cordis.patch.yml 里的覆盖行。

这也是为什么「卸载 ≠ 删除会话 ≠ 清数据」是三件独立的事。分界的关键判断只有一句：你要删的是「某个插件的登记」，还是「整个数据目录的内容」？ 前者走 remove，后者才是文件层删除。残留到底有哪些、怎么逐层清，见《卸载残留怎么清理》，那篇不在本篇展开。

什么时候该 purge、怎么做、误清会怎样

只有当你确定要「回到全新状态」时才该动数据目录；日常想摘掉某个插件，永远只走 remove。 清数据没有官方命令，只能在文件层操作，所以每一步都要先想清楚。按顺序来：

1. 先定档：你要的只是「摘掉某个插件」「只清聊天记录」，还是「整机重置」？预期：三个答案对应三种操作，想清楚再动手，避免误删还想留的东西。
2. 动手前先整体备份（唯一能兜底的一步）：

cp -r "$DSH_HOME" "$DSH_HOME.bak"

预期：得到一份含配置、密钥、会话与插件的完整副本，出问题可随时拷回。 3. 只想让某个 profile 回到默认：直接删它的目录，下次启动会自动重建。

rm -rf "$DSH_HOME/profiles/web"

预期：dsh web 下次启动重建一个全新的 web profile，装过的第三方插件需要重装——这是「有控制地清一部分」。 4. 想整机重置：删掉整个数据目录。

rm -rf "$DSH_HOME"

预期：目录消失，重装后是全新状态，模型密钥需要重新填。 5. 只清聊天记录、保留配置与插件：先停掉 dsh，再只删会话目录。

cp -r "$DSH_HOME/sessions" "$DSH_HOME/sessions.bak" && rm -rf "$DSH_HOME/sessions"

预期：会话清空，配置、密钥与已装插件都不受影响。 6. 校验：echo $DSH_HOME 确认路径，ls "$DSH_HOME" 看目录还在不在。预期：结果与你第 1 步定的档一致。

误清的后果按「删错一层，丢一层」来记：删 sessions 丢聊天记录；删 profiles/<名字> 丢该 profile 的全部第三方插件与本地配置；删整个 $DSH_HOME 则密钥、会话、插件一锅端，而且没有回收站。唯一能救的就是第 2 步的备份——所以「先备份再删」不是客套话，是这类操作的硬前提。

说不清该清哪一层时，先别急着删——打开 DSH Plugin Hub 的「已安装」列表，把装了哪些插件、各自什么来源和版本看清，再决定是摘某个插件、还是清整个数据目录。

来源：dsh CLI README、deepseek-ai/deepseek-harness、社区插件仓库 - dsh-purge、dsh-purge 插件条目。