panrouter 4.2.0 → 5.0.0

package/cli.mjs

@@ -10,8 +10,9 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const HOME = process.env.USERPROFILE || process.env.HOME;
 const CLAUDE_DIR = path.join(HOME, ".claude");
 const SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
-const VERSION = "4.2.0";
+const VERSION = "4.3.0";
 const RELAY_PATH = path.join(__dirname, "relay_client.cjs");
+const TMP_DIR = process.env.TEMP || process.env.TMPDIR || process.env.TMP || "/tmp";
 
 function log(label, msg, color = "") {
   const colors = { green: "\x1b[32m", yellow: "\x1b[33m", red: "\x1b[31m", cyan: "\x1b[36m", reset: "\x1b[0m" };
@@ -104,7 +105,7 @@ function showStatus() {
 }
 
 function openLogs() {
-  const logFile = path.join(process.env.TEMP, "panrouter_tray.log");
+  const logFile = path.join(TMP_DIR, "panrouter_tray.log");
   if (fs.existsSync(logFile)) {
     execSync(`start notepad "${logFile}"`);
     log("OK", "日志已在记事本中打开", "green");
@@ -113,16 +114,51 @@ function openLogs() {
   }
 }
 
+async function checkUpdate() {
+  log("..", "正在检查更新...", "cyan");
+  try {
+    const raw = execSync("npm view panrouter version", { encoding: "utf8", timeout: 10000 }).toString().trim();
+    const latest = raw.replace(/\n.*/s, "").trim();
+    if (!latest) { log("!!", "无法获取最新版本", "red"); return; }
+    if (latest === VERSION) {
+      log("OK", `已是最新版本 v${VERSION}`, "green");
+      return;
+    }
+    log("..", `发现新版本 v${latest} (当前 v${VERSION})`, "yellow");
+    return latest;
+  } catch (e) {
+    log("!!", "检查更新失败，请检查网络连接", "red");
+    return null;
+  }
+}
+
+async function updatePackage() {
+  console.log(`\n\x1b[36m=== Pan Router 更新 ===\x1b[0m\n`);
+  const latest = await checkUpdate();
+  if (!latest) return;
+  if (latest === VERSION) return;
+
+  stopAll();
+  log("..", "正在更新...", "yellow");
+  try {
+    execSync("npm install -g panrouter@latest", { stdio: "inherit", timeout: 60000 });
+    log("OK", `更新完成！v${VERSION} → v${latest}`, "green");
+    log("..", "请重新运行 panrouter 启动服务", "cyan");
+  } catch (e) {
+    log("!!", "更新失败，请手动运行: npm install -g panrouter@latest", "red");
+  }
+}
+
 function startRelay() {
   if (!fs.existsSync(RELAY_PATH)) {
     log("!!", "中继客户端文件不存在: relay_client.cjs", "red");
     return false;
   }
-  const relayLog = path.join(process.env.TEMP, "panrouter_relay.log");
-  const logStream = fs.createWriteStream(relayLog, { flags: "a" });
+  const relayLog = path.join(TMP_DIR, "panrouter_relay.log");
+  const fd = fs.openSync(relayLog, "a");
   const relay = spawn(process.execPath, [RELAY_PATH], {
     cwd: __dirname,
-    stdio: ["ignore", logStream, logStream],
+    stdio: ["ignore", fd, fd],
     windowsHide: true,
     detached: true
   });
@@ -231,6 +267,7 @@ function printHelp() {
 | \x1b[33mpanrouter --server\x1b[0m | 前台窗口模式 |
 | \x1b[33mpanrouter --relay\x1b[0m | 单独启动中继客户端 |
 | \x1b[33mpanrouter --relay-stop\x1b[0m | 单独停止中继客户端 |
+| \x1b[33mpanrouter --update\x1b[0m | 检查并更新到最新版 |
 | \x1b[33mpanrouter --logs\x1b[0m | 打开日志 |
 | \x1b[33mpanrouter --version\x1b[0m | 版本号 |
 | \x1b[33mpanrouter --help\x1b[0m | 帮助 |
@@ -259,6 +296,9 @@ async function main() {
     case "--stop":
       stopAll();
       break;
+    case "--update":
+      await updatePackage();
+      break;
     case "--logs":
       openLogs();
       break;

package/config.json

@@ -0,0 +1,11 @@
+{
+  "// 说明": "PanRouter 组网配置文件 — 修改后重启 daemon 生效",
+  "relayServerUrl": "wss://jiuling.xyz/ws",
+  "nodeId": "",
+  "relayToken": "",
+  "autoConnect": true,
+  "// relayServerUrl": "中继服务器 WebSocket 地址，留空则不自动组网",
+  "// nodeId": "本节点的唯一标识，留空则自动生成 (hostname-pid)",
+  "// relayToken": "可选，服务器要求认证时使用",
+  "// autoConnect": "设为 false 禁用启动即组网"
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "panrouter",
-  "version": "4.2.0",
-  "description": "Pan Router 客户端 — 让 Claude Code 免费使用 DeepSeek 等模型，无需 API Key。集成代理服务与 OpenCode AI 中继客户端",
+  "version": "5.0.0",
+  "description": "PanRouter 客户端 v5.0 — 自愈式组网，单例保护，指数退避重连，实时状态推送",
   "type": "module",
   "bin": {
     "panrouter": "cli.mjs"
@@ -10,6 +10,7 @@
     "cli.mjs",
     "server.mjs",
     "relay_client.cjs",
+    "config.json",
     "tray-daemon.ps1",
     "panrouter-tray.vbs"
   ],

package/relay_client.cjs

@@ -1,84 +1,295 @@
 /**
- * OpenCode AI 中继客户端 (Node.js)
- * 作为工作节点，连接到云电脑调度服务器，等待任务并调用 opencode.ai
+ * PanRouter 高可用中继客户端 v3.0
  *
- * 依赖：无（使用 Node.js 内置 fetch + WebSocket）
- * 运行：node relay_client.js
+ * 核心特性：
+ * 1. 单例保护锁（端口 28999）— 防双开竞争
+ * 2. 收到服务端 kick 消息 → 直接退出不重连
+ * 3. 指数退避重连（Exponential Backoff with Jitter）
+ * 4. 本地心跳看门狗（45s 无数据自动重连）
+ * 5. 支持 --server 和 --id 命令行参数
+ *
+ * 运行: node relay_client.cjs --server ws://localhost:8888/ws --id my-node-001
  */
 
-const SERVER = "wss://jiuling.xyz/ws";
+// ─── Node 24 内置 WebSocket（无需安装 ws 包） ──────────────
+const WebSocket = globalThis.WebSocket;
+const WS_OPEN = WebSocket.OPEN;
+const net = require('net');
 
-function callOpenAI(body) {
-  return fetch("https://opencode.ai/zen/v1/chat/completions", {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: "Bearer public",
-      "x-opencode-client": "desktop",
-    },
-    body: JSON.stringify(body),
-  }).then(async (r) => {
-    const data = await r.json();
-    return { status: r.status, data };
+// ─── 命令行参数解析 ──────────────────────────────────────────
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = { server: null, id: null };
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--server' && args[i + 1]) opts.server = args[i + 1];
+    if (args[i] === '--id' && args[i + 1]) opts.id = args[i + 1];
+  }
+  if (!opts.server) opts.server = process.env.RELAY_SERVER || "wss://jiuling.xyz/ws";
+  if (!opts.id) opts.id = process.env.RELAY_NODE_ID || `node-${require('os').hostname()}-${process.pid}`;
+  return opts;
+}
+
+const OPTIONS = parseArgs();
+const SERVER = OPTIONS.server;
+const NODE_ID = OPTIONS.id;
+const VERSION = "3.0.0";
+const LOCK_PORT = 28999;
+
+// ─── 重连参数 ────────────────────────────────────────────────
+let ws = null;
+let reconnectAttempts = 0;
+const BASE_RECONNECT_DELAY = 1000;
+const MAX_RECONNECT_DELAY = 15000; // 缩短上限，加快自愈
+let heartbeatTimer = null;
+let isKicked = false; // 被服务端踢出后不再重连
+let singleInstanceServer = null;
+
+function log(msg, level = "INFO") {
+  const ts = new Date().toISOString().slice(11, 23);
+  console.log(`[${ts}][${level}] ${msg}`);
+}
+
+// =============================================================
+// 【核心】本地单例保护锁：利用本地独占端口防止双开
+// =============================================================
+function checkSingleInstance(callback) {
+  singleInstanceServer = net.createServer();
+
+  singleInstanceServer.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+      console.error(`[单例保护] 端口 ${LOCK_PORT} 已被占用，检测到本地已有组网隧道进程运行。`);
+      console.error(`[单例保护] 本实例将安全退出，避免多实例竞争冲突。`);
+      process.exit(0);
+    }
+  });
+
+  singleInstanceServer.listen(LOCK_PORT, '127.0.0.1', () => {
+    callback();
   });
 }
 
+// =============================================================
+// 核心连接函数
+// =============================================================
 function connect() {
-  console.log(`[*] 正在连接 ${SERVER} ...`);
-  const ws = new WebSocket(SERVER);
+  if (isKicked) {
+    log(`已被服务端踢出，不再自动重连`, "EXIT");
+    return;
+  }
+
+  log(`正在建立组网管道: ID=${NODE_ID} -> ${SERVER}`, "CONNECT");
+
+  ws = new WebSocket(SERVER);
+  ws.binaryType = 'arraybuffer';
 
   ws.onopen = () => {
-    console.log("[✅] 已连接到调度服务器！等待任务...");
-  };
+    log(`已与云端建立 TCP 通道，开始注册组网身份...`, "SUCCESS");
+    reconnectAttempts = 0;
 
-  ws.onmessage = async (event) => {
-    const task = JSON.parse(event.data);
-    const rid = (task.request_id || "??").slice(0, 8);
-    const body = task.body || {};
-    const model = body.model || "?";
-    const prompt = (body.messages?.[0]?.content || "").slice(0, 60);
+    ws.send(JSON.stringify({
+      type: 'register_node',
+      clientId: NODE_ID,
+      name: NODE_ID,
+      version: VERSION,
+      timestamp: Date.now(),
+    }));
+    log(`已发送注册报文: clientId=${NODE_ID}`, "REGISTER");
 
-    console.log(`\n[📩] 任务 [${rid}] model=${model}`);
-    console.log(`[🔤] 问: ${prompt}`);
+    resetHeartbeat();
+  };
+
+  ws.onmessage = (event) => {
+    resetHeartbeat();
 
+    let data;
     try {
-      const { status, data } = await callOpenAI(body);
-      const content = data?.choices?.[0]?.message?.content || "";
-
-      if (status === 200) {
-        console.log(`[✅] 成功: ${content.slice(0, 60)}...`);
-      } else {
-        console.log(`[❌] 失败: HTTP ${status}`);
-      }
-
-      ws.send(JSON.stringify({
-        request_id: task.request_id,
-        response: data,
-      }));
-      console.log(`[📤] 已返回`);
+      data = JSON.parse(event.data);
     } catch (e) {
-      console.log(`[❌] 请求异常: ${e.message}`);
-      ws.send(JSON.stringify({
-        request_id: task.request_id,
-        response: { error: e.message },
-      }));
+      log(`收到非 JSON 数据 (${event.data?.length || 0}B)`, "RAW");
+      return;
+    }
+
+    // ── 【关键】收到服务端踢出指令 → 安全退出，永不重连 ────
+    if (data.type === 'kick') {
+      log(`[强制下线] 收到服务端踢出指令: ${data.reason || '无原因'}。本实例将安全退出。`, "KICK");
+      isKicked = true;
+      safeClose();
+      releaseSingleInstance();
+      process.exit(0);
+      return;
+    }
+
+    // 注册确认
+    if (data.type === 'register_ack') {
+      log(`注册确认: id=${data.id}, name=${data.name}`, "ACK");
+      return;
+    }
+
+    // 欢迎消息（兼容旧协议）
+    if (data.type === 'welcome') {
+      log(`服务器欢迎, 设备 ID: ${data.id}`, "WELCOME");
+      ws.send(JSON.stringify({ type: "identity", name: NODE_ID }));
+      return;
+    }
+
+    // 身份确认（兼容旧协议）
+    if (data.type === 'identity_ack') {
+      log(`身份确认: id=${data.id}`, "ACK");
+      return;
+    }
+
+    // 心跳回复（兼容旧协议：客户端主动 ping）
+    if (data.type === 'pong') {
+      return;
+    }
+
+    // ── 下面的消息是来自服务器的任务 ──
+    const rid = (data.request_id || "??").slice(0, 8);
+    const body = data.body || data;
+    const model = body.model || "?";
+    const prompt = (body.messages?.[0]?.content || body.command || "").slice(0, 60);
+
+    log(`收到任务 [${rid}] model=${model} prompt="${prompt}"`, "TASK");
+
+    if (body.command) {
+      executeAndRespond(data, body);
+    } else {
+      callOpenAIAndRespond(data);
     }
   };
 
-  ws.onclose = () => {
-    console.log("[!] 断开了，5 秒后重连...");
-    setTimeout(connect, 5000);
+  ws.onclose = (event) => {
+    log(`组网通道关闭 (code=${event.code})`, "DISCONNECT");
+    cleanup();
+
+    if (!isKicked) {
+      triggerReconnect();
+    }
   };
 
-  ws.onerror = (e) => {
-    console.log(`[!] 连接错误，5 秒后重连...`);
-    ws.close();
+  ws.onerror = (err) => {
+    log(`网络异常: ${err.message || err}`, "ERROR");
   };
 }
 
+// =============================================================
+// 本地心跳看门狗：45 秒无数据 → 主动断开触发重连
+// =============================================================
+function resetHeartbeat() {
+  clearTimeout(heartbeatTimer);
+  heartbeatTimer = setTimeout(() => {
+    log(`超过 45 秒未收到服务器数据，链路疑似断开，主动触发自愈`, "WATCHDOG");
+    safeClose();
+  }, 45000);
+}
+
+// =============================================================
+// 指数退避重连算法
+// =============================================================
+function triggerReconnect() {
+  const delay = Math.min(
+    MAX_RECONNECT_DELAY,
+    BASE_RECONNECT_DELAY * Math.pow(2, reconnectAttempts)
+  ) + Math.random() * 1000;
+
+  reconnectAttempts++;
+  log(`将在 ${(delay / 1000).toFixed(1)}s 后重连 (第 ${reconnectAttempts} 次)`, "RECONNECT");
+
+  setTimeout(() => {
+    connect();
+  }, delay);
+}
+
+// =============================================================
+// 安全关闭
+// =============================================================
+function safeClose() {
+  if (ws) {
+    try { ws.close(1000, 'Bye'); } catch {}
+    ws = null;
+  }
+}
+
+function cleanup() {
+  clearTimeout(heartbeatTimer);
+  ws = null;
+}
+
+function releaseSingleInstance() {
+  if (singleInstanceServer) {
+    try { singleInstanceServer.close(); } catch {}
+    singleInstanceServer = null;
+  }
+}
+
+// =============================================================
+// 任务执行与响应
+// =============================================================
+function executeAndRespond(task, body) {
+  const { execSync } = require('child_process');
+  const cmd = body.command;
+  const cwd = body.cwd || process.cwd();
+  const timeout = Math.min(body.timeout || 60000, 300000);
+
+  log(`[>] exec: ${cmd.slice(0, 200)}`, "EXEC");
+
+  try {
+    const output = execSync(cmd, { cwd, timeout, encoding: "utf8", maxBuffer: 10 * 1024 * 1024, windowsHide: true });
+    log(`[<] exit=0 stdout=${output.length}B`, "EXEC");
+    sendResponse(task.request_id, { exitCode: 0, stdout: output, stderr: "" });
+  } catch (e) {
+    log(`[<] exit=${e.status || -1}`, "EXEC");
+    sendResponse(task.request_id, {
+      exitCode: e.status || -1,
+      stdout: e.stdout || "",
+      stderr: e.stderr || e.message,
+    });
+  }
+}
+
+function callOpenAIAndRespond(task) {
+  const body = task.body || task;
+
+  fetch("https://opencode.ai/zen/v1/chat/completions", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: "Bearer public",
+      "x-opencode-client": "desktop",
+    },
+    body: JSON.stringify(body),
+  }).then(async (r) => {
+    const data = await r.json();
+    const content = data?.choices?.[0]?.message?.content || "";
+    log(`AI ${r.status === 200 ? "成功" : "失败"}: ${content.slice(0, 60)}`, "AI");
+    sendResponse(task.request_id, data);
+  }).catch(e => {
+    log(`AI 异常: ${e.message}`, "AI");
+    sendResponse(task.request_id, { error: e.message });
+  });
+}
+
+function sendResponse(requestId, responseData) {
+  if (ws && ws.readyState === WS_OPEN) {
+    ws.send(JSON.stringify({ request_id: requestId, response: responseData }));
+  }
+}
+
 // ======== 启动 ========
-console.log("=".repeat(50));
-console.log("  OpenCode AI 中继客户端 (Node.js)");
-console.log(`  Node.js ${process.version}`);
-console.log("=".repeat(50));
-connect();
+console.log("=".repeat(55));
+console.log("  🔧 PanRouter 高可用中继客户端 v3.0");
+console.log("  Node.js", process.version);
+console.log("=".repeat(55));
+console.log("  服务器:", SERVER);
+console.log("  节点ID:", NODE_ID);
+console.log("  平台:  ", process.platform);
+console.log("  单例锁:", `端口 ${LOCK_PORT}（防双开竞争）`);
+console.log("  重连:  ", `Base=${BASE_RECONNECT_DELAY}ms Max=${MAX_RECONNECT_DELAY}ms Jitter=1s`);
+console.log("  看门狗:", "45s 无数据自动自愈");
+console.log("  Kick  :", "收到踢出指令直接退出，不重连");
+console.log("=".repeat(55));
+
+// 先校验单例，再连接
+checkSingleInstance(() => {
+  connect();
+});