dsh-jira-tasks 1.0.5 → 1.0.6

package/README.en.md

@@ -11,6 +11,7 @@ Shows the current JIRA project's **open / reopened** issues **assigned to the cu
 - 📋 Panel shown below the composer in both new and active sessions (aligned with the input width in new sessions)
 - 👤 Defaults to the current user (`assignee = currentUser()`) with status `开启 / 重新开启` (Open / Reopened)
 - ⚙️ **Settings → Plugins → JIRA** edits the base URL and access token (the token is written to the credential store and never sent back to the browser)
+- 🟢 The card auto-probes the connection and shows a status light: green = usable, red = unusable, grey = unconfigured; **Test connection** verifies unsaved drafts immediately
 - ⚙️ Project key and JQL are saved per workspace; unconfigured workspaces show "unconfigured"
 - 🔄 Auto-query on every new session, with a one-click refresh (⟳)
 - 🔗 Click an issue to open its JIRA detail in a new tab
@@ -56,6 +57,14 @@ Open **Settings → Plugins → Plugin configuration → JIRA** and fill in:
 
 Leaving the token blank on save keeps the existing one; clearing the address on save removes the override and falls back to the environment. Auth is auto-detected: tokens containing `:` use Basic, otherwise Bearer (JIRA PAT).
 
