@znmin/claude-remote-cli 0.2.3 → 0.2.5

package/README.md

@@ -1,6 +1,6 @@
 # claude-remote-cli
 
-在项目目录运行 `claude`，让 Claude Code 主进程运行在 SSH 服务器，文件、终端和浏览器操作在本机执行；也保留服务器执行和目录双向同步模式。
+在项目目录运行 `claude`，让 Claude Code 主进程运行在 SSH 服务器，文件、终端和交互式浏览器操作在本机执行，普通公开资料搜索与网页读取使用服务器原生工具；也保留服务器执行和目录双向同步模式。
 
 本项目是独立的 SSH/同步封装，不是 Anthropic 官方客户端。它不提供服务器、Claude 账号或 API 服务。
 
@@ -25,10 +25,10 @@ npm install -g git+https://github.com/znmin/claude-remote-cli.git
 也可以从已下载的分发包安装：
 
 ```bash
-npm install -g ./znmin-claude-remote-cli-0.2.3.tgz
+npm install -g ./znmin-claude-remote-cli-0.2.5.tgz
 ```
 
-若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.2.3.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
+若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.2.5.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
 
 npm 中不带作用域的 `claude-remote-cli` 属于其他项目。本项目使用独立的 `@znmin/claude-remote-cli` 作用域包名；请安装完整包名，或使用上述 GitHub 地址及本项目分发的 `.tgz` 文件。
 
@@ -129,6 +129,8 @@ Git、npm、pnpm、Python、Go、Docker、数据库 CLI、`gh` 等共用本地
 
 文件工具限定项目内，拒绝路径穿越和指向项目外的符号链接；修改已有文件需要精确旧文本或读取时的 SHA-256。终端具有启动用户的正常系统权限，项目工作目录不是操作系统沙箱。本地模式可使用本机 Git worktree。
 
