terminal-bridge-setup 3.3.3 → 3.3.5

package/bin/setup.mjs

@@ -128,8 +128,13 @@ function installProxyDeps() {
   const registryArg = process.argv.find(a => a.startsWith("--registry="));
   const baseArgs = ["install", "--no-audit", "--no-fund"];
   const runNpm = (args) => {
-    console.log(c.dim(`  运行 npm ${args.join(" ")} ...`));
-    return spawnSync("npm", args, { cwd: proxyDir, stdio: "inherit" });
+    // Windows 的 npm 是 npm.cmd 批处理，spawn 不带 shell 无法启动
+    // （表现为"运行 npm install ..."后无任何输出直接失败，实测踩过）。
+    // shell:true 下走 cmd 解析；registry 参数先过白名单校验防 shell 注入。
+    const safeArgs = args.filter(a =>
+      !a.startsWith("--registry=") || /^--registry=https?:\/\/[\w.\-/:]+$/.test(a));
+    console.log(c.dim(`  运行 npm ${safeArgs.join(" ")} ...`));
+    return spawnSync("npm", safeArgs, { cwd: proxyDir, stdio: "inherit", shell: true });
   };
 
   let result;
@@ -147,9 +152,12 @@ function installProxyDeps() {
     }
   }
 
-  if (result.status !== 0) {
-    // 失败时给出明确的排查建议
-    console.error("");
+  if (result.status !== 0 || result.error) {
+    if (result.error) {
+      console.error(c.red("  ✗ 无法启动 npm：" + result.error.message));
+      console.error(c.yellow(`  手动修复：cd "${join(INSTALL_DIR, "proxy")}" && npm install`));
+      fail("npm 无法启动");
+    }
     console.error(c.red("  ✗ npm install 失败"));
     console.error(c.yellow("  常见原因和解决方法："));
     console.error("");

package/files/extension/content-yearning.js

@@ -777,9 +777,22 @@ function clickDropdownOption(target) {
         });
         // 用与编排一致的定位逻辑回看"到底选中了哪个节点"
         const trigEl = findDbTrigger();
+        // 编辑器现场取证：焦点在哪、每个 monaco 的可见性与内容长度
+        const ae = document.activeElement;
+        const editors = [...document.querySelectorAll(".monaco-editor")].map(m => {
+          const r = m.getBoundingClientRect();
+          return {
+            visible: m.offsetParent !== null && r.width > 0 && r.height > 0,
+            rect: { x: Math.round(r.left), y: Math.round(r.top), w: Math.round(r.width), h: Math.round(r.height) },
+            textLen: (m.querySelector(".view-lines")?.textContent || "").length,
+            inputareaFocused: document.activeElement === m.querySelector("textarea.inputarea"),
+          };
+        });
         sendResponse({
           ok: true,
           hash: location.hash,
+          activeElement: ae ? { cls: String(ae.className || "").slice(0, 80), id: ae.id || "", tag: ae.tagName } : null,
+          editors,
           selects: [...document.querySelectorAll(".ant-select")].map(selectDump),
           triggerLocated: trigEl ? selectDump(trigEl) : null,
           metaNow: readYearningMeta(),

package/files/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "JumpServer 终端桥接",
-  "version": "3.3.3",
+  "version": "3.3.5",
   "description": "终端桥接：JumpServer / Arthas / Yearning，让 Agent 能通过浏览器执行命令、收结果与查数据",
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtsnqR6PcFUueZwYria79tVbstvjk+tM7PpvIXILm5xbd6bAdjDIhzg3lsnKioVfvxjfvT+s6vJsiOYa9ojVZyJMFc5m/05TYqr770ovYwQmz0e88fmiy6dUoSulbtKvBCSLbN6OOL7u+ul8ixLZ/HautxSmou/eNgAFPmhE+4UueE7wfCqcgMYvjLvEzlqTVumMW+5LKw9YsRk6WhHPghY1a3MVUn3eQOWXBtQTEUy3wBM3v4wHxLwDeinVOR4f/P87IlUNo84C5DeimoFit0qCj3K04hS8MIYCLCYZc3v9ftRJDJBkAoah6Eaqj7JajbS3KvLR1ctOYfDhubgmURQIDAQAB",
   "permissions": ["debugger", "tabs", "alarms", "webNavigation", "nativeMessaging", "scripting", "downloads", "storage"],

package/files/proxy/server.js

@@ -166,7 +166,12 @@ function feedYearningWaiters(payload) {
   try {
     obj = msgpackDecode(Buffer.from(data, "base64"));
   } catch { return; }
-  if (!obj || obj.results == null) return;  // 心跳帧忽略
+  if (!obj) return;
+  // 两类有效帧：正常结果（results 非空）/ SQL 执行报错（error 非空，results 为空）。
+  // 错误帧不接住的话 waiter 只能干等超时，Agent 无从得知 SQL 写错了
+  const hasResults = obj.results != null;
+  const hasError = typeof obj.error === "string" && obj.error.trim().length > 0;
+  if (!hasResults && !hasError) return;  // 心跳等噪音帧
 
   let consumed = false;
   if (yrRunWaiters.size > 0) {
@@ -181,8 +186,8 @@ function feedYearningWaiters(payload) {
   }
 
   // 未被 yr-run 消费的结果帧 = 手动查询（或 yr-run 已完成后的重复帧），
-  // 也生成 CSV 记录。同一帧 yr-run 路径已经发过 export，不重复。
-  if (!consumed) {
+  // 也生成 CSV 记录。错误帧没有数据，跳过导出。
+  if (!consumed && hasResults) {
     const rows = Array.isArray(obj.results)
       ? obj.results.map(t => (t && t.data ? t.data.length : 0)).reduce((a, b) => a + b, 0)
       : 0;
@@ -251,6 +256,18 @@ async function handleYrRun(ws, msg) {
       settled = true;
       yrRunWaiters.delete(runEntry);
       clearTimeout(timer);
+      // SQL 执行报错帧：把数据库错误原文带回给 Agent（不导 CSV，无数据可导）
+      const sqlError = typeof obj.error === "string" ? obj.error.trim() : "";
+      if (sqlError) {
+        console.log(TAG, `[yr-run ${reqId}] SQL 执行报错: ${sqlError.slice(0, 200)}`);
+        ws.send(JSON.stringify({
+          type: "result", reqId, ok: false, error: "sql-error",
+          message: "SQL 被数据库拒绝：" + sqlError,
+          output: JSON.stringify(obj),
+          elapsedMs: Date.now() - sentAt,
+        }));
+        return true;
+      }
       console.log(TAG, `[yr-run ${reqId}] 结果帧到达（query_time=${obj.query_time ?? "?"}）`);
       // 同步发给插件：浏览器侧生成 CSV 落下载（popup 可见、可重新下载）
       sendToExtension({

package/files/skill/SKILL.md

@@ -334,6 +334,8 @@ Agent → 代理：
 | 现象 | 原因 | 处理 |
 |------|------|------|
 | `error: extension not connected` | 代理没收到插件 hello | 检查插件是否启用、service worker 日志、代理是否在跑 |
+| `error: write-forbidden` | Yearning 只读白名单拦截（非 SELECT/SHOW/DESC/EXPLAIN） | 修正为只读语句重试；不要试图混淆绕过 |
+| `error: sql-error` | **SQL 被数据库拒绝**（message 带原文，如 `Table 'xxx' doesn't exist`、权限不足） | 按 message 修正 SQL 后重试；秒回不是超时 |
 | `error: sudo-required` | 命令触发 sudo 密码提示（alias 劫持，仅 JumpServer） | 按"sudo 自动重试"流程问用户是否切 root，确认后切 root 重发原命令 |
 | `error: arthas-forbidden` | Arthas 高风险命令（retransform/profiler/stop/reset）被禁用 | 告知用户去浏览器 Arthas 终端手动执行，不要重试或绕过 |
 | `error: arthas-needs-limit` | 中风险命令（trace/watch/stack/monitor）缺 -n/#cost（严格模式） | 按 suggest 补参数重发，或加 `-n 1` |

package/files/skill/references/protocol.md

@@ -50,6 +50,10 @@ WebSocket 结果帧。Yearning 结果帧是 opcode=2 二进制帧，解码后通
 SELECT/SHOW/DESC/EXPLAIN；命中 INTO OUTFILE/DUMPFILE/FOR UPDATE 等副作用子句
 同样拒绝。失败返回 `ok:false, error:"write-forbidden"`。yr-set 路径同受约束。
 
+**SQL 执行报错回传**：数据库拒绝 SQL 时（表不存在/权限不足等），Yearning 的
+错误帧会被捕获并立即返回 `ok:false, error:"sql-error", message:"SQL 被数据库拒绝：<原文>"`，
+不会等到超时。Agent 应按 message 修正 SQL 重试。
+
 prepare 模式示例：
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-bridge-setup",
-  "version": "3.3.3",
+  "version": "3.3.5",
   "description": "一次性安装器：释放终端桥接（JumpServer / Arthas / Yearning）的本地代理 + Chrome 插件，并注册 native messaging host。让 Agent 能通过浏览器 xterm 终端执行命令并拿回输出。",
   "license": "MIT",
   "author": "encorearon",