terminal-bridge-setup 2.9.1 → 3.1.0

package/files/extension/content-yearning.js

@@ -0,0 +1,307 @@
+// Terminal Bridge - Yearning SQL 平台自动化 content script (ISOLATED world)
+//
+// 只在 Yearning（sql.meiyunji.net）页面工作。配合 background 的 tap 模式：
+//   Agent → 代理 → background → 本脚本：注入 SQL 到编辑器、点「查询」按钮
+//   查询结果通过 tap 通道（WS 帧）回到 Agent
+//
+// 消息（均由 background 转发，frameId=0 顶层文档）：
+//   yr-ping        探测编辑器类型和查询按钮，返回结构化信息
+//   yr-sql-set     {sql} 注入 SQL（按探测到的编辑器类型选策略）
+//   yr-query-click 找「查询」按钮并点击
+
+(function () {
+  const TAG = "[terminal-bridge-yr]";
+  if (window.__terminalBridgeYearning) return;
+  window.__terminalBridgeYearning = true;
+
+  // ---------- MAIN world 桥（CodeMirror/monaco API 只在页面上下文可达）----------
+  let mainMsgId = 0;
+  const mainWaiters = new Map();
+
+  window.addEventListener("message", (event) => {
+    if (event.source !== window) return;
+    const msg = event.data;
+    if (!msg || msg.source !== "tb-yr-main") return;
+    const waiter = mainWaiters.get(msg.id);
+    if (waiter) {
+      mainWaiters.delete(msg.id);
+      waiter(msg);
+    }
+  });
+
+  function callMain(kind, payload, timeoutMs = 300) {
+    return new Promise((resolve) => {
+      const id = ++mainMsgId;
+      const timer = setTimeout(() => {
+        mainWaiters.delete(id);
+        resolve(null);  // 超时 = MAIN world 没装或没处理
+      }, timeoutMs);
+      mainWaiters.set(id, (reply) => {
+        clearTimeout(timer);
+        resolve(reply);
+      });
+      window.postMessage({ source: "tb-yr-iso", id, kind, ...payload }, "*");
+    });
+  }
+
+  // ---------- 编辑器探测 ----------
+  async function detectEditor() {
+    const info = {
+      url: location.href,
+      codeMirrorDom: !!document.querySelector(".CodeMirror"),
+      monacoDom: !!document.querySelector(".monaco-editor"),
+      mainWorld: null,
+      textareas: [],
+      contentEditables: [],
+    };
+    const main = await callMain("detect", {}, 200);
+    info.mainWorld = main ? main.editors : "unreachable";
+    document.querySelectorAll("textarea").forEach((ta, i) => {
+      if (i < 5) info.textareas.push({
+        cls: (ta.className || "").slice(0, 60),
+        placeholder: (ta.placeholder || "").slice(0, 40),
+        visible: ta.offsetParent !== null,
+      });
+    });
+    document.querySelectorAll('[contenteditable="true"]').forEach((el, i) => {
+      if (i < 5) info.contentEditables.push({
+        tag: el.tagName,
+        cls: (el.className || "").slice(0, 60),
+        visible: el.offsetParent !== null,
+      });
+    });
+    return info;
+  }
+
+  // ---------- 数据库/数据源元信息 ----------
+  // 三层读取策略：
+  //   1. 数据库（所选库）：精确 XPath（form 下 div[2]/div[2] 的选择器文本）——
+  //      未选库时查询会报错，必须准确知道
+  //   2. 数据源：URL hash 的 source/idc 参数（#/apply/query?source=xxx&idc=xxx）
+  //   3. 兜底：整个 form 的 input/select 值启发式
+  const FORM_XPATH = "/html/body/div[1]/div/section/section/div[2]/main/div/div/div[2]/div[2]/div/div/div/div/div[2]/div/div[1]/div/div[2]/div/div/div/form";
+  const DATABASE_XPATH = FORM_XPATH + "/div[2]/div[2]/div/div/div";
+
+  function xpathNode(path) {
+    try { return document.evaluate(path, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue; } catch { return null; }
+  }
+
+  function readYearningMeta() {
+    let database = "";
+    let dataSource = "";
+
+    // 1. 所选数据库：精确 XPath 读取（antd Select 的显示文本）
+    const dbNode = xpathNode(DATABASE_XPATH);
+    if (dbNode) {
+      const dbText = (dbNode.textContent || "").trim();
+      // Select 未选择时 antd 显示 placeholder（"请选择..."），排除
+      if (dbText && !/请选择|placeholder/i.test(dbText)) database = dbText;
+    }
+
+    // 2. 数据源：URL hash
+    try {
+      const h = location.hash.replace(/^#/, "");
+      const q = new URLSearchParams(h.split("?")[1] || "");
+      dataSource = q.get("source") || "";
+      const idc = q.get("idc") || "";
+      if (idc && idc !== dataSource) dataSource = dataSource ? `${dataSource} · ${idc}` : idc;
+    } catch {}
+
+    // 3. 兜底：form 启发式
+    if (!database || !dataSource) {
+      const form = document.querySelector("form") || xpathNode(FORM_XPATH);
+      if (form) {
+        const values = [];
+        form.querySelectorAll("input, select").forEach(el => {
+          if (el.offsetParent === null) return;
+          const value = el.tagName === "SELECT" ? el.options[el.selectedIndex]?.textContent : el.value;
+          if (value?.trim()) values.push(value.trim());
+        });
+        const unique = [...new Set(values)].filter(v => !/^(查询|执行|取消|确定|SQL)$/i.test(v));
+        if (!dataSource) dataSource = unique.find(v => /source|实例|数据源|tdsql|mysql|prod|test/i.test(v)) || "";
+        if (!database) database = unique.find(v => /database|db|库|schema/i.test(v)) || "";
+      }
+    }
+
+    const label = [dataSource, database].filter(Boolean).join(" · ")
+      || [database, dataSource].filter(Boolean).join(" · ")
+      || document.title
+      || "Yearning";
+    return { ok: true, database, dataSource, label, formFound: !!(database || dataSource) };
+  }
+
+  // ---------- 查询按钮探测 ----------
+  function findQueryButtons() {
+    const buttons = [];
+    document.querySelectorAll("button").forEach((b) => {
+      const text = (b.textContent || "").trim();
+      if (!text || text.length > 8) return;
+      buttons.push({ text, visible: b.offsetParent !== null, disabled: b.disabled });
+    });
+    return buttons;
+  }
+
+  // ---------- monaco 编辑器内容读取（注入验证用，无 API 时从 DOM 读）----------
+  function readMonacoText() {
+    const lines = [...document.querySelectorAll(".monaco-editor .view-lines .view-line")]
+      .map(l => l.textContent || "");
+    return lines.join("\n");
+  }
+
+  // ---------- SQL 注入（先 MAIN world API，后 DOM 策略，注入后验证）----------
+  async function setSql(sql) {
+    // 策略 1：CodeMirror/monaco（MAIN world，官方 API 状态一定同步）
+    const main = await callMain("set-sql", { sql });
+    if (main && main.ok) return { ok: true, via: main.via };
+
+    // 策略 2：monaco DOM 注入——合成 paste 事件（monaco 官方输入路径）。
+    //   实测教训：execCommand("insertText") 在 inputarea 上静默失败（假阳性），
+    //   而 ClipboardEvent("paste") + DataTransfer 是 monaco 粘贴处理器认的通道。
+    const monacoTa = document.querySelector(".monaco-editor textarea.inputarea");
+    if (monacoTa) {
+      monacoTa.focus();
+      // 全选旧内容（paste 会替换选区）
+      monacoTa.dispatchEvent(new KeyboardEvent("keydown", {
+        key: "a", code: "KeyA", keyCode: 65, which: 65,
+        ctrlKey: true, bubbles: true, cancelable: true
+      }));
+      const dt = new DataTransfer();
+      dt.setData("text/plain", sql);
+      monacoTa.dispatchEvent(new ClipboardEvent("paste", {
+        clipboardData: dt, bubbles: true, cancelable: true
+      }));
+
+      // 注入后验证：等 monaco 渲染，读回 view-lines 内容比对（杜绝假阳性）
+      await new Promise(r => setTimeout(r, 250));
+      const current = readMonacoText();
+      const norm = s => s.replace(/\s+/g, "");
+      if (norm(current).includes(norm(sql).slice(0, 40))) {
+        return { ok: true, via: "monaco-paste" };
+      }
+      // paste 失败再试 execCommand（检查返回值）
+      monacoTa.focus();
+      const ok2 = document.execCommand("insertText", false, sql);
+      await new Promise(r => setTimeout(r, 250));
+      const current2 = readMonacoText();
+      if (ok2 && norm(current2).includes(norm(sql).slice(0, 40))) {
+        return { ok: true, via: "monaco-execcmd" };
+      }
+      return {
+        ok: false,
+        error: "monaco inject failed (paste+execCommand 均未生效)",
+        editorText: current2.slice(0, 120),
+      };
+    }
+
+    // 策略 3：普通可见 textarea（value + input 事件）
+    const tas = [...document.querySelectorAll("textarea")].filter(ta => ta.offsetParent !== null);
+    if (tas.length > 0) {
+      const ta = tas[0];
+      ta.focus();
+      ta.value = sql;
+      ta.dispatchEvent(new InputEvent("input", {
+        inputType: "insertText", data: sql, bubbles: true, cancelable: true
+      }));
+      return { ok: true, via: "textarea" };
+    }
+
+    // 策略 4：contenteditable（focus + 全选 + 插入）
+    const ces = [...document.querySelectorAll('[contenteditable="true"]')].filter(el => el.offsetParent !== null);
+    if (ces.length > 0) {
+      const el = ces[0];
+      el.focus();
+      document.execCommand("selectAll", false, null);
+      document.execCommand("insertText", false, sql);
+      return { ok: true, via: "contenteditable" };
+    }
+
+    return { ok: false, error: "no editor found (main-world/monaco/textarea/contenteditable 均未命中)" };
+  }
+
+  // ---------- 点「查询」按钮 ----------
+  function clickQuery() {
+    // 文本匹配时去空白（实测按钮文案是「查 询」，中间带空格）
+    const norm = (s) => (s || "").replace(/\s+/g, "").trim();
+    const candidates = [...document.querySelectorAll("button")]
+      .filter(b => b.offsetParent !== null && !b.disabled)
+      .map(b => ({ b, text: (b.textContent || "").trim(), key: norm(b.textContent) }));
+    const exact = candidates.find(c => c.key === "查询") ||
+                  candidates.find(c => c.key === "执行") ||
+                  candidates.find(c => /^查询|^执行|^运行/.test(c.key));
+    if (!exact) {
+      return { ok: false, error: "query button not found", buttons: candidates.slice(0, 15).map(c => c.text) };
+    }
+    exact.b.scrollIntoView({ block: "center" });
+    exact.b.click();
+    return { ok: true, via: exact.text };
+  }
+
+  // ---------- 消息处理 ----------
+  chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
+    if (!msg || !msg.type) return;
+
+    if (msg.type === "yr-meta") {
+      sendResponse(readYearningMeta());
+      return true;
+    }
+    if (msg.type === "yr-ping") {
+      detectEditor().then(editor => {
+        sendResponse({
+          ok: true,
+          editor,
+          buttons: findQueryButtons().slice(0, 20),
+        });
+      });
+      return true;  // 异步响应
+    }
+    if (msg.type === "yr-sql-set") {
+      setSql(msg.sql || "").then(sendResponse);
+      return true;
+    }
+    if (msg.type === "yr-query-click") {
+      sendResponse(clickQuery());
+      return true;
+    }
+    if (msg.type === "yr-new-sql") {
+      // 新建 SQL 窗口：点工具栏新建按钮，等新编辑器渲染。
+      // 避免把 SQL 注入用户正在看/正在用的已有编辑器。
+      // 按钮定位：优先 XPath（用户给的路径），兜底找文本含"新建"的可见按钮。
+      const btn = xpathNode("/html/body/div[1]/div/section/section/div[2]/main/div/div/div[2]/div[2]/div/div/div/div/div[2]/div/div[1]/div/div[1]/div[1]/div/button")
+        || [...document.querySelectorAll("button")].find(b =>
+            b.offsetParent !== null && /新建|new/i.test((b.textContent || "").trim()));
+      if (!btn) { sendResponse({ ok: false, error: "新建按钮未找到" }); return true; }
+      const before = document.querySelectorAll(".monaco-editor").length;
+      btn.click();
+      // 等新编辑器出现（最多 4s；tab 页签式 UI 时编辑器数不变，退化为等 800ms）
+      const deadline = Date.now() + 4000;
+      (function waitFor() {
+        const now = document.querySelectorAll(".monaco-editor").length;
+        if (now > before || Date.now() > deadline) {
+          setTimeout(() => sendResponse({ ok: true, editors: now, via: "new-sql-btn" }), 800);
+          return;
+        }
+        setTimeout(waitFor, 200);
+      })();
+      return true;
+    }
+    if (msg.type === "yr-focus-editor") {
+      // CDP 注入前置：聚焦 monaco 的 inputarea（Input.insertText 作用于焦点元素）
+      const ta = document.querySelector(".monaco-editor textarea.inputarea")
+        || document.querySelector("textarea");
+      if (!ta) { sendResponse({ ok: false, error: "no inputarea" }); return true; }
+      ta.focus();
+      sendResponse({ ok: true });
+      return true;
+    }
+    if (msg.type === "yr-verify-sql") {
+      // CDP 注入后验证：读回 monaco view-lines 内容比对
+      const current = readMonacoText();
+      const norm = s => s.replace(/\s+/g, "");
+      const hit = norm(current).indexOf(norm(msg.sql || "").slice(0, 40)) !== -1;
+      sendResponse({ ok: hit, editorText: current.slice(0, 120) });
+      return true;
+    }
+  });
+
+  console.log(TAG, "Yearning content script loaded at", location.href);
+})();

