DeepSeek Harness 怎么卸载?三种安装方式各自的删除方法、数据保留与完全清理
卸载 DeepSeek Harness 前先做选择题:只卸程序、保留数据待重装,还是全部清除——三档对应的操作完全不同。 npx 免安装方式本机几乎没有程序文件,npm 全局安装用 npm uninstall -g @deepseek-ai/dsh,源码构建直接删仓库目录;而聊天记录、配置与插件都在独立的用户数据目录(默认 ~/.dsh),删不删由你决定。
概览
「卸载 dsh」这件事,九成问题出在没分清「程序」和「数据」是两个东西。 程序文件决定 dsh 能不能运行,数据目录(默认 ~/.dsh,可用 $DSH_HOME 改位置)决定你的配置、会话与插件记录在不在。所以卸载前先想清楚要哪一档,再按当初的安装方式执行对应命令。本文给对照表与验证方法;卡在卸载失败、想深挖残留清理的,文末有对应旧文。
卸载 DeepSeek Harness 前先分三档:只卸程序 / 保留数据 / 全部清除
卸载不是只有一种「删掉」,先决定你要哪一档,避免误删想留的数据。 三档区别:
- 只卸程序(想换安装方式或暂时不用):删掉程序文件即可,数据目录原样保留,之后随时重装,配置、会话、插件都在;
- 保留数据待重装(想重置出问题或换机器):删程序 + 数据目录整个备份走(拷走
~/.dsh),旧环境卸干净,新机器拷回数据即可恢复,见《卸载重装与数据迁移》; - 全部清除(彻底告别):程序文件 + npx/npm 缓存 + 数据目录一起处理,聊天记录会随数据目录删除而消失——确定不需要再删。
按当初安装方式卸载 DeepSeek Harness:三种装法三种删法
卸载命令取决于你当初怎么装的——和安装一一对应:npx 方式无全局文件、npm 全局用 uninstall 命令、源码方式删目录。 对照表如下:
| 当初安装方式 | 程序删除动作 | 说明 |
|---|---|---|
| npx 免安装 | 无需删除全局文件 | npx 方式不产生全局 dsh 命令;下载内容在 npx 缓存(~/.npm/_npx),可留着可清理 |
| npm 全局安装 | npm uninstall -g @deepseek-ai/dsh | 执行后 dsh 命令即不可用 |
| 源码构建 | 删除 clone 的仓库目录 | 找到当初 git clone 的目录(如 deepseek-harness/)整体删除即可 |
源码方式的删除示例:
# 先退出正在运行的 dsh
rm -rf ~/dev/deepseek-harness # 换成你实际的仓库路径
删完程序后,数据目录(默认 ~/.dsh)保持不动——这就是第一档「只卸程序」。想在删程序时顺便清理数据,见下一节的「全部清除」清单。
数据保留:卸载 DeepSeek Harness 后 ~/.dsh 的去留决定一切
「卸载后数据还在吗」的答案只有一个变量:你有没有删数据目录。 默认数据在 ~/.dsh(可用 $DSH_HOME 覆盖),里面是你的 profile、配置与聊天会话,独立于程序文件,所以:
- 想留:什么都不用做,卸载程序后它原样保留,重装即恢复;
- 想备份:把整个
~/.dsh拷到别处(或改$DSH_HOME指向备份位置); - 想清:确定聊天记录不再需要后,再删除该目录。
拿不准时先备份再删,这是最稳的姿势。
完全清理 DeepSeek Harness:程序、缓存与数据目录的分层清单
「卸载干净」= 程序层无残留 + 数据层按你意愿处理,逐层核对。 分层清单:
- 程序层:npm 全局装的执行
npm uninstall -g @deepseek-ai/dsh;源码装的删掉仓库目录;npx 方式本无全局文件; - 验证程序已删:终端执行
dsh --version应提示找不到命令;npm ls -g列表里不再出现@deepseek-ai/dsh; - 缓存层(可选):想清理 npx 下载缓存可删除
~/.npm/_npx或npm cache clean --force;pnpm store 等深度缓存清理见《DSH plugin 残留清理》; - 数据层(按需):决定不要聊天记录与配置后,删除
~/.dsh(或$DSH_HOME指向的目录)——这是唯一会「删掉聊天记录」的一步; - 最后确认:
dsh --version无输出、数据目录已按意愿保留或删除,即卸载完成。
卸载 DSH 插件走正规路径:DSH Plugin Hub 先确认再移除
如果某些插件你确定不再用,先在 DSH Plugin Hub 的已安装列表把它们卸载,别直接手删目录。 在已安装列表点卸载会先弹确认窗口,展示插件与来源,确认后才移除——避免误删:

