@hyzyn/dsh-tty 0.1.2 → 0.2.1

package/lib/ssh.d.ts

@@ -0,0 +1,49 @@
+import { PassThrough } from 'node:stream';
+export interface TermExit {
+    exitCode: number | null;
+    signal: string | null;
+}
+export interface TermHandle {
+    readonly kind: 'local' | 'ssh';
+    /** SSH 会话没有本地 pid，为 null。 */
+    readonly pid: number | null;
+    /** 输出流（flowing 模式消费；pause/resume 用于下行背压）。 */
+    readonly output: PassThrough;
+    /** 退出事实，恰好 resolve 一次。 */
+    readonly done: Promise<TermExit>;
+    write(data: string): Promise<unknown>;
+    resize(cols: number, rows: number): void;
+    terminate(): Promise<unknown>;
+    /** terminate 失败后的最后手段（本地 PTY：对顶层 shell 直接 SIGKILL）。 */
+    forceKill?(): void;
+}
+/** 内联 SSH 连接规格（ws 帧或连接簿条目共用）。 */
+export interface SshSpec {
+    host: string;
+    port?: number;
+    username: string;
+    auth?: 'agent' | 'key' | 'password';
+    keyPath?: string;
+    passphrase?: string;
+    password?: string;
+}
+/** 连接簿条目（带名字，存 settings）。 */
+export interface SshHostEntry extends SshSpec {
+    name: string;
+}
+export interface SshSpawnOptions {
+    term: string;
+    cols: number;
+    rows: number;
+    logger?: {
+        info(msg: string): void;
+        warn(msg: string): void;
+    };
+}
+/** 展示用目标串：user@host（非默认端口时带 :port）。 */
+export declare function sshTarget(spec: SshSpec): string;
+/**
+ * 建立 SSH 连接并打开交互 shell channel，返回 TermHandle。
+ * 失败（连接超时/认证被拒/host 不可达）时 reject 带人类可读信息。
+ */
+export declare function spawnSsh(spec: SshSpec, options: SshSpawnOptions): Promise<TermHandle>;

package/lib/ssh.js

@@ -0,0 +1,232 @@
+/**
+ * @hyzyn/dsh-tty — SSH 会话封装（方案 C：ssh2 原生集成）。
+ *
+ * 不经过本地 ssh 进程 / node-pty，直接用 ssh2 建立连接并开 shell channel，
+ * 包装成与本地 PTY 完全一致的 TermHandle 形状，TtyServer 无差别调度：
+ * input/resize/kill 上行，data/exit 下行，背压、环形缓冲、agent 工具全复用。
+ *
+ * 认证优先级由 spec.auth 决定：
+ *   agent    —— ssh-agent（SSH_AUTH_SOCK），最推荐，凭证不落盘
+ *   key      —— keyPath 私钥文件（~ 可省略 home），passphrase 可选
+ *   password —— 密码认证，同时挂 keyboard-interactive（很多服务端只开这个）
+ * password / passphrase 支持 `env:VAR` 前缀从进程环境变量取值（配合
+ * dsh-env-manager 插件托管密钥，避免明文写入 settings 文件）。
+ *
+ * 主机密钥策略：当前版本为 accept-and-log——hostVerifier 记录 sha256 指纹
+ * 后无条件放行，每次连接都接受并记录，等同于
+ * `ssh -o StrictHostKeyChecking=no`（而非 accept-new）：不做 known_hosts
+ * 钉扎，首次连接不询问，同一主机指纹变更也不会告警，因此存在被中间人
+ * （MITM）冒充的风险。loopback 围栏保证只有本机 Web GUI 能发起连接，
+ * 仅作为缓解；known_hosts 钉扎留作后续项。
+ */
+import { Client } from 'ssh2';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { PassThrough } from 'node:stream';
+/** `env:VAR` 前缀从 process.env 取值；否则原样返回。 */
+function resolveSecret(value) {
+    if (value === undefined)
+        return undefined;
+    if (!value.startsWith('env:'))
+        return value;
+    const name = value.slice(4);
+    const resolved = process.env[name];
+    if (resolved === undefined || resolved === '')
+        throw new Error(`环境变量未设置: ${name}`);
+    return resolved;
+}
+function expandHome(path) {
+    if (path === '~')
+        return homedir();
+    if (path.startsWith('~/'))
+        return join(homedir(), path.slice(2));
+    return path;
+}
+/** 展示用目标串：user@host（非默认端口时带 :port）。 */
+export function sshTarget(spec) {
+    const port = spec.port ?? 22;
+    return `${spec.username}@${spec.host}${port === 22 ? '' : ':' + String(port)}`;
+}
+/* ------------------------------------------------------------------ *
+ * 连接与 channel 包装
+ * ------------------------------------------------------------------ */
+function buildConnectConfig(spec) {
+    const auth = spec.auth ?? 'agent';
+    const base = {
+        host: spec.host,
+        port: spec.port ?? 22,
+        username: spec.username,
+        readyTimeout: 20000,
+        keepaliveInterval: 10000,
+        keepaliveCountMax: 3,
+        // accept-and-log：记录指纹后放行（见文件头策略说明）
+        hostHash: 'sha256',
+    };
+    if (auth === 'agent') {
+        base.agent = process.env.SSH_AUTH_SOCK;
+    }
+    else if (auth === 'key') {
+        if (typeof spec.keyPath !== 'string' || spec.keyPath.trim() === '') {
+            throw new Error('auth=key 需要 keyPath（私钥路径）');
+        }
+        base.privateKey = readFileSync(expandHome(spec.keyPath.trim()));
+        const passphrase = resolveSecret(spec.passphrase);
+        if (passphrase !== undefined)
+            base.passphrase = passphrase;
+    }
+    else {
+        const password = resolveSecret(spec.password);
+        if (password === undefined)
+            throw new Error('auth=password 需要 password（或 env:VAR 引用）');
+        base.password = password;
+        // 大量服务端（如部分路由器/堡垒机）只开 keyboard-interactive
+        base.tryKeyboard = true;
+    }
+    return base;
+}
+/**
+ * 建立 SSH 连接并打开交互 shell channel，返回 TermHandle。
+ * 失败（连接超时/认证被拒/host 不可达）时 reject 带人类可读信息。
+ */
+export async function spawnSsh(spec, options) {
+    const target = sshTarget(spec);
+    const logger = options.logger;
+    const conn = new Client();
+    const output = new PassThrough();
+    let exitCode = null;
+    let exitSignal = null;
+    let settleDone;
+    const done = new Promise((resolve) => {
+        settleDone = resolve;
+    });
+    let finished = false;
+    const finish = () => {
+        if (finished)
+            return;
+        finished = true;
+        try {
+            output.end();
+        }
+        catch {
+            /* 已结束 */
+        }
+        try {
+            conn.end();
+        }
+        catch {
+            /* 已断开 */
+        }
+        settleDone({ exitCode, signal: exitSignal });
+    };
+    // 认证配置可能抛错（keyPath 读不到 / env 变量缺失）——先构造再连
+    const connectConfig = buildConnectConfig(spec);
+    connectConfig.hostVerifier = (hash) => {
+        logger?.info(`[dsh-tty] ssh ${target} host key sha256:${hash}（accept-and-log 放行）`);
+        return true;
+    };
+    const channel = await new Promise((resolve, reject) => {
+        let settled = false;
+        conn.on('ready', () => {
+            conn.shell({ term: options.term, cols: options.cols, rows: options.rows }, (error, ch) => {
+                settled = true;
+                if (error !== undefined && error !== null) {
+                    conn.end();
+                    reject(new Error(`shell channel 打开失败: ${error.message}`));
+                    return;
+                }
+                resolve(ch);
+            });
+        });
+        conn.on('error', (error) => {
+            if (!settled) {
+                settled = true;
+                reject(new Error(`SSH 连接失败（${target}）: ${error.message}`));
+            }
+            else {
+                logger?.warn(`[dsh-tty] ssh ${target} 连接错误: ${error.message}`);
+                finish();
+            }
+        });
+        conn.on('close', () => {
+            finish();
+        });
+        if (connectConfig.tryKeyboard === true) {
+            const password = connectConfig.password ?? '';
+            conn.on('keyboard-interactive', (_name, _instructions, _lang, _prompts, finishKb) => {
+                finishKb([password]);
+            });
+        }
+        try {
+            conn.connect(connectConfig);
+        }
+        catch (error) {
+            reject(error instanceof Error ? error : new Error(String(error)));
+        }
+    });
+    channel.on('data', (chunk) => {
+        output.write(chunk);
+    });
+    channel.stderr.on('data', (chunk) => {
+        output.write(chunk);
+    });
+    channel.on('exit', (code, signal) => {
+        exitCode = typeof code === 'number' ? code : null;
+        exitSignal = typeof signal === 'string' ? signal : null;
+    });
+    channel.on('close', () => {
+        finish();
+    });
+    // 背压透传：TtyServer 暂停 PassThrough 时一并暂停上游 channel，
+    // 避免高速输出（cat 大文件）在 Node 侧无界堆积
+    const nativePause = output.pause.bind(output);
+    output.pause = () => {
+        try {
+            channel.pause();
+        }
+        catch {
+            /* channel 已关闭 */
+        }
+        return nativePause();
+    };
+    const nativeResume = output.resume.bind(output);
+    output.resume = () => {
+        try {
+            channel.resume();
+        }
+        catch {
+            /* channel 已关闭 */
+        }
+        return nativeResume();
+    };
+    logger?.info(`[dsh-tty] ssh 会话就绪: ${target}`);
+    return {
+        kind: 'ssh',
+        pid: null,
+        output,
+        done,
+        write: (data) => {
+            channel.write(data);
+            return Promise.resolve(true);
+        },
+        resize: (cols, rows) => {
+            try {
+                channel.setWindow(rows, cols, 0, 0);
+            }
+            catch {
+                /* channel 已关闭 */
+            }
+        },
+        terminate: () => {
+            try {
+                channel.close();
+            }
+            catch {
+                /* 已关闭 */
+            }
+            finish();
+            return Promise.resolve(true);
+        },
+    };
+}
+//# sourceMappingURL=ssh.js.map

package/lib/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../src/ssh.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hyzyn/dsh-tty",
-  "version": "0.1.2",
-  "description": "DSH Web GUI 的终端面板插件：侧边栏「终端」大弹窗，xterm.js + PTY 全交互终端（路线1）。",
+  "version": "0.2.1",
+  "description": "DSH Web GUI 的终端面板插件：侧边栏「终端」大弹窗，xterm.js + PTY 全交互终端（路线1），ssh2 原生 SSH 远程连接（方案 C）。",
   "type": "module",
   "engines": {
     "node": ">=22.19.0"
@@ -25,17 +25,22 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.7",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@hyzyn/dsh-kit": "^0.1.0",
+    "ssh2": "^1.17.0",
     "ws": "^8.18.0"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2"
+  },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
     "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.7",
     "@deepseek-ai/dsh-subprocess": "0.1.0-rc.7",
     "@deepseek-ai/dsh-subprocess-local": "0.1.0-rc.7",
     "@types/node": "^22.20.0",
+    "@types/ssh2": "^1.15.5",
     "@types/ws": "^8.5.12",
     "@xterm/addon-fit": "^0.10.0",
     "@xterm/addon-search": "^0.16.0",
@@ -44,6 +49,15 @@
     "esbuild": "^0.24.0",
     "typescript": "~5.7.2"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
+    "typecheck": "tsc --noEmit",
+    "probe": "node scripts/probe.mjs",
+    "integration": "node scripts/integration.mjs",
+    "live": "node scripts/live.mjs",
+    "tui": "node scripts/tui-smoke.mjs",
+    "ssh-smoke": "node scripts/ssh-smoke.mjs"
+  },
   "files": [
     "lib",
     "client.js",
@@ -62,13 +76,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
-    "typecheck": "tsc --noEmit",
-    "probe": "node scripts/probe.mjs",
-    "integration": "node scripts/integration.mjs",
-    "live": "node scripts/live.mjs",
-    "tui": "node scripts/tui-smoke.mjs"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 dsh-plugin-kit contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.