DeepSeek Harness 磁盘布局全景：DSH plugin 装在哪、会话与缓存在哪

理解 DeepSeek Harness 的磁盘布局，只要先分清两棵树：程序安装目录与数据目录。 前者是「可重装的部分」（可执行文件与依赖），后者是「你的东西」（profile 配置、已装 DSH plugin 记录、会话、凭据）——插件的安装记录在数据目录里，不跟程序走，这就是为什么删掉程序目录重装后插件还在、而换个数据目录启动插件就「消失」了。搞清楚这条，备份、清理、迁移、多机对齐四件事都会变简单：该备份的是数据目录，该清理的是缓存，该重装的是程序。

DeepSeek Harness 的两棵树：安装目录、数据目录与三种管理做法

一句话结论：程序目录可删可重装、数据目录不可删；两者分离是理解其余所有问题的前提。

1. 查数据目录：echo $DSH_HOME——为空说明用的是默认目录（位置由程序约定），此时更需要显式设定，避免「不知道数据在哪」。
2. 查程序位置：which -a dsh 与 npm ls -g @deepseek-ai/dsh，确认装在哪、有几个入口。

方案 A：用环境变量固定数据目录（推荐）

一句话结论：显式设定数据目录是后续一切（备份、迁移、多入口共享）的基础动作，成本是一行配置。

1. 设定并持久化：

export DSH_HOME="$HOME/.dsh"      # 写进 ~/.bashrc / ~/.zshrc
mkdir -p "$DSH_HOME"

2. 让所有入口读到同一值：CLI 继承 shell 环境；桌面端与网页端需要在其启动环境里也能读到该变量，否则会出现「桌面端和 CLI 数据不一样」。
3. 验证：

ls -la "$DSH_HOME"       # 预期：能看到 profile、会话等子目录（名称随版本可能不同）

4. 好处：数据位置确定后，备份脚本、迁移、容器挂卷都能直接引用它。

方案 B：按 profile 隔离多套环境

一句话结论：需要「工作一套、实验一套」时用 profile 隔离，而不是靠切换数据目录——更清晰、也更少误操作。

1. 用 --profile 指定不同 profile（参数名以 dsh --help 为准），各自持有独立配置与 DSH plugin 集合。
2. 实验环境指向单独的数据目录，彻底与日常环境隔离——这也是排查插件冲突时推荐的隔离手段（见 DeepSeek Harness 插件冲突总览）。
3. 给每套环境写一行说明（在哪个目录、装了什么插件），避免几个月后自己都分不清。
4. 清理时按 profile 粒度走，不要整目录删。

方案 C：把数据目录放到别处（外置盘 / 大容量盘）

一句话结论：本地盘紧张或要跨机复用时，把数据目录整体外移；要点是「移动 + 改指向 + 验证」三步。

1. 先备份再移动（移动前做一份副本，出问题能退回）：

cp -a "$DSH_HOME" "${DSH_HOME}.bak"
mv "$DSH_HOME" /Volumes/外置盘/dsh-data     # 路径按你的实际盘位替换
export DSH_HOME=/Volumes/外置盘/dsh-data

2. 改指向并让所有入口生效（含桌面端/网页端的启动环境）。
3. 验证三件事：会话能打开、插件清单完整、服务能启动。
4. 外置盘的额外注意：网络盘或外置盘可能带来权限与文件系统差异（大小写敏感、锁行为），移动后先跑一轮再删旧副本。
5. 确认无误后再清理旧目录，别急着删。

DSH plugin 数据的三张备份优先级表

一句话结论：数据目录里也要分轻重——凭据与配置必须备份、会话建议备份、缓存不必备份。

1. 备份频率：凭据与配置在改动后备份；会话按你的使用强度定期增量备份。
2. 备份方式：直接复制数据目录（注意权限位），或按子目录分别打包。
3. 验证备份可用：在另一台机器或临时数据目录里恢复一次——没验证过的备份不算备份。

DeepSeek Harness 磁盘清理与回收：三种做法

一句话结论：清理只动缓存与历史会话，别动配置与凭据；先看体积分布再动手。

1. 做法一：清包缓存（最安全、见效快）：

npm cache verify        # 先校验
npm cache clean --force # 需要时再清（会影响下次安装速度）

2. 做法二：清理历史会话：按保留策略删除过期会话（uninstall/delete-session 一类操作），比整目录删除安全。
3. 做法三：重建索引与投影缓存：把它们删掉后由程序重建，通常能回收可观空间——前提是你确认这些目录属于缓存而不是业务数据。
4. 先看体积再决定：

du -sh "$DSH_HOME"/* 2>/dev/null | sort -h | tail -5
# 预期：列出占空间最多的子目录，按此决定清理对象

5. 别用整目录删除代替清理——那会连配置与凭据一起丢掉。

DSH plugin 排查注意事项

一句话结论：数据位置的排查顺序永远是「先确认 DSH_HOME、再确认版本、最后才怀疑插件」。

1. 插件不见了→ 查 DSH_HOME 是否变了（换 shell、换容器、换入口都会变）。
2. 换机后插件缺失→ 按清单重装（包本体不随数据目录搬走）。
3. 磁盘不够→ 按三张表清理：先缓存、再历史会话，最后才考虑迁移数据目录。
4. 迁移后行为异常→ 查外置盘权限与文件系统差异。
5. 要多套环境→ 用 profile 隔离，不要靠来回改数据目录（容易记错）。
6. 修复状态如实：本文对目录职责的划分基于官方 CLI 的 home/profile 说明与通用实践；具体子目录名称与结构随版本变化，查证时以你机器上 ls "$DSH_HOME" 的实际结果与官方 README 为准。

不确定某个插件装没装、装在哪个 profile 时，DSH Plugin Hub 的已安装列表比翻目录更快给出答案。

来源：apps/cli/README.md、apps/desktop/README.zh.md、npm Docs · npm cache。