前言¶
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 僅編輯主機/令牌,不會在界面上回顯密鑰。
典型用法¶
- 打開面板:從會話頭部「看板」按鈕打開浮動面板。
- 配置連接:配置 Jira/GitLab 全局連接和項目覆蓋。
- 查看與搜索:在面板中搜索問題(支持按鍵/摘要/指派人/狀態)。
- 操作問題:點擊問題查看詳情,執行轉換或評論。
- 分析請求:從問題詳情發送「丟進會話分析」請求。
- 創建問題:使用 Jira 的 createmeta API 創建問題。
- GitLab 集成:配置 GitLab MR 鏈接關鍵詞,支持從看板切換分支。
適用場景與注意¶
- 適用場景:需要將 Jira 和 GitLab 集成到 DSH 工作流中,讓 Agent 能夠基於項目狀態進行決策和操作的開發者。
- 注意:
- 許可證:MIT。
- Web GUI 使用
webprofile。 - 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