@wendongfly/zihi 1.0.0

package/bin/daemon.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * zihi 守护进程：写入 PID 并启动 server
+ */
+import { writeFileSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pidFile = join(homedir(), '.zihi', 'daemon.pid');
+
+// 写入自身 PID
+writeFileSync(pidFile, String(process.pid));
+
+// 退出时清理 PID 文件
+function cleanup() { try { unlinkSync(pidFile); } catch {} }
+process.on('exit', cleanup);
+process.on('SIGTERM', () => process.exit(0));
+process.on('SIGINT', () => process.exit(0));
+
+// 启动 server
+await import('../dist/index.js');

package/bin/zihi.js

@@ -0,0 +1,603 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { mkdirSync, openSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { homedir } from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 解析 -p / --port 参数
+const args = process.argv.slice(2);
+let cmd = null;
+for (let i = 0; i < args.length; i++) {
+  if ((args[i] === '-p' || args[i] === '--port') && args[i + 1]) {
+    process.env.PORT = args[i + 1];
+    args.splice(i, 2); i--;
+  } else if (args[i].startsWith('--port=')) {
+    process.env.PORT = args[i].split('=')[1];
+    args.splice(i, 1); i--;
+  } else if (!cmd && !args[i].startsWith('-')) {
+    cmd = args[i];
+  }
+}
+if (!cmd) cmd = args[0];
+
+const configDir = join(homedir(), '.zihi');
+const pidFile = join(configDir, 'daemon.pid');
+const logFile = join(configDir, 'daemon.log');
+
+// ── 工具函数 ──────────────────────────────────────────────
+
+function readPid() {
+  try { return parseInt(readFileSync(pidFile, 'utf8').trim(), 10); }
+  catch { return null; }
+}
+
+function isRunning(pid) {
+  try { process.kill(pid, 0); return true; }
+  catch { return false; }
+}
+
+function stopDaemon() {
+  const pid = readPid();
+  if (!pid) { console.log('[zihi] 没有正在运行的后台进程'); return false; }
+  if (!isRunning(pid)) {
+    try { unlinkSync(pidFile); } catch {}
+    console.log('[zihi] 进程已不存在，已清理 PID 文件');
+    return false;
+  }
+  process.kill(pid, 'SIGTERM');
+  try { unlinkSync(pidFile); } catch {}
+  console.log(`[zihi] 已停止后台进程 (PID ${pid})`);
+  return true;
+}
+
+function startDaemon() {
+  mkdirSync(configDir, { recursive: true });
+  const out = openSync(logFile, 'a');
+  // 启动守护进程（daemon.js），由它管理 server 子进程
+  const child = spawn(process.execPath, [join(__dirname, 'daemon.js')], {
+    detached: true,
+    stdio: ['ignore', out, out],
+    cwd: process.cwd(),
+    env: { ...process.env },
+    windowsHide: true,
+  });
+  child.unref();
+  console.log(`[zihi] 已在后台启动 (PID ${child.pid})`);
+
+  // 等待 server 启动，显示日志
+  let waited = 0;
+  const poll = setInterval(() => {
+    waited += 500;
+    try {
+      const content = readFileSync(logFile, 'utf8');
+      const lines = content.split('\n');
+      // 找到最新的启动信息
+      let startIdx = -1;
+      for (let i = lines.length - 1; i >= 0; i--) { if (lines[i].includes('━━━━')) { startIdx = i; break; } }
+      if (startIdx >= 0) {
+        clearInterval(poll);
+        // 显示从启动横幅开始的日志
+        const recent = lines.slice(Math.max(0, startIdx - 1));
+        console.log(recent.join('\n'));
+        process.exit(0);
+      }
+    } catch {}
+    if (waited > 10000) {
+      clearInterval(poll);
+      console.log(`[zihi] 停止: zihi stop`);
+      console.log(`[zihi] 日志: zihi log`);
+      console.log(`[zihi] 管理: http://localhost:${process.env.PORT || 12300}/admin`);
+      process.exit(0);
+    }
+  }, 500);
+}
+
+// ── 命令分发 ──────────────────────────────────────────────
+
+if (cmd === 'attach') {
+  process.argv.splice(2, 1);
+  await import('../dist/attach.js');
+
+} else if (cmd === 'stop') {
+  stopDaemon();
+
+} else if (cmd === 'restart') {
+  stopDaemon();
+  await new Promise(r => setTimeout(r, 500));
+  startDaemon();
+  process.exit(0);
+
+} else if (cmd === 'status') {
+  const pkgVersion = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8')).version;
+  const pid = readPid();
+  if (pid && isRunning(pid)) {
+    console.log(`[zihi] v${pkgVersion} 运行中 (PID ${pid})`);
+  } else {
+    console.log(`[zihi] v${pkgVersion} 未运行`);
+  }
+
+} else if (cmd === 'log' || cmd === 'logs') {
+  try {
+    const content = readFileSync(logFile, 'utf8');
+    const lines = content.split('\n');
+    const n = parseInt(process.argv[3], 10) || 50;
+    console.log(lines.slice(-n).join('\n'));
+  } catch {
+    console.log('[zihi] 日志文件不存在');
+  }
+
+} else if (cmd === 'exclusive') {
+  // 独占模式开关
+  const { existsSync } = await import('fs');
+  const usersFile = join(configDir, 'users.json');
+  function loadCfg() {
+    try { if (existsSync(usersFile)) return JSON.parse(readFileSync(usersFile, 'utf8')); } catch {}
+    return { users: {} };
+  }
+  function saveCfg(data) {
+    mkdirSync(configDir, { recursive: true });
+    writeFileSync(usersFile, JSON.stringify(data, null, 2), { mode: 0o600 });
+  }
+
+  const sub = args[args.indexOf('exclusive') + 1] || process.argv[3];
+  if (sub === 'on' || sub === 'enable') {
+    const data = loadCfg();
+    data.exclusive = true;
+    saveCfg(data);
+    console.log('[zihi] 独占模式已开启（同一时间只允许一个账号登录）');
+  } else if (sub === 'off' || sub === 'disable') {
+    const data = loadCfg();
+    data.exclusive = false;
+    saveCfg(data);
+    console.log('[zihi] 独占模式已关闭（允许多人同时登录）');
+  } else {
+    const data = loadCfg();
+    const mode = data.exclusive ? '开启' : '关闭';
+    console.log(`[zihi] 独占模式: ${mode}`);
+    console.log(`\n用法:
+  zihi exclusive on     开启独占模式（同一时间只允许一个账号）
+  zihi exclusive off    关闭独占模式（允许多人同时登录）`);
+  }
+
+} else if (cmd === 'user') {
+  // 用户管理：直接读写 ~/.zihi/users.json，不依赖 src/
+  const { existsSync } = await import('fs');
+  const usersFile = join(configDir, 'users.json');
+
+  function loadUsersFile() {
+    try {
+      if (existsSync(usersFile)) return JSON.parse(readFileSync(usersFile, 'utf8'));
+    } catch {}
+    return { users: {} };
+  }
+  function saveUsersFile(data) {
+    mkdirSync(configDir, { recursive: true });
+    writeFileSync(usersFile, JSON.stringify(data, null, 2), { mode: 0o600 });
+  }
+
+  const sub = args[args.indexOf('user') + 1] || process.argv[3];
+  if (sub === 'list' || sub === 'ls') {
+    const data = loadUsersFile();
+    const entries = Object.entries(data.users || {});
+    if (entries.length === 0) {
+      console.log('[zihi] 还没有用户，使用 zihi user add <密码> <名称> <目录> 添加');
+    } else {
+      console.log('\n  密码\t\t名称\t\t目录');
+      console.log('  ────\t\t────\t\t────');
+      for (const [pwd, info] of entries) {
+        const masked = pwd.slice(0, 2) + '*'.repeat(pwd.length - 2);
+        console.log(`  ${masked}\t\t${info.name}\t\t${info.dir}`);
+      }
+      console.log();
+    }
+  } else if (sub === 'add') {
+    const pwd  = process.argv[4];
+    const name = process.argv[5];
+    const dir  = process.argv[6];
+    if (!pwd || !name || !dir) {
+      console.log('用法: zihi user add <密码> <名称> <目录>');
+      console.log('示例: zihi user add 1234 张三 D:\\project\\app1');
+      process.exit(1);
+    }
+    mkdirSync(dir, { recursive: true });
+    // 为用户创建独立的 git 配置（隔离凭据）
+    const gitconfigPath = join(dir, '.gitconfig');
+    const gitcredPath = join(dir, '.git-credentials');
+    if (!existsSync(gitconfigPath)) {
+      writeFileSync(gitconfigPath, `[credential]\n\thelper = store --file ${gitcredPath.replace(/\\/g, '/')}\n[user]\n\tname = ${name}\n`, { mode: 0o600 });
+      console.log(`[zihi] 已创建 git 配置: ${gitconfigPath}`);
+    }
+    const data = loadUsersFile();
+    data.users[pwd] = { name, dir };
+    saveUsersFile(data);
+    console.log(`[zihi] 已添加用户 "${name}" (目录: ${dir})`);
+  } else if (sub === 'remove' || sub === 'rm') {
+    const pwd = process.argv[4];
+    if (!pwd) {
+      console.log('用法: zihi user remove <密码>');
+      process.exit(1);
+    }
+    const data = loadUsersFile();
+    if (data.users[pwd]) {
+      delete data.users[pwd];
+      saveUsersFile(data);
+      console.log(`[zihi] 已删除用户`);
+    } else {
+      console.log('[zihi] 未找到该密码对应的用户');
+    }
+  } else {
+    console.log(`
+用户管理命令:
+  zihi user list                      列出所有用户
+  zihi user add <密码> <名称> <目录>  添加用户
+  zihi user remove <密码>             删除用户
+
+示例:
+  zihi user add 1234 张三 D:\\project\\app1
+  zihi user add 5678 李四 D:\\project\\app2
+  zihi user list
+  zihi user remove 1234
+`);
+  }
+
+} else if (cmd === 'ssh') {
+  // SSH 账号管理：为 zihi 用户创建系统 SSH 账号，隔离目录权限
+  const { existsSync } = await import('fs');
+  const { platform } = await import('os');
+  const usersFile = join(configDir, 'users.json');
+  const isWindows = platform() === 'win32';
+
+  function loadUsersFile() {
+    try { if (existsSync(usersFile)) return JSON.parse(readFileSync(usersFile, 'utf8')); } catch {}
+    return { users: {} };
+  }
+  function saveUsersFile(data) {
+    mkdirSync(configDir, { recursive: true });
+    writeFileSync(usersFile, JSON.stringify(data, null, 2), { mode: 0o600 });
+  }
+
+  function run(cmd, opts = {}) {
+    try {
+      return execSync(cmd, { encoding: 'utf8', stdio: opts.silent ? 'pipe' : 'inherit', ...opts }).trim();
+    } catch (e) {
+      if (!opts.ignoreError) { console.error(`[zihi] 命令失败: ${cmd}\n${e.stderr || e.message}`); process.exit(1); }
+      return '';
+    }
+  }
+
+  function findUserByName(name) {
+    const data = loadUsersFile();
+    for (const [pwd, info] of Object.entries(data.users || {})) {
+      if (info.name === name) return { pwd, ...info };
+    }
+    return null;
+  }
+
+  const sub = args[args.indexOf('ssh') + 1] || process.argv[3];
+
+  if (sub === 'add' || sub === 'setup') {
+    const myName = process.argv[4];
+    const sshPass = process.argv[5];
+    if (!myName) {
+      console.log('用法: zihi ssh add <zihi用户名> [SSH密码]');
+      console.log('示例: zihi ssh add 张三 mypassword');
+      console.log('\n将为 zihi 用户创建系统 SSH 账号，绑定到该用户的项目目录');
+      process.exit(1);
+    }
+
+    const user = findUserByName(myName);
+    if (!user) { console.log(`[zihi] 未找到 zihi 用户 "${myName}"，请先 zihi user add`); process.exit(1); }
+
+    const dir = user.dir;
+    // SSH 用户名：zihi-<name> (ASCII 化)
+    const sshUser = 'zihi-' + myName.replace(/[^a-zA-Z0-9_-]/g, () => Math.random().toString(36)[2]);
+    const sshPassword = sshPass || Math.random().toString(36).slice(2, 10) + 'A1!';
+
+    console.log(`[zihi] 创建 SSH 账号...`);
+    console.log(`  zihi 用户: ${myName}`);
+    console.log(`  项目目录:  ${dir}`);
+    console.log(`  SSH 用户:  ${sshUser}`);
+
+    if (isWindows) {
+      // ── Windows ──
+      // 创建本地用户
+      run(`net user "${sshUser}" "${sshPassword}" /add /y`, { silent: true, ignoreError: true });
+      run(`net user "${sshUser}" "${sshPassword}" /y`, { silent: true, ignoreError: true });
+
+      // 设置目录权限
+      mkdirSync(dir, { recursive: true });
+      // 上级目录：允许穿越（Traverse）但不允许列目录
+      const parent = join(dir, '..');
+      run(`icacls "${parent}" /grant "${sshUser}:(RC,S,X,RA,REA)"`, { silent: true, ignoreError: true });
+      // 用户自己的目录：完全控制
+      run(`icacls "${dir}" /grant "${sshUser}:(OI)(CI)F"`, { silent: true });
+
+      // 在用户 home 下创建 project 符号链接
+      const userHome = `C:\\Users\\${sshUser}`;
+      if (!existsSync(userHome)) mkdirSync(userHome, { recursive: true });
+      const link = join(userHome, 'project');
+      if (!existsSync(link)) {
+        run(`cmd /c mklink /D "${link}" "${dir}"`, { silent: true, ignoreError: true });
+      }
+
+      // 确保 OpenSSH Server 已启动
+      run('powershell -Command "Start-Service sshd 2>$null; Set-Service -Name sshd -StartupType Automatic 2>$null"', { silent: true, ignoreError: true });
+
+    } else {
+      // ── Linux / Ubuntu ──
+      // 创建系统用户，home 指向项目目录
+      run(`id "${sshUser}" 2>/dev/null || useradd -m -d "/home/${sshUser}" -s /bin/bash "${sshUser}"`, { silent: true, ignoreError: true });
+      run(`echo "${sshUser}:${sshPassword}" | chpasswd`, { silent: true });
+
+      mkdirSync(dir, { recursive: true });
+
+      // 在用户 home 下创建 project 符号链接
+      const homeDir = `/home/${sshUser}`;
+      const link = `${homeDir}/project`;
+      run(`ln -sfn "${dir}" "${link}"`, { silent: true, ignoreError: true });
+      run(`chown -h ${sshUser}:${sshUser} "${link}"`, { silent: true, ignoreError: true });
+
+      // 项目目录：设置为该用户所有
+      run(`chown -R ${sshUser}:${sshUser} "${dir}"`, { silent: true, ignoreError: true });
+
+      // 上级目录权限：移除 others 的读和执行
+      const parent = join(dir, '..');
+      run(`chmod 711 "${parent}"`, { silent: true, ignoreError: true });
+      // 用户自己的目录
+      run(`chmod 700 "${dir}"`, { silent: true, ignoreError: true });
+
+      // 确保 SSH 服务运行
+      run('systemctl enable ssh 2>/dev/null; systemctl start ssh 2>/dev/null || service ssh start 2>/dev/null', { silent: true, ignoreError: true });
+    }
+
+    // 保存 SSH 映射到 users.json
+    const data = loadUsersFile();
+    if (data.users[user.pwd]) {
+      data.users[user.pwd].sshUser = sshUser;
+      saveUsersFile(data);
+    }
+
+    console.log(`\n  ✓ SSH 账号创建成功！`);
+    console.log(`  ┌─────────────────────────────────`);
+    console.log(`  │ SSH 用户名: ${sshUser}`);
+    console.log(`  │ SSH 密码:   ${sshPassword}`);
+    console.log(`  │ 项目目录:   ${dir}`);
+    console.log(`  └─────────────────────────────────`);
+    console.log(`\n  VS Code 连接方式:`);
+    console.log(`    1. 安装 Remote-SSH 扩展`);
+    console.log(`    2. 按 F1 → "Remote-SSH: Connect to Host"`);
+    console.log(`    3. 输入: ${sshUser}@<服务器IP>`);
+    console.log(`    4. 打开目录: ~/project`);
+
+  } else if (sub === 'list' || sub === 'ls') {
+    const data = loadUsersFile();
+    const entries = Object.entries(data.users || {}).filter(([, info]) => info.sshUser);
+    if (entries.length === 0) {
+      console.log('[zihi] 还没有 SSH 账号，使用 zihi ssh add <用户名> 创建');
+    } else {
+      console.log('\n  zihi用户\tSSH账号\t\t\t目录');
+      console.log('  ────────\t───────\t\t\t────');
+      for (const [, info] of entries) {
+        console.log(`  ${info.name}\t\t${info.sshUser}\t\t${info.dir}`);
+      }
+      console.log();
+    }
+
+  } else if (sub === 'remove' || sub === 'rm') {
+    const myName = process.argv[4];
+    if (!myName) { console.log('用法: zihi ssh remove <zihi用户名>'); process.exit(1); }
+
+    const user = findUserByName(myName);
+    if (!user || !user.sshUser) { console.log(`[zihi] 未找到 "${myName}" 的 SSH 账号`); process.exit(1); }
+
+    const sshUser = user.sshUser;
+    console.log(`[zihi] 删除 SSH 账号: ${sshUser}`);
+
+    if (isWindows) {
+      run(`net user "${sshUser}" /delete`, { silent: true, ignoreError: true });
+    } else {
+      run(`userdel "${sshUser}" 2>/dev/null`, { silent: true, ignoreError: true });
+      // 不删除 home，避免误删项目数据
+    }
+
+    const data = loadUsersFile();
+    if (data.users[user.pwd]) {
+      delete data.users[user.pwd].sshUser;
+      saveUsersFile(data);
+    }
+    console.log(`[zihi] 已删除 SSH 账号 "${sshUser}"（项目目录保留）`);
+
+  } else {
+    console.log(`
+SSH 账号管理：为 zihi 用户创建独立的 SSH 开发账号
+
+  zihi ssh add <用户名> [密码]    创建 SSH 账号（绑定到 zihi 用户的项目目录）
+  zihi ssh list                   列出所有 SSH 账号
+  zihi ssh remove <用户名>        删除 SSH 账号（保留项目目录）
+
+示例:
+  zihi user add 1234 张三 /data/projects/zhangsan   # 先添加 zihi 用户
+  zihi ssh add 张三 sshpass123                       # 再创建 SSH 账号
+  zihi ssh list                                      # 查看所有 SSH 账号
+
+员工使用 VS Code Remote-SSH 连接后打开 ~/project 即可开发。
+每个用户只能访问自己的项目目录，无法查看其他用户的文件。
+`);
+  }
+
+} else if (cmd === 'kick') {
+  // 踢出会话中的用户
+  const { createRequire } = await import('module');
+  const require = createRequire(import.meta.url);
+  const { io } = require('socket.io-client');
+  const { createInterface } = await import('readline');
+
+  const SERVER = process.env.ZIHI_SERVER || 'http://localhost:12300';
+  let token;
+  try {
+    token = readFileSync(join(configDir, 'token'), 'utf8').trim();
+  } catch {
+    console.log('[zihi] 未找到 token，请先启动服务器');
+    process.exit(1);
+  }
+
+  const socket = io(SERVER, { auth: { token }, reconnection: false });
+
+  socket.on('connect_error', (err) => {
+    console.log(`[zihi] 连接失败: ${err.message}`);
+    process.exit(1);
+  });
+
+  socket.on('connect', () => {
+    // 获取所有会话
+    socket.emit('sessions', null, (sessions) => {
+      // sessions 事件可能不存在，用 HTTP 回退
+    });
+
+    // 通过 HTTP 获取会话列表
+    fetch(`${SERVER}/api/sessions?token=${token}`)
+      .then(r => r.json())
+      .then(async (sessions) => {
+        const alive = sessions.filter(s => s.alive);
+        if (alive.length === 0) {
+          console.log('[zihi] 没有活跃的会话');
+          socket.disconnect();
+          process.exit(0);
+        }
+
+        // 收集所有会话的在线用户
+        const allViewers = [];
+        for (const session of alive) {
+          const result = await new Promise(resolve => {
+            socket.emit('join', session.id);
+            socket.emit('list-viewers', { sessionId: session.id }, resolve);
+          });
+          if (result.ok) {
+            for (const v of result.viewers) {
+              allViewers.push({ ...v, sessionId: session.id, sessionTitle: session.title });
+            }
+          }
+        }
+
+        if (allViewers.length === 0) {
+          console.log('[zihi] 没有在线用户');
+          socket.disconnect();
+          process.exit(0);
+        }
+
+        // 去重（同一个 socket 可能只在一个会话中）
+        const unique = [...new Map(allViewers.map(v => [v.socketId, v])).values()];
+
+        console.log('\n  在线用户：');
+        console.log('  ────────────────────────────────────────');
+        unique.forEach((v, i) => {
+          const ctrl = v.isController ? ' [控制中]' : '';
+          console.log(`  [${i + 1}] ${v.userName} (${v.role})${ctrl}  会话: ${v.sessionTitle}`);
+        });
+        console.log();
+
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question('  输入序号踢出用户（0 取消）: ', (answer) => {
+          rl.close();
+          const idx = parseInt(answer, 10);
+          if (!idx || idx < 1 || idx > unique.length) {
+            console.log('[zihi] 已取消');
+            socket.disconnect();
+            process.exit(0);
+          }
+          const target = unique[idx - 1];
+          socket.emit('kick-user', { socketId: target.socketId, sessionId: target.sessionId }, (res) => {
+            if (res.ok) {
+              console.log(`[zihi] 已踢出用户 "${res.name}"`);
+            } else {
+              console.log(`[zihi] 踢出失败: ${res.error}`);
+            }
+            socket.disconnect();
+            process.exit(0);
+          });
+        });
+      })
+      .catch((err) => {
+        console.log(`[zihi] 获取会话失败: ${err.message}`);
+        socket.disconnect();
+        process.exit(1);
+      });
+  });
+
+} else if (cmd === 'help' || cmd === '--help' || cmd === '-h') {
+  console.log(`
+zihi — 基于 Web 的终端共享工具
+通过局域网或 Tailscale 在手机/平板上控制电脑终端，无需中继服务器。
+
+服务器：
+  zihi                 前台启动服务器
+  zihi start           前台启动服务器
+  zihi -p <port>       指定监听端口（默认 12300）
+  zihi -d, --daemon    后台启动服务器（日志写入 ~/.zihi/daemon.log）
+  zihi stop            停止后台服务器
+  zihi restart         重启后台服务器
+  zihi status          查看后台运行状态
+  zihi log [N]         查看后台日志（最后 N 行，默认 50）
+
+用户管理：
+  zihi user list              列出所有用户
+  zihi user add <密码> <名称> <目录>  添加用户
+  zihi user remove <密码>     删除用户
+  zihi exclusive on           开启独占模式（一次只能一个账号）
+  zihi exclusive off          关闭独占模式（多人同时使用，默认）
+
+SSH 开发：
+  zihi ssh add <用户名> [密码]    为 zihi 用户创建 SSH 账号
+  zihi ssh list                   列出所有 SSH 账号
+  zihi ssh remove <用户名>        删除 SSH 账号
+
+远程连接：
+  zihi attach                        列出活跃会话，交互式选择后附加
+  zihi attach <id>                   直接附加到指定会话
+  zihi attach --new                  创建新会话并附加
+  zihi attach --password <密码>      用指定用户身份连接（看到该用户的会话）
+  zihi kick            列出在线用户，交互式选择后踢出
+
+快捷键（attach 模式）：
+  Ctrl+]               分离终端（退出但不关闭会话）
+
+选项：
+  -p, --port <port>    监听端口（默认 12300）
+
+环境变量：
+  PORT                 监听端口（默认 12300）
+  HOST                 监听地址（默认 0.0.0.0）
+  ZIHI_AUTO_ATTACH     启动时自动创建会话（默认 1，设 0 关闭）
+  ZIHI_CWD             会话工作目录（默认当前目录）
+  ZIHI_SERVER          attach 连接的服务器地址（默认 http://localhost:12300）
+
+配置目录：~/.zihi/
+  token                认证令牌（自动生成）
+  password             登录密码（自动生成，可手动修改）
+  users.json           独占用户配置（zihi user 命令管理）
+  roles.json           多用户角色配置（可选）
+  sessions.json        会话持久化数据
+  daemon.pid           后台进程 PID
+  daemon.log           后台运行日志
+
+示例：
+  zihi                          # 启动后扫描二维码即可在手机上操作
+  zihi -p 8080                  # 指定 8080 端口启动
+  zihi -p 8080 -d               # 8080 端口后台启动
+  ZIHI_CWD=/project zihi        # 指定会话工作目录
+  zihi attach                   # 从另一台机器连接到会话
+  zihi user add 1234 张三 D:\\project  # 添加用户
+`);
+
+} else if (cmd === '-d' || cmd === '--daemon' || cmd === 'daemon') {
+  startDaemon();
+  process.exit(0);
+
+} else {
+  // 默认 / 'start'：前台运行
+  await import('../dist/index.js');
+}