卸载 DeepSeek Harness 怎么做？DSH plugin 跨平台卸载命令、残留清理与清数据边界

卸载 deepseek harness 这件事，uninstall、how to uninstall、remove 三种英文问法指向的是同一个操作；中文里也有人搜「卸载 DeepSeek插件」「卸载 DSH插件」，落到的还是同一条命令；真正麻烦的在命令之外——残留去了哪、该不该清。 这篇把几个英文搜索词归一到一个答案上，再顺着你机器上的目录，讲清「卸载后残留去哪」，以及卸载只动程序层、清数据与删会话为什么是另外两件事。

概览：卸载、删会话、清数据是三件不同的事

先记住一句话：卸载动程序，删除会话动日志，清数据动整个用户数据目录——三者互不替代。 DeepSeek Harness 的程序文件、会话日志与配置分放在不同位置，所以英文搜索词虽然都带 "uninstall"，落到操作上却可能指三件不同的事（来源）：

看清这张表，再看下面三个方向，就不会把「卸程序」和「删数据」混成一件事。

三个英文问法都指卸载：uninstall、how to uninstall、remove 与各平台卸载命令

uninstall deepseek harness、how to uninstall deepseek harness、deepseek harness uninstall、remove deepseek harness 是同一条搜索意图——把 DeepSeek Harness 从机器上移除，答案取决于你当初的安装方式。 英文里 uninstall 和 remove 在包管理器语境下是同义词：npm 用 uninstall（别名 remove、rm）、pnpm 用 remove，指的都是把包从依赖里摘掉并删除它注册的可执行链接（来源）。先对号入座：

按顺序操作，每一步都给出预期结果：

1. 先退干净正在运行的进程——关闭终端里的 dsh web 或桌面应用窗口。预期：没有进程再占用端口（Web 默认 3080，桌面版用系统随机分配的端口，不会撞 3080）。
2. npm 全局安装的，执行卸载命令：

npm uninstall -g @deepseek-ai/dsh

预期：终端输出 removed ... packages，随后 npm ls -g --depth=0 列表里不再出现 @deepseek-ai/dsh。 3. 桌面应用安装的，先移除它注册的 CLI——打开应用菜单，点 Manage dsh Command… → Remove。预期：macOS 上 /usr/local/bin/dsh 链接被移除、Windows 上当前用户 PATH 里的登记被删除，且不影响其它来源安装的 dsh（来源）。 4. 再卸载桌面应用本体——macOS 把应用拖进废纸篓，Windows 走「设置 → 应用 → 已安装的应用 → 卸载」或安装包自带的卸载器。预期：应用从系统里消失；若应用还在运行，Windows 卸载器会提示你先从系统托盘退出。 5. 源码构建的，删掉仓库目录：

rm -rf ~/deepseek-harness   # 换成你的实际路径

预期：目录消失，本机不再留下构建产物。 6. 验证程序层——新开一个终端执行 dsh --version。预期：提示 command not found（Windows 为「不是内部或外部命令」），说明命令入口已经干净。

三种装法的完整步骤另见《DeepSeek Harness 怎么卸载》，npm 与 pnpm 通道的报错排查见《npm 卸载 DSH》。

卸载后残留去哪：配置目录、会话缓存与 DSH plugin 的 node_modules

卸载命令只动程序层，$DSH_HOME（默认 ~/.dsh）下的配置、会话、profile 与 node_modules 一律原地保留——这就是「卸了但磁盘还有东西」的全部来源。 残留按位置分成五处（来源）：

定位与清理步骤：

1. 确认数据目录的真实路径——执行 echo $DSH_HOME（Windows 用 echo %DSH_HOME%）。预期：有输出就用它，空输出即默认 ~/.dsh。
2. 看会话日志还剩什么——ls "$DSH_HOME/sessions"。预期：列出按项目分好的 --...-- 目录；一次会话都没写过时该目录不存在，属正常现象。
3. 看插件依赖在哪——ls "$DSH_HOME/profiles"。预期：列出 web、headless 等 profile 目录，每个下面都有独立的 node_modules。
4. 想清 npx 残留：

rm -rf ~/.npm/_npx

预期：npx 临时环境被清空；下次 npx @deepseek-ai/dsh web 会重新下载，不丢任何用户数据。 5. 只想清聊天记录、保留配置与插件——先停掉 dsh，再只删会话目录：

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

预期：先落一份备份再删除，配置、密钥与插件依赖都不受影响。

残留的逐层清理（配置覆盖层、pnpm store）细节见《卸载残留怎么清理》。

卸载 DeepSeek Harness 只动程序层，清数据与删会话另看一篇

卸载命令只移除程序本体，$DSH_HOME 下的配置、会话与 DSH plugin 依赖一律原地保留；要不要继续删会话，或把整个数据目录清掉，是另外两件事，本篇不展开。 换句话说，卸载不等于清数据——想「回到全新状态」是在卸载程序之后、再删掉整个数据目录，那一步才不可逆、没有回收站。卸载、删除会话、清数据三者的边界表、什么时候该清、文件层怎么删、误清的后果，都在《dsh purge 与卸载的分界》，需要时跳过去看即可。

与其在命令行里逐个 list、remove、再手动核对残留目录，不如用带确认弹窗的可视化方式管理插件——DSH Plugin Hub 把已装插件、来源、版本和卸载入口收在同一个面板里，卸载前会弹出确认框展示插件与来源，确认后才移除，避免误删。

注意事项

1. 卸载命令的参数写包名：npm uninstall -g @deepseek-ai/dsh，写 dsh 会因找不到同名包而报错。
2. 桌面版别漏了 CLI 注册：卸载 Electron 应用前先走 Manage dsh Command… → Remove，否则 /usr/local/bin/dsh 会一直遗留。
3. 数据目录不在卸载范围内：任何卸载命令都不碰 $DSH_HOME，删不删要自己决定，删之前先备份。
4. 多份安装会「卸不干净」：用 nvm 时每个 Node 版本各有一份全局包，用 which -a dsh 逐一排查后再确认。

来源：dsh CLI README、@deepseek-ai/dsh on npm、deepseek-ai/deepseek-harness