JIRA 开启任务面板（DeepSeek Harness 插件）

中文 · English

在 DSH 会话输入框下方展示当前 JIRA 项目指派给当前用户的「开启 / 重新开启」任务列表。JIRA 地址与令牌在设置 → JIRA 配置（设置对话框左侧导航）中配置（JIRA_BASE_URL / JIRA_API_TOKEN 作为回退）；项目 Key 与 JQL 按工作区配置并持久化。

适配的 DSH 版本：0.1.7 与 0.2.0（0.1.7-rc.2、0.2.0-rc.2 实测），浏览器（web profile）与桌面端（Electron 独占的 desktop profile）通用。 客户端槽位 conversation.input.dock / plugins.item / settings.section、设置服务 ctx.configForms（命名空间 = profile 条目 id jira-tasks）、ctx.effect / configForms.whileServed 的注销契约在 0.1.7 → 0.2.0 之间没有变化（逐包 diff 过），所以同一份 lib/ 同时覆盖两版；0.1.6 及更早版本的 settingsScope / settings.register / settings.plugin.item 已不再使用。 包内声明了 DSH 兼容范围 >=0.1.7-rc.2 <0.3.0-0（engines.dsh + 可选 peer @deepseek-ai/dsh）：0.2.0 起 DSH 会在安装与启动时校验该范围，不满足的版本会被跳过并在插件管理器里给出 allow-version 精确豁免入口（peer 标了 optional，pnpm 不会把整套 @deepseek-ai/dsh 装进 profile）。

功能

• 📋 新会话与活跃会话的输入框下方均展示任务面板（新会话时与输入框等宽）

• 👤 默认仅显示当前用户（assignee = currentUser()）的「开启 / 重新开启」任务
• ⚙️ 设置 → JIRA 配置（设置对话框左侧导航，位于「Agent 预设」下方）配置 JIRA 地址与访问令牌（令牌写入凭据存储，不回传前端）；插件面板里的同一张 JIRA 卡片仍然可用
• 🟢 设置卡片自动探测连接并显示状态灯：绿=可用、红=不可用、灰=未配置；点「测试连接」可用未保存的草稿值即时验证

• ⚙️ 项目 Key 与 JQL 按工作区保存；未配置的工作区显示"未配置"
• 🔄 打开新会话自动查询，面板内支持一键刷新（⟳）
• 🧭 点击标题可收起 / 展开面板；标题徽标显示查询命中的任务总数（列表最多展示 50 条，按更新时间倒序）
• 🏷️ 每条任务附状态徽章（按状态分类着色：新建 / 进行中 / 其他）、优先级与类型标签
• 🔗 任务可点击，在新标签页打开 JIRA 详情
• 🎨 颜色使用 DSH 主题令牌，浅色 / 深色主题自适应

安装

包已发布到公共 npm（dsh-jira-tasks）；仓库的发布工作流同时把同一版本发布到 GitHub Packages（作用域包名 @liu3734/dsh-jira-tasks）。**浏览器（web profile）**从 npm 安装（推荐）：

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

或直接从 GitHub 安装（仓库根即包目录，lib/ 为预构建产物）：

dsh plugin --profile web add github:liu3734/jira-tasks-dsh-plugin

重启 DSH 后生效。

桌面端（DeepSeek Harness.app）

桌面端不用 web profile，而是 Electron 独占的 desktop profile（~/.dsh/profiles/desktop/）。该 profile 名被应用保留：npm 全局安装的 dsh 会直接拒绝 --profile desktop 的 boot 与 plugin 操作（profile "desktop" is managed exclusively by the Electron application），必须用桌面端自带的命令：

1. 先打开一次桌面端（由应用初始化 desktop profile），然后完全退出桌面端

2. 应用内菜单 → 管理 dsh 命令 / Manage dsh Command → Install，把桌面端自带的 dsh 装进 PATH

3. 安装插件：

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

4. 确认 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 里有 "dsh-jira-tasks"，再启动桌面端

桌面端渲染进程的 origin 是 dsh-app://app。非静态资源的请求由 Electron 转发到本机 Host，所以插件的 fetch("/jira/api/search") 这类绝对路径照常可用；任务链接的 target="_blank" 由 Electron 交给系统浏览器打开。项目 Key / JQL 存在该 origin 的 localStorage 里，与浏览器访问 http://127.0.0.1:<port> 时的配置互不相通，两边各配一次即可。

装完没反应？先查 dsh.profile.bundles。 DSH 只有当对应 profile 的 package.json（~/.dsh/profiles/web/package.json 或 ~/.dsh/profiles/desktop/package.json）里的 dsh.profile.bundles 列了 "dsh-jira-tasks" 时才把本包当作 profile 层挂载；只出现在 dependencies 里不够——此时启动日志会打 patch: entry "jira-tasks" not found，插件静默不加载。dsh plugin --profile <name> add 一般会补上这一行，但该包已在 dependencies 中时重装不会重新补，手动往 dsh.profile.bundles 追加 "dsh-jira-tasks" 即可。

