dsh-infra-bootstrap: 基礎設施就緒探測與狀態報告

在 DSH（DeepSeek Harness）的開發流程中，在執行具體任務前，通常需要確認當前環境是否具備必要的組件（如記憶、搜索、觀測能力）。手動檢查這些狀態容易遺漏。dsh-infra-bootstrap 插件提供了一個極簡的基礎設施入口，通過工具直接探測已掛載的組件棧，並輸出就緒狀態。

核心定位¶

這個插件由 Bryan-cmf 維護，旨在作爲基礎設施的“最小入口”。它不處理具體的業務邏輯，而是專注於檢查。通過探測已掛載的棧，它能夠確認記憶、觀測、搜索和技能目錄等模塊是否處於可用狀態，並輸出結構化的就緒報告。

主要功能¶

插件提供了兩個核心工具，以及一組配套的探測邏輯：

1. infra_status

   • 探測每個組件的狀態。
   • 以逐行的方式輸出當前基礎設施的運行情況。

2. infra_bootstrap

   • 執行與 infra_status 相同的探測流程。
   • 在最後輸出一個總結性的判定：PASS（通過）或 WARN（警告）。

3. 探測範圍
   插件會檢查以下組件和狀態：

   • vectorMemory 服務記錄
   • 兄弟工具：usage_report、audit_skills、infra_health、mem_save、mem_search、cross_search
   • 技能目錄大小
   • 活躍代理和會話數

安裝與啓用¶

將以下配置添加到 DSH 的配置文件中即可啓用該插件：

"dsh": {
  "profile": {
    "bundles": ["@bryan-cmf/dsh-infra-bootstrap"]
  }
}

使用說明¶

安裝完成後，可以通過命令行調用上述工具。插件會列出所有可探測的項。

• 依賴檢查：插件依賴的兄弟包是可選的。如果運行時發現某些兄弟包未安裝，工具輸出中會明確顯示 MISSING 並告訴你需要安裝什麼。
• 前置要求：使用該插件需要 DSH 版本 >= 0.1.0-rc.6，且當前進程必須已加載 tools 和 skills 服務。

適用場景與注意¶

• 環境自檢：適合在智能體工作流啓動前，快速驗證基礎設施的連通性。
• 權限範圍：該插件以當前 DSH 進程的權限運行，請確保在安裝前檢查其源碼與許可證（MIT）。

通過 infra_status 或 infra_bootstrap，你可以快速獲取當前環境的健康度概覽，從而決定是否繼續後續操作。