dsh-jira-tasks
JIRA open tasks panel for DeepSeek Harness (DSH): shows the current user's open/reopened issues below the composer, per-workspace project key, persistent profile bundle.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add dsh-jira-tasks@1.0.8
Jira Tasks is published as dsh-jira-tasks and currently resolves to version 1.0.8. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
中文 · English
在 DSH 会话输入框下方展示当前 JIRA 项目指派给当前用户的「开启 / 重新开启」任务列表。JIRA 地址与令牌在设置 → 插件 → JIRA 中配置（JIRA_BASE_URL / JIRA_API_TOKEN 作为回退）；项目 Key 与 JQL 按工作区配置并持久化。
assignee = currentUser()）的「开启 / 重新开启」任务包已发布到公共 npm（dsh-jira-tasks）；仓库的发布工作流同时把同一版本发布到 GitHub Packages（作用域包名 @liu3734/dsh-jira-tasks）。从 npm 安装（推荐）：
dsh plugin --profile web add dsh-jira-tasks
或直接从 GitHub 安装（仓库根即包目录，lib/ 为预构建产物）：
dsh plugin --profile web add github:liu3734/jira-tasks-dsh-plugin
重启 DSH 后生效。
若改用 GitHub Packages 源：先在 profile 的
.npmrc配置@liu3734:registry=https://npm.pkg.github.com/及读取令牌，再执行dsh plugin --profile web add @liu3734/dsh-jira-tasks。
~/.dsh/profiles/web/packages/dsh-jira-tasks/（可忽略 .git/）~/.dsh/profiles/web/package.json：
dependencies 增加："dsh-jira-tasks": "file:./packages/dsh-jira-tasks"dsh.profile.bundles 追加："dsh-jira-tasks"pnpm install注：
pnpm install会把包复制到node_modules/（非符号链接），改动源码后需同步node_modules/dsh-jira-tasks或重跑 install。
在 DSH 会话中用 Cordis 工具执行：cordis_define（kind: new，idPrefix: "jira"，源码见仓库 plugin/host.js / plugin/client.js）→ cordis_run 激活。动态插件只存在于进程内存，重启后消失，仅适合临时试用。
打开 设置 → 插件 → 插件配置 → JIRA，填写：
http://jira.example.com/（存入用户设置文档，可在界面回读）$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想改回用环境变量，点卡片里的「清除设置页令牌」即可。
卡片底部有连接状态灯与 测试连接 按钮：
/rest/api/2/myself），保存后也会自动重测以下环境变量 / 凭据仍作为回退（设置页未配置时生效，兼容旧部署），热加载无需重启：
JIRA_BASE_URL: "http://jira.example.com/"
JIRA_API_TOKEN: "<PAT 或 user:token>"
JIRA_BASE_URL / JIRA_URLJIRA_TASKS_TOKEN（设置页写入）→ JIRA_API_TOKEN → JIRA_TOKEN，前者优先HCPFYH1，保存后立即查询，该工作区后续新会话自动加载{projectKey}（或 {key}）会被替换为项目 Key默认查询：
project = "{projectKey}" AND status in ("开启", "重新开启") AND assignee = currentUser() ORDER BY updated DESC
状态名按中文工作流（"开启"/"重新开启"）配置；若 JIRA 用英文状态（Open/Reopened），在 ⚙ 中填写自定义 JQL 即可。
dsh plugin --profile web remove dsh-jira-tasks
面板中的提示位于「查询失败：」之后，与下列文案对应：
| 提示 | 处理 |
|---|---|
| 未设置项目 Key | 面板未配置项目，点标题右侧 ⚙ 填写项目 Key |
| 未配置 JIRA 地址（设置 → 插件 → JIRA，或环境变量 JIRA_BASE_URL） | 地址未写入，见上文「配置 1」 |
| 未配置 JIRA 令牌（设置 → 插件 → JIRA，或环境变量 JIRA_API_TOKEN） | 令牌未写入，见上文「配置 1」 |
| 401 … | 令牌无效或认证方式不对；先 curl -H "Authorization: Bearer <token>" <base>/rest/api/2/myself 验证 |
| 无法解析 JIRA 响应：… | 网络 / 代理问题，curl 无输出 |
能。 卡片把令牌保存到插件自有引用 JIRA_TASKS_TOKEN，而不是直接写环境变量用的 JIRA_API_TOKEN。DSH 只拒绝写入「会被启动环境遮蔽的同名引用」，插件自有引用不受影响，所以哪怕 shell / 系统里已导出 JIRA_API_TOKEN，设置页也能正常输入并保存，并且 Host 解析时优先用它：
JIRA_TASKS_TOKEN（设置页） > JIRA_API_TOKEN > JIRA_TOKEN
is supplied read-only by the launching environment 的情况：有人把 JIRA_TASKS_TOKEN 本身也导出到了启动环境——那种情况下该引用确实只读，需先移除它（Windows：系统属性 → 环境变量，或 PowerShell [Environment]::SetEnvironmentVariable('JIRA_TASKS_TOKEN', $null, 'User')）并重启 DSH┌────────────────────────────────────────┐ ┌────────────────────────────────────┐
│ conversation.composer.dock（活跃会话） │ │ webServer 路由 /jira/api/search │
│ conversation.input.dock（新会话） │ │ ↓ │
│ 面板 hero 布局（flex order:99） │ │ settings.get("jira-tasks").baseUrl │
│ ↓ 挂载 / 刷新时 fetch POST │ │ credentials.resolve(TOKEN_REFS) │
│ 渲染：任务列表 / 错误 / 未配置 │ │ subprocess.spawn(curl …) │
│ localStorage 按工作区存取项目 Key/JQL │ │ ↓ stdout JSON │
│ settings.plugin.item（设置页卡片） │ │ 解析 issues → 返回 {ok,issues} │
└────────────────────────────────────────┘ └────────────────────────────────────┘
settings 命名空间 jira-tasks（baseUrl，可读）与 webServer 路由 POST /jira/api/search；地址优先读设置文档，令牌经 credentials 服务按 JIRA_TASKS_TOKEN（设置页写入）→ JIRA_API_TOKEN → JIRA_TOKEN 的顺序解析（$DSH_HOME/.credentials.yaml / 环境变量，热加载），因此设置页保存的令牌能覆盖环境变量；查询用 subprocess 直接 spawn curl，认证头经 stdin（--config -）传入，令牌不进入命令行参数。window.__ModuleLoader__.load({ id, factory }) 标准 web bundle；注册 conversation.composer.dock（活跃会话，注册 order: 5）与 conversation.input.dock（新会话，注册 order: 10）。新会话面板走 hero 布局：面板元素自身 flex order: 99 排在输入框之后下方，并以 --dsh-composer-side-clearance / --dsh-composer-card-max-width 与输入卡等宽。另注册 settings.plugin.item（key: "jira-tasks"）作为设置页卡片：地址经 settingsScope 写入命名空间，令牌经 remote.credentials 写入 JIRA_TASKS_TOKEN。shell 服务：shell 会套 sandbox-exec，部分 macOS 上不可用（sandbox_apply: Operation not permitted）；subprocess 是原始进程缝，无此问题。composer.dock，故额外注册 input.dock，并用「会话是否已有消息」去重（新版 DSH 依据 SessionSnapshot.blank），避免双份面板。与动态插件版的差异
| 维度 | 动态插件 | 正式安装（本包） |
|---|---|---|
| 持久性 | 重启丢失 | 重启保留 |
| Client→Host 通信 |
MIT
host.call / harness.handle |
webServer 路由 + fetch |
| 客户端 bundle | 会话内注入 | /plugins/dsh-jira-tasks/client.js |
| 配置 / 凭据 | 仅环境变量 / .credentials.yaml（无设置页卡片） | 设置页卡片 + 同一 .credentials.yaml 回退 |