dsh-health-scheduler

前言¶

DeepSeek Harness (DSH) 的插件化架構讓系統擴展變得靈活，但在設備健康監控、重啓壓力評估以及維護調度這些運維層面，往往需要專門的邏輯。dsh-health-scheduler 插件就是爲了解決這些問題而生，它負責將觀測數據轉化爲可執行的動作決策。

是什麼¶

這是一個 DeepSeek Harness 的工作流插件。它提供設備/運行時健康監控、重啓壓力評分、維護調度和動作決策。該插件由用戶 zhiheng-zhang-Mera 維護，採用 MIT 許可證。

核心功能¶

該插件專注於狀態感知與決策，核心能力包括：

• 設備/運行時健康監控：收集並分析設備的運行狀態與健康指標。
• 重啓壓力評分：將可觀測的指標歸一化爲 0 到 100 之間的 restart_pressure 數值。
• 維護調度：根據策略安排維護窗口。
• 動作決策：基於壓力評分決定下一步操作。
• 減少負載：支持通過 THROTTLE（限流）或 PAUSE_NEW_WORK（暫停新任務）來降低系統負載。

安裝與啓用¶

安裝插件需要使用 dsh plugin 命令。該命令會將參數轉發給 profile 目錄下的 pnpm，從而完成插件的加入。

1. 安裝：
   使用以下命令將插件添加到當前 profile：

    dsh plugin --profile web add dsh-health-scheduler

2. 從 Git 安裝的注意事項：
   如果通過 Git URL 安裝，pnpm 默認會阻止構建過程。當安裝失敗時，需要在 <profile directory>/pnpm-workspace.yaml 中添加 allowBuilds 條目，然後重新運行安裝命令。

3. 啓動與驗證：
   安裝完成後，啓動 DSH 並檢查配置是否正確：

    # 啓動
    dsh --profile web

    # 驗證配置（打印組合後的配置樹，不啓動）
    dsh --profile web --dump-config

典型用法¶

插件內置了 balanced 預設作爲默認值，無需配置即可運行。若需調整行爲，可以通過配置項覆蓋預設。

• 最小配置：
  僅需指定預設名稱：

    {
      "preset": "balanced"
    }

適用場景與注意¶

• 職責邊界：該插件本身不執行重啓操作。它負責決策併發出請求，實際的重啓執行由 dsh-restart 負責。
• 數據缺失處理：任何維度如果缺失遙測數據，會被標記爲 unknown，該狀態永遠不會被視爲 healthy。
• 採樣安全：單次點採樣不會觸發高風險動作，所有評分都基於滾動窗口。
• 依賴檢查：在使用前，建議檢查源碼與許可證，確保符合項目安全規範。