DeepSeek Harness 插件:dsh-kanban | 將 Jira + GitLab 轉化爲 Agent 可操作看板

前言

DeepSeek Harness (DSH) 提供了 Agent 工作流的框架,但在實際落地中,管理外部工具(如 Jira 和 GitLab)往往需要手動操作。靜態的看板視圖無法直接驅動 Agent,導致 Agent 無法基於項目狀態進行決策。

dsh-kanban 插件解決了這個問題。它由 JianwuYang 維護,是一個 DeepSeek Harness 插件,旨在將 Jira Server / Data Center 和 GitLab 轉化爲 Agent 可操作的看板。每個 DSH 工作區被映射爲一個項目,Agent 通過工具驅動看板,同時提供浮動面板供人工查看。

核心功能

該插件提供了以下已覈實功能:

  • Agent 可操作看板:將 Jira/GitLab 看板轉化爲 Agent 可操作的工作流。
  • DSH 工作區即項目:每個 DSH 工作區對應一個項目,包含 Jira 連接、GitLab 連接和本地倉庫配置。
  • 浮動面板:跟隨當前會話,自動切換項目並重新加載,支持狀態分組、分類高亮、摺疊和搜索。
  • 完整問題詳情:渲染描述(包含 Jira 圖片代理)、附件鏈接、轉換按鈕、評論(支持粘貼/上傳圖片)和 Lightbox。
  • 創建問題:使用 Jira 的 createmeta API,支持必填標記、自動選擇類型、優先級、指派人搜索和多值字段(組件/標籤)。
  • GitLab 工作區:支持 Issues 和 Merge Requests 的過濾、搜索、鏈接、創建 MR,以及從 Jira Issue 創建 MR。
  • 分支切換:點擊帶有已打開 MR 的 Jira 卡片上的分支芯片,可在本地倉庫執行 git fetch + git checkout。
  • 發送到會話分析:從問題詳情發送分析請求到當前會話或新會話,支持附件作爲圖片內容傳遞。
  • Agent 工具:提供 15 個模型調用工具,結果直接在對話中渲染。
  • 雙語 UI:支持中英文切換。

安裝與啓用

安裝插件時,請使用以下命令:

dsh plugin --profile demo add /path/to/dsh-ui-kanban

如果從 Git 倉庫安裝,命令如下:

dsh plugin --profile demo add github:owner/dsh-ui-kanban

注意:如果使用 pnpm >= 10,第一次 Git 依賴的 prepare 腳本可能會被拒絕。此時需要在 pnpm-workspace.yaml 中添加 allowBuilds 配置,然後重試。

若需使用 Web GUI 配置卡片,請使用 web profile:

dsh plugin --profile web add /path/to/dsh-ui-kanban

配置

插件使用 YAML 配置文件。配置命名空間爲 dsh-kanban。默認設置會從 schema 讀取,然後合併 cordis.yml 基礎配置,最後應用用戶文檔配置。

- insert:
    - id: dsh-kanban
      name: dsh-kanban
      config:
        dataDir: ''            # 留空則使用 ~/.dsh/kanban
        allowSelfSigned: true  # 通用默認值,用於 GitLab 自簽名 TLS
        verbose: false
        jira:                  # 全局 Jira 主機 + 令牌,被每個工作區繼承
          baseUrl: 'https://jira.example.com'
          apiToken: ''
        gitlab:                # 全局 GitLab 主機 + 令牌
          baseUrl: ''          # 例如 https://gitlab.example.com
          apiToken: ''
        projects:              # 每個工作區覆蓋(以工作區 ID 爲鍵)
          - id: default        # 工作區 ID
            name: Default      # 可選顯示覆蓋
            jira:
              projectKey: 'PROJ'
              jql: ''          # 會自動前置 `project = <key>`
            gitlab:
              project: ''      # 組/倉庫或完整 URL
              mrAutoLink: true      # 從 MR 描述自動推導 MR <-> Issue 鏈接
              mrLinkKeywords: ''    # 閉合關鍵詞(逗號分隔;留空則使用 GitLab 官方列表)
              mrLinkMentions: true  # 普通 #123 提及也視爲鏈接
            localRepo:
              directory: ''    # 留空則使用工作區自身路徑

權限與安全:Jira 和 GitLab Token 使用 role('secret'),Web GUI 僅編輯主機/令牌,不會在界面上回顯密鑰。

典型用法

  1. 打開面板:從會話頭部「看板」按鈕打開浮動面板。
  2. 配置連接:配置 Jira/GitLab 全局連接和項目覆蓋。
  3. 查看與搜索:在面板中搜索問題(支持按鍵/摘要/指派人/狀態)。
  4. 操作問題:點擊問題查看詳情,執行轉換或評論。
  5. 分析請求:從問題詳情發送「丟進會話分析」請求。
  6. 創建問題:使用 Jira 的 createmeta API 創建問題。
  7. GitLab 集成:配置 GitLab MR 鏈接關鍵詞,支持從看板切換分支。

適用場景與注意

  • 適用場景:需要將 Jira 和 GitLab 集成到 DSH 工作流中,讓 Agent 能夠基於項目狀態進行決策和操作的開發者。
  • 注意:
    • 許可證:MIT。
    • Web GUI 使用 web profile。
    • Token 爲 role('secret')。

總結

dsh-kanban 通過提供 Agent 工具和可視化面板,將 Jira/GitLab 集成到 DSH 工作流中,實現了 Agent 對項目狀態的直接操作。

  • 目錄頁:https://www.skillhub.cn/plugins/JianwuYang/dsh-ui-kanban
  • GitHub 倉庫:https://github.com/JianwuYang/dsh-ui-kanban
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