ChatGPTClaudeGrok / X / CursorGemini

dsh 安装占多少磁盘:npx 缓存、全局 node_modules 与多版本并存,先量后删的顺序

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
dsh安装磁盘占用清理缓存node_modules安装维护
同一台机器装了几份 dsh 时,磁盘占用往往来自缓存与重复的依赖树,而不是主程序。本文给出按目录统计的方法、可删与不可删的边界,以及安全清理顺序。

dsh 安装本身的体积不大,真正吃磁盘的是缓存、每个 profile 的依赖树,以及你不知道还存在的第二份安装。 先量清楚每一处,再决定删什么。

dsh 清理先量再删

不看数字就删,最常见的后果是把会话和凭据一起清掉。 正确顺序:

  1. 先列出所有可能的占用位置;
  2. 逐个统计大小;
  3. 标记「可删」「重建可恢复」「不可删」;
  4. 从最安全的一类开始删;
  5. 每删一处,复测一次启动。

量的时候用同一把尺子。 全部用 du -sh <路径>,输出单位一致,才好比较谁是大头。

dsh 占用来自哪五处、逐个怎么量

把这五处记住,排查时不用满盘找。 一览:

位置怎么找通常多大
npx 缓存npm 缓存目录下的 _npx中,随版本累积
npm 下载缓存npm config get cache大,全局共享
全局 node_modulesnpm root -g中
profile 依赖树$DSH_HOME/profiles/*/node_modules大,按 profile 数增长
桌面端运行时系统应用安装目录大,独立于 CLI

桌面端与 CLI 是两套体积。 如果两样都装了,磁盘上是两份运行时,不要把它们算成一次安装。

知道位置,还要落到具体数字。 按顺序执行,把结果记在一张纸上。步骤:

  1. 执行 npm config get cache 得到缓存根目录;
  2. 统计缓存:du -sh <缓存目录>;
  3. 统计 npx 子目录:du -sh <缓存目录>/_npx;
  4. 统计全局目录:du -sh "$(npm root -g)";
  5. 统计数据目录:du -sh "${DSH_HOME:-$HOME/.dsh}";
  6. 统计每个 profile:du -sh "${DSH_HOME:-$HOME/.dsh}"/profiles/*。

最后一行的输出最值得看。 多个 profile 各自有独立依赖,装了三四个 profile 时,这里往往是最大的一项。

dsh 可删边界与安全清理顺序

判断标准不是「大不大」,而是「删了能不能恢复」。 对照:

内容能否删删后影响
npx 缓存可以下次 npx 重新下载
npm 下载缓存可以重新下载变慢
旧全局安装可以需重新确认 PATH
日志目录可以丢失历史启动诊断
某个 profile 依赖谨慎该 profile 需重建
会话与凭据不要删历史与登录状态丢失

最后一行是红线。 可以清空日志,可以重建 profile,但不要把整个 DSH_HOME 当成缓存删掉。

边界清楚之后,剩下的就是顺序。 从「重新下载即可恢复」到「删了就找不回」,按这个顺序做:

  1. 清理 npx 缓存:删除缓存目录下的 _npx;
  2. 校验并清理 npm 缓存:先 npm cache verify,再按需清理;
  3. 清理旧的启动诊断日志,保留最近几次;
  4. 卸载不再使用的旧全局安装;
  5. 删除已废弃 profile 的依赖目录。

每步之后启动一次。 清理缓存后第一次启动会慢,属于正常填充,不要误判成故障。

npm cache verify 优先于强制清空。 它会先校验完整性、回收无用条目,多数情况下已经够用。

dsh 多版本并存与清理后的验证

多版本并存往往不是「装了很多次」,而是「用不同方式装过」。 定位方法:

  1. which -a dsh 列出所有可执行路径;
  2. 对每条路径执行 <路径> --version,看各自版本;
  3. npm root -g 对照全局目录,确认哪些是全局安装;
  4. 检查是否有别的 Node 版本目录下也装了 dsh;
  5. 保留你实际要用的那一份,其余卸载。

不要只删文件不卸依赖。 手工删目录会留下残留的 bin 链接,表现为「命令还在但执行报错」。

保留策略建议只留一份主安装。 需要临时用别的版本时,用 npx 指定版本,不要长期并存两份全局安装。

清完之后还要验收。 标准是「该在的还在,该小的变小了」,清单:

  1. dsh --version 正常输出;
  2. dsh web 能启动,页面能打开;
  3. 历史会话仍在列表里;
  4. 模型调用成功,说明凭据没被误删;
  5. 再统计一次总占用,与清理前对比,没有前后数字就无法判断清理是否真的生效。

dsh 长期控制占用

与其定期大扫除,不如让占用不失控:主安装只留一份、每个用途一个 profile 且不用就删、日志按时间保留、升级后清一次旧缓存。 profile 数量是最容易被忽视的变量,每多一个就多一份完整依赖树。

dsh 下一步

先量后删,删完复测。 想看迁移时怎么避免重复安装,读 从旧安装迁移;想看装错后的回退,读 dsh 安装回退;想看最小安装组合,读 dsh 最小安装;想自定义数据目录,读 自定义 DSH_HOME。

来源:dsh CLI README、npm 文档:npm cache、DeepSeek Harness 官方文档

ChatGPTClaudeGrok / X / CursorGemini

常见问题

把 npx 缓存删掉之后,已经全局安装好的 dsh 还能正常使用吗?

删掉 npx 缓存不会影响全局安装的那一份 dsh,但下次用 npx 运行时会重新下载。npx 缓存只是复用加速,删掉最坏的结果是下一次启动慢一点,不涉及 DSH_HOME 里的会话与配置。

DSH_HOME 目录占用的空间很大,能不能整个删掉再重新开始?

不建议删掉整个 DSH_HOME 重来:里面除了插件依赖,还有会话、凭据与配置,删掉等于把历史和登录状态一起清空。要减体积应该只清日志或重建某个 profile,而不是删整个目录。

为什么装了几次之后磁盘占用翻倍,但 dsh --version 只有一个?

dsh --version 只显示 PATH 命中的那一份,另外几份可能藏在 npx 缓存、旧全局目录或别的 Node 版本下。用 which -a dsh 和 npm root -g 对照,才能看到磁盘上到底有几套。

清理缓存之后第一次启动明显变慢,需要把删掉的缓存重新恢复回来吗?

不需要为 dsh 重新恢复缓存,缓存的作用就是加速后续解析,第一次运行会重新填充,之后恢复。如果长期都慢,问题更可能在网络或镜像配置,而不是缓存被清。

相关术语

npx 缓存
npx 缓存是 npx 解析并执行过的包的本地副本目录,用来避免每次运行都重新下载,默认位于 npm 缓存目录下的 _npx 子目录。— npm 文档
全局 node_modules
全局 node_modules 是 npm 全局安装目录下的依赖树,路径可用 `npm root -g` 查看,`dsh` 命令通常从这里解析。— npm 文档
profile 依赖树
profile 依赖树是每个 profile 目录下独立安装的插件依赖,位于 $DSH_HOME/profiles/<名称>/node_modules,不同 profile 之间不共享。— dsh CLI README
DSH_HOME
DSH_HOME 是 DeepSeek Harness 的数据根目录,默认 ~/.dsh,保存 profile、配置、会话、日志与凭据。— DeepSeek Harness 官方文档

来源