+0.2.5 起，普通公开资料查询优先使用服务器上的 Claude 原生 `WebSearch` / `WebFetch`，不打开本地浏览器；服务器的文件、终端和浏览器执行工具仍不开放。原生搜索/网页读取是否可用取决于服务器 Claude 的账号、服务商和策略；如果不可用或查询失败，会先说明并征求用户意见，再回退本地浏览器。本地开发页面、localhost/局域网地址、交互测试、截图和交互登录仍使用本地浏览器，不交给服务器 WebFetch。该选择通过工具白名单及提示词约定实现，不是对模型每次路由选择的硬性拦截。
+
 浏览器使用独立窗口和临时上下文，不读取日常 Chrome 的登录态。启动本地模式时准备相应浏览器版本，后续使用缓存；收到浏览器工具调用时才打开窗口。可以打开本机 localhost，填写表单、点击、截图和读取控制台错误。
 
 ```bash
@@ -142,7 +144,7 @@ Linux 上仍需安装 Playwright 所需的系统共享库，有窗口模式还
 
 本地模式要求服务器允许 SSH TCP 转发，Claude Code 版本至少 **2.1.248**；已有版本过旧时会提示在服务器运行 `claude update`。每个会话创建仅监听本机回环地址的工具服务、随机令牌和 SSH 反向隧道；令牌通过 SSH 标准输入写入服务器 0600 临时配置，不出现在命令行参数或同步项目中。退出时清理配置、连接和浏览器。
 
-启动时使用 `--restricted`、`--tools ""`、`--strict-mcp-config`，限定工具和设置来源、关闭普通 hooks。0.2.2 起恢复 `/config`、`/model`、`/help` 等内置交互命令，不再使用禁用整个命令菜单的 `--disable-slash-commands`；通过 `disableSkillShellExecution` 和 `disableBundledSkills` 单独关闭技能内联 shell 和内置技能工作流。恢复菜单不代表所有依赖服务器项目目录或原生工具的命令都适用于本地模式。设置面板修改的是服务器上的 Claude 配置；受限模式仍只加载托管配置和本次 `--settings`，不会恢复读取普通用户/项目 settings.json，因此偏好设置的跨会话持久化仍受该限制影响，可用 `claude --model sonnet` 明确指定启动模型。保留服务器上的订阅认证，不使用跳过 OAuth 的 `--bare`。本地连接失效时不会退回服务器工具。支持 `--continue`、`--resume`、`--model`、`--effort`、`-p` 和输入/输出格式；暂不接受替换工具配置、加载插件、切换云会话等参数。
+启动时使用 `--restricted`、`--tools "WebSearch,WebFetch"`、`--strict-mcp-config`，限定工具和设置来源、关闭普通 hooks。0.2.2 起恢复 `/config`、`/model`、`/help` 等内置交互命令，不再使用禁用整个命令菜单的 `--disable-slash-commands`；通过 `disableSkillShellExecution` 和 `disableBundledSkills` 单独关闭技能内联 shell 和内置技能工作流。恢复菜单不代表所有依赖服务器项目目录或原生工具的命令都适用于本地模式。设置面板修改的是服务器上的 Claude 配置；受限模式仍只加载托管配置和本次 `--settings`，不会恢复读取普通用户/项目 settings.json，因此偏好设置的跨会话持久化仍受该限制影响，可用 `claude --model sonnet` 明确指定启动模型。保留服务器上的订阅认证，不使用跳过 OAuth 的 `--bare`。本地连接失效时不会将文件或命令操作退回服务器执行。支持 `--continue`、`--resume`、`--model`、`--effort`、`-p` 和输入/输出格式；暂不接受替换工具配置、加载插件、切换云会话等参数。
 
 这是工具路由约束，不是对 Claude Code 主进程的系统隔离。认证、会话和日志仍在服务器，管理员管理策略继续生效。文件内容、命令结果和截图会经过服务器交给模型，不整体同步不代表数据不离开本机。
 
@@ -181,6 +183,16 @@ CLAUDE_REMOTE_HOST=another-server CLAUDE_REMOTE_PORT=2222 claude
 - 不允许同步整个本机用户目录或磁盘根目录。不会同步用户目录中的 Claude 登录信息；远程使用自己的登录状态和工具配置。
 - 本版不提供 tmux 会话恢复。网络中断后文件同步会尝试重连，远程 Claude 进程是否继续运行取决于服务器的进程行为。
 
+## 运行提示与调试
+
+正常使用时，只显示需要等待或操作的提示，例如首次下载组件、SSH 验证、服务器策略修复结果，以及错误。已配置好的本地模式直接进入 Claude，不重复显示模式说明、项目路径或浏览器缓存检查。服务器同步模式会简短提示“正在同步…”。`configure`、`setup-ssh`、`doctor` 等显式管理命令仍显示操作结果；Claude 自身的界面和 SSH 验证提示不受影响。
+
+需要查看连接目标、项目路径、密钥配置过程、缓存检查、同步工具过程输出和错误堆栈时，临时启用：
+
+```bash
+CLAUDE_REMOTE_DEBUG=1 claude
+```
+
 ## 高级环境变量
 
 | 变量 | 用途 |
@@ -194,7 +206,7 @@ CLAUDE_REMOTE_HOST=another-server CLAUDE_REMOTE_PORT=2222 claude
 | `CLAUDE_REMOTE_MUTAGEN` | 使用自行准备的 Mutagen 可执行文件绝对路径（应为 0.18.1，并放置配套代理包） |
 | `CLAUDE_REMOTE_PREPARE_SYNC=1` | npm 安装阶段提前准备同步工具，默认按需准备 |
 | `CLAUDE_REMOTE_SKIP_DOWNLOAD=1` | 跳过安装阶段的同步工具准备 |
-| `CLAUDE_REMOTE_DEBUG=1` | 出错时显示调试信息 |
+| `CLAUDE_REMOTE_DEBUG=1` | 显示详细启动过程和错误堆栈 |
 
 `npm install --ignore-scripts` 也受支持，首次使用各模式时准备对应组件。无法访问 GitHub 时可自行准备 Mutagen 并使用 `CLAUDE_REMOTE_MUTAGEN`。浏览器缓存由 Playwright 管理，支持其 `PLAYWRIGHT_BROWSERS_PATH` 环境变量。
 
@@ -210,7 +222,7 @@ npm test
 CLAUDE_REMOTE_INTEGRATION=1 CLAUDE_REMOTE_BROWSER_TEST=1 npm test
 
 npm pack
-npm install -g ./znmin-claude-remote-cli-0.2.3.tgz
+npm install -g ./znmin-claude-remote-cli-0.2.5.tgz
 
 # 确定包名、版本和使用条款后，使用有发布权限的 npm 账号发布
 npm login
@@ -219,6 +231,6 @@ npm publish --access public
 
 GitHub 仓库名为 `claude-remote-cli`，npm 包名为 `@znmin/claude-remote-cli`，命令名为 `claude` 和 `claude-remote`。发布账号必须拥有 npm 用户作用域 `@znmin`，或拥有同名 npm 组织的发布权限；GitHub 身份不会自动授予 npm 权限。当前 `license` 为 `UNLICENSED`，尚未指定开源许可证。
 
-测试覆盖真实 MCP HTTP 调用、本机文件与进程、受控浏览器交互、本地真实同步、模拟 SSH/Claude 的完整启动清理链路，以及官方安装流程的隔离模拟。尚未提供服务器，真实 SSH 认证、Claude 模型端到端调用、Linux 和其他 CPU 架构尚未实测。
+测试覆盖真实 MCP HTTP 调用、本机文件与进程、受控浏览器交互、本地真实同步、模拟 SSH/Claude 的完整启动清理链路，以及官方安装流程的隔离模拟。真实服务器完整启动、Claude 模型端到端调用、Linux 和其他 CPU 架构尚未完成实测。
 
 参考：[npm 命令入口配置](https://docs.npmjs.com/cli/configuring-npm/package-json#bin)、[Mutagen 同步机制](https://mutagen.io/documentation/synchronization/)、[Mutagen SSH 支持](https://mutagen.io/documentation/transports/ssh/)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@znmin/claude-remote-cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Run Claude Code on an SSH server with local filesystem, terminal and browser tools, or remote bidirectional sync",
   "type": "module",
   "license": "UNLICENSED",

package/scripts/postinstall.js

@@ -3,10 +3,9 @@ import { ensureMutagen } from '../src/installer.js';
 if (process.env.CLAUDE_REMOTE_PREPARE_SYNC === '1' && process.env.CLAUDE_REMOTE_SKIP_DOWNLOAD !== '1') {
   try {
     await ensureMutagen();
-    console.log('claude 已安装。运行 claude-remote configure 用户名@服务器，或直接运行 claude 开始配置。');
   } catch (error) {
     // Offline installation and npm --ignore-scripts remain supported: retry at first use.
     console.warn(`CLI 已安装，同步工具准备未完成：${error.message}\n首次连接时会重试。`);
   }
 }
-console.log('安装完成：运行 claude 配置服务器并启动。新配置默认本地执行；同步工具和浏览器在对应模式首次使用时自动准备。');
+console.log('安装完成，运行 claude 开始。');

package/src/cli.js

@@ -29,6 +29,7 @@ configure 可选：--mode local|remote、--headless/--headed、--root 远程根
 新配置默认使用本地执行；旧配置保持服务器模式，直到显式切换。
 服务器缺少默认 Claude Code 时会自动安装；首次启动需完成认证。
 此工具不提供服务器或 Claude 账号。
+详细诊断：CLAUDE_REMOTE_DEBUG=1 claude
 仅服务器同步模式会在退出后继续后台同步；停止请运行 claude-remote stop。
 `;
 
