DeepSeek Harness 環境體檢插件

在 DeepSeek Harness (DSH) 的開發與調試過程中，環境狀態（磁盤、內存、網絡、插件版本）直接影響智能體的穩定性。當模型表現異常時，開發者往往需要排查系統資源佔用或緩存膨脹問題。dsh-healthcheck 旨在解決這一痛點，提供一套標準化的環境體檢流程。

這是一個由 taxueseek 維護的插件，屬於“記憶”類別。它是一個只讀工具，不執行任何清理或刪除操作，僅負責採集當前環境指標，並與歷史基線進行對比，生成 CRITICAL / WARNING / INFO 分級報告。

核心能力¶

該插件主要完成以下體檢任務：

系統資源檢查：檢查磁盤使用率（APFS 數據卷 /System/Volumes/Data）、內存壓力、網絡延遲（ping 8.8.8.8）。
環境細節檢查：檢查 ~/.dsh 目錄膨脹情況（包括 clipboard 圖片、sessions、profiles、storages 各目錄）、工具鏈可用性、插件版本。
趨勢對比：記錄歷史數據，對比磁盤增量趨勢，首次體檢即建立基線。

安裝與啓用¶

通過官方目錄安裝插件：

dsh plugin --profile web add taxueseek/dsh-healthcheck

安裝後需重啓 DSH Web Profile 以使插件生效。

配置¶

插件支持以下配置項，可在工具定義的 config 字段中修改：

- id: healthcheck-toolkit
  name: 'dsh-healthcheck'
  config:
    stateDir: '~/.dsh/health'      # 歷史基線目錄
    historyLimit: 200              # 保留快照條數
    diskWarnPct: 80                # 磁盤 WARNING 閾值（%）
    diskCriticalPct: 90            # 磁盤 CRITICAL 閾值（%）
    memoryWarnPct: 80              # 內存壓力 WARNING 閾值（%）
    latencyWarnMs: 150             # 延遲 WARNING 閾值（ms）
    scanTimeoutMs: 30000           # 單次掃描超時（毫秒）

使用示例¶

在對話中，用戶可發送指令觸發體檢：

用戶：“體檢一下”
用戶：“看看磁盤”
用戶：“環境是不是有問題”

模型隨後會調用 health_check 接口，返回分級報告。示例輸出如下：

# 環境體檢報告
總體: HEALTHY | CRITICAL 0 / WARNING 0 / INFO 4
- [INFO] 磁盤使用率 62.5%，可用 285.3 GB
- [INFO] 內存壓力 34.2%
- [INFO] 網絡延遲 18 ms
~/.dsh 數據目錄:
  1.2 GB  ~/.dsh/sessions
插件版本:
  dsh-context: 0.5.0 → 0.7.3（可升級）

設計與數據¶

只讀設計：插件僅做體檢和報告，絕不自動刪除任何東西。清理動作需用戶確認後執行。
數據存儲：歷史基線數據存儲在 ~/.dsh/health/history.l，每次體檢追加一條記錄。

生態與鏈接¶

該插件是 DeepSeek Harness 生態的一部分。社區目錄：https://www.skillhub.cn/plugins/taxueseek/dsh-healthcheck。源碼倉庫：https://github.com/taxueseek/dsh-healthcheck。