@znmin/claude-remote-cli 0.3.1 → 0.4.0

package/src/cli.js

@@ -1,157 +1,187 @@
-import { parseArgs } from 'node:util';
-import { createInterface } from 'node:readline/promises';
-import { Client, DEFAULTS } from './client.js';
-import { cachedBinary, ensureMutagen, findTar, VERSION } from './installer.js';
-import { exists, installSignalHandlers, readJSON, which } from './system.js';
-import { readFileSync } from 'node:fs';
-
-const PACKAGE = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-
-const HELP = `${PACKAGE.name} ${PACKAGE.version}（非 Anthropic 官方客户端）
-
-安装后使用：
-  claude                           首次引导设置服务器，之后启动远程 Claude Code
-  claude --continue                将参数传给服务器上的 Claude
-  claude --local                   本次使用本地文件、终端和受控浏览器
-  claude --remote                  本次使用服务器工具与双向同步
-  claude-remote configure [user@host] [--port 2222] [--claude /路径/claude]
-  claude-remote mode local|remote   切换默认执行模式
-  claude-remote status              查看全部同步状态和冲突
-  claude-remote flush               等待当前目录同步完成
-  claude-remote stop [--all | --name 名称]
-  claude-remote doctor              检查本地环境，不连接服务器
-  claude-remote setup-ssh [--enable-pubkey] 配置免密登录；可显式开启服务器公钥认证
-  claude-remote install-sync        准备同步工具（通常自动完成）
-  claude-remote install-browser     准备本地受控浏览器（本地模式自动完成）
-  claude-remote run [Claude 参数]   启动远程 Claude
-
-configure 可选：--mode local|remote、--headless/--headed、--root 远程根目录、--ignore 忽略规则（可重复）。
-新配置默认使用本地执行；旧配置保持服务器模式，直到显式切换。
-服务器缺少默认 Claude Code 时会自动安装；首次启动需完成认证。
-此工具不提供服务器或 Claude 账号。
-详细诊断：CLAUDE_REMOTE_DEBUG=1 claude
-仅服务器同步模式会在退出后继续后台同步；停止请运行 claude-remote stop。
-`;
-
-async function configure(client, args) {
-  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
-    port: { type: 'string' }, root: { type: 'string' }, claude: { type: 'string' },
-    ignore: { type: 'string', multiple: true }, mode: { type: 'string' }, headless: { type: 'boolean' }, headed: { type: 'boolean' }
-  } });
-  if (positionals.length > 1) throw new Error('仅接受一个 SSH 别名或 user@host。');
-  if (values.headless && values.headed) throw new Error('--headless 和 --headed 不能同时使用。');
-  let host = positionals[0], port = values.port;
-  if (!host) {
-    if (!process.stdin.isTTY) throw new Error('请指定服务器：claude-remote configure 用户名@服务器');
-    const prompt = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-      console.log('设置你的 SSH 服务器（不要填写密码或私钥）。');
-      host = (await prompt.question('SSH 别名或 user@host：')).trim();
-      if (port === undefined) port = (await prompt.question('端口（留空使用 SSH 默认配置）：')).trim() || undefined;
-    } finally { prompt.close(); }
-  }
-  return client.configure({ host, port: port === undefined ? null : Number(port),
-    root: values.root || DEFAULTS.root, claude: values.claude || DEFAULTS.claude, ignores: values.ignore || [],
-    mode: values.mode, browserHeadless: values.headed ? false : values.headless });
-}
-
-export function executionOptions(args) {
-  const forwarded = []; let mode, literal = false;
-  for (const arg of args) {
-    if (arg === '--') literal = true;
-    if (!literal && (arg === '--local' || arg === '--remote')) {
-      const selected = arg.slice(2);
-      if (mode && mode !== selected) throw new Error('--local 和 --remote 不能同时使用。');
-      mode = selected;
-    } else forwarded.push(arg);
-  }
-  return { mode, forwarded };
-}
-
-export async function main(asClaude, args = process.argv.slice(2), client = new Client()) {
-  if (asClaude) {
-    const options = executionOptions(args);
-    args = options.forwarded;
-    if (args.length === 1 && ['--help', '-h'].includes(args[0])) { console.log(HELP); return 0; }
-    if (args.length === 1 && ['--version', '-v'].includes(args[0])) { console.log(`${PACKAGE.name} ${PACKAGE.version}`); return 0; }
-    const saved = await readJSON(client.configFile, {});
-    if (!saved.host && !client.env.CLAUDE_REMOTE_HOST) {
-      if (args.includes('--help') || args.includes('-h')) { console.log(HELP); return 0; }
-      if (args.includes('--version')) { console.log(`${PACKAGE.name} ${PACKAGE.version}`); return 0; }
-      if (process.stdin.isTTY) await configure(client, []);
-    }
-    const config = await client.settings();
-    return client.launch(options.mode ? { ...config, mode: options.mode } : config, args);
-  }
-  const [action, ...rest] = args;
-  if (!action || ['--help', '-h', 'help'].includes(action)) { console.log(HELP); return 0; }
-  if (['--version', '-v'].includes(action)) { console.log(PACKAGE.version); return 0; }
-  if (action === 'configure') { await configure(client, rest); return 0; }
-  if (action === 'mode') {
-    if (rest.length !== 1) throw new Error('用法：claude-remote mode local|remote');
-    await client.setMode(rest[0]); return 0;
-  }
-  if (action === 'run') return main(true, rest[0] === '--' ? rest.slice(1) : rest, client);
-  if (action === 'stop') {
-    const { values, positionals } = parseArgs({ args: rest, allowPositionals: true,
-      options: { all: { type: 'boolean' }, name: { type: 'string' } } });
-    if (positionals.length || values.all && values.name) throw new Error('用法：claude-remote stop [--all | --name 名称]');
-    await client.stop(values); return 0;
-  }
-  if (action === 'setup-ssh') {
-    const { values, positionals } = parseArgs({ args: rest, allowPositionals: true,
-      options: { 'enable-pubkey': { type: 'boolean' } } });
-    if (positionals.length) throw new Error('用法：claude-remote setup-ssh [--enable-pubkey]');
-    await client.ensureSSH(client, await client.settings(), { enablePubkey: Boolean(values['enable-pubkey']) });
-    client.log('SSH 免密登录可用。'); return 0;
-  }
-  if (rest.length) throw new Error(`${action} 不接受额外参数。`);
-  if (action === 'status') {
-    await client.sync(['list', '--long', '--label-selector', 'claude-remote=true'], { capture: false }); return 0;
-  }
-  if (action === 'flush') {
-    await client.flush((await client.project(await client.settings())).name); return 0;
-  }
-  if (action === 'install-sync') { console.log('同步工具：' + await ensureMutagen({ env: client.env })); return 0; }
-  if (action === 'install-browser') {
-    const { installBrowser } = await import('./local/browser.js');
-    await installBrowser(client.log, { debug: client.debug }); console.log('浏览器已就绪。'); return 0;
-  }
-  if (action === 'doctor') {
-    const [major, minor] = process.versions.node.split('.').map(Number);
-    const nodeOk = major > 20 || major === 20 && minor >= 11;
-    console.log(`Node.js：${process.version}${nodeOk ? '' : '（需要 20.11 或更高版本）'}\n平台：${process.platform}/${process.arch}`);
-    for (const tool of ['ssh', 'ssh-keygen', 'scp']) console.log(`${tool}：${await which(tool, client.env.PATH) || '未安装'}`);
-    console.log(`tar：${await findTar(client.env) || '未安装'}`);
-    if (process.platform === 'win32') {
-      const { describeShell, findShell } = await import('./local/shell.js');
-      const shell = await findShell(client.env);
-      console.log(`本地终端：${describeShell(shell)}（${shell.file}）${shell.kind === 'powershell' ? '；安装 Git for Windows 后改用 Git Bash' : ''}`);
-      const { conflictReport } = await import('./powershell-conflicts.js');
-      for (const line of await conflictReport(client.env)) console.log(line);
-    }
-    try {
-      const { browserReady } = await import('./local/browser.js');
-      const { chromium } = await import('playwright');
-      const ready = await browserReady();
-      console.log(`本地浏览器：${ready ? chromium.executablePath() : '尚未准备（本地模式首次启动或 claude-remote install-browser 时下载）'}`);
-    } catch (error) { console.log('本地浏览器：无法检查（' + error.message + '）'); }
-    const cached = cachedBinary(client.env);
-    console.log(`同步工具：${client.env.CLAUDE_REMOTE_MUTAGEN || (await exists(cached) ? cached : await which('mutagen', client.env.PATH)) || '首次使用时自动下载'}（目标版本 ${VERSION}）`);
-    const config = await readJSON(client.configFile, {});
-    console.log(`配置：${client.configFile}\n服务器：${client.env.CLAUDE_REMOTE_HOST || config.host || '尚未配置'}`);
-    console.log(`默认模式：${client.env.CLAUDE_REMOTE_MODE || config.mode || 'remote（旧配置）'}`);
-    return 0;
-  }
-  throw new Error(`未知命令 ${action}。运行 claude-remote --help 查看用法。`);
-}
-
-export async function entry(asClaude) {
-  installSignalHandlers();
-  try { process.exitCode = await main(asClaude); }
-  catch (error) {
-    console.error('claude-remote：' + error.message);
-    if (process.env.CLAUDE_REMOTE_DEBUG === '1') console.error(error.stack);
-    process.exitCode = 1;
-  }
-}
+import { parseArgs } from 'node:util';
+import { createInterface } from 'node:readline/promises';
+import { Client, DEFAULTS } from './client.js';
+import { cachedBinary, ensureMutagen, findTar, VERSION } from './installer.js';
+import { exists, installSignalHandlers, readJSON, which } from './system.js';
+import { readFileSync } from 'node:fs';
+import { realpath } from 'node:fs/promises';
+
+const PACKAGE = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+
+const HELP = `${PACKAGE.name} ${PACKAGE.version}（非 Anthropic 官方客户端）
+
+安装后使用：
+  claude                           首次引导设置服务器，之后启动远程 Claude Code
+  claude --continue                将参数传给服务器上的 Claude
+  claude --local                   本次使用本地文件、终端和受控浏览器
+  claude --remote                  本次使用服务器工具与双向同步
+  claude-remote configure [user@host] [--port 2222] [--claude /路径/claude]
+  claude-remote mode local|remote   切换默认执行模式
+  claude-remote status              查看全部同步状态和冲突
+  claude-remote flush               等待当前目录同步完成
+  claude-remote stop [--all | --name 名称]
+  claude-remote doctor              检查本地环境，不连接服务器
+  claude-remote setup-ssh [--enable-pubkey] 配置免密登录；可显式开启服务器公钥认证
+  claude-remote install-sync        准备同步工具（通常自动完成）
+  claude-remote install-browser     准备本地受控浏览器（本地模式自动完成）
+  claude-remote mcp list|add|remove 管理本机 MCP（可访问内网），本地模式下提供给服务器上的 Claude
+  claude-remote run [Claude 参数]   启动远程 Claude
+
+configure 可选：--mode local|remote、--headless/--headed、--root 远程根目录、--ignore 忽略规则（可重复）。
+新配置默认使用本地执行；旧配置保持服务器模式，直到显式切换。
+服务器缺少默认 Claude Code 时会自动安装；首次启动需完成认证。
+此工具不提供服务器或 Claude 账号。
+详细诊断：CLAUDE_REMOTE_DEBUG=1 claude
+仅服务器同步模式会在退出后继续后台同步；停止请运行 claude-remote stop。
+`;
+
+async function configure(client, args) {
+  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
+    port: { type: 'string' }, root: { type: 'string' }, claude: { type: 'string' },
+    ignore: { type: 'string', multiple: true }, mode: { type: 'string' }, headless: { type: 'boolean' }, headed: { type: 'boolean' }
+  } });
+  if (positionals.length > 1) throw new Error('仅接受一个 SSH 别名或 user@host。');
+  if (values.headless && values.headed) throw new Error('--headless 和 --headed 不能同时使用。');
+  let host = positionals[0], port = values.port;
+  if (!host) {
+    if (!process.stdin.isTTY) throw new Error('请指定服务器：claude-remote configure 用户名@服务器');
+    const prompt = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      console.log('设置你的 SSH 服务器（不要填写密码或私钥）。');
+      host = (await prompt.question('SSH 别名或 user@host：')).trim();
+      if (port === undefined) port = (await prompt.question('端口（留空使用 SSH 默认配置）：')).trim() || undefined;
+    } finally { prompt.close(); }
+  }
+  return client.configure({ host, port: port === undefined ? null : Number(port),
+    root: values.root || DEFAULTS.root, claude: values.claude || DEFAULTS.claude, ignores: values.ignore || [],
+    mode: values.mode, browserHeadless: values.headed ? false : values.headless });
+}
+
+export function executionOptions(args) {
+  const forwarded = []; let mode, literal = false;
+  for (const arg of args) {
+    if (arg === '--') literal = true;
+    if (!literal && (arg === '--local' || arg === '--remote')) {
+      const selected = arg.slice(2);
+      if (mode && mode !== selected) throw new Error('--local 和 --remote 不能同时使用。');
+      mode = selected;
+    } else forwarded.push(arg);
+  }
+  return { mode, forwarded };
+}
+
+// Mirrors Client: configure saves new setups as local; a saved server without
+// a mode predates local mode and stays remote.
+export function defaultModeLabel(config, env = {}) {
+  if (env.CLAUDE_REMOTE_MODE) return `${env.CLAUDE_REMOTE_MODE}（环境变量 CLAUDE_REMOTE_MODE）`;
+  if (config.mode) return config.mode;
+  if (config.host) return 'remote（旧配置）';
+  if (env.CLAUDE_REMOTE_HOST) return 'remote（未保存配置）';
+  return 'local（配置服务器后的默认值）';
+}
+
+async function mcp(client, args) {
+  const { McpStore, runMcpCommand } = await import('./local/mcp-config.js');
+  const root = await realpath(client.cwd);
+  return runMcpCommand(new McpStore({ directory: client.directory, lockFile: client.lockFile, root }), args);
+}
+
+export async function main(asClaude, args = process.argv.slice(2), client = new Client()) {
+  if (asClaude) {
+    const options = executionOptions(args);
+    args = options.forwarded;
+    if (args.length === 1 && ['--help', '-h'].includes(args[0])) { console.log(HELP); return 0; }
+    if (args.length === 1 && ['--version', '-v'].includes(args[0])) { console.log(`${PACKAGE.name} ${PACKAGE.version}`); return 0; }
+    const saved = await readJSON(client.configFile, {});
+    // In local mode MCP servers run on this computer, so `claude mcp` manages them here.
+    if (args[0] === 'mcp') {
+      const mode = options.mode || client.env.CLAUDE_REMOTE_MODE || saved.mode || (saved.host || client.env.CLAUDE_REMOTE_HOST ? 'remote' : 'local');
+      if (mode === 'local') return mcp(client, args.slice(1));
+    }
+    if (!saved.host && !client.env.CLAUDE_REMOTE_HOST) {
+      if (args.includes('--help') || args.includes('-h')) { console.log(HELP); return 0; }
+      if (args.includes('--version')) { console.log(`${PACKAGE.name} ${PACKAGE.version}`); return 0; }
+      if (process.stdin.isTTY) await configure(client, []);
+    }
+    const config = await client.settings();
+    return client.launch(options.mode ? { ...config, mode: options.mode } : config, args);
+  }
+  const [action, ...rest] = args;
+  if (!action || ['--help', '-h', 'help'].includes(action)) { console.log(HELP); return 0; }
+  if (['--version', '-v'].includes(action)) { console.log(PACKAGE.version); return 0; }
+  if (action === 'configure') { await configure(client, rest); return 0; }
+  if (action === 'mode') {
+    if (rest.length !== 1) throw new Error('用法：claude-remote mode local|remote');
+    await client.setMode(rest[0]); return 0;
+  }
+  if (action === 'run') return main(true, rest[0] === '--' ? rest.slice(1) : rest, client);
+  if (action === 'mcp') return mcp(client, rest);
+  if (action === 'stop') {
+    const { values, positionals } = parseArgs({ args: rest, allowPositionals: true,
+      options: { all: { type: 'boolean' }, name: { type: 'string' } } });
+    if (positionals.length || values.all && values.name) throw new Error('用法：claude-remote stop [--all | --name 名称]');
+    await client.stop(values); return 0;
+  }
+  if (action === 'setup-ssh') {
+    const { values, positionals } = parseArgs({ args: rest, allowPositionals: true,
+      options: { 'enable-pubkey': { type: 'boolean' } } });
+    if (positionals.length) throw new Error('用法：claude-remote setup-ssh [--enable-pubkey]');
+    await client.ensureSSH(client, await client.settings(), { enablePubkey: Boolean(values['enable-pubkey']) });
+    client.log('SSH 免密登录可用。'); return 0;
+  }
+  if (rest.length) throw new Error(`${action} 不接受额外参数。`);
+  if (action === 'status') {
+    await client.sync(['list', '--long', '--label-selector', 'claude-remote=true'], { capture: false }); return 0;
+  }
+  if (action === 'flush') {
+    await client.flush((await client.project(await client.settings())).name); return 0;
+  }
+  if (action === 'install-sync') { console.log('同步工具：' + await ensureMutagen({ env: client.env })); return 0; }
+  if (action === 'install-browser') {
+    const { browserName, installBrowser } = await import('./local/browser.js');
+    const choice = await installBrowser(client.log, { debug: client.debug, env: client.env });
+    console.log(`浏览器已就绪：${browserName(choice)}（${choice.file}）${choice.kind === 'chromium' ? '' : '，无需下载'}`); return 0;
+  }
+  if (action === 'doctor') {
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    const nodeOk = major > 20 || major === 20 && minor >= 11;
+    console.log(`Node.js：${process.version}${nodeOk ? '' : '（需要 20.11 或更高版本）'}\n平台：${process.platform}/${process.arch}`);
+    for (const tool of ['ssh', 'ssh-keygen', 'scp']) console.log(`${tool}：${await which(tool, client.env.PATH) || '未安装'}`);
+    console.log(`tar：${await findTar(client.env) || '未安装'}`);
+    if (process.platform === 'win32') {
+      const { describeShell, findShell } = await import('./local/shell.js');
+      const shell = await findShell(client.env);
+      console.log(`本地终端：${describeShell(shell)}（${shell.file}）${shell.kind === 'powershell' ? '；安装 Git for Windows 后改用 Git Bash' : ''}`);
+      const { conflictReport } = await import('./powershell-conflicts.js');
+      for (const line of await conflictReport(client.env)) console.log(line);
+    }
+    try {
+      const { browserName, browserReady, chooseBrowser } = await import('./local/browser.js');
+      const choice = await chooseBrowser(client.env);
+      if (choice.kind !== 'chromium') console.log(`本地浏览器：${browserName(choice)}（${choice.file}），无需下载`);
+      else {
+        const { chromium } = await import('playwright');
+        const ready = await browserReady();
+        console.log(`本地浏览器：${browserName(choice)}，${ready ? chromium.executablePath() : '尚未准备（本地模式首次启动或 claude-remote install-browser 时下载）'}` +
+          (choice.explicit ? '' : '；安装 Chrome 或 Edge 后可直接使用'));
+      }
+    } catch (error) { console.log('本地浏览器：无法检查（' + error.message + '）'); }
+    const cached = cachedBinary(client.env);
+    console.log(`同步工具：${client.env.CLAUDE_REMOTE_MUTAGEN || (await exists(cached) ? cached : await which('mutagen', client.env.PATH)) || '首次使用时自动下载'}（目标版本 ${VERSION}）`);
+    const config = await readJSON(client.configFile, {});
+    console.log(`配置：${client.configFile}\n服务器：${client.env.CLAUDE_REMOTE_HOST || config.host || '尚未配置'}`);
+    console.log(`默认模式：${defaultModeLabel(config, client.env)}`);
+    return 0;
+  }
+  throw new Error(`未知命令 ${action}。运行 claude-remote --help 查看用法。`);
+}
+
+export async function entry(asClaude) {
+  installSignalHandlers();
+  try { process.exitCode = await main(asClaude); }
+  catch (error) {
+    console.error('claude-remote：' + error.message);
+    if (process.env.CLAUDE_REMOTE_DEBUG === '1') console.error(error.stack);
+    process.exitCode = 1;
+  }
+}