+#### Connection test
+
+The card's footer carries a status light and a **Test connection** button:
+
+- Opening the card **auto-probes** once (against JIRA `/rest/api/2/myself`), and saving re-probes
+- **Green** = address and token work (the current user is shown); **red** = unusable (JIRA's reason, e.g. 401, is shown); **grey** = address or token not configured
+- **Test connection** probes what is currently in the fields, saved or not, so you can check before saving
+
 Environment variables / credentials still work as a **fallback** (used when the settings card is empty), hot-reloaded without a restart:
 
 ```yaml

package/README.md

@@ -15,6 +15,7 @@
 
 - 👤 默认仅显示当前用户（`assignee = currentUser()`）的「开启 / 重新开启」任务
 - ⚙️ **设置 → 插件 → JIRA** 配置 JIRA 地址与访问令牌（令牌写入凭据存储，不回传前端）
+- 🟢 设置卡片自动探测连接并显示状态灯：绿=可用、红=不可用、灰=未配置；点「测试连接」可用**未保存的草稿值**即时验证
 - ⚙️ 项目 Key 与 JQL 按工作区保存；未配置的工作区显示"未配置"
 - 🔄 打开新会话自动查询，面板内支持一键刷新（⟳）
 - 🧭 点击标题可**收起 / 展开**面板；标题徽标显示查询命中的任务总数（列表最多展示 50 条，按更新时间倒序）
@@ -64,6 +65,14 @@ dsh plugin --profile web add dsh-jira-tasks
 
 留空并保存会保持已有令牌不变；地址留空并保存则清除设置项，回退到环境变量。认证自动识别：令牌含 `:` 用 Basic，否则用 Bearer（JIRA PAT）。
 
+#### 连接测试
+
+卡片底部有连接状态灯与 **测试连接** 按钮：
+
+- 打开卡片时会**自动探测**一次（请求 JIRA `/rest/api/2/myself`），保存后也会自动重测
+- **绿** = 地址与令牌可用（并显示当前登录用户）；**红** = 不可用（显示 JIRA 返回的原因，如 401 认证失败）；**灰** = 地址或令牌未配置
+- 点 **测试连接** 会用**当前输入框里的内容**（未保存也可）立即测试，方便改完再存
+
 以下环境变量 / 凭据仍作为**回退**（设置页未配置时生效，兼容旧部署），热加载无需重启：
 
 ```yaml

package/lib/client.js

@@ -47,7 +47,12 @@ window.__ModuleLoader__.load({
       + ".jt-set-card{box-sizing:border-box;list-style:none;margin:0;border:1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.28));background:var(--dsw-alias-bg-layer-1, rgba(127,127,127,.05));border-radius:10px;padding:10px 12px}"
       + ".jt-set-head{display:flex;flex-direction:column;gap:2px;margin-bottom:8px}"
       + ".jt-set-title{font-weight:600;font-size:13px;color:var(--dsw-alias-label-primary, #222)}"
-      + ".jt-set-desc{font-size:12px;color:var(--dsw-alias-label-secondary, #666);line-height:1.6}";
+      + ".jt-set-desc{font-size:12px;color:var(--dsw-alias-label-secondary, #666);line-height:1.6}"
+      + ".jt-probe{display:flex;align-items:center;gap:6px;margin:0 0 8px;font-size:12px;color:var(--dsw-alias-label-secondary, #666);line-height:1.6;word-break:break-word}"
+      + ".jt-dot{flex:none;width:8px;height:8px;border-radius:50%;background:var(--dsw-alias-label-secondary, #999)}"
+      + ".jt-dot-ok{background:var(--dsw-alias-state-success-primary, #1a9d4f)}"
+      + ".jt-dot-fail{background:var(--dsw-alias-state-error-primary, #d93026)}"
+      + ".jt-dot-testing{background:var(--dsw-alias-state-warn-primary, #b76e00)}";
 
     var STORAGE_KEY = "dsh.jiraTasks.config.v1";
 
@@ -107,6 +112,15 @@ window.__ModuleLoader__.load({
       }).then(function (r) { return r.json(); });
     }
 
+    // 探测 JIRA 地址/令牌可用性；可选传入未保存的草稿值。
+    function testConnection(payload) {
+      return fetch("/jira/api/test", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload || {})
+      }).then(function (r) { return r.json(); });
+    }
+
     function JiraTasksDock(props) {
       var blankOnly = !!(props && props.blankOnly === true);
       var useWorkspaces = props && typeof props.useWorkspaces === "function" ? props.useWorkspaces : null;
@@ -313,6 +327,9 @@ window.__ModuleLoader__.load({
         var busy = busyState[0], setBusy = busyState[1];
         var failedState = React.useState("");
         var failed = failedState[0], setFailed = failedState[1];
+        var probeState = React.useState({ phase: "idle" });
+        var probe = probeState[0], setProbe = probeState[1];
+        var probeGen = React.useRef(0);
 
         React.useEffect(function () {
           var alive = true;
@@ -320,6 +337,12 @@ window.__ModuleLoader__.load({
           return function () { alive = false; };
         }, []);
 
+        // 自动测试：命名空间就绪后、以及已保存配置变更（含保存后）时各探测一次。
+        React.useEffect(function () {
+          if (snapshot.status !== "ready") return;
+          runProbe({});
+        }, [snapshot.status, snapshot.revision]);
+
         var storedBase = snapshot.value && typeof snapshot.value.baseUrl === "string" ? snapshot.value.baseUrl : "";
         var baseValue = baseEdit === undefined ? storedBase : baseEdit;
         var dirty = (baseEdit !== undefined && baseEdit !== storedBase) || (tokenDraft || "").length > 0;
@@ -364,9 +387,27 @@ window.__ModuleLoader__.load({
           setFailed("");
         }
 
+        // 探测连接：payload 传入即测草稿，传空对象则测已保存/环境配置。
+        function runProbe(payload) {
+          var gen = ++probeGen.current;
+          setProbe({ phase: "testing", message: "正在测试连接…" });
+          testConnection(payload).then(function (res) {
+            if (gen !== probeGen.current) return;
+            if (res && res.ok) setProbe({ phase: "ok", message: "可用" + (res.user ? "：" + res.user : "") });
+            else if (res && res.code === "unconfigured") setProbe({ phase: "idle", message: "未配置地址或令牌" });
+            else setProbe({ phase: "fail", message: (res && res.error) || "不可用" });
+          }).catch(function (err) {
+            if (gen !== probeGen.current) return;
+            setProbe({ phase: "fail", message: String((err && err.message) || err) });
+          });
+        }
+
         var tokenHint = tokenInfo === null
           ? "正在读取令牌状态…"
           : (tokenInfo.configured ? "令牌已配置；留空并保存可保持不变。" : "令牌未配置。含 “:” 时用 Basic，否则用 Bearer。");
+        var dotClass = probe.phase === "ok" ? "jt-dot jt-dot-ok"
+          : probe.phase === "fail" ? "jt-dot jt-dot-fail"
+            : probe.phase === "testing" ? "jt-dot jt-dot-testing" : "jt-dot";
 
         return h("li", { className: "jt-set-card" },
           h("div", { className: "jt-set-head" },
@@ -400,8 +441,19 @@ window.__ModuleLoader__.load({
             })
           ),
           h("div", { className: "jt-hint", style: { marginBottom: "8px" } }, tokenHint),
+          h("div", { className: "jt-probe", role: "status" },
+            h("span", { className: dotClass, "aria-hidden": "true" }),
+            h("span", null, probe.message || "未测试")
+          ),
           failed ? h("div", { className: "jt-error", style: { marginBottom: "8px" } }, "保存失败：" + failed) : null,
           h("div", { className: "jt-buttons" },
+            h("button", {
+              className: "jt-btn",
+              style: { marginRight: "auto" },
+              disabled: busy || probe.phase === "testing",
+              title: "用当前填写的内容测试 JIRA 地址与令牌",
+              onClick: function () { runProbe({ baseUrl: baseValue, token: (tokenDraft || "").trim() }); }
+            }, probe.phase === "testing" ? "测试中…" : "测试连接"),
             h("button", { className: "jt-btn", disabled: !dirty || busy, onClick: discard }, "放弃"),
             h("button", { className: "jt-btn jt-btn-primary", disabled: !dirty || busy || !writable, onClick: save }, busy ? "保存中…" : "保存")
           )

package/lib/index.js

@@ -117,6 +117,49 @@ export default {
       return { exitCode: outcome.exitCode, stdout, stderr };
     }
 
+    // 从 JIRA 错误响应体/curl stderr 中提取可读信息。
+    function errorTextFrom(body, stderr, fallback) {
+      let message = (stderr || '').trim() || fallback;
+      try {
+        const parsed = JSON.parse(body);
+        if (parsed.errorMessages && parsed.errorMessages.length) message = parsed.errorMessages.join('；');
+        else if (parsed.message) message = parsed.message;
+      } catch (e) { /* body 非 JSON */ }
+      return message;
+    }
+
+    // 连通性/鉴权探测：GET /rest/api/2/myself，stdout 末尾追加 HTTP 状态码。
+    async function probeJira(baseUrl, token) {
+      const auth = buildAuthHeader(token);
+      const cleanBase = baseUrl.replace(/\/+$/, '');
+      let curl;
+      try {
+        curl = await subprocess.resolveExecutable('curl');
+      } catch (e) {
+        curl = '/usr/bin/curl';
+      }
+      const handle = subprocess.spawn({
+        argv: [
+          curl, '-sS', '--max-time', '15',
+          '-H', 'Accept: application/json',
+          '--config', '-',
+          '-w', '\n%{http_code}',
+          cleanBase + '/rest/api/2/myself'
+        ],
+        cwd: workspaceRoot,
+        stdio: {
+          stdin: { data: 'header = "Authorization: ' + auth + '"\n' },
+          stdout: { maxBytes: 1024 * 1024, spill: { maxBytes: 4 * 1024 * 1024 } },
+          stderr: { maxBytes: 256 * 1024, spill: { maxBytes: 1024 * 1024 } }
+        },
+        graceMs: 5000
+      });
+      const outcome = await handle.done;
+      const stdout = (handle.collected.stdout ? handle.collected.stdout.readFrom(0).text : '') || '';
+      const stderr = (handle.collected.stderr ? handle.collected.stderr.readFrom(0).text : '') || '';
+      return { exitCode: outcome.exitCode, stdout, stderr };
+    }
+
     async function handleSearch(args) {
       const projectKey = String((args && args.projectKey) || '').trim();
       if (!projectKey) return { ok: false, error: '未设置项目 Key' };
@@ -132,13 +175,7 @@ export default {
         const stderr = raw.stderr;
 
         if (raw.exitCode !== 0) {
-          let message = stderr.trim() || ('curl 退出码 ' + String(raw.exitCode));
-          try {
-            const parsed = JSON.parse(stdout);
-            if (parsed.errorMessages && parsed.errorMessages.length) message = parsed.errorMessages.join('；');
-            else if (parsed.message) message = parsed.message;
-          } catch (e) { /* stdout 非 JSON */ }
-          return { ok: false, error: message };
+          return { ok: false, error: errorTextFrom(stdout, stderr, 'curl 退出码 ' + String(raw.exitCode)) };
         }
 
         let data;
@@ -169,6 +206,43 @@ export default {
       }
     }
 
+    // 设置卡片“测试连接”：用草稿值（未保存也可测）或已保存/环境配置探测 JIRA。
+    async function handleTest(args) {
+      try {
+        const draftBase = args && typeof args.baseUrl === 'string' ? args.baseUrl.trim() : '';
+        const draftToken = args && typeof args.token === 'string' ? args.token.trim() : '';
+        const baseUrl = draftBase || settingsBaseUrl() || await resolveFirst(['JIRA_BASE_URL', 'JIRA_URL']);
+        if (!baseUrl) return { ok: false, code: 'unconfigured', error: '未配置 JIRA 地址' };
+        const token = draftToken || await resolveFirst(['JIRA_API_TOKEN', 'JIRA_TOKEN']);
+        if (!token) return { ok: false, code: 'unconfigured', error: '未配置 JIRA 令牌' };
+
+        const raw = await probeJira(baseUrl, token);
+        if (raw.exitCode !== 0) {
+          return { ok: false, code: 'network', error: (raw.stderr || '').trim() || ('curl 退出码 ' + String(raw.exitCode)) };
+        }
+        const nl = raw.stdout.lastIndexOf('\n');
+        const body = nl === -1 ? raw.stdout : raw.stdout.slice(0, nl);
+        const httpCode = Number((nl === -1 ? '' : raw.stdout.slice(nl + 1)).trim()) || 0;
+
+        if (httpCode >= 200 && httpCode < 300) {
+          let data = {};
+          try { data = JSON.parse(body); } catch (e) { /* 空/非 JSON 也视为连通 */ }
+          return {
+            ok: true,
+            baseUrl: baseUrl.replace(/\/+$/, ''),
+            user: data.displayName || data.name || data.key || ''
+          };
+        }
+        return {
+          ok: false,
+          code: httpCode === 401 || httpCode === 403 ? 'auth' : 'http',
+          error: errorTextFrom(body, raw.stderr, 'HTTP ' + String(httpCode))
+        };
+      } catch (err) {
+        return { ok: false, code: 'error', error: String((err && err.message) || err) };
+      }
+    }
+
     if (webServer && typeof webServer.register === 'function') {
       webServer.register({
         kind: 'exact',
@@ -181,6 +255,17 @@ export default {
           }
         }
       });
+      webServer.register({
+        kind: 'exact',
+        path: '/jira/api/test',
+        handler: async (req, res) => {
+          try {
+            sendJson(res, await handleTest(await readBody(req)));
+          } catch (e) {
+            sendJson(res, { ok: false, code: 'error', error: String((e && e.message) || e) });
+          }
+        }
+      });
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-jira-tasks",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "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.",
   "type": "module",
   "main": "lib/index.js",