@@ -101,7 +102,8 @@ export async function main(asClaude, args = process.argv.slice(2), client = new
     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']) }); return 0;
+    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') {
@@ -113,7 +115,7 @@ export async function main(asClaude, args = process.argv.slice(2), client = new
   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); console.log('本地受控浏览器已就绪。'); return 0;
+    await installBrowser(client.log, { debug: client.debug }); console.log('浏览器已就绪。'); return 0;
   }
   if (action === 'doctor') {
     console.log(`Node.js：${process.version}\n平台：${process.platform}/${process.arch}`);

package/src/client.js

@@ -63,6 +63,9 @@ export class Client {
     this.ensureMutagen = options.ensureMutagen || ensureMutagen;
     this.log = options.log || console.error;
     this.warn = options.warn || console.error;
+    this.debug = (...messages) => {
+      if (this.env.CLAUDE_REMOTE_DEBUG === '1') this.log(...messages);
+    };
     this.tty = options.tty ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
   }
 
@@ -74,8 +77,10 @@ export class Client {
         ignores: [...DEFAULTS.ignores, ...(input.ignores || [])],
         client_id: old.client_id || randomUUID().replaceAll('-', '').slice(0, 12) });
       await writeJSON(this.configFile, config);
-      this.log(`已配置服务器：${config.host}。进入项目目录后运行 claude。`);
-      this.log(`当前模式：${config.mode === 'local' ? '本地执行' : '服务器执行与双向同步'}。旧后台同步不会自动停止，可用 claude-remote stop --all 停止。`);
+      this.log(`已保存：${config.host}（${config.mode === 'local' ? '本地执行' : '远程同步'}）。`);
+      this.debug(`配置文件：${this.configFile}`);
+      if (old.host && (old.host !== config.host || (old.mode || 'remote') !== config.mode))
+        this.log('停止旧同步：claude-remote stop --all');
       return config;
     });
   }
