terminal-bridge-setup 3.3.4 → 3.3.6

package/files/extension/background.js

@@ -846,6 +846,19 @@ async function yrSqlSetViaCDP(tabId, sql, reqId, skipNew = false) {
       await new Promise(resolve => attachDebugger(tabId) ?? resolve());
       await new Promise(r => setTimeout(r, 400));  // 等 Network.enable 完成
     }
+    // 把 Yearning 标签页带到前台：后台标签页的 Vue/monaco 渲染被 rAF 节流，
+    // 新建查询 tab 点了也不渲染 → SQL 会被追加到已有编辑器后面（严重 bug，实测）
+    try {
+      const yrTab = await chrome.tabs.get(tabId);
+      if (!yrTab.active) {
+        await chrome.tabs.update(tabId, { active: true });
+        if (yrTab.windowId != null) await chrome.windows.update(yrTab.windowId, { focused: true });
+        await sleepMs(500);  // 等页面从节流中恢复渲染
+        console.log("[bg] Yearning 标签页已带到前台（原为后台）");
+      }
+    } catch (err) {
+      console.warn("[bg] 激活 Yearning 标签页失败（继续注入）:", err?.message);
+    }
     // 新建 SQL 窗口：避免把 SQL 注入用户正在使用的已有编辑器。
     // 编排模式（代理已显式建过 tab 并选好库）由 skipNew 跳过。
     if (!skipNew) {
@@ -853,6 +866,18 @@ async function yrSqlSetViaCDP(tabId, sql, reqId, skipNew = false) {
       if (!newWin || !newWin.ok) {
         console.warn("[bg] 新建 SQL 窗口失败（继续在当前编辑器注入）:", newWin?.error);
       }
+      // 安全护栏：新建失败且现有编辑器非空时绝不注入——宁可失败也不能把 SQL
+      // 追加到用户已有语句后面（后台节流场景实测踩过）
+      const cur = await sendFrameMessage(tabId, { type: "yr-sql-get" }, 0);
+      if (cur?.ok && (cur.sql || "").trim().length > 0) {
+        sendToBridge({
+          type: "yr-result", reqId, tabId, ok: false,
+          error: "editor-not-empty",
+          message: "新建查询 tab 未生效且当前编辑器已有内容，为避免把 SQL 追加到你现有语句后面已中止。请切到 Yearning 页面确认后重试（或先清空/关闭已有 SQL tab）。",
+          editorText: (cur.sql || "").slice(0, 120),
+        });
+        return;
+      }
     }
     // 前置校验：数据库未选择时 Yearning 查询必报错，提前失败给明确提示
     const meta = await sendFrameMessage(tabId, { type: "yr-meta" }, 0);

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.4",
+  "version": "3.3.6",
   "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({
@@ -602,6 +619,25 @@ function detectTerminalType(text) {
 }
 
 // 插件上报的 ws-recv 帧
+// OrcaTerm（腾讯云 TKE 容器终端等）用 JSON 文本帧包裹终端流：
+//   {"type":"data","data":"<带 ANSI 的真实终端明文>","sessionId":"..."}
+// 且一帧内可能拼接多个 JSON 对象。解包取 data 字段；其他类型帧（心跳等）丢弃。
+function extractOrcaTermData(text) {
+  if (typeof text !== "string" || text.indexOf('{"type"') === -1) return text;
+  let out = "";
+  let buf = "";
+  for (const ch of text) {
+    buf += ch;
+    if (ch !== "}") continue;
+    try {
+      const obj = JSON.parse(buf);
+      buf = "";
+      if (obj && obj.type === "data" && typeof obj.data === "string") out += obj.data;
+    } catch { /* 还没凑齐一个完整 JSON，继续累积 */ }
+  }
+  return out;
+}
+
 function handleWsRecv(payload) {
   const data = payload && payload.data;
   const opcode = payload && payload.opcode;
@@ -630,6 +666,9 @@ function handleWsRecv(payload) {
     text = typeof data === "string" ? data : String(data);
   }
 
+  // OrcaTerm JSON 包裹帧解包（koko 无此包裹，indexOf 快速跳过零开销）
+  text = extractOrcaTermData(text);
+
   // 给当前 pending（同时只会有一个）喂帧，按 prompt 锚点状态机处理
   for (const [reqId, entry] of pending) {
     entry.buffer += text;
@@ -1045,7 +1084,10 @@ wss.on("connection", (ws, req) => {
       // 防止 tap 页面（Yearning JSON 帧）污染终端命令的输出配对。
       broadcastTap(msg.payload);
       const frameUrl = (msg.payload && msg.payload.url) || "";
-      const isTerminalUrl = !frameUrl || /\/koko\/ws|connectArthas/i.test(frameUrl);
+      // 终端白名单：koko（JumpServer）/ Arthas / 腾讯云 OrcaTerm（TKE 容器终端，
+      // JSON 文本帧由 extractOrcaTermData 解包）。空 URL 也接受（attach 前建立的
+      // 连接拿不到 webSocketCreated，帧没有 url）
+      const isTerminalUrl = !frameUrl || /\/koko\/ws|connectArthas|orcaterm/i.test(frameUrl);
       if (isTerminalUrl) handleWsRecv(msg.payload);
       return;
     }

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.4",
+  "version": "3.3.6",
   "description": "一次性安装器：释放终端桥接（JumpServer / Arthas / Yearning）的本地代理 + Chrome 插件，并注册 native messaging host。让 Agent 能通过浏览器 xterm 终端执行命令并拿回输出。",
   "license": "MIT",
   "author": "encorearon",