前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」，旨在將外部服務能力無縫接入 AI 工作流。在 CI/CD 場景中，Jenkins 是常用的構建引擎，但傳統的對接方式往往需要編寫額外的腳本或通過 API 手動觸發，缺乏與 AI 對話的直接交互能力。
dsh-jenkins-panel 插件解決了這一割裂。它通過在 DSH 中暴露 22 個 jenkins_* 工具，讓 AI 能夠直接觸發、查詢、跟蹤 Jenkins 構建，並在 DSH 官方右側欄提供可視化的交互面板，將構建狀態與日誌分析閉環。
插件定位¶
dsh-jenkins-panel 是一個面向 Jenkins 的 DeepSeek Harness 插件，由開發者 developerdh 維護。它主要解決兩個問題：一是讓 AI 模型具備調用 Jenkins API 的能力，二是爲開發者提供一個可視化的右側欄面板，用於監控和管理構建任務。
核心功能¶
1. AI 工具（Host 半）¶
插件在 Host 端暴露了 22 個以 jenkins_ 開頭的工具，供 AI 模型直接調用。這些工具覆蓋了構建生命週期的全流程：
- 構建控制：觸發構建、查詢狀態、獲取日誌、查看歷史記錄、下載產物。
- 任務管理：任務搜索與智能解析（遇到多候選時暫停並詢問）。
- 運維操作：查看隊列狀態、清理工作空間、測試連接。
- 持久化記錄：觸發成功後自動寫入觸發記錄註冊表，數據跨重啓保留。
2. 右側欄面板（Client 半）¶
在 Client 端，插件接入 DSH 官方右側欄，提供可視化的構建管理視圖：
- 總覽：展示對話觸發的構建記錄，支持按狀態實時過濾和刷新。
- 任務樹：多 Jenkins 連接切換、多層級摺疊樹形結構、任務搜索。
- 構建詳情：日誌實時滾動（tail/分段/自動跟隨）、產物下載、工作空間清理。
3. 失敗自動分析¶
當對話觸發的構建狀態變爲 FAILURE 時，插件會自動向觸發會話回推一條分析任務書。AI 只讀模式排查日誌後，輸出結構化的失敗總結，包含結論、關鍵報錯、可能原因及修復建議。該功能可在配置中關閉。
4. 插件頁配置（dsh 0.2.0+）¶
在 dsh 插件管理頁（0.2.0+ 版本），可直接通過 plugins.bundle.config / plugins.row.config 槽位配置插件。支持連接管理、設置默認連接、以及開關失敗自動分析功能。配置持久化到 profile patch。
安裝與啓用¶
前置要求：dsh 版本需在 0.2.0-rc.2 及以上（web profile），不再兼容 0.1.x。
安裝步驟：
- 確保本地安裝了兼容版本的 dsh。
- 執行以下命令安裝插件（請顯式指定版本，例如
@0.2.0-rc.2或@next）：
dsh plugin --profile <name> add dsh-jenkins-panel@<version>
啓用與配置：
安裝完成後，進入 dsh 設置頁的「Jenkins 連接」分區，配置連接信息（包括 URL、用戶名、超時）以及每連接對應的 Token。重載頁面後，即可在右側欄與頂部欄入口看到插件面板。
典型用法¶
- 配置連接：在設置頁完成 Jenkins 連接的配置與 Token 綁定。
- 觸發構建：在 DSH 對話中，利用
jenkins_trigger等工具直接觸發構建。 - 排查失敗：構建失敗後，查看右側欄的構建詳情，或等待 AI 自動推送的分析任務書。
- 切換連接：在右側欄面板的任務視圖中，切換不同的 Jenkins 連接進行管理。
適用場景與注意¶
本插件適合需要在 DSH 環境中直接管理 Jenkins 任務、利用 AI 輔助排查構建問題的開發者。
- 版本兼容：請務必使用 0.2.0-rc.2+ 版本的 dsh，且安裝時顯式指定版本標籤（如
@0.2.0-rc.2），避免使用latest標籤（當前異常，停留在 0.0.1-rc.1）。 - 權限與來源：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
- 商標聲明：Jenkins® 是 LF Charities, Inc. 的註冊商標。本插件爲獨立的第三方工具，與 Jenkins 官方項目及 LF Charities 無隸屬或背書關係；插件內使用的 Jenkins 圖標依據 CC BY-SA 3.0 許可分發。
結語¶
dsh-jenkins-panel 通過標準化的工具接口和可視化的面板，將 Jenkins 的構建能力深度集成到 DeepSeek Harness 中，讓 AI 能夠更直接地參與 CI/CD 流程。更多細節可參考插件目錄或 GitHub 倉庫。