@@ -150,6 +155,7 @@ export class Client {
   }
 
   async launch(config, extra) {
+    this.debug(`连接：${config.host}${config.port ? ':' + config.port : ''}，模式：${config.mode || 'remote'}`);
     await this.ensureSSH(this, config);
     if (config.mode === 'local') {
       const { launchLocal } = await import('./local-mode.js');
@@ -178,21 +184,22 @@ export class Client {
       await this.remote(config, ensureRemoteClaude(config.claude) +
         'mkdir -p -- ' + remotePath(item.remote), false, { timeout: 600000 });
       if (existing.some(session => session.name === item.name)) {
-        await this.sync(['resume', item.name], { timeout: 60000, capture: !this.tty });
+        await this.sync(['resume', item.name], { timeout: 60000, capture: this.env.CLAUDE_REMOTE_DEBUG !== '1' || !this.tty });
       } else {
         const endpoint = config.host + ':' + (config.port != null ? config.port + ':' : '') +
           (item.remote.startsWith('/') ? item.remote : '~/' + item.remote);
         const args = ['create', '--name', item.name, '--label', 'claude-remote=true', '--mode', 'two-way-safe',
           '--no-global-configuration', '--no-ignore-vcs', '--watch-polling-interval', '2'];
         for (const pattern of config.ignores) args.push('--ignore', pattern);
-        await this.sync([...args, item.local, endpoint], { timeout: 180000, capture: !this.tty });
+        await this.sync([...args, item.local, endpoint], { timeout: 180000, capture: this.env.CLAUDE_REMOTE_DEBUG !== '1' || !this.tty });
       }
       registry[item.name] = item;
       await writeJSON(this.registryFile, registry);
     });
-    this.log(`本地：${item.local}\n远程：${config.host}:${item.remote}\n正在完成双向同步……`);
+    this.debug(`本地：${item.local}\n远程：${config.host}:${item.remote}`);
+    this.log('正在同步…');
     await this.flush(item.name);
-    this.log('开始远程 Claude Code。退出后继续后台同步；停止请运行 claude-remote stop。');
+    this.debug('同步完成，启动远程 Claude Code。退出后继续后台同步；停止请运行 claude-remote stop。');
     let code = 1;
     try {
       code = (await this.remote(config, prefix + 'cd -- ' + remotePath(item.remote) +

package/src/installer.js

@@ -64,7 +64,7 @@ export async function ensureMutagen({ env = process.env, forceDownload = false }
     const temporary = await fs.mkdtemp(path.join(path.dirname(destination), '.mutagen-install-'));
     try {
       const archive = path.join(temporary, 'download.tar.gz');
-      console.error(`正在下载同步工具 Mutagen ${VERSION}（首次使用，可能需要几分钟）……`);
+      console.error('正在下载同步工具…');
       await download(`https://github.com/mutagen-io/mutagen/releases/download/v${VERSION}/${archiveName}`, archive);
       await verifyChecksum(archive, checksum);
       // Extract only the two required files from the authenticated archive.

package/src/local/browser.js

@@ -8,13 +8,14 @@ import { execute, exists, withLock } from '../system.js';
 const require = createRequire(import.meta.url);
 let preparation;
 
-export async function installBrowser(log = console.error) {
+export async function installBrowser(log = console.error, { debug = () => {} } = {}) {
   if (!preparation) preparation = (async () => {
     const cli = path.join(path.dirname(require.resolve('playwright/package.json')), 'cli.js');
     // Keep the lock outside Playwright's cache: its installer replaces browser directories.
     const lock = path.join(process.env.CLAUDE_REMOTE_CACHE_DIR || path.join(os.homedir(), '.cache', 'claude-remote'), 'browser-install');
     await withLock(lock, async () => {
-      log('正在准备本地受控浏览器（首次使用或升级时自动下载）……');
+      if (!await exists(chromium.executablePath())) log('正在下载浏览器…');
+      else debug('检查浏览器缓存：' + chromium.executablePath());
       // The CLI checks completion markers and prepares headed AND headless binaries.
       const result = await execute(process.execPath, [cli, 'install', 'chromium'], { capture: true, timeout: 600000 });
       if (!await exists(chromium.executablePath())) throw new Error('浏览器安装未完成：' + result.stderr);

package/src/local/server.js

@@ -66,7 +66,7 @@ export async function startLocalServer({ root, env = process.env, headless = fal
     register('list_processes', 'List processes owned by this tool session, not all system processes.', {}, () => processes.list(), true);
     register('stop_process', 'Stop a process group started by this tool session, including a development server.', { job_id: z.string() },
       args => processes.stop(args.job_id));
-    register('browser_open', 'Open a page in a dedicated LOCAL browser. localhost is the developer computer. Does not attach to existing browser profiles.', {
+    register('browser_open', 'Open a page in a dedicated LOCAL browser for local development, interactive UI testing, screenshots or interactive sign-in. For ordinary public research use server WebSearch/WebFetch; ask the user before falling back to this browser. localhost is the developer computer. Does not attach to existing browser profiles.', {
       url: z.string().url().or(z.literal('about:blank')).default('about:blank')
     }, args => browser.open(args.url));
     register('browser_snapshot', 'Inspect a LOCAL browser page and get visible text and selectors for interactive elements.', { page_id: pageId },

package/src/local-mode.js

@@ -38,7 +38,7 @@ export function validateLocalArguments(args) {
 
 export function localClaudeArguments(configFile, root, extra) {
   validateLocalArguments(extra);
-  return ['--restricted', '--tools', '', '--strict-mcp-config', '--mcp-config', configFile,
+  return ['--restricted', '--tools', 'WebSearch,WebFetch', '--strict-mcp-config', '--mcp-config', configFile,
     // Keep built-in UI commands (/config, /model, /help) available. Disable
     // skill shell expansion separately instead of disabling the entire menu.
     '--setting-sources', '', '--settings', JSON.stringify({ disableAllHooks: true,
@@ -46,8 +46,11 @@ export function localClaudeArguments(configFile, root, extra) {
     '--append-system-prompt', `All project operations run on the developer's LOCAL computer through the local MCP server. ` +
     `The LOCAL project root is ${JSON.stringify(root)}. The server working directory is only for session metadata, not project files. ` +
     'Call workspace_info before working. Use only local tools for file access, shell commands and browser operations. ' +
+    'For public information research, use the server-side WebSearch and WebFetch tools first; do not open the local browser for ordinary searches or reading public documentation. ' +
+    'Use the LOCAL browser for local development pages, localhost/loopback or developer LAN addresses, interactive UI testing, screenshots, or pages requiring interactive sign-in. ' +
+    'Never send local development URLs to server-side WebFetch. If WebSearch or WebFetch is unavailable or fails for ordinary public research, report it and ask before using the local browser as a fallback. ' +
     'Read LOCAL CLAUDE.md with read_file if present. Use background commands for development servers, inspect their logs, and stop owned processes when finished. ' +
-    'If the local connection fails, report it and stop tool work; never fall back to server tools.', ...extra];
+    'If the local connection fails, report it and stop local project operations; never fall back to server filesystem, shell or browser tools.', ...extra];
 }
 
 export function supportsLocalMode(output) {
@@ -63,7 +66,7 @@ export async function launchLocal(client, config, extra, dependencies = {}) {
   const root = await fs.realpath(client.cwd), home = await fs.realpath(client.home);
   if (root === home || root === path.parse(root).root) throw new Error('请进入具体项目目录，不允许以用户目录或磁盘根目录作为项目。');
   const prepareBrowser = dependencies.installBrowser || installBrowser;
-  await prepareBrowser(client.log);
+  await prepareBrowser(client.log, { debug: client.debug });
   const gateway = await (dependencies.startLocalServer || startLocalServer)({ root, env: client.env,
     headless: client.env.CLAUDE_REMOTE_HEADLESS === undefined ? Boolean(config.browserHeadless) : client.env.CLAUDE_REMOTE_HEADLESS === '1', log: client.log });
   let tunnel, configFile;
@@ -82,7 +85,7 @@ export async function launchLocal(client, config, extra, dependencies = {}) {
       headers: { Authorization: 'Bearer ' + gateway.token }, timeout: 180000 } } };
     await remote('set -e; umask 077; mkdir -p -- ' + remotePath(remoteDirectory) + '; cat > ' + remotePath(configFile),
       { input: JSON.stringify(mcp) });
-    client.log(`本地执行模式：${root}\n文件、命令和浏览器在本机运行；项目文件不通过本模式同步。`);
+    client.debug(`本地执行模式：${root}\n文件、命令和浏览器在本机运行；项目文件不通过本模式同步。`);
     const args = localClaudeArguments(path.posix.basename(configFile), root, extra);
     // Keep the parent shell so EXIT can remove the token-bearing temporary config.
     const script = remoteEnvironment + 'cd -- ' + remotePath(remoteDirectory) + ' || exit 1; ' +

package/src/ssh-auth.js

@@ -39,7 +39,7 @@ export async function ensureSSH(client, config, { enablePubkey = false } = {}) {
     const temporary = await fs.mkdtemp(path.join(base, 'ccra-'));
     const socket = path.join(temporary, 'ssh');
     try {
-      client.log('正在配置 SSH 免密登录。首次连接请确认服务器指纹，并按 SSH 提示输入服务器密码。');
+      client.log('请按提示完成 SSH 验证。');
       // Authenticate once; subsequent installation reuses this private socket.
       // Do not capture authentication output or handle passwords in JavaScript.
       await run(['-M', '-S', socket, '-o', 'ControlPersist=no', '-o', 'ControlMaster=yes',
@@ -47,7 +47,7 @@ export async function ensureSSH(client, config, { enablePubkey = false } = {}) {
       const inspect = await run(['-S', socket, config.host, 'sh -c ' + quote(sshPolicyScript({ enable: enablePubkey }))],
         { capture: true });
       const policy = parseSSHPolicy(inspect.stdout);
-      if (policy.backup) client.log('服务器公钥登录已开启，原配置备份：' + policy.backup);
+      if (policy.backup) client.log('已开启公钥登录。配置备份：' + policy.backup);
       if (policy.pubkeyauthentication === 'no')
         throw new Error('服务器关闭了公钥登录（PubkeyAuthentication no），尚未生成或添加密钥。' +
           (policy.uid === '0' ? '如需开启，请运行：claude-remote setup-ssh --enable-pubkey（备份配置、校验后重新加载，保留密码登录）。' :
@@ -58,14 +58,14 @@ export async function ensureSSH(client, config, { enablePubkey = false } = {}) {
           '，不允许仅凭公钥登录；请联系管理员确认认证策略。未修改该策略，尚未生成或添加密钥。');
       if (policy.status !== 'ok') {
         if (enablePubkey) throw new Error('无法读取服务器有效 SSH 配置，未自动修改服务器策略；请联系管理员检查。');
-        client.log('当前账号无法读取 SSH 服务策略，将尝试普通公钥授权；如失败请由管理员检查公钥登录是否开启。');
+        client.debug('无法读取服务器 SSH 策略，尝试普通公钥授权。');
       }
       const id = createHash('sha256').update(config.host + '\0' + (config.port ?? '')).digest('hex').slice(0, 20);
       const key = path.join(directory, 'id_ed25519_' + id);
       await fs.chmod(directory, 0o700);
       if (!await exists(key)) {
         if (await exists(key + '.pub')) throw new Error('专用 SSH 私钥缺失但公钥仍存在，请检查：' + key);
-        client.log('创建仅供该服务器使用的无口令 SSH 密钥，私钥保存在本机，文件权限设为仅本人可读。');
+        client.debug('创建专用 SSH 密钥：' + key);
         await client.execute('ssh-keygen', ['-q', '-t', 'ed25519', '-N', '', '-C', 'claude-remote-cli', '-f', key],
           { env: client.env, capture: true, timeout: 30000 });
       }
@@ -91,7 +91,7 @@ export async function ensureSSH(client, config, { enablePubkey = false } = {}) {
       });
       if (!previous.includes(block)) await fs.appendFile(configFile, block, { mode: 0o600 });
       if (!await probe()) throw new Error('密钥已授权，但默认 SSH 配置验证失败。请检查 ~/.ssh/config 的 IdentityFile 和 IdentitiesOnly 设置。');
-      client.log('SSH 免密登录已配置并验证成功，后续连接无需输入服务器密码。');
+      client.debug('SSH 免密登录已配置并验证成功。');
     } finally {
       await run(['-S', socket, '-O', 'exit', config.host], { capture: true, check: false, timeout: 5000 }).catch(() => {});
       await fs.rm(temporary, { recursive: true, force: true });