容器与 CI 里卸载 DeepSeek Harness：DSH plugin 缓存、镜像层与卷清理

容器里「卸载 DeepSeek Harness」这件事天生比宿主复杂，因为默认行为是「程序随容器走、数据留在卷里」。 删掉容器只清掉可写层，数据卷里的 profile、已装 DSH plugin 记录、会话与凭据照样在；而即使把容器和卷都删了，镜像层与构建缓存仍会占着磁盘——这三件事互不相干，很多人只做了第一件就以为卸干净了。所以正确做法是先明确目标：要彻底不留痕迹就删容器 + 删卷 + 清镜像与构建缓存；只想清程序保留数据就只删容器。

容器里卸载 DeepSeek Harness 和宿主差在哪

一句话结论：宿主卸载是「删程序 + 决定数据留不留」，容器卸载是「删容器 + 决定卷留不留 + 清镜像层」——多了一层。

方案 A：丢容器重建（最干净）

一句话结论：不「清理」而是「重建」——删容器与不再需要的卷，下次从镜像重新起一个，比在容器里逐项清更彻底。

1. 确认数据是否要留（这一步决定后面的动作）：

docker volume ls | grep dsh        # 列出与 DeepSeek Harness 相关的卷
# 预期：看到你之前挂的数据卷名；不想留则下一步一并删

2. 停并删容器：

docker rm -f dsh

3. 按需删卷（这一步才决定数据是否真的消失）：

docker volume rm dsh-data        # 数据卷：删了 = 会话与插件记录都没了

4. 重建：按原来的方式重新起一个容器（写法见 DeepSeek Harness 容器化安装）。
5. 验证：新容器里 dsh plugin 清单是否符合预期（空 = 数据确实清了；有 = 卷还在）。

方案 B：容器内定向清理（想保留容器）

一句话结论：保留容器、只清插件与缓存时，按「插件清单 → 缓存 → 索引」的顺序清，别动配置与凭据。

1. 先记录清单（万一要重装）：

dsh plugin          # 记下装了什么，便于后续按清单恢复

2. 移除插件：用卸载/移除类子命令逐个处理（参数名以 dsh plugin --help 为准）。
3. 清缓存与索引：只删缓存类目录（可重建），不要删整个数据目录。
4. 看体积确认效果：

du -sh "$DSH_HOME"/* 2>/dev/null | sort -h | tail -5
# 预期：确认清理后主要占用是否下降

5. 验证：重装一个插件跑一次，确认环境仍然可用。

方案 C：镜像瘦身（构建阶段清理）

一句话结论：镜像变小只能在构建阶段做——运行时删掉的文件已经写进层里，不会减小镜像。

1. 多阶段构建：构建阶段装依赖与编译，运行阶段只拷贝产物。
2. 同一层内「装 → 用 → 清」：把安装、使用与清理缓存放进同一条 RUN，避免缓存留在中间层。
3. 基础镜像选小的（但注意：slim / alpine 装带原生模块的插件容易失败，取舍见容器化安装一文）。
4. 清构建缓存（这一步常被忘）：

docker builder prune
# 预期：释放构建缓存占用；执行前确认没有正在进行的构建

5. 验证：docker images 看镜像体积变化；功能跑一轮确认没删错东西。

DSH plugin 容器的三个卷分别怎么处理

一句话结论：数据卷决定「会不会丢会话」、工作区卷决定「会不会丢文件」、缓存卷可以放心删。

1. 命名要能区分：卷名带语义前缀（dsh-data / proj-data / dsh-cache），避免清理时误删。
2. 清理前先列清单，确认每个卷归属。
3. 备份优先于清理：数据卷要删之前先备份（备份口径见 DeepSeek Harness 磁盘布局全景）。

DeepSeek Harness 在 CI 里的收尾三步

一句话结论：CI 的干净靠「不挂持久卷 + 临时容器 + 显式清缓存」三步——第一步最关键。

1. 数据目录指向容器内临时路径（不挂卷）：容器结束数据随之消失，无需额外清理。
2. 用临时容器跑（--rm），避免残留容器堆积。
3. 流水线末尾清本地缓存与临时目录，防止构建机上长期积累。

docker run --rm -e DSH_HOME=/tmp/dsh -v "$PWD:/workspace" dsh-local:0.2.0-rc.2 dsh --version
# 预期：容器退出即销毁，/tmp/dsh 中的数据不留痕

4. 验证方法：跑完看构建机上的卷列表与磁盘占用，确认没有累积。

DSH plugin 排查注意事项

一句话结论：卸载类问题先分清「删了什么」——容器、卷、镜像层是三样东西，别用一个动作期待三种效果。

1. 数据没清→ 卷还在（删容器不会删卷）。
2. 磁盘没释放→ 镜像与构建缓存还在（删容器与卷都不会回收镜像层）。
3. 误删了数据→ 检查是否删到了数据卷或工作区卷；有备份就恢复，无备份只能重来。
4. CI 越跑越占空间→ 数据目录挂了持久卷，或未清构建缓存。
5. 重装后插件还在→ 说明数据卷被保留了（有时是期望行为，有时不是，先确认目标）。
6. 修复状态如实：本文基于 Docker 的容器/卷/镜像层语义与官方 CLI 的数据目录说明；容器化 DeepSeek Harness 无官方专文，具体卷名、缓存目录名以你自己环境的实际布局为准。

清理前先把已装清单记下来——DSH Plugin Hub 的已安装列表可以直接当这份清单用，重建容器后照着重装。

宿主侧（非容器）的卸载与残留清理，见dsh 卸载命令与数据清理。

来源：apps/cli/README.md、Docker Docs · volumes、Docker Docs · build cache。