卸载插件但想留着其它数据,用 Hub 正规路径即可;不逐个卸也没关系——只要不动 ~/.dsh,重装后插件记录原样保留。插件卸载的界面操作与残留清理见《DSH Plugin Hub 怎么卸载插件》;卸载本体时遇到卡住、报错的,见《卸载失败怎么办》与《卸载完整指南》。
一句话收尾:先选档、再按装法删程序、最后决定 ~/.dsh 去留——分清楚「程序」和「数据」,卸载 DeepSeek Harness 就不会再犹豫。
来源:deepseek-ai/deepseek-harness、@deepseek-ai/dsh on npm、npm uninstall 文档
常见问题
卸载 DeepSeek Harness 本身不会删数据:程序文件与用户数据是分开的,聊天记录、配置、profile 都在数据目录(默认 ~/.dsh)里,删程序文件不影响它们。只有当你主动删除数据目录时,聊天记录才会一起消失。
卸载 DeepSeek Harness 后重装,只要没删数据目录(默认 ~/.dsh),配置、会话与插件记录都会原样回来;想彻底重置再重装,才需要把 ~/.dsh 一起删掉。换机器迁移时直接把整个 ~/.dsh 拷过去即可,详见《卸载重装与数据迁移》。
判断 DeepSeek Harness 是否卸载干净,按当初安装方式验证:npm 全局装过的执行 dsh --version 应提示 command not found,npm ls -g 里不再有 @deepseek-ai/dsh;源码方式确认仓库目录已删、启动命令不再可用;npx 方式本来就没有全局文件。数据目录是否保留是你自己的决定,程序层面无残留即可。
不需要逐个手动卸——DeepSeek Harness 的插件记录都在数据目录(默认 ~/.dsh)里,只要不删数据目录,卸载本体再重装插件原样还在;想连插件一起清掉直接删数据目录即可,或用 DSH Plugin Hub 的已安装列表把不想要的先卸掉再卸载本体,避免误删仍想用的数据。
相关术语
- ~/.dsh
- ~/.dsh 是 DeepSeek Harness 默认的用户数据目录(可用 $DSH_HOME 环境变量改位置),存 profile、配置、会话等数据;它独立于程序安装位置,卸载程序不影响它。— deepseek-ai/deepseek-harness
- npx 免安装方式
- npx 免安装方式指用 npx @deepseek-ai/dsh web 直接运行官方包:本机不产生全局 dsh 命令,下载内容缓存在 npx 缓存里,所以「卸载程序」这一步对它来说几乎没有文件要删。— npm 官方文档
- npm uninstall -g
- npm uninstall -g @deepseek-ai/dsh 用于卸载 npm 全局安装的 dsh,是「npm 全局安装方式」卸载 DeepSeek Harness 本体的标准命令。— npm 官方文档
- 数据目录 / $DSH_HOME
- 数据目录存放 DSH 的配置与会话,默认 ~/.dsh,可用环境变量 $DSH_HOME 指向别处;判断卸载要不要删数据,本质是判断要不要删这个目录。— deepseek-ai/deepseek-harness
来源
- deepseek-ai/deepseek-harness· GitHub
- @deepseek-ai/dsh on npm· npm
- npm 官方文档 - 卸载全局包· npm