DeepSeek Harness (DSH) 的设计理念是“一切皆插件”，通过扩展可以接管各种运行时行为。在使用过程中，大模型运行产生的缓存、下载的安装包或导出文件往往默认落盘在 C 盘，容易导致系统盘空间不足。dsh-disk-guard 是一个针对这一痛点的插件，它负责把 DSH 的下载产物与缓存/临时文件从 C 盘重定向到用户指定目录，并向每个会话注入“路径纪律”提示词，防止 C 盘爆炸。
核心功能¶
该插件提供以下能力：
- 指定目录：统一管理下载目录（产物/安装包）和缓存目录（临时文件、npm 缓存）。
- 环境重定向：将
TMP/TEMP/TMPDIR等临时环境变量和npm_config_cache重定向到指定目录，对子进程生效。 - 持久化继承：配置写入
$DSH_HOME/.env，实现持久化继承。 - 提示词注入：在会话首条消息前自动插入“路径纪律”提示词。
- 管理工具：提供
disk_guard命令行工具，支持查看状态、清理过期缓存和修改目录。 - 智能默认：不配置目录时，自动选择剩余空间最大的非 C 盘（需 ≥5GB）。
安装与启用¶
在插件包目录（含 package.json 的那层）执行安装脚本：
powershell -ExecutionPolicy Bypass -File scripts\install.ps1
安装完成后，需要重启 DeepSeek Harness（无论是 Web 界面还是 Headless 模式）才能生效。
使用示例¶
安装成功后，即可在会话中或命令行使用 disk_guard 工具。
查看磁盘状态
disk_guard status
清理过期缓存
disk_guard clean
修改目录
disk_guard set downloadDir:"E:\dsh\dl" cacheDir:"E:\dsh\cache"
配置文件位于 $DSH_HOME/disk-guard.yaml。路径支持 ~（用户主目录）与 %VAR% 展开，相对路径以 DSH home 为基准。
注意事项¶
- 零依赖：插件运行期无第三方依赖。
- 清理边界：清理操作仅针对插件自己管理的目录。
- 重启生效：安装后必须重启 DSH。
