terminal-bridge-setup 2.4.0 → 2.6.0

package/bin/setup.mjs

@@ -88,14 +88,41 @@ function installProxyDeps() {
   }
 
   const proxyDir = join(INSTALL_DIR, "proxy");
+
+  // 支持 --registry 透传（国内网络/公司内网常用）
+  // 用法：npx terminal-bridge-setup --registry=https://registry.npmmirror.com
+  const registryArg = process.argv.find(a => a.startsWith("--registry="));
+  const npmArgs = ["install", "--no-audit", "--no-fund"];
+  if (registryArg) {
+    npmArgs.push(registryArg);
+    console.log(c.dim(`  使用 registry: ${registryArg.split("=")[1]}`));
+  } else {
+    npmArgs.push("--silent");
+  }
+
   console.log(c.dim("  运行 npm install ..."));
-  const result = spawnSync("npm", ["install", "--silent", "--no-audit", "--no-fund"], {
+  const result = spawnSync("npm", npmArgs, {
     cwd: proxyDir,
     stdio: "inherit",
   });
 
   if (result.status !== 0) {
-    fail("npm install 失败，请检查网络后重试");
+    // 失败时给出明确的排查建议
+    console.error("");
+    console.error(c.red("  ✗ npm install 失败"));
+    console.error(c.yellow("  常见原因和解决方法："));
+    console.error("");
+    console.error("  1. 网络不通/防火墙拦截：");
+    console.error("     检查：curl -I https://registry.npmjs.org/ws");
+    console.error("");
+    console.error("  2. 公司内网/国内网络慢：换国内镜像重试");
+    console.error("     命令：npx terminal-bridge-setup --registry=https://registry.npmmirror.com");
+    console.error("");
+    console.error("  3. 需要代理：");
+    console.error("     命令：npm config set proxy http://your-proxy:port");
+    console.error("     然后重跑 npx terminal-bridge-setup");
+    console.error("");
+    fail("npm install 失败（见上方排查建议）");
   }
   ok("依赖安装完成");
 }

package/files/extension/background.js

@@ -556,4 +556,4 @@ chrome.alarms.onAlarm.addListener(() => {
 
 // ============== 启动 ==============
 connectBridge();
-console.log('[WS Sniffer] background 已启动');
+console.log('[Terminal Bridge] background 已启动');

package/files/extension/content.js

@@ -1,4 +1,4 @@
-// WS Sniffer - content script (ISOLATED world).
+// Terminal Bridge - content script (ISOLATED world).
 //
 // 注：manifest 用 matches: <all_urls> + all_frames:true + run_at:document_start
 // 注入，是为了确保能进终端 frame（koko connect iframe / Arthas console 顶层文档等）。
@@ -13,10 +13,10 @@
 // observer 只监听 documentElement 的 childList，开销可忽略。
 
 (function () {
-  const TAG = "[ws-sniffer-cs]";
+  const TAG = "[terminal-bridge-cs]";
 
-  if (window.__wsSnifferContentLoaded) return;
-  window.__wsSnifferContentLoaded = true;
+  if (window.__terminalBridgeContentLoaded) return;
+  window.__terminalBridgeContentLoaded = true;
 
   // ---------- xterm 定位 ----------
   function findXtermTextarea() {

package/files/native/host.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// WS Sniffer Native Messaging Host
+// Terminal Bridge Native Messaging Host
 //
 // Chrome 通过 native messaging 和这个脚本通信（stdin/stdout，4 字节小端长度前缀）。
 // 职责：接收插件命令，启动/停止/查询 proxy/server.js。

package/files/proxy/package.json

@@ -1,9 +1,9 @@
 {
-  "name": "ws-sniffer-proxy",
+  "name": "terminal-bridge-proxy",
   "version": "1.0.0",
   "private": true,
   "type": "module",
-  "description": "JumpServer xterm 桥接代理：Agent <-> Chrome 插件，请求-响应配对",
+  "description": "Terminal Bridge 代理：Agent <-> Chrome 插件，请求-响应配对",
   "main": "server.js",
   "scripts": {
     "start": "node server.js",

package/files/proxy/server.js

@@ -120,7 +120,7 @@ function maybeRunNext() {
   // kitty 终端逐字符注入会重绘，把任何标记字符串（BEGIN/END/哨兵）打散，
   // 标记方案不可靠。改用 shell prompt 作为命令完成的锚点（expect/pexpect 经典做法）。
   //
-  // 你的 PS1=[\u@\h \w]\$ 渲染成 [root@k8s-master-test /home/operation]#
+  // 典型 shell prompt: [root@host /path]# 或 [user@host ~]$
   // 关键：prompt 是服务端 shell 在命令完成后输出的，不受 kitty 输入重绘影响。
   //
   // 流程：

package/files/skill/SKILL.md

@@ -91,17 +91,17 @@ Arthas 的能力不止于读，以下命令/用法一律禁止通过桥接执行
 lsof -i:8787 | grep LISTEN
 
 # 2. 没跑就启动（也可从插件 popup 的"启动代理"按钮启动）
-cd ~/Code/testwork/ws-sniffer/proxy && node server.js &
+cd ~/.terminal-bridge/proxy && node server.js &
 ```
 
 浏览器侧（任选其一或都开）：
-- **JumpServer**：WS Sniffer 插件已加载 + JumpServer 终端页面已打开 + 已连上一个资产（终端可见、能敲字）
-- **Arthas**：WS Sniffer 插件已加载 + Arthas Console 页面已打开 + 已 Connect 上目标 JVM
+- **JumpServer**：Terminal Bridge 插件已加载 + JumpServer 终端页面已打开 + 已连上一个资产（终端可见、能敲字）
+- **Arthas**：Terminal Bridge 插件已加载 + Arthas Console 页面已打开 + 已 Connect 上目标 JVM
 
 多终端场景：如果同时开了 JumpServer 和 Arthas 两个 tab，代理命令只会发给 popup 里"当前选中"的那个 tab。切换用 popup 的 tab 选择器，或让用户在 popup 点选。
 
 如果用户说"命令没反应"或"inject-failed"：
-1. `chrome://extensions/` 刷新 WS Sniffer 插件 ↻
+1. `chrome://extensions/` 刷新 Terminal Bridge 插件 ↻
 2. 让用户在终端页面按 F5 刷新（让 content script 重新识别 xterm）
 3. 让用户在 popup 点"捕捉 xterm"按钮（手动扫描，免刷新）
 4. 确认终端 tab 顶部有黄色调试条（说明 CDP 已 attach）
@@ -113,7 +113,7 @@ cd ~/Code/testwork/ws-sniffer/proxy && node server.js &
 最简方式（用示例客户端）：
 
 ```bash
-cd ~/Code/testwork/ws-sniffer/proxy
+cd ~/.terminal-bridge/proxy
 
 # JumpServer 场景
 node client-example.mjs "uname -a"

package/files/skill/references/protocol.md

@@ -129,7 +129,7 @@ const PROMPT_RE = /\]\s*[#$]\s*$|>\s*$/;
 
 | 终端 | prompt 样式 | 匹配部分 |
 |------|------------|---------|
-| JumpServer (shell) | `[root@k8s-master /home/op]#` 或 `]$` | `]\s*[#$]\s*$` |
+| JumpServer (shell) | `[root@host /path]#` 或 `]$` | `]\s*[#$]\s*$` |
 | Arthas | `arthas@pid>` 或 `[arthas@...]` | `>\s*$` |
 
 注意：单独的 `>` 较宽（命令输出里 `>` 偶尔出现），但配合"行尾 + ANSI 清理后 + 注入命令后才出现"三个条件，误判率可接受。

package/package.json

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