@lixiangtian/webbridge 0.1.0

package/bin/webbridge.mjs

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+/**
+ * webbridge CLI 入口。
+ *
+ * 用法：
+ *   webbridge            前台启动（默认）
+ *   webbridge start      后台启动（守护进程）
+ *   webbridge stop       停止后台进程
+ *   webbridge status     查看运行状态
+ *   webbridge version    版本
+ *
+ * 需 Node 22+（pi-coding-agent 依赖 fs.globSync）。
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as net from 'node:net';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE = path.resolve(__dirname, '../dist/webbridge.bundle.mjs');
+const PID_FILE = path.join(process.env.HOME ?? '.', '.webbridge.pid');
+const PORT = 8765;
+
+// ---- 版本检查 ----
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 22) {
+  console.error(`✗ webbridge 需要 Node 22+（当前 v${process.versions.node}）`);
+  console.error('  升级：https://nodejs.org 或 nvm install 22');
+  process.exit(1);
+}
+
+if (!fs.existsSync(BUNDLE)) {
+  console.error('✗ 未找到 dist/webbridge.bundle.mjs，请重新安装本包（npm i -g @linglin/webbridge）');
+  process.exit(1);
+}
+
+const VERSION = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8'),
+).version;
+
+// ---- 工具 ----
+
+/** 端口是否可连（bridge 存活探测） */
+function isAlive() {
+  return new Promise((resolve) => {
+    const sock = net.connect({ host: '127.0.0.1', port: PORT, timeout: 800 });
+    sock.once('connect', () => {
+      sock.destroy();
+      resolve(true);
+    });
+    sock.once('error', () => resolve(false));
+    sock.once('timeout', () => {
+      sock.destroy();
+      resolve(false);
+    });
+  });
+}
+
+function readPid() {
+  try {
+    return Number(fs.readFileSync(PID_FILE, 'utf8').trim()) || null;
+  } catch {
+    return null;
+  }
+}
+
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ---- 子命令 ----
+
+async function cmdStart() {
+  if (await isAlive()) {
+    console.log('✓ webbridge 已在运行（ws://127.0.0.1:8765）');
+    return;
+  }
+  console.log('→ 后台启动 webbridge…');
+  const out = fs.openSync(path.join(process.env.HOME ?? '.', '.webbridge.log'), 'a');
+  const child = spawn(process.execPath, [BUNDLE], {
+    detached: true,
+    stdio: ['ignore', out, out],
+    env: process.env,
+  });
+  child.unref();
+  fs.writeFileSync(PID_FILE, String(child.pid));
+  // 等待就绪
+  for (let i = 0; i < 20; i++) {
+    await new Promise((r) => setTimeout(r, 300));
+    if (await isAlive()) {
+      console.log(`✓ webbridge 已启动（后台 pid ${child.pid}，ws://127.0.0.1:${PORT}）`);
+      console.log('  日志：~/.webbridge.log　停止：webbridge stop');
+      return;
+    }
+  }
+  console.error('✗ 启动超时，查看 ~/.webbridge.log 排查');
+  process.exit(1);
+}
+
+async function cmdStop() {
+  const pid = readPid();
+  if (pid && isPidAlive(pid)) {
+    process.kill(pid, 'SIGTERM');
+    console.log(`✓ 已停止 webbridge（pid ${pid}）`);
+  } else if (await isAlive()) {
+    console.log('! 找不到 pid 记录但端口在监听，可能由其他方式启动，未自动停止');
+  } else {
+    console.log('webbridge 未在运行');
+  }
+  try {
+    fs.unlinkSync(PID_FILE);
+  } catch {}
+}
+
+async function cmdStatus() {
+  const pid = readPid();
+  const alive = await isAlive();
+  if (alive) {
+    console.log(`✓ 运行中　ws://127.0.0.1:${PORT}${pid ? `（pid ${pid}）` : '（外部启动）'}`);
+  } else {
+    console.log('○ 未运行');
+  }
+}
+
+function cmdRun() {
+  // 前台运行（Ctrl+C 退出），直接替换为 bundle 进程
+  const res = spawnSync(process.execPath, [BUNDLE], { stdio: 'inherit' });
+  process.exit(res.status ?? 0);
+}
+
+// ---- 分发 ----
+const cmd = process.argv[2] ?? 'run';
+switch (cmd) {
+  case 'start':
+    void cmdStart();
+    break;
+  case 'stop':
+    void cmdStop();
+    break;
+  case 'status':
+    void cmdStatus();
+    break;
+  case 'version':
+  case '-v':
+  case '--version':
+    console.log(`webbridge v${VERSION}`);
+    break;
+  case 'help':
+  case '-h':
+  case '--help':
+    console.log(`webbridge v${VERSION} — 灵犀本地桥接服务
+
+用法：
+  webbridge          前台启动（Ctrl+C 退出）
+  webbridge start    后台启动（守护）
+  webbridge stop     停止后台进程
+  webbridge status   查看运行状态
+  webbridge version  版本`);
+    break;
+  default:
+    console.error(`未知命令：${cmd}（webbridge help 查看用法）`);
+    process.exit(1);
+}