前言¶

在使用 DeepSeek Harness (dsh) 时，数据目录的磁盘占用增长往往难以察觉。尤其是会话日志采用追加式写入，很容易积攒到几百 MB，甚至接近社区报告的 ~512 MB stringify 上限。在磁盘空间被填满或遇到报错前，往往缺乏直观的监控手段。dsh-disk-audit 旨在解决这个问题，提供对 dsh 数据目录的只读审计能力。

插件介绍¶

dsh-disk-audit 是一个针对 DeepSeek Harness (dsh) 数据目录的磁盘占用审计插件。它提供总大小、按目录拆分、最大目录和文件、超大文件警告以及清理建议。插件本身零运行时依赖，采用只读操作，不删除或移动任何数据。它通过 CLI 工具和 Agent 可调用的 disk_audit 工具提供支持。

核心功能¶

• 目录审计：审计 dsh 数据目录的总大小和目录分布。
• 最大文件/目录：列出最大的目录和文件。
• 超限检测：检测超大文件并给出清理建议。
• 零依赖与只读：零运行时依赖、只读操作，永不删除或移动任何东西。
• 工具支持：提供命令行工具 (CLI) 和 Agent 可调用工具 (disk_audit)。

安装与启用¶

通过 DSH 的插件系统安装：

dsh plugin add dsh-disk-audit

典型用法¶

独立运行 CLI：

npx dsh-disk-audit ~/.dsh

指定单文件告警阈值：

npx dsh-disk-audit ~/.dsh -- --large-file 52428800

输出机器可读报告：

npx dsh-disk-audit ~/.dsh --json

在 Harness 内使用¶

可以在 Harness 中通过 Agent 直接调用 disk_audit 工具。例如，向 Agent 提问：

看看我的 dsh 数据目录占了多少磁盘，最大的文件是哪些。

工具返回 dsh-disk-audit/v1 格式的报告，包含总大小、目录详情、最大文件及清理建议。

适用场景与注意¶

• 适用场景：定期检查磁盘空间占用，防止会话日志过大导致存储问题。
• 注意事项：
  • 会话日志是追加式的，容易悄悄增长。
  • 插件为只读操作，不删除或移动文件。
  • 无需 API Key。
  • 退出码：0 表示无问题，1 表示有警告（如超大文件或总量超阈值），2 表示用法或 IO 错误。

总结¶

dsh-disk-audit 提供了一种低成本的方式来监控 DSH 的磁盘健康度。更多细节和源码可参考项目主页：
* GitHub 仓库
* 社区目录