package/files/extension/manifest.json

@@ -4,7 +4,7 @@
   "version": "2.0.0",
   "description": "桥接 JumpServer Web 终端，让 Agent 能远程执行命令并获取输出",
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtsnqR6PcFUueZwYria79tVbstvjk+tM7PpvIXILm5xbd6bAdjDIhzg3lsnKioVfvxjfvT+s6vJsiOYa9ojVZyJMFc5m/05TYqr770ovYwQmz0e88fmiy6dUoSulbtKvBCSLbN6OOL7u+ul8ixLZ/HautxSmou/eNgAFPmhE+4UueE7wfCqcgMYvjLvEzlqTVumMW+5LKw9YsRk6WhHPghY1a3MVUn3eQOWXBtQTEUy3wBM3v4wHxLwDeinVOR4f/P87IlUNo84C5DeimoFit0qCj3K04hS8MIYCLCYZc3v9ftRJDJBkAoah6Eaqj7JajbS3KvLR1ctOYfDhubgmURQIDAQAB",
-  "permissions": ["debugger", "tabs", "alarms", "webNavigation", "nativeMessaging", "scripting"],
+  "permissions": ["debugger", "tabs", "alarms", "webNavigation", "nativeMessaging", "scripting", "downloads", "storage"],
   "background": {
     "service_worker": "background.js"
   },
@@ -18,6 +18,19 @@
       "js": ["content.js"],
       "run_at": "document_start",
       "all_frames": true
+    },
+    {
+      "matches": ["*://sql.meiyunji.net/*"],
+      "js": ["content-yearning-main.js"],
+      "run_at": "document_start",
+      "all_frames": false,
+      "world": "MAIN"
+    },
+    {
+      "matches": ["*://sql.meiyunji.net/*"],
+      "js": ["content-yearning.js"],
+      "run_at": "document_idle",
+      "all_frames": false
     }
   ],
   "host_permissions": ["<all_urls>"]

package/files/extension/popup.html

@@ -115,6 +115,22 @@
       margin-left: 6px;
     }
     .tab-item .tab-row { display: flex; align-items: center; margin-left: 6px; flex: 1; min-width: 0; }
+    .yearning-item {
+      padding: 6px 8px; margin: 3px 0; border-radius: 4px;
+      background: #f5f5f5; cursor: pointer; font-size: 11px;
+    }
+    .yearning-item.active { background: #e3f2fd; border-left: 3px solid #2196F3; }
+    .yearning-item .yr-title { font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+    .yearning-item .yr-meta { color: #666; margin-top: 2px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+    .yearning-item .yr-badge { color: #4CAF50; font-size: 10px; margin-left: 4px; }
+    .csv-item {
+      display: flex; align-items: center; gap: 6px;
+      padding: 5px 8px; margin: 3px 0; border-radius: 4px;
+      background: #f0f7ff; cursor: pointer; font-size: 11px;
+    }
+    .csv-item:hover { background: #dcebfd; }
+    .csv-item .csv-name { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .csv-item .csv-rows { color: #888; font-size: 10px; flex-shrink: 0; }
     .guide {
       font-size: 11px;
       color: #666;
@@ -177,6 +193,23 @@
     <div id="tabList" style="margin-top:6px;"></div>
   </div>
 
+  <div class="section">
+    <div class="section-title">Yearning 监听</div>
+    <div class="hint" style="margin-bottom:6px;">监听 Yearning SQL 查询结果。先监听页面，再选择一个页面作为 SQL 注入和结果接收目标。</div>
+    <button class="scan" id="btnWsTap">📡 监听当前 Yearning 页</button>
+    <div class="hint" id="wsTapStatus">未监听 Yearning 页面</div>
+    <div id="yearningTabList" style="margin-top:6px;"></div>
+    <div id="csvSection" style="margin-top:8px;display:none;">
+      <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:4px;">
+        <span class="section-title" style="margin:0;">CSV 导出记录</span>
+        <button class="copy-btn" id="btnCsvClear" style="background:#e53935;">清空</button>
+      </div>
+      <div id="csvList"></div>
+      <div class="hint">点击记录下载 · 表名_库_数据源_日期.csv</div>
+    </div>
+    <button class="scan" id="btnCopyPrompt" style="margin-top:8px;background:#7c4dff;">📋 复制 Agent 使用 Prompt</button>
+  </div>
+
   <div class="section">
     <div class="section-title">桥接代理</div>
     <div class="status-line">

package/files/extension/popup.js

@@ -75,6 +75,134 @@ document.getElementById('btnXtermScan').onclick = () => {
   });
 };
 
+// ============== Yearning 监听（多 tab 绑定）==============
+const btnWsTap = document.getElementById('btnWsTap');
+const wsTapStatus = document.getElementById('wsTapStatus');
+const yearningTabList = document.getElementById('yearningTabList');
+
+function refreshYearningTabs() {
+  chrome.runtime.sendMessage({ type: 'YR_TAP_STATUS' }, (res) => {
+    if (chrome.runtime.lastError || !res || !res.ok) return;
+    const tabs = res.tabs || [];
+    wsTapStatus.textContent = tabs.length
+      ? `${tabs.length} 个 Yearning 页面已监听，当前选中 1 个`
+      : '未监听 Yearning 页面';
+    yearningTabList.innerHTML = tabs.map(t => {
+      const title = escapeHtml(t.title || 'Yearning');
+      const label = escapeHtml(t.label || [t.database, t.dataSource].filter(Boolean).join(' · ') || t.host || '数据库信息读取中');
+      const host = escapeHtml(t.host || `tab ${t.tabId}`);
+      return `<div class="yearning-item ${t.active ? 'active' : ''}" data-tabid="${t.tabId}">
+        <div class="yr-title">${t.active ? '◉' : '○'} ${title}${t.active ? '<span class="yr-badge">✓ 当前 Yearning 页面</span>' : ''}${t.isCurrent ? '<span class="yr-badge">● 当前浏览器页</span>' : ''}</div>
+        <div class="yr-meta">${label} · ${host}</div>
+      </div>`;
+    }).join('');
+    yearningTabList.querySelectorAll('.yearning-item').forEach(el => {
+      el.onclick = () => {
+        chrome.runtime.sendMessage({ type: 'YR_TAP_SELECT', tabId: Number(el.dataset.tabid) }, () => refreshYearningTabs());
+      };
+    });
+    // 按钮文案按「当前浏览器页是否在监听」决定（不是看 active 选中页）
+    const thisTabWatched = tabs.some(t => t.isCurrent);
+    btnWsTap.textContent = thisTabWatched ? '⏹ 停止监听当前 Yearning 页' : '📡 监听当前 Yearning 页';
+  });
+}
+
+function escapeHtml(value) {
+  return String(value).replace(/[&<>"']/g, ch => ({ '&':'&amp;', '<':'&lt;', '>':'&gt;', '"':'&quot;', "'":'&#39;' }[ch]));
+}
+
+btnWsTap.onclick = () => {
+  chrome.tabs.query({ active: true, currentWindow: true }, (tabs) => {
+    const tab = tabs && tabs[0];
+    if (!tab || !tab.id) { wsTapStatus.textContent = '未找到当前页'; return; }
+    // 先查当前状态：已在监听 → 停止；未监听 → 添加
+    chrome.runtime.sendMessage({ type: 'YR_TAP_STATUS' }, (st) => {
+      if (chrome.runtime.lastError || !st || !st.ok) {
+        wsTapStatus.textContent = '状态查询失败';
+        return;
+      }
+      const already = (st.tapTabs || []).includes(tab.id);
+      const type = already ? 'WS_TAP_DETACH' : 'WS_TAP_ATTACH';
+      chrome.runtime.sendMessage({ type, tabId: tab.id }, (res) => {
+        if (chrome.runtime.lastError || !res || !res.ok) {
+          wsTapStatus.textContent = (already ? '停止失败: ' : '监听失败: ') + (res && res.msg || '无响应');
+          return;
+        }
+        wsTapStatus.textContent = already ? '已停止监听该页面' : '已监听';
+        refreshYearningTabs();
+      });
+    });
+  });
+};
+
+refreshYearningTabs();
+
+// ============== CSV 导出记录 ==============
+const csvSection = document.getElementById('csvSection');
+const csvList = document.getElementById('csvList');
+
+function refreshCsvList() {
+  chrome.runtime.sendMessage({ type: 'CSV_LIST' }, (res) => {
+    if (chrome.runtime.lastError || !res || !res.ok) return;
+    const all = res.exports || [];
+    csvSection.style.display = all.length ? 'block' : 'none';
+    // 只显示最近 5 条，popup 不超长（存储仍保留 20 条）
+    const exports = all.slice(0, 5);
+    csvList.innerHTML = exports.map(e => {
+      const time = new Date(e.time).toLocaleTimeString();
+      return `<div class="csv-item" data-id="${e.id}" title="${escapeHtml(e.sql || e.name)}">
+        <span class="csv-name">📄 ${escapeHtml(e.name)}</span>
+        <span class="csv-rows">${e.rows} 行 · ${time}</span>
+      </div>`;
+    }).join('');
+    csvList.querySelectorAll('.csv-item').forEach(el => {
+      el.onclick = () => {
+        chrome.runtime.sendMessage({ type: 'CSV_DOWNLOAD', id: Number(el.dataset.id) }, (r) => {
+          if (chrome.runtime.lastError || !r || !r.ok) {
+            console.warn('重新下载失败:', r && r.msg);
+          }
+        });
+      };
+    });
+  });
+}
+refreshCsvList();
+
+// 清空 CSV 导出记录
+document.getElementById('btnCsvClear').onclick = () => {
+  chrome.runtime.sendMessage({ type: 'CSV_CLEAR' }, () => refreshCsvList());
+};
+
+// 复制 Agent 使用 Prompt（粘给任意 AI 助手即可用桥接查 Yearning）
+const AGENT_PROMPT = `你的机器上已装好 Terminal Bridge（Yearning SQL 桥接）。请按以下方式查询数据库：
+
+## 查询（Yearning）
+cd ~/.terminal-bridge/proxy && node yr-example.mjs "SELECT ...;" [超时ms]
+
+返回 JSON：{ ok, output(结果 JSON: field 列定义 + data 数据行), error }。
+
+## 说明
+- SQL 会自动注入到用户浏览器里选中的 Yearning 页面并点「查询」，结果自动返回
+- 前置：用户已在 Yearning 页面选择数据库，且插件 popup 已「监听当前 Yearning 页」
+- 多个 Yearning 页面时：用户在 popup 列表点选目标页面（显示 数据源 · 数据库）
+- 报 database-not-selected = 页面未选数据库，请让用户先选
+- 报 timeout = 查询超时或页面未监听，让用户确认 popup 状态
+- 只读查询即可；每次查询的结果会自动出现在插件 popup 的「CSV 导出记录」里供用户下载
+
+## 终端命令（JumpServer/Arthas，同一代理）
+cd ~/.terminal-bridge/proxy && node client-example.mjs "linux 命令" [超时ms]
+多层引号命令加 --b64 参数下发。`;
+
+document.getElementById('btnCopyPrompt').onclick = () => {
+  navigator.clipboard.writeText(AGENT_PROMPT).then(() => {
+    const btn = document.getElementById('btnCopyPrompt');
+    btn.textContent = '✓ 已复制，粘贴给 Agent 即可';
+    setTimeout(() => { btn.textContent = '📋 复制 Agent 使用 Prompt'; }, 2000);
+  }).catch(() => {
+    console.warn('复制失败');
+  });
+};
+
 // ============== 代理控制 ==============
 const proxyDot = document.getElementById('proxyDot');
 const proxyText = document.getElementById('proxyStatusText');
@@ -176,7 +304,7 @@ document.getElementById('btnCopyInstall').onclick = () => {
 };
 
 // 定时刷新（popup 打开期间）
-setInterval(() => { refreshXterm(); refreshProxy(); }, 3000);
+setInterval(() => { refreshXterm(); refreshProxy(); refreshCsvList(); refreshYearningTabs(); }, 3000);
 refreshXterm();
 refreshProxy();
 // 启动时主动探测一次 native host：发个 status，失败就显示安装提示

package/files/proxy/package.json

@@ -10,6 +10,7 @@
     "example": "node client-example.mjs"
   },
   "dependencies": {
+    "@msgpack/msgpack": "^3.1.3",
     "ws": "^8.18.0"
   }
 }