DeepSeek Harness (DSH) 插件：dsh-jira-tasks

前言¶

DSH 允許通過插件擴展功能。對於需要管理 JIRA 任務上下文的開發者來說，在會話輸入框下方直接查看當前指派任務的列表，能夠減少切換窗口的頻率。dsh-jira-tasks 專爲這一場景設計，提供持久化的配置與直觀的任務面板。

功能¶

該插件在 DSH 會話輸入框下方展示當前 JIRA 項目指派給當前用戶的「開啓 / 重新開啓」任務列表。

核心能力包括：
- 面板展示：新會話與活躍會話均展示任務列表；默認摺疊，點擊標題展開。
- 持久化配置：項目 Key 與 JQL 按工作區保存並持久化。
- 連接狀態：自動探測連接狀態（綠=可用，紅=不可用，灰=未配置），支持手動測試連接。
- 任務信息：顯示狀態徽章、優先級、類型標籤及更新時間。
- 交互：點擊任務在新標籤頁打開 JIRA 詳情；面板支持一鍵刷新。
- 主題適配：適配淺色與深色主題。
- 兼容性：兼容瀏覽器端與桌面端。

安裝¶

插件包名爲 dsh-jira-tasks。

Web Profile（瀏覽器）¶

使用 npm 安裝：

dsh plugin --profile web add dsh-jira-tasks

Desktop Profile（桌面端）¶

桌面端需使用應用自帶的 dsh 命令。npm 全局安裝的 dsh 會拒絕 --profile desktop 操作。

打開一次桌面端，確保 desktop profile 初始化。
完全退出桌面端。
通過應用菜單 管理 dsh 命令 / Manage dsh Command 安裝桌面端自帶的 dsh。
執行安裝命令：

dsh plugin --profile desktop add dsh-jira-tasks

注意：插件必須被聲明在 profile 的 dsh.profile.bundles 列表中才能加載。若安裝後無反應，請檢查 ~/.dsh/profiles/desktop/package.json 中的該字段。

配置¶

1. JIRA 地址與令牌¶

在 設置 → JIRA 配置 中填寫。

JIRA 地址：如 http://jira.example.com/。優先級爲 Config.baseUrl > JIRA_BASE_URL > JIRA_URL。
訪問令牌 / PAT：令牌寫入憑據存儲，不回傳前端。優先級爲 JIRA_TASKS_TOKEN > JIRA_API_TOKEN > JIRA_TOKEN。

點擊面板標題右側的 ⚙ 圖標或設置頁的 測試連接 按鈕可驗證配置。

2. 項目 Key 與 JQL¶

在面板設置中配置，配置按工作區持久化。

項目 Key：如 HCPFYH1。
JQL：留空使用默認查詢。支持 {projectKey} 佔位符，會被替換爲實際項目 Key。

默認 JQL：

project = "{projectKey}" AND status in ("開啓", "重新開啓") AND assignee = currentUser() ORDER BY updated DESC

兼容性與驗證¶

DSH 版本：>=0.1.7-rc.2 <0.3.0-0（含 0.1.7 與 0.2.x）。
平臺：瀏覽器（web profile）與桌面端（desktop profile）。

卸載¶

dsh plugin --profile web remove dsh-jira-tasks
dsh plugin --profile desktop remove dsh-jira-tasks

結尾¶

dsh-jira-tasks 適合需要頻繁查看 JIRA 進度的 DSH 用戶。插件代碼開源，許可證爲 MIT。更多細節與源碼可參考：GitHub 倉庫。