linco-connect 1.0.0

package/bin/linco.js

@@ -0,0 +1,465 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync, spawn } = require('child_process');
+const { startServer } = require('../src/serverApp');
+const {
+  ensureDir,
+  findGitBash,
+  getConfigFile,
+  loadConfig,
+  parseToken,
+  readUserConfig,
+  resolveCommand,
+  saveUserConfig,
+} = require('../src/config');
+const { ensureLocalToken, localUrlWithToken } = require('../src/localAuth');
+const pkg = require('../package.json');
+
+const rootDir = path.resolve(__dirname, '..');
+
+main().catch((err) => {
+  console.error(`❌ ${err.message}`);
+  process.exit(1);
+});
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const command = argv[0] && !argv[0].startsWith('-') ? argv.shift() : 'help';
+  const options = parseArgs(argv);
+
+  if (options.version || command === 'version') {
+    console.log(pkg.version);
+    return;
+  }
+
+  if (options.help || command === 'help') {
+    printHelp();
+    return;
+  }
+
+  switch (command) {
+    case 'init':
+      initCommand(options);
+      break;
+    case 'start':
+      await startCommand(options);
+      break;
+    case 'stop':
+      await stopCommand();
+      break;
+    case 'doctor':
+      doctorCommand();
+      break;
+    default:
+      throw new Error(`未知命令: ${command}\n运行 linco --help 查看用法。`);
+  }
+}
+
+function parseArgs(args) {
+  const options = {};
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (!arg.startsWith('--')) continue;
+
+    const eq = arg.indexOf('=');
+    const key = eq > 2 ? arg.slice(2, eq) : arg.slice(2);
+    const value = eq > 2 ? arg.slice(eq + 1) : args[i + 1];
+
+    if (['force', 'help', 'version', 'daemon', 'daemon-child', 'local-im', 'mock-im'].includes(key)) {
+      options[key] = true;
+      continue;
+    }
+
+    if (value == null || String(value).startsWith('--')) {
+      throw new Error(`参数 --${key} 缺少值`);
+    }
+    options[key] = value;
+    if (eq < 0) i += 1;
+  }
+  return options;
+}
+
+function initCommand(options) {
+  const tokenValue = options.token || process.env.LINCO_TOKEN || '';
+  const token = parseToken(tokenValue);
+  const appId = options['app-id'] || token.appId;
+  const appSecret = options['app-secret'] || token.appSecret;
+
+  if (!appId || !appSecret) {
+    throw new Error('请提供 --token "appId:appSecret"，或同时提供 --app-id 与 --app-secret。');
+  }
+
+  const account = options.account || 'default';
+  const configFile = getConfigFile();
+  const current = readUserConfig(configFile);
+
+  if (fs.existsSync(configFile) && !options.force) {
+    const existingAccount = current.channels?.linco?.accounts?.[account];
+    if (existingAccount?.appId || existingAccount?.appSecret || existingAccount?.token) {
+      throw new Error(`配置已存在，如需覆盖请添加 --force。配置文件: ${configFile}`);
+    }
+  }
+
+  const agentType = options.agent ? options.agent.trim().toLowerCase() : null;
+
+  if (agentType) {
+    const agentBin = resolveCommand(agentType);
+    if (!agentBin || !commandExists(agentType)) {
+      throw new Error(`未检测到 ${agentType} CLI，请先安装 ${agentType} 再初始化。`);
+    }
+  }
+
+  const next = mergeInitConfig(current, { appId, appSecret, account, agentType });
+  saveUserConfig(next, configFile);
+
+  const config = loadConfig(rootDir);
+  ensureLocalToken(config);
+
+  console.log('✅ Linco Connect 初始化完成');
+  console.log(`   配置文件: ${config.configFile}`);
+  console.log(`   账号: ${account}`);
+  if (agentType) {
+    console.log(`   Agent 类型: ${agentType}`);
+  }
+  console.log('   下一步: linco doctor && linco start');
+}
+
+function commandExists(command) {
+  try {
+    const detector = process.platform === 'win32' ? 'where.exe' : 'which';
+    const args = [command];
+    execFileSync(detector, args, { stdio: 'ignore', windowsHide: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function mergeInitConfig(current, values) {
+  const accountEntry = {
+    appId: values.appId,
+    appSecret: values.appSecret,
+    enabled: true,
+  };
+
+  return {
+    ...current,
+    defaultChannel: 'linco',
+    channels: {
+      ...(current.channels || {}),
+      linco: {
+        ...(current.channels?.linco || {}),
+        agents: {
+          ...(current.channels?.linco?.agents || {}),
+          [values.agentType]: {
+            ...(current.channels?.linco?.agents?.[values.agentType] || {}),
+            defaultAccount: values.account,
+            accounts: {
+              ...(current.channels?.linco?.agents?.[values.agentType]?.accounts || {}),
+              [values.account]: {
+                ...(current.channels?.linco?.agents?.[values.agentType]?.accounts?.[values.account] || {}),
+                ...accountEntry,
+              },
+            },
+          },
+        },
+      },
+    },
+    localWeb: {
+      ...(current.localWeb || {}),
+    },
+  };
+}
+
+async function startCommand(options = {}) {
+  if (options['local-im'] || options['mock-im']) {
+    process.env.LINCO_LOCAL_IM_ENABLED = '1';
+  }
+
+  const config = loadConfig(rootDir);
+  ensureLocalToken(config);
+
+  if (options.daemon && options['daemon-child']) {
+    throw new Error('--daemon 与 --daemon-child 不能同时使用');
+  }
+
+  if (options.daemon) {
+    await startDaemon(config);
+    return;
+  }
+
+  if (options['daemon-child']) {
+    startDaemonChild(config);
+    return;
+  }
+
+  startServer(rootDir, { config });
+}
+
+async function startDaemon(config) {
+  ensureDir(config.lincoHome);
+  ensureDir(config.logsDir);
+
+  const pidFile = daemonPidFile(config);
+  const existing = readDaemonPid(pidFile);
+  if (existing?.pid) {
+    if (isOwnDaemon(existing) && isProcessRunning(existing.pid)) {
+      throw new Error(`Linco Connect 已在后台运行，PID: ${existing.pid}`);
+    }
+    removeDaemonPid(pidFile);
+  }
+
+  const logs = daemonLogFiles(config);
+  const outFd = fs.openSync(logs.stdoutLog, 'a');
+  const errFd = fs.openSync(logs.stderrLog, 'a');
+  const childArgs = [__filename, 'start', '--daemon-child'];
+  if (config.localWeb?.imEnabled) childArgs.push('--local-im');
+  const child = spawn(process.execPath, childArgs, {
+    cwd: rootDir,
+    detached: true,
+    env: process.env,
+    stdio: ['ignore', outFd, errFd],
+    windowsHide: true,
+  });
+
+  child.unref();
+  fs.closeSync(outFd);
+  fs.closeSync(errFd);
+
+  await waitForDaemonStart(child.pid, pidFile, 5000);
+
+  console.log('✅ Linco Connect 已在后台启动');
+  console.log(`   PID: ${child.pid}`);
+  console.log(`   PID 文件: ${pidFile}`);
+  console.log(`   标准输出日志: ${logs.stdoutLog}`);
+  console.log(`   错误日志: ${logs.stderrLog}`);
+}
+
+function startDaemonChild(config) {
+  const pidFile = daemonPidFile(config);
+  let cleaned = false;
+  const cleanup = () => {
+    if (cleaned) return;
+    cleaned = true;
+    removeDaemonPid(pidFile);
+  };
+  const shutdown = () => {
+    cleanup();
+    process.exit(0);
+  };
+
+  process.once('SIGINT', shutdown);
+  process.once('SIGTERM', shutdown);
+  process.once('exit', cleanup);
+
+  startServer(rootDir, {
+    config,
+    onListening: () => writeDaemonPid(config),
+    onClose: cleanup,
+  });
+}
+
+async function stopCommand() {
+  const config = loadConfig(rootDir);
+  const pidFile = daemonPidFile(config);
+  const metadata = readDaemonPid(pidFile);
+
+  if (!metadata?.pid) {
+    removeDaemonPid(pidFile);
+    console.log('Linco Connect 未在后台运行。');
+    return;
+  }
+
+  if (!isOwnDaemon(metadata)) {
+    removeDaemonPid(pidFile);
+    console.log(`已清理无效的 PID 文件: ${pidFile}`);
+    return;
+  }
+
+  if (!isProcessRunning(metadata.pid)) {
+    removeDaemonPid(pidFile);
+    console.log(`已清理失效的 PID 文件: ${pidFile}`);
+    return;
+  }
+
+  process.kill(metadata.pid, 'SIGTERM');
+  const stopped = await waitForProcessExit(metadata.pid, 5000);
+  if (!stopped && isProcessRunning(metadata.pid)) {
+    process.kill(metadata.pid, 'SIGKILL');
+    const killed = await waitForProcessExit(metadata.pid, 2000);
+    if (!killed && isProcessRunning(metadata.pid)) {
+      throw new Error(`停止失败，进程仍在运行，PID: ${metadata.pid}`);
+    }
+  }
+
+  removeDaemonPid(pidFile);
+  console.log(`✅ Linco Connect 已停止，PID: ${metadata.pid}`);
+}
+
+function daemonPidFile(config) {
+  return path.join(config.lincoHome, 'linco.pid');
+}
+
+function daemonLogFiles(config) {
+  ensureDir(config.logsDir);
+  return {
+    stdoutLog: path.join(config.logsDir, 'daemon.out.log'),
+    stderrLog: path.join(config.logsDir, 'daemon.err.log'),
+  };
+}
+
+function readDaemonPid(pidFile) {
+  try {
+    return JSON.parse(fs.readFileSync(pidFile, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeDaemonPid(config) {
+  ensureDir(config.lincoHome);
+  const logs = daemonLogFiles(config);
+  fs.writeFileSync(daemonPidFile(config), `${JSON.stringify({
+    app: pkg.name,
+    cli: __filename,
+    cwd: rootDir,
+    pid: process.pid,
+    startedAt: new Date().toISOString(),
+    host: config.host,
+    port: config.port,
+    ...logs,
+  }, null, 2)}\n`);
+}
+
+function isOwnDaemon(metadata) {
+  return metadata?.app === pkg.name && metadata?.cli === __filename;
+}
+
+function removeDaemonPid(pidFile) {
+  try {
+    fs.rmSync(pidFile, { force: true });
+  } catch {}
+}
+
+function isProcessRunning(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function waitForProcessExit(pid, timeoutMs) {
+  const startedAt = Date.now();
+  return new Promise((resolve) => {
+    const timer = setInterval(() => {
+      if (!isProcessRunning(pid)) {
+        clearInterval(timer);
+        resolve(true);
+        return;
+      }
+      if (Date.now() - startedAt >= timeoutMs) {
+        clearInterval(timer);
+        resolve(false);
+      }
+    }, 100);
+  });
+}
+
+function waitForDaemonStart(pid, pidFile, timeoutMs) {
+  const startedAt = Date.now();
+  return new Promise((resolve, reject) => {
+    const timer = setInterval(() => {
+      const metadata = readDaemonPid(pidFile);
+      if (metadata?.pid === pid && isProcessRunning(pid)) {
+        clearInterval(timer);
+        resolve();
+        return;
+      }
+      if (!isProcessRunning(pid)) {
+        clearInterval(timer);
+        reject(new Error(`后台进程启动失败，请查看日志。PID 文件: ${pidFile}`));
+        return;
+      }
+      if (Date.now() - startedAt >= timeoutMs) {
+        clearInterval(timer);
+        reject(new Error(`后台进程启动超时，请查看日志。PID 文件: ${pidFile}`));
+      }
+    }, 100);
+  });
+}
+
+function doctorCommand() {
+  const checks = [];
+  const config = loadConfig(rootDir);
+  ensureLocalToken(config);
+
+  checks.push(['Node.js', Number(process.versions.node.split('.')[0]) >= 18, process.version]);
+  checks.push(['配置文件', fs.existsSync(config.configFile), config.configFile]);
+  checks.push(['IM token', Boolean(config.im.appId && config.im.appSecret), config.im.appId ? `appId=${config.im.appId}` : '未配置']);
+  checks.push(['远端 IM 连接', true, config.im.enabled ? '已启用' : '未启用']);
+  checks.push(['远端 IM 地址', Boolean(config.im.wsUrl), safeUrlForDisplay(config.im.wsUrl)]);
+  checks.push(['IM 账号', true, `${config.im.channel}/${config.im.account}`]);
+  checks.push(['IM Agent', true, config.im.agentId]);
+  checks.push(['本地测试 token', Boolean(config.localWeb?.token), '已生成']);
+  for (const [agentType, agent] of Object.entries(config.agents || {})) {
+    checks.push([`${agentType} Agent`, true, agent.enabled ? `已启用 ${safeUrlForDisplay(agent.wsUrl)}` : `未启用 ${safeUrlForDisplay(agent.wsUrl)}`]);
+    checks.push([`${agentType} CLI`, !agent.enabled || (path.isAbsolute(agent.bin) ? fs.existsSync(agent.bin) : commandExists(agent.bin)), agent.bin]);
+  }
+  checks.push(['Git Bash', process.platform !== 'win32' || Boolean(findGitBash(readUserConfig(config.configFile))), process.platform === 'win32' ? (config.gitBashEnv || '未找到') : '非 Windows 不需要']);
+  checks.push(['Linco Home', canEnsureWritable(config.lincoHome), config.lincoHome]);
+  checks.push(['会话目录', canEnsureWritable(config.sessionsDir), config.sessionsDir]);
+
+  console.log('Linco Connect Doctor\n');
+  let ok = true;
+  for (const [name, passed, detail] of checks) {
+    ok = ok && passed;
+    console.log(`${passed ? '✅' : '❌'} ${name}: ${detail}`);
+  }
+  console.log(`\n本地测试页: ${localUrlWithToken(config)}`);
+
+  if (!ok) process.exitCode = 1;
+}
+
+function safeUrlForDisplay(value) {
+  try {
+    const url = new URL(value);
+    return `${url.protocol}//${url.host}${url.pathname}`;
+  } catch {
+    return value || '未配置';
+  }
+}
+
+function canEnsureWritable(dir) {
+  try {
+    ensureDir(dir);
+    fs.accessSync(dir, fs.constants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function printHelp() {
+  console.log(`Linco Connect ${pkg.version}
+
+用法:
+  linco init --token "appId:appSecret" --agent claude [--account default] [--force]
+  linco start [--daemon] [--local-im|--mock-im]
+  linco stop
+  linco doctor
+
+说明:
+  init    初始化本地配置，不需要填写 wsUrl
+  start   启动本机 Agent 连接器和本地测试页
+  stop    停止后台运行的 Linco Connect
+  doctor  检查本地运行环境
+
+Agent:
+  --agent   指定 Agent 类型，如 claude 或 codex
+`);
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "linco-connect",
+  "version": "1.0.0",
+  "description": "自研 IM 桥接多 Agent 服务",
+  "main": "server.js",
+  "bin": {
+    "linco": "./bin/linco.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "public",
+    "server.js",
+    "CLAUDE.md"
+  ],
+  "scripts": {
+    "start": "node server.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "ws": "^8.16.0"
+  }
+}