dsh 安装占多少磁盘:npx 缓存、全局 node_modules 与多版本并存,先量后删的顺序
dsh 安装本身的体积不大,真正吃磁盘的是缓存、每个 profile 的依赖树,以及你不知道还存在的第二份安装。 先量清楚每一处,再决定删什么。
dsh 清理先量再删
不看数字就删,最常见的后果是把会话和凭据一起清掉。 正确顺序:
- 先列出所有可能的占用位置;
- 逐个统计大小;
- 标记「可删」「重建可恢复」「不可删」;
- 从最安全的一类开始删;
- 每删一处,复测一次启动。
量的时候用同一把尺子。 全部用 du -sh <路径>,输出单位一致,才好比较谁是大头。
dsh 占用来自哪五处、逐个怎么量
把这五处记住,排查时不用满盘找。 一览:
| 位置 | 怎么找 | 通常多大 |
|---|---|---|
| npx 缓存 | npm 缓存目录下的 _npx | 中,随版本累积 |
| npm 下载缓存 | npm config get cache | 大,全局共享 |
| 全局 node_modules | npm root -g | 中 |
| profile 依赖树 | $DSH_HOME/profiles/*/node_modules | 大,按 profile 数增长 |
| 桌面端运行时 | 系统应用安装目录 | 大,独立于 CLI |
桌面端与 CLI 是两套体积。 如果两样都装了,磁盘上是两份运行时,不要把它们算成一次安装。
知道位置,还要落到具体数字。 按顺序执行,把结果记在一张纸上。步骤:
- 执行
npm config get cache得到缓存根目录; - 统计缓存:
du -sh <缓存目录>; - 统计 npx 子目录:
du -sh <缓存目录>/_npx; - 统计全局目录:
du -sh "$(npm root -g)"; - 统计数据目录:
du -sh "${DSH_HOME:-$HOME/.dsh}"; - 统计每个 profile:
du -sh "${DSH_HOME:-$HOME/.dsh}"/profiles/*。
最后一行的输出最值得看。 多个 profile 各自有独立依赖,装了三四个 profile 时,这里往往是最大的一项。
dsh 可删边界与安全清理顺序
判断标准不是「大不大」,而是「删了能不能恢复」。 对照:
| 内容 | 能否删 | 删后影响 |
|---|---|---|
| npx 缓存 | 可以 | 下次 npx 重新下载 |
| npm 下载缓存 | 可以 | 重新下载变慢 |
| 旧全局安装 | 可以 | 需重新确认 PATH |
| 日志目录 | 可以 | 丢失历史启动诊断 |
| 某个 profile 依赖 | 谨慎 | 该 profile 需重建 |
| 会话与凭据 | 不要删 | 历史与登录状态丢失 |
最后一行是红线。 可以清空日志,可以重建 profile,但不要把整个 DSH_HOME 当成缓存删掉。
边界清楚之后,剩下的就是顺序。 从「重新下载即可恢复」到「删了就找不回」,按这个顺序做:
- 清理 npx 缓存:删除缓存目录下的
_npx; - 校验并清理 npm 缓存:先
npm cache verify,再按需清理; - 清理旧的启动诊断日志,保留最近几次;
- 卸载不再使用的旧全局安装;
- 删除已废弃 profile 的依赖目录。
每步之后启动一次。 清理缓存后第一次启动会慢,属于正常填充,不要误判成故障。
npm cache verify 优先于强制清空。 它会先校验完整性、回收无用条目,多数情况下已经够用。
dsh 多版本并存与清理后的验证
多版本并存往往不是「装了很多次」,而是「用不同方式装过」。 定位方法:
which -a dsh列出所有可执行路径;- 对每条路径执行
<路径> --version,看各自版本; npm root -g对照全局目录,确认哪些是全局安装;- 检查是否有别的 Node 版本目录下也装了 dsh;
- 保留你实际要用的那一份,其余卸载。
不要只删文件不卸依赖。 手工删目录会留下残留的 bin 链接,表现为「命令还在但执行报错」。
保留策略建议只留一份主安装。 需要临时用别的版本时,用 npx 指定版本,不要长期并存两份全局安装。
清完之后还要验收。 标准是「该在的还在,该小的变小了」,清单:
dsh --version正常输出;dsh web能启动,页面能打开;- 历史会话仍在列表里;
- 模型调用成功,说明凭据没被误删;
- 再统计一次总占用,与清理前对比,没有前后数字就无法判断清理是否真的生效。
dsh 长期控制占用
与其定期大扫除,不如让占用不失控:主安装只留一份、每个用途一个 profile 且不用就删、日志按时间保留、升级后清一次旧缓存。 profile 数量是最容易被忽视的变量,每多一个就多一份完整依赖树。
dsh 下一步
先量后删,删完复测。 想看迁移时怎么避免重复安装,读 从旧安装迁移;想看装错后的回退,读 dsh 安装回退;想看最小安装组合,读 dsh 最小安装;想自定义数据目录,读 自定义 DSH_HOME。
常见问题
删掉 npx 缓存不会影响全局安装的那一份 dsh,但下次用 npx 运行时会重新下载。npx 缓存只是复用加速,删掉最坏的结果是下一次启动慢一点,不涉及 DSH_HOME 里的会话与配置。
不建议删掉整个 DSH_HOME 重来:里面除了插件依赖,还有会话、凭据与配置,删掉等于把历史和登录状态一起清空。要减体积应该只清日志或重建某个 profile,而不是删整个目录。
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 官方文档
来源
- dsh CLI README· deepseek-ai
- npm 文档:npm cache· npm
- DeepSeek Harness 官方文档· deepseek-harness