DeepSeek Harness (DSH) 生態強調“一切皆插件”的理念。在開發智能體工作流時，有時需要直接調用底層的 DevOps 工具而非編寫通用插件。ddtcorex/dsh-maestro-govard 旨在解決 Govard 工具與 DSH 會話之間的集成問題，它不嵌入 Go 代碼，而是作爲一個輕量級橋接層，將 Govard 工作區/項目的工具註冊爲 DSH 的可調用工具。
插件定位¶
這是一個由 ddtcorex 維護的 DSH 插件，屬於 Maestro Harness 套件的一部分。它本身不包含 Govard 的核心引擎代碼，僅作爲橋接層，將 Govard 的功能暴露給 DSH 會話。
核心能力¶
- Shell 調用工具註冊：插件通過調用
govard二進制文件註冊了一系列工具，支持環境啓停、容器內命令執行、數據庫導入導出以及調試配置。這些工具使用schemastery-typed參數，保證了參數校驗的準確性。 - 只讀部署檢查：提供
govard_deploy_plan和govard_deploy_check兩個工具。前者生成機器可讀的kind: "plan"文檔，後者在部署前對目標進行預檢。這兩個工具不需要建立遠程連接即可獲取部分信息。 - 路徑解析：工具的路徑解析邏輯與 Maestro 套件保持一致，確保上下文識別準確。
安裝與前置條件¶
安裝插件需要使用官方命令。安裝前請確保 govard 二進制文件已構建並可用。
dsh plugin --profile web add @ddtcorex/dsh-maestro-govard
前置條件說明：
1. Govard 引擎是一個獨立的 Go 代碼庫，需單獨構建（通常在 govard 倉庫中執行 make build）。
2. 該橋接插件期望 govard 二進制文件在系統的 PATH 中，或在配置的路徑下可用。
使用示例¶
插件提供了兩類主要命令，均支持 projectPath 參數，參數缺失時會依次回退到配置的根目錄或當前會話的工作區。
- 查看部署計劃：
govard_deploy_plan，用於獲取遠程項目的解析後管道，並以機器可讀的 plan 文檔形式返回。 - 部署前檢查：
govard_deploy_check，在向目標發送修改命令前，執行預檢流程。
適用場景與注意事項¶
- 權限風險：插件以當前 DSH 進程的權限運行。修改部署等操作依然在終端中執行，但建議在將功能交付給智能體前，先在真實的 Govard 管理項目上進行驗證。
- 依賴分離：請勿混淆 Govard 引擎與該插件。該插件僅作爲橋接，不嵌入 Go 代碼。
- 源碼審查：安裝前請檢查源碼與許可證（MIT）。
總結¶
該插件通過輕量級橋接的方式，將 Govard 的豐富工具能力引入 DSH 生態，適合需要精細控制基礎設施和部署流程的場景。