若改用 GitHub Packages 源：先在 profile 的 .npmrc 配置 @liu3734:registry=https://npm.pkg.github.com/ 及读取令牌，再执行 dsh plugin --profile web add @liu3734/dsh-jira-tasks。

配置

1. JIRA 地址与令牌

打开 设置 → JIRA 配置（左侧导航最后一项，在「Agent 预设」下面；插件面板里的 JIRA 卡片是同一张表单），填写：

• JIRA 地址：如 http://jira.example.com/（写入本插件 profile 条目 jira-tasks 的 Config.baseUrl，即 profile 的 cordis.patch.yml，可在界面回读；保存被宿主拒绝时会直接报错，不会静默失败）
• 访问令牌 / PAT：写入凭据存储（$DSH_HOME/.credentials.yaml，引用名是插件自有的 JIRA_TASKS_TOKEN），前端只显示"已配置"，不回传令牌本身

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

设置页令牌优先于环境变量：启动 DSH 的环境里已有 JIRA_API_TOKEN（Windows 用户级环境变量也算）时，卡片照常可以输入并保存——保存的是插件自有引用 JIRA_TASKS_TOKEN，DSH 不会拒绝（它只拒绝写入会被环境遮蔽的同名引用），Host 解析时也把它排在环境变量之前：

JIRA_TASKS_TOKEN（设置页） > JIRA_API_TOKEN > JIRA_TOKEN

想改回用环境变量，点卡片里的「清除设置页令牌」即可。

连接测试

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

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

以下环境变量 / 凭据仍作为回退（设置页未配置 baseUrl 时生效，兼容旧部署），热加载无需重启。注意地址的优先级是 Config.baseUrl > JIRA_BASE_URL > JIRA_URL，而 JIRA_BASE_URL 既可以从启动环境读，也可以像下面这样存在 .credentials.yaml 里——旧域名的记录留在凭据文件里时，设置页一旦清空地址就会回退到它：

JIRA_BASE_URL: "http://jira.example.com/"
JIRA_API_TOKEN: "<PAT 或 user:token>"

• 地址别名：JIRA_BASE_URL / JIRA_URL
• 令牌解析顺序：JIRA_TASKS_TOKEN（设置页写入）→ 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 即可。

兼容性与验证

验证方式（不改动用户 profile，临时 DSH_HOME 起真实服务）：

# 用目标版本的 dsh 起一个隔离实例，profile 的 dsh.profile.bundles 含 dsh-jira-tasks
DSH_HOME=/tmp/dsh-check node <dsh-0.2.0-rc.2>/lib/bin.js --profile web --no-open --port 19399

curl -sX POST http://127.0.0.1:19399/jira/api/test   -d '{}'                      # 连通性 / 鉴权
curl -sX POST http://127.0.0.1:19399/jira/api/search -d '{"projectKey":"<KEY>"}'  # 任务查询
curl -s "http://127.0.0.1:19399/?token=<启动日志里的 token>" | grep -o dsh-jira-tasks  # 客户端进入 __DSH_BOOT__ 模块图

桌面端另需确认：客户端 bundle 出现在应用 Code Cache（说明浏览器端已加载执行）、localStorage 里存在 dsh.jiraTasks.config.v1（说明面板可用且按工作区写入）。

卸载

dsh plugin --profile web remove dsh-jira-tasks        # 浏览器
dsh plugin --profile desktop remove dsh-jira-tasks    # 桌面端（需桌面端自带的 dsh 命令）

常见问题

JIRA_TASKS_TOKEN（设置页） > JIRA_API_TOKEN > JIRA_TOKEN

架构与实现细节

┌────────────────────────────────────────┐   ┌────────────────────────────────────┐
│ conversation.input.dock（两种会话）     │   │ webServer 路由 /jira/api/search     │
│   CSS order:99 → 输入框下方、整宽       │   │ 条目 Config.baseUrl（volatile 引用） │
│   ↓ 挂载 / 刷新时 fetch POST            │   │ credentials.resolve(TOKEN_REFS)     │
│ 渲染：任务列表 / 错误 / 未配置          │   │ subprocess.spawn(curl …)            │
│ localStorage 按工作区存取项目 Key/JQL   │   │ ↓ stdout JSON                       │
│ plugins.item（插件面板卡片）            │   │ 解析 issues → 返回 {ok,issues}      │
│ settings.section（设置导航整页）        │   │                                     │
└────────────────────────────────────────┘   └────────────────────────────────────┘

License

MIT