@znmin/claude-remote-cli 0.2.6 → 0.2.7

package/README.md

@@ -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.6.tgz
+npm install -g ./znmin-claude-remote-cli-0.2.7.tgz
 ```
 
-若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.2.6.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
+若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.2.7.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
 
 npm 中不带作用域的 `claude-remote-cli` 属于其他项目。本项目使用独立的 `@znmin/claude-remote-cli` 作用域包名；请安装完整包名，或使用上述 GitHub 地址及本项目分发的 `.tgz` 文件。
 
@@ -131,6 +131,7 @@ claude-remote configure my-server --mode local
 - 浏览器元素选择器在多次快照间保持不变；快照包含 iframe（选择器形如 `frame=1 >> …`）和开放的 Shadow DOM 元素；截图支持整页和单个元素。
 - 本地项目的 `CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md` 在启动时读取并放入系统提示（合计最多 64 KiB），不再依赖模型自行读取。
 - 关闭终端窗口（SIGHUP）或被 `kill`（SIGTERM）时也会清理浏览器、后台命令、SSH 隧道和服务器临时文件。
+- 0.2.7 起，SSH 断线等原因导致远程 Claude 异常结束时，会自动关闭它遗留的鼠标上报、焦点事件、括号粘贴和扩展键盘等终端模式，避免移动鼠标或按键时输出乱码。若仍显示异常（例如停留在全屏界面），可运行 `reset`。
 - 启动时浏览器检查与 SSH 连接并行，浏览器已就绪时不再调用 Playwright 安装程序；服务器上的版本检查和配置写入合并为一次往返。
 
 Git、npm、pnpm、Python、Go、Docker、数据库 CLI、`gh` 等共用本地终端，不需要逐项适配，仍需在本机安装并具备必要的登录、连接配置及权限。终端继承启动用户环境和登录 shell，默认工作目录为当前项目。长任务使用后台进程，再查询日志和停止；退出会话会停止仍受本工具管理的进程组，自行 daemonize 或逃离原进程组的程序不在自动清理保证内。
@@ -235,7 +236,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.6.tgz
+npm install -g ./znmin-claude-remote-cli-0.2.7.tgz
 
 # 确定包名、版本和使用条款后，使用有发布权限的 npm 账号发布
 npm login

package/package.json

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

package/src/client.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
 import { createHash, randomUUID } from 'node:crypto';
-import { execute, exists, quote, readJSON, shellJoin, which, withLock, writeJSON } from './system.js';
+import { execute, exists, quote, readJSON, restoreTerminal, shellJoin, which, withLock, writeJSON } from './system.js';
 import { ensureMutagen } from './installer.js';
 import { ensureRemoteClaude, remoteEnvironment as prefix } from './remote-claude.js';
 import { sshArgs } from './ssh.js';
@@ -67,6 +67,7 @@ export class Client {
       if (this.env.CLAUDE_REMOTE_DEBUG === '1') this.log(...messages);
     };
     this.tty = options.tty ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    this.restoreTerminal = options.restoreTerminal || (() => restoreTerminal());
   }
 
   async configure(input) {
@@ -204,6 +205,8 @@ export class Client {
     try {
       code = (await this.remote(config, prefix + 'cd -- ' + remotePath(item.remote) +
         ' && exec ' + shellJoin([config.claude, ...extra]), true)).code;
+      // A dropped connection leaves the remote UI's terminal modes switched on.
+      if (code !== 0) this.restoreTerminal();
     } finally {
       try { await this.flush(item.name); }
       catch (error) {

package/src/local-mode.js

@@ -169,7 +169,10 @@ export async function launchLocal(client, config, extra, dependencies = {}) {
     const script = remoteEnvironment + 'cd -- ' + remotePath(remoteDirectory) + ' || exit 1; ' +
       'trap ' + quote('rm -f -- ' + remotePath(configFile) + ' ' + remotePath(promptFile)) + ' EXIT; ' +
       shellJoin([config.claude, ...args]);
-    return (await remote(script, { interactive: true, check: false })).code;
+    const code = (await remote(script, { interactive: true, check: false })).code;
+    // A dropped connection leaves the remote UI's terminal modes switched on.
+    if (code !== 0) client.restoreTerminal();
+    return code;
   } finally {
     removeCleanup();
     await cleanup();

package/src/system.js

@@ -57,7 +57,7 @@ export function onCleanup(callback) {
   return () => cleanups.delete(callback);
 }
 
-export function terminate(signal, { exit = code => process.exit(code), graceMs = 10000 } = {}) {
+export function terminate(signal, { exit = code => process.exit(code), graceMs = 10000, terminal = process.stdout } = {}) {
   if (terminating) return terminating;
   const code = 128 + (os.constants.signals[signal] || 15);
   terminating = (async () => {
@@ -71,11 +71,33 @@ export function terminate(signal, { exit = code => process.exit(code), graceMs =
     for (const child of trackedChildren) {
       try { child.kill('SIGTERM'); } catch { /* already gone */ }
     }
+    restoreTerminal(terminal);
     exit(code);
   })();
   return terminating;
 }
 
+// A remote full-screen program that loses its connection cannot switch off the
+// terminal modes it enabled, so mouse moves, focus changes and keys show up as
+// stray escape codes. Every sequence here only turns a mode off and is a no-op
+// when the mode is already off. The alternate screen (?1049l) is deliberately
+// left alone: leaving it when not active can move the cursor on some terminals.
+export const TERMINAL_RESET = [
+  '\x1b[?1000l', '\x1b[?1002l', '\x1b[?1003l', '\x1b[?1005l', '\x1b[?1006l', '\x1b[?1015l', // mouse reporting
+  '\x1b[?1004l', // focus in/out events
+  '\x1b[?2004l', // bracketed paste
+  '\x1b[=0;1u', '\x1b[<99u', // kitty keyboard protocol: clear flags, pop pushed levels
+  '\x1b[>4m', // xterm modifyOtherKeys
+  '\x1b[?1l', '\x1b>', // normal cursor keys and keypad
+  '\x1b[0m', '\x1b[?25h' // plain text attributes, visible cursor
+].join('');
+
+export function restoreTerminal(stream = process.stdout) {
+  if (!stream?.isTTY) return false;
+  try { stream.write(TERMINAL_RESET); return true; }
+  catch { return false; } // The terminal may already be gone (SIGHUP).
+}
+
 export function installSignalHandlers() {
   for (const signal of ['SIGHUP', 'SIGTERM']) process.on(signal, () => { terminate(signal); });
 }