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 仓库。