DeepSeek Harness 怎么卸载？dsh 卸载命令与 ~/.dsh 数据清理指南

卸载 DeepSeek Harness 分三步：先备份会话数据，再按安装方式删程序本体（npx 方式没有本地安装、删掉缓存即完成，源码构建删掉仓库目录），最后按需清理 ~/.dsh 里的插件与数据。本文把备份、删程序、卸插件、清数据、重装的全流程一次讲透。

概览：卸载三步走，先备份再动手

dsh 没有一键 uninstall 命令，卸载 = 备份 + 删程序 + 按需删数据。 DeepSeek Harness 通过 npx 或源码构建运行（来源），两种方式留下的东西不一样：npx 无本地安装，源码构建有一个仓库目录；两者都会在用户目录留下数据（$DSH_HOME，默认 ~/.dsh，来源）。整个卸载流程按顺序走三步：

1. 备份：先把 ~/.dsh/sessions 会话数据备份到安全位置；
2. 删程序：按你的安装方式（npx / 源码构建 / 全局安装）删掉程序本体；
3. 清数据：按需卸载插件、删除 ~/.dsh 数据目录，实现彻底卸载。

下面按这三步逐个拆开讲。

步骤 0：卸载前先备份会话数据

删程序不会动数据，但删 ~/.dsh 会——所以备份永远放在第一步。 会话数据存放在 ~/.dsh/sessions 目录，里面是你所有的历史会话记录；卸载本体不会删除它们，但如果后续要清理 ~/.dsh，会话就没了。建议卸载前先备份：

# 备份会话数据（建议先做）
cp -r ~/.dsh/sessions ~/.dsh-sessions-backup

备份完成后，即使之后误删了 ~/.dsh，会话文件也还在备份目录里，随时可以拷回去。

步骤 1：按安装方式删除程序本体

npx 方式删 npx 缓存即可，源码构建删仓库目录；全局装过的再用 npm uninstall -g 卸载。 三种安装方式对应三种卸载做法：

# 方式一：npx 方式（无本地安装，可选清理 npx 缓存）
rm -rf ~/.npm/_npx

# 方式二：源码构建（删除 clone 的仓库目录）
rm -rf ~/path/to/deepseek-harness

# 方式三：如果全局安装过 dsh 命令
npm uninstall -g @deepseek-ai/dsh

npx 每次运行从 npm 临时拉取，不产生持久本地安装，所以本体无需卸载；~/.npm/_npx 只是缓存目录。源码构建的 DeepSeek Harness 没有全局副作用，删除仓库目录即完成卸载（来源）。

步骤 2：卸载 DSH 插件（可选）

想一起卸掉插件，最省心的是在「设置 → 插件中心」里一键卸载——装 DSH Plugin Hub 就能用。 插件装在各 profile 的 node_modules 里，有三种卸法：

1. 一键卸载（推荐）：装了 DSH Plugin Hub 后，打开设置 → 插件中心，找到要卸载的插件点「卸载」即可，卸载全程可视化、实时进度一目了然：

   dsh-plugin-hub · 一键卸载

   

2. 命令行卸载：只想卸载单个插件，执行 dsh plugin --profile web remove <包名>。
3. 整目录删除：想一次性清掉某个 profile 的所有插件，直接删对应 profile 目录（如 ~/.dsh/profiles/web）就一并移除。

Hub 的卸载与通知中心用法见《DSH Plugin Hub 怎么用？》。

步骤 3：清理 ~/.dsh 数据目录

数据目录 $DSH_HOME（默认 ~/.dsh）装着 profiles 与 sessions，删程序不会动它，需要手动清理并先备份。 ~/.dsh 目录结构：profiles 存放各 profile 的插件依赖与配置（web profile 就是在这里自动初始化的），sessions 存放会话数据。彻底卸载时：

# 备份会话数据（建议先做）
cp -r ~/.dsh/sessions ~/.dsh-sessions-backup

# 彻底删除数据目录
rm -rf ~/.dsh

卸载后的检查与重装

卸载完成后确认三件事：会话已备份、插件去向清楚、重装路径明确。 几点提醒：

1. 确认没有残留：执行 which dsh，没有输出即程序已卸载干净；再确认 ~/.dsh 与源码仓库目录都已删除。
2. 想保留数据重装：只要没删 ~/.dsh，重新执行 npx @deepseek-ai/dsh web 即可，web profile 会自动再次初始化，历史配置与会话都还在。
3. 想彻底重来：删干净 ~/.dsh 后重装，等于全新安装；需要备份的会话用步骤 0 的备份文件恢复。

常见问题与下一步

1. 只卸载部分插件：参考《DSH plugin 怎么安装》里 dsh plugin 命令的卸载写法，或直接走「设置 → 插件中心」。
2. 卸载后残留报错：多半是 profile 目录里还有旧的 node_modules，删掉对应 profile 目录即可，参考《卸载后残留文件清理》。
3. 卸载失败：清理时被占用或权限不足，参考《DSH plugin 卸载失败怎么办》。

来源：DeepSeek Harness 官网、dsh CLI README、官方 Quickstart