DeepSeek Harness 在 Windows、macOS、Linux 上怎么卸载？dsh 各平台路径与残留位置

卸载 DeepSeek Harness 的难点从来不是命令，而是「哪些路径要删、哪些要留」。 平台之间命令差别很小，路径差别很大：程序在全局 npm 目录，缓存在 npm 缓存目录，而配置与会话在数据目录 $DSH_HOME（默认 ~/.dsh）。这篇按 Windows、macOS、Linux 逐平台列出「程序 → 缓存 → 数据」三档的位置与验证方式。

卸载 DeepSeek Harness 的统一思路：程序、缓存与数据三档

卸载 DeepSeek Harness 先分三档，再谈平台差异——三档对应三个不同路径，删错一档的代价完全不同（来源）。

三个档位的判断顺序：

1. 先判断程序怎么装的 — 免安装的 npx 路径没有全局文件，全局安装的要走卸载命令，源码构建的直接删仓库目录。预期：判断对了，程序层一步到位；判断错了会「卸了还能跑」。
2. 再决定缓存删不删 — 缓存只是下载副本。预期：留着不影响使用，只是占磁盘；想彻底清干净再删。
3. 最后决定数据去留 — 数据目录保存 profile、配置与会话。预期：留下它，重装后一切照旧；删掉它等于重置。

按安装方式逐条展开的完整对照见《DeepSeek Harness 怎么卸载》。

Windows 卸载 DeepSeek Harness：全局目录、PATH 与数据目录

Windows 卸载 DeepSeek Harness 分四步：退进程、删程序、清缓存、定数据（来源）。

1. 先退干净进程 — 关闭所有正在运行的 dsh 窗口，必要时在任务管理器结束残留的 Node 进程。预期：netstat -ano | findstr :3080 没有输出，说明端口已释放。
2. 删程序 — 全局装过就执行 npm uninstall -g @deepseek-ai/dsh。预期：执行后 dsh 命令不再可用。
3. 核对全局目录与命令入口 — 用 npm root -g 查全局 node_modules 的真实路径，Windows 一般位于 %APPDATA%\npm\node_modules，同级的 %APPDATA%\npm 下还有 dsh 的命令入口文件。预期：目录里不再有该包，命令入口一并消失。
4. 清缓存 — 用 npm config get cache 拿到缓存目录，删掉其中的 _npx 子目录即可。预期：免安装方式下载的副本被清掉，不影响其他 Node 项目。
5. 定数据去留 — 数据目录在 %USERPROFILE%\.dsh。预期：要重装就留着；要彻底清就整个删掉，删前先备份。

macOS 卸载 DeepSeek Harness：全局 node_modules 与 Finder 定位残留

macOS 卸载 DeepSeek Harness 的关键是先用命令拿到真实路径，再用 Finder 定位确认（来源）。

1. 退进程并确认端口 — 关闭终端里的 dsh，执行 lsof -i :3080。预期：没有输出说明服务已停。
2. 删程序 — 执行 npm uninstall -g @deepseek-ai/dsh。预期：命令不再可用。
3. 拿到全局 node_modules 路径 — 执行 npm root -g。预期：路径取决于 Node 的安装方式，可能是系统级目录，也可能在 nvm 的版本目录下，所以不要照抄固定路径。
4. 用 Finder 定位残留 — 在 Finder 里按 Cmd+Shift+G，粘贴上一步的路径回车。预期：能直接看到是否还有该包目录，比在终端层层 cd 更快。
5. 定数据去留 — 数据目录是 ~/.dsh，即 /Users/<你的用户名>/.dsh。预期：它不在系统应用缓存目录里，删之前先确认是否还要保留会话。

Linux 卸载 DeepSeek Harness：权限、全局目录与自启残留

Linux 卸载 DeepSeek Harness 最容易卡在权限和自启两件事上（来源）。

1. 先判断要不要 sudo — 如果 Node 是系统级安装的，全局 node_modules 属于 root。预期：不加 sudo 会报权限错误，这属于权限问题而不是包损坏，处理思路见《卸载失败怎么办》。
2. 删程序 — 执行 npm uninstall -g @deepseek-ai/dsh（按上一步的结论决定是否加 sudo）。预期：命令不再可用。
3. 核对全局目录 — 执行 npm root -g 确认路径，常见于系统级 node_modules 下，nvm 安装的则在自己的用户目录里。预期：用 nvm 的用户不需要 sudo，也不需要动系统目录。
4. 检查自启与后台进程 — 如果你自己写过 systemd 单元或后台启动脚本，把它一并停掉并移除。预期：pgrep -af dsh 不再返回进程，避免卸载后仍占着 3080 端口。
5. 定数据去留 — 数据目录是 /home/<你的用户名>/.dsh。预期：删除前先备份，尤其是想保留会话数据的场景。

DSH plugin 与残留验证：清干净怎么确认、只想重装怎么留

验证卸载是否干净要看三层：程序层、端口层与数据层（来源）。

1. 程序层 — 执行 dsh --version，再看 npm ls -g --depth=0 的输出。预期：前者提示命令不存在，后者不再列出 @deepseek-ai/dsh。
2. 端口层 — 查看 3080 是否仍被监听（macOS/Linux 用 lsof -i :3080，Windows 用 netstat -ano | findstr :3080）。预期：没有输出才算干净，还有输出说明有进程没退。
3. 数据层 — 确认 $DSH_HOME 目录的状态符合你的意图。预期：想重装就要看到它还在，不想留就确认已删除。
4. 插件层别手删文件 — 只想清掉部分 DSH plugin 时，在已安装列表点卸载。预期：Hub 会先弹出确认弹窗，展示插件与来源仓库，确认后才移除，避免误删仍要用的插件。
5. 想重装就留住数据 — 卸载程序时不要动数据目录。预期：重装后配置、会话与插件记录原样回来，细节见《卸载重装与数据迁移》。

DeepSeek Harness 分平台卸载的注意事项与局限

1. 命令相同、路径不同：npm uninstall -g 三平台一致，残留在哪却随 Node 安装方式变化，所以一律用 npm root -g 现场查询。
2. 数据目录不属于卸载范围：任何卸载命令都不会碰 $DSH_HOME，删不删必须自己决定，且删前先备份。
3. 权限错误不等于卸载失败：Linux 上的 EACCES 通常只说明需要用 sudo 或改用 nvm 的 Node，不要因此重装 Node。
4. 自启残留最容易被忽略：手动配过的服务或后台脚本不会随包卸载消失，会继续占端口，升级与重装时尤其容易混淆。
5. 彻底清理的边界：程序、缓存、数据三档全删才是「完全清理」，只删程序属于常规卸载，想清残留参考《残留怎么清理》。

只想卸载插件而不是整个 DSH 的话，在 DSH Plugin Hub 的已安装列表里操作即可，来源标签能帮你只清掉自定义安装的那些。

来源：DeepSeek Harness README（官方仓库）、dsh CLI README（官方仓库）、npm uninstall 官方文档