前言¶

在使用 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 倉庫
* 社區目錄