npm - terminal-bridge-setup - Versions diffs - 2.0.0 - Mend

terminal-bridge-setup 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md +65 -0
package/bin/setup.mjs +205 -0
package/files/extension/background.js +505 -0
package/files/extension/content.js +134 -0
package/files/extension/manifest.json +24 -0
package/files/extension/popup.html +216 -0
package/files/extension/popup.js +185 -0
package/files/native/com.wssniffer.host.json.template +9 -0
package/files/native/host.js +168 -0
package/files/native/host.sh.template +5 -0
package/files/native/install.sh +89 -0
package/files/proxy/arthas-guard.js +194 -0
package/files/proxy/client-example.mjs +189 -0
package/files/proxy/package.json +15 -0
package/files/proxy/server.js +529 -0
package/package.json +33 -0

package/files/extension/popup.html ADDED Viewed

@@ -0,0 +1,216 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <style>
+    body {
+      width: 340px;
+      padding: 12px;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      font-size: 13px;
+      margin: 0;
+    }
+    h3 { margin: 0 0 4px; font-size: 15px; }
+    .subtitle { font-size: 11px; color: #888; margin-bottom: 8px; }
+    button {
+      width: 100%;
+      padding: 9px;
+      margin: 4px 0;
+      cursor: pointer;
+      border: none;
+      border-radius: 5px;
+      font-size: 13px;
+      font-weight: 500;
+      transition: opacity .15s;
+    }
+    button:hover { opacity: .9; }
+    .proxy-start { background: #FF9800; color: white; }
+    .proxy-stop  { background: #795548; color: white; }
+    .scan        { background: #2196F3; color: white; }
+    .status-line {
+      display: flex;
+      align-items: center;
+      font-size: 12px;
+      margin-bottom: 6px;
+    }
+    .dot {
+      display: inline-block;
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+      margin-right: 6px;
+      flex-shrink: 0;
+    }
+    .dot.on  { background: #4CAF50; }
+    .dot.off { background: #ccc; }
+    .dot.loading { background: #FF9800; animation: pulse 1s infinite; }
+    @keyframes pulse { 50% { opacity: 0.4; } }
+    .section {
+      margin-top: 12px;
+      padding-top: 10px;
+      border-top: 1px solid #e0e0e0;
+    }
+    .section-title {
+      font-size: 11px;
+      color: #888;
+      text-transform: uppercase;
+      letter-spacing: 0.5px;
+      margin-bottom: 8px;
+    }
+    .hint {
+      font-size: 11px;
+      color: #888;
+      margin-top: 4px;
+      line-height: 1.5;
+    }
+    .tab-item {
+      display: flex;
+      align-items: center;
+      padding: 6px 8px;
+      margin: 3px 0;
+      border-radius: 4px;
+      background: #f5f5f5;
+      font-size: 12px;
+      cursor: pointer;
+      transition: background .15s;
+    }
+    .tab-item:hover { background: #e8e8e8; }
+    .tab-item.active {
+      background: #e3f2fd;
+      border-left: 3px solid #2196F3;
+    }
+    .tab-item .tab-title {
+      flex: 1;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      margin-left: 6px;
+    }
+    .tab-item .tab-check { font-size: 14px; flex-shrink: 0; }
+    .tab-item .tab-host {
+      font-size: 10px;
+      color: #888;
+      background: #e8e8e8;
+      padding: 1px 5px;
+      border-radius: 3px;
+      margin-left: 6px;
+      flex-shrink: 0;
+      max-width: 90px;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .tab-item.active .tab-host { background: #bbdefb; color: #1565c0; }
+    .tab-item .tab-current {
+      font-size: 9px;
+      color: #4CAF50;
+      margin-left: 4px;
+      flex-shrink: 0;
+    }
+    .tab-item .tab-info { display: flex; flex-direction: column; flex: 1; min-width: 0; }
+    .tab-item .tab-title {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      margin-left: 6px;
+    }
+    .tab-item .tab-row { display: flex; align-items: center; margin-left: 6px; flex: 1; min-width: 0; }
+    .guide {
+      font-size: 11px;
+      color: #666;
+      line-height: 1.7;
+    }
+    .guide code {
+      background: #f0f0f0;
+      padding: 1px 4px;
+      border-radius: 3px;
+      font-size: 10px;
+    }
+    .guide ol { margin: 4px 0; padding-left: 18px; }
+    .install-hint {
+      margin-top: 8px;
+      padding: 8px;
+      background: #fff3e0;
+      border: 1px solid #ffb74d;
+      border-radius: 4px;
+      font-size: 11px;
+      color: #e65100;
+    }
+    .install-hint .cmd-row {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      margin: 6px 0 4px;
+    }
+    .install-hint code {
+      flex: 1;
+      background: #fff;
+      padding: 4px 6px;
+      border-radius: 3px;
+      font-size: 10px;
+      color: #333;
+      font-family: "SF Mono", Menlo, monospace;
+    }
+    .copy-btn {
+      width: auto;
+      padding: 4px 10px;
+      margin: 0;
+      font-size: 10px;
+      background: #ff9800;
+      color: white;
+      border-radius: 3px;
+      flex-shrink: 0;
+    }
+  </style>
+</head>
+<body>
+  <h3>🔌 终端桥接</h3>
+  <div class="subtitle">JumpServer · Arthas Web Console</div>
+  <div class="section" style="margin-top:8px;padding-top:0;border:none;">
+    <div class="status-line">
+      <span class="dot off" id="xtermDot"></span>
+      <span id="xtermStatusText">未检测到终端</span>
+    </div>
+    <div class="hint" id="xtermHint">打开 JumpServer 终端 或 Arthas Console</div>
+    <button class="scan" id="btnXtermScan">🔍 捕捉终端</button>
+    <div id="tabList" style="margin-top:6px;"></div>
+  </div>
+  <div class="section">
+    <div class="section-title">桥接代理</div>
+    <div class="status-line">
+      <span class="dot off" id="proxyDot"></span>
+      <span id="proxyStatusText">代理未运行</span>
+    </div>
+    <button class="proxy-start" id="btnProxyStart">🚀 启动代理</button>
+    <button class="proxy-stop"  id="btnProxyStop" style="display:none;">⏹ 停止代理</button>
+    <div id="proxyInstallHint" class="install-hint" style="display:none;">
+      <div>⚠ 未安装本地宿主，代理无法启动</div>
+      <div class="cmd-row">
+        <code id="installCmd">npx terminal-bridge-setup</code>
+        <button class="copy-btn" id="btnCopyInstall">复制</button>
+      </div>
+      <div class="hint">在终端运行此命令完成安装，然后重新加载插件</div>
+    </div>
+  </div>
+  <div class="section">
+    <div class="section-title">使用说明</div>
+    <div class="guide">
+      <ol>
+        <li>打开终端页面（JumpServer Web 终端 / Arthas Console），完成连接</li>
+        <li>点「🔍 捕捉终端」（灰点变绿）。多开时在下方选目标 tab</li>
+        <li>点「🚀 启动代理」（橙点变绿）</li>
+        <li>两个都绿，Agent 即可通过桥接发命令</li>
+      </ol>
+      <div class="hint" style="margin-top:6px;">
+        ⚠ 交互式命令（vim/less/需密码的 sudo）会超时<br>
+        ⚠ Arthas 高风险命令（retransform/profiler/stop/reset）已禁用
+      </div>
+    </div>
+  </div>
+  <script src="popup.js"></script>
+</body>
+</html>

package/files/extension/popup.js ADDED Viewed

@@ -0,0 +1,185 @@
+// JumpServer 终端桥接 — popup 交互
+// 只管两件事：xterm 捕获/选择 + 代理启停
+// ============== xterm 终端状态 ==============
+const xtermDot = document.getElementById('xtermDot');
+const xtermText = document.getElementById('xtermStatusText');
+const xtermHint = document.getElementById('xtermHint');
+const tabListEl = document.getElementById('tabList');
+function refreshXterm() {
+  chrome.runtime.sendMessage({ type: 'XTERM_STATUS' }, (res) => {
+    if (chrome.runtime.lastError || !res) {
+      xtermDot.className = 'dot off';
+      xtermText.textContent = '状态未知';
+      tabListEl.innerHTML = '';
+      return;
+    }
+    if (res.ready) {
+      xtermDot.className = 'dot on';
+      xtermText.textContent = `xterm 已捕获 (${res.tabCount} 个终端)`;
+      xtermHint.textContent = res.attachedCount > 0
+        ? `✓ 已 attach，可执行命令`
+        : `⚠ 等待 attach...`;
+      // 渲染 tab 列表
+      if (res.tabs && res.tabs.length > 0) {
+        tabListEl.innerHTML = res.tabs.map(t => {
+          const hostTag = t.host ? `<span class="tab-host" title="${t.host}">${t.host}</span>` : '';
+          const currentTag = t.isCurrent ? '<span class="tab-current">● 当前</span>' : '';
+          return `<div class="tab-item ${t.active ? 'active' : ''}" data-tabid="${t.tabId}">
+             <span class="tab-check">${t.active ? '◉' : '○'}</span>
+             <span class="tab-row">
+               <span class="tab-title" title="${t.title}">${t.title}</span>
+               ${hostTag}${currentTag}
+             </span>
+           </div>`;
+        }).join('');
+        tabListEl.querySelectorAll('.tab-item').forEach(el => {
+          el.onclick = () => {
+            const tabId = parseInt(el.dataset.tabid, 10);
+            chrome.runtime.sendMessage({ type: 'XTERM_SELECT', tabId }, () => refreshXterm());
+          };
+        });
+      } else {
+        tabListEl.innerHTML = '';
+      }
+    } else {
+      xtermDot.className = 'dot off';
+      xtermText.textContent = '未检测到终端';
+      xtermHint.textContent = '打开 JumpServer 终端 或 Arthas Console';
+      tabListEl.innerHTML = '';
+    }
+  });
+}
+document.getElementById('btnXtermScan').onclick = () => {
+  xtermDot.className = 'dot loading';
+  xtermText.textContent = '扫描中...';
+  xtermHint.textContent = '正在遍历所有 tab 查找 xterm';
+  chrome.runtime.sendMessage({ type: 'XTERM_SCAN' }, (res) => {
+    if (chrome.runtime.lastError || !res) {
+      xtermDot.className = 'dot off';
+      xtermText.textContent = '扫描失败';
+      return;
+    }
+    if (res.found > 0) {
+      xtermDot.className = 'dot on';
+      xtermText.textContent = `✓ 捕获到 ${res.found} 个终端`;
+      xtermHint.textContent = '已自动 attach，可以执行命令';
+      setTimeout(refreshXterm, 800);
+    } else {
+      xtermDot.className = 'dot off';
+      xtermText.textContent = '未找到终端';
+      xtermHint.textContent = '请确认终端页面已打开并完成连接';
+    }
+  });
+};
+// ============== 代理控制 ==============
+const proxyDot = document.getElementById('proxyDot');
+const proxyText = document.getElementById('proxyStatusText');
+const btnProxyStart = document.getElementById('btnProxyStart');
+const btnProxyStop = document.getElementById('btnProxyStop');
+const proxyInstallHint = document.getElementById('proxyInstallHint');
+// 判断是不是 native host 未安装（连接被拒/超时/无响应）
+function isNativeHostMissing(res) {
+  if (!res) return true;  // 完全无响应
+  if (res.ok === false) {
+    const msg = (res.msg || '').toLowerCase();
+    return msg.includes('native host') || msg.includes('连接失败') ||
+           msg.includes('未安装') || msg.includes('无法连接') ||
+           msg.includes('access forbidden');
+  }
+  return false;
+}
+function showInstallHint(show) {
+  proxyInstallHint.style.display = show ? 'block' : 'none';
+}
+function setProxyUI(state, text) {
+  proxyDot.className = 'dot ' + state;
+  proxyText.textContent = text;
+  if (state === 'on') {
+    btnProxyStart.style.display = 'none';
+    btnProxyStop.style.display = 'block';
+  } else if (state === 'off') {
+    btnProxyStart.style.display = 'block';
+    btnProxyStop.style.display = 'none';
+  }
+}
+function refreshProxy() {
+  // 注意：不要在查询前置 loading，否则定时刷新每 3 秒会闪一次黄。
+  // 保持上次的 UI 状态不动，拿到结果后才更新。
+  chrome.runtime.sendMessage({ type: 'PROXY_STATUS' }, (res) => {
+    if (chrome.runtime.lastError || !res) {
+      setProxyUI('off', '状态未知');
+      return;
+    }
+    if (res.ok && res.status === 'running') {
+      setProxyUI('on', `运行中 · 127.0.0.1:${res.port || 8787}`);
+    } else if (res.ok) {
+      setProxyUI('off', '代理未运行');
+    } else {
+      setProxyUI('off', res.msg || '代理未运行');
+    }
+  });
+}
+btnProxyStart.onclick = () => {
+  setProxyUI('loading', '启动中...');
+  showInstallHint(false);
+  chrome.runtime.sendMessage({ type: 'PROXY_START' }, (res) => {
+    if (chrome.runtime.lastError || !res) {
+      setProxyUI('off', '启动失败（无响应）');
+      showInstallHint(true);  // 无响应多半是 native host 没装
+      return;
+    }
+    if (res.ok && res.status === 'running') {
+      setProxyUI('on', `✓ 运行中 · 127.0.0.1:${res.port || 8787}`);
+    } else {
+      setProxyUI('off', '✗ ' + (res.msg || '启动失败'));
+      // native host 未安装时显示安装命令
+      if (isNativeHostMissing(res)) showInstallHint(true);
+    }
+  });
+};
+btnProxyStop.onclick = () => {
+  setProxyUI('loading', '停止中...');
+  chrome.runtime.sendMessage({ type: 'PROXY_STOP' }, (res) => {
+    if (chrome.runtime.lastError || !res) {
+      setProxyUI('off', '已停止');
+      return;
+    }
+    setProxyUI('off', res.msg || '代理已停止');
+  });
+};
+// 复制安装命令
+document.getElementById('btnCopyInstall').onclick = () => {
+  const cmd = document.getElementById('installCmd').textContent;
+  navigator.clipboard.writeText(cmd).then(() => {
+    const btn = document.getElementById('btnCopyInstall');
+    const orig = btn.textContent;
+    btn.textContent = '✓ 已复制';
+    setTimeout(() => { btn.textContent = orig; }, 1500);
+  }).catch(() => {
+    // clipboard API 可能因权限失败，fallback 选中文本
+    const range = document.createRange();
+    range.selectNode(document.getElementById('installCmd'));
+    getSelection().removeAllRanges();
+    getSelection().addRange(range);
+  });
+};
+// 定时刷新（popup 打开期间）
+setInterval(() => { refreshXterm(); refreshProxy(); }, 3000);
+refreshXterm();
+refreshProxy();
+// 启动时主动探测一次 native host：发个 status，失败就显示安装提示
+chrome.runtime.sendMessage({ type: 'PROXY_STATUS' }, (res) => {
+  if (isNativeHostMissing(res)) showInstallHint(true);
+});

package/files/native/com.wssniffer.host.json.template ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "name": "com.wssniffer.host",
+  "description": "Terminal bridge native messaging host",
+  "path": "__HOST_SH__",
+  "type": "stdio",
+  "allowed_origins": [
+    "chrome-extension://__EXTENSION_ID__/"
+  ]
+}

package/files/native/host.js ADDED Viewed

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+// WS Sniffer Native Messaging Host
+//
+// Chrome 通过 native messaging 和这个脚本通信（stdin/stdout，4 字节小端长度前缀）。
+// 职责：接收插件命令，启动/停止/查询 proxy/server.js。
+//
+// 关键设计：proxy 是独立的守护进程，不跟随 host 退出。
+//   - start: 用 detached + unref 启动 proxy，PID 写到 PID 文件，立即返回
+//   - stop:  读 PID 文件，发 SIGTERM
+//   - status: 检查端口是否在监听 + PID 文件是否存在
+// host 进程本身是短命的（每次命令一个连接），proxy 持久运行。
+const { spawn, execSync } = require("node:child_process");
+const path = require("node:path");
+const fs = require("node:fs");
+const net = require("node:net");
+const NODE_BIN = process.execPath;
+const PROXY_DIR = path.resolve(__dirname, "..", "proxy");
+const PROXY_SCRIPT = path.join(PROXY_DIR, "server.js");
+const PROXY_PORT = Number(process.env.JTB_PORT || 8787);
+const PID_FILE = path.join(PROXY_DIR, ".proxy.pid");
+const LOG_FILE = path.join(PROXY_DIR, ".proxy.log");
+// ============== Native messaging I/O ==============
+function sendMessage(obj) {
+  const json = Buffer.from(JSON.stringify(obj), "utf8");
+  const header = Buffer.alloc(4);
+  header.writeUInt32LE(json.length, 0);
+  process.stdout.write(Buffer.concat([header, json]));
+}
+function readMessages(onMessage) {
+  let buf = Buffer.alloc(0);
+  process.stdin.on("data", (chunk) => {
+    buf = Buffer.concat([buf, chunk]);
+    while (buf.length >= 4) {
+      const len = buf.readUInt32LE(0);
+      if (buf.length < 4 + len) break;
+      const msg = JSON.parse(buf.slice(4, 4 + len).toString("utf8"));
+      buf = buf.slice(4 + len);
+      onMessage(msg);
+    }
+  });
+  process.stdin.on("end", () => process.exit(0));
+}
+// ============== 工具函数 ==============
+function isProxyListening() {
+  return new Promise((resolve) => {
+    const sock = new net.Socket();
+    sock.setTimeout(800);
+    sock.on("connect", () => { sock.destroy(); resolve(true); });
+    sock.on("error", () => resolve(false));
+    sock.on("timeout", () => { sock.destroy(); resolve(false); });
+    sock.connect(PROXY_PORT, "127.0.0.1");
+  });
+}
+function readPid() {
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, "utf8").trim(), 10);
+    return isNaN(pid) ? null : pid;
+  } catch { return null; }
+}
+function writePid(pid) {
+  try { fs.writeFileSync(PID_FILE, String(pid)); } catch {}
+}
+function clearPid() {
+  try { fs.unlinkSync(PID_FILE); } catch {}
+}
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);  // 信号 0 = 探活，不发实际信号
+    return true;
+  } catch { return false; }
+}
+// ============== 命令处理 ==============
+async function startProxy() {
+  // 已在运行？
+  if (await isProxyListening()) {
+    return { ok: true, status: "running", msg: "proxy already running", port: PROXY_PORT };
+  }
+  // 清理失效的 PID 文件
+  const oldPid = readPid();
+  if (oldPid && !isPidAlive(oldPid)) clearPid();
+  // 打开日志文件（append 模式），proxy 的 stdout/stderr 都写进去
+  const logFd = fs.openSync(LOG_FILE, "a");
+  try {
+    const child = spawn(NODE_BIN, [PROXY_SCRIPT], {
+      cwd: PROXY_DIR,
+      stdio: ["ignore", logFd, logFd],
+      env: { ...process.env, PORT: String(PROXY_PORT) },
+      detached: true,   // 关键：脱离父进程，变成独立进程组
+    });
+    // unref 让父进程（host）可以不等子进程就退出
+    child.unref();
+    writePid(child.pid);
+    fs.writeFileSync(logFd, `\n[host] proxy started PID=${child.pid} at ${new Date().toISOString()}\n`);
+    // 等一小段时间确认端口起来
+    await new Promise(r => setTimeout(r, 800));
+    const up = await isProxyListening();
+    if (up) {
+      return { ok: true, status: "running", msg: "proxy started", port: PROXY_PORT };
+    } else {
+      return { ok: true, status: "running", msg: "proxy process started (port not ready yet)", port: PROXY_PORT };
+    }
+  } catch (err) {
+    return { ok: false, status: "stopped", msg: "start error: " + err.message };
+  }
+}
+function stopProxy() {
+  return new Promise(async (resolve) => {
+    const pid = readPid();
+    if (!pid) {
+      // 没有 PID 文件，但端口可能在监听（手动启动的），尝试用 lsof 找
+      const up = await isProxyListening();
+      resolve(up
+        ? { ok: false, status: "running", msg: "无法停止：PID 文件缺失（可能是手动启动的代理），请手动 kill" }
+        : { ok: true, status: "stopped", msg: "proxy was not running" });
+      return;
+    }
+    try {
+      process.kill(pid, "SIGTERM");
+      // 等 2s 确认退出
+      setTimeout(() => {
+        if (isPidAlive(pid)) {
+          try { process.kill(pid, "SIGKILL"); } catch {}
+        }
+        clearPid();
+        resolve({ ok: true, status: "stopped", msg: "proxy stopped" });
+      }, 2000);
+    } catch (err) {
+      clearPid();
+      resolve({ ok: true, status: "stopped", msg: "proxy was not running (stale pid)" });
+    }
+  });
+}
+async function status() {
+  const up = await isProxyListening();
+  return { ok: true, status: up ? "running" : "stopped", port: PROXY_PORT };
+}
+// ============== 主循环 ==============
+readMessages(async (msg) => {
+  const cmd = msg && msg.cmd;
+  if (cmd === "start") {
+    sendMessage(await startProxy());
+  } else if (cmd === "stop") {
+    sendMessage(await stopProxy());
+  } else if (cmd === "status") {
+    sendMessage(await status());
+  } else {
+    sendMessage({ ok: false, msg: "unknown cmd: " + cmd });
+  }
+});
+process.stderr.write("[host] native messaging host ready\n");

package/files/native/host.sh.template ADDED Viewed

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Native messaging host 启动 wrapper
+# 由安装脚本（install.sh / npx 包）生成，__NODE_BIN__ 和 __HOST_JS__ 会被替换成实际路径
+# 用绝对路径调 node，避免 Chrome 启动时 PATH 不全找不到 node
+exec __NODE_BIN__ __HOST_JS__

package/files/native/install.sh ADDED Viewed

@@ -0,0 +1,89 @@
+#!/bin/bash
+# 安装 Native Messaging Host（通用版，不写死路径）
+#
+# 这个脚本被两种方式调用：
+#   1. 直接运行：bash native/install.sh（开发模式，用当前项目目录）
+#   2. 被 npx 安装包调用：传入 INSTALL_DIR 参数（释放目录，如 ~/.terminal-bridge）
+#
+# 做的事：
+#   1. 检测 node 可执行文件路径
+#   2. 从模板生成 host.sh（填入实际 node 路径 + host.js 路径）
+#   3. 从模板生成 com.wssniffer.host.json（填入实际 host.sh 路径 + 插件 ID）
+#   4. 复制 manifest 到 Chrome 的 NativeMessagingHosts 目录
+#   5. 安装 proxy 的 npm 依赖（ws）
+#
+# 卸载：rm "$HOME/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.wssniffer.host.json"
+set -e
+# ---------- 路径解析 ----------
+# SCRIPT_DIR: 本脚本所在目录（native/）
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# INSTALL_DIR: 项目根目录（native 的上一级）
+# 支持外部传入（npx 包用），否则用相对路径推断
+INSTALL_DIR="${1:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+NATIVE_DIR="$INSTALL_DIR/native"
+PROXY_DIR="$INSTALL_DIR/proxy"
+# ---------- 配置 ----------
+# 插件 ID（由 manifest.json 的 key 字段决定，固定不变）
+EXTENSION_ID="jkbnakjnbahigfefgiipfngheiafoein"
+# Chrome native messaging host 目录（macOS）
+DEST_DIR="$HOME/Library/Application Support/Google/Chrome/NativeMessagingHosts"
+DEST="$DEST_DIR/com.wssniffer.host.json"
+# ---------- 前置检查 ----------
+echo "=== 安装 Terminal Bridge Native Host ==="
+echo "  安装目录: $INSTALL_DIR"
+# 检测 node
+if ! command -v node > /dev/null 2>&1; then
+  echo "✗ 未找到 node，请先安装 Node.js (https://nodejs.org)"
+  exit 1
+fi
+NODE_BIN="$(command -v node)"
+echo "  node 路径: $NODE_BIN ($(node --version))"
+# 检查模板存在
+if [ ! -f "$NATIVE_DIR/host.sh.template" ]; then
+  echo "✗ 未找到 $NATIVE_DIR/host.sh.template，项目结构不完整"
+  exit 1
+fi
+# ---------- 1. 生成 host.sh ----------
+HOST_SH="$NATIVE_DIR/host.sh"
+HOST_JS="$NATIVE_DIR/host.js"
+sed -e "s|__NODE_BIN__|$NODE_BIN|g" \
+    -e "s|__HOST_JS__|$HOST_JS|g" \
+    "$NATIVE_DIR/host.sh.template" > "$HOST_SH"
+chmod +x "$HOST_SH"
+echo "✓ 生成 host.sh → $HOST_SH"
+# ---------- 2. 生成 com.wssniffer.host.json ----------
+TMP_MANIFEST="$NATIVE_DIR/com.wssniffer.host.json"
+sed -e "s|__HOST_SH__|$HOST_SH|g" \
+    -e "s|__EXTENSION_ID__|$EXTENSION_ID|g" \
+    "$NATIVE_DIR/com.wssniffer.host.json.template" > "$TMP_MANIFEST"
+echo "✓ 生成 manifest → $TMP_MANIFEST"
+# ---------- 3. 注册到 Chrome ----------
+mkdir -p "$DEST_DIR"
+cp "$TMP_MANIFEST" "$DEST"
+echo "✓ 已注册到 Chrome: $DEST"
+# ---------- 4. 安装 proxy 依赖 ----------
+if [ -f "$PROXY_DIR/package.json" ]; then
+  if [ ! -d "$PROXY_DIR/node_modules/ws" ]; then
+    echo "→ 安装 proxy 依赖 (ws)..."
+    (cd "$PROXY_DIR" && npm install --silent)
+    echo "✓ 依赖已安装"
+  else
+    echo "✓ proxy 依赖已存在"
+  fi
+fi
+echo ""
+echo "=== Native Host 安装完成 ==="