dsh-jira-tasks

配置

1. JIRA 地址与令牌

打开 设置 → 插件 → 插件配置 → JIRA，填写：

• JIRA 地址：如 http://jira.example.com/（存入用户设置文档，可在界面回读）
• 访问令牌 / PAT：写入凭据存储（$DSH_HOME/.credentials.yaml），前端只显示"已配置"，不回传令牌本身

留空并保存会保持已有令牌不变；地址留空并保存则清除设置项，回退到环境变量。认证自动识别：令牌含 : 用 Basic，否则用 Bearer（JIRA PAT）。

连接测试

卡片底部有连接状态灯与 测试连接 按钮：

• 打开卡片时会自动探测一次（请求 JIRA /rest/api/2/myself），保存后也会自动重测
• 绿 = 地址与令牌可用（并显示当前登录用户）；红 = 不可用（显示 JIRA 返回的原因，如 401 认证失败）；灰 = 地址或令牌未配置
• 点 测试连接 会用当前输入框里的内容（未保存也可）立即测试，方便改完再存

以下环境变量 / 凭据仍作为回退（设置页未配置时生效，兼容旧部署），热加载无需重启：

JIRA_BASE_URL: "http://jira.example.com/"
JIRA_API_TOKEN: "
"

• 地址别名：JIRA_BASE_URL / JIRA_URL
• 令牌别名：JIRA_API_TOKEN / JIRA_TOKEN

2. 项目 Key 与 JQL（按工作区）

• 点击面板标题右侧 ⚙ 打开设置（表单顶部提示当前配置归属的工作区）
• 项目 Key：如 HCPFYH1，保存后立即查询，该工作区后续新会话自动加载
• JQL：留空使用默认查询；也可填写自定义 JQL，{projectKey}（或 {key}）会被替换为项目 Key

默认查询：

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

状态名按中文工作流（"开启"/"重新开启"）配置；若 JIRA 用英文状态（Open/Reopened），在 ⚙ 中填写自定义 JQL 即可。