dsh-ssh-terminal 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.1.0] - 2026-08-29
+
+- Initial release.
+- **Agent SSH tools**: `ssh_connect` / `ssh_exec` / `ssh_disconnect` / `ssh_status`.
+- **better-sidebar tab**: registers a "SSH 终端" tab via `ctx.betterSidebar.registerTab`; opens in the sidebar pane with a live command→output transcript.
+- **Transcript UX**: timestamps per step, theme-aware colors (DSH design tokens), scroll-to-bottom only when already pinned at the bottom.
+- **Local history persistence**: the record is written to `~/.dsh/ssh-terminal-history.json` and survives restarts; a "清空记录" button clears it.
+- **Host half**: spawns `ssh -tt` via `subprocess`, keeps the transcript, registers the `/ssh-terminal/api` HTTP route through `webServer` (password prompt auto-detection, failed-login banner tolerated).
+- **Client half**: built with `tsdown` into the DSH `window.__ModuleLoader__.load` bundle format (`react` externalized).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-ssh-terminal authors
+
+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.

package/README.md

@@ -0,0 +1,59 @@
+# dsh-ssh-terminal
+
+🌏 [English](README_EN.md) · [中文](README.md)
+
+SSH 远程终端：在 `dsh-better-sidebar` 侧边栏里连接远程主机，**逐步查看 agent 输入的命令和输出**，不影响对话主流程；同时为 Agent 提供 SSH 工具。
+
+![SSH 终端面板](docs/screenshot.png)
+
+## 功能
+
+- **Better-sidebar「SSH 终端」tab**：右侧栏 `+` 菜单里出现，点击即打开面板，含连接表单 + 命令输入 + **实时命令→输出转录**（带时间戳、颜色跟随 DSH 皮肤）。
+- **多连接并行**：每次 `ssh_connect` 都会创建独立的 SSH 进程、输出缓冲和命令队列；侧边栏左侧列出各连接，点击即可切换对应转录。
+- **Agent 工具**（独立可用）：`ssh_connect` / `ssh_exec` / `ssh_disconnect` / `ssh_status` / `ssh_list`。
+- **记录持久化**：本机会话内跨重启保留（写盘到 `~/.dsh/ssh-terminal-history.json`），面板右上角「清空当前」只清理当前选中连接的记录。
+
+### 多任务调用约定
+
+并行任务必须保存 `ssh_connect` 返回的 `connectionId`，后续对同一主机的 `ssh_exec`、`ssh_status`、`ssh_disconnect` 都传入它。不同 `connectionId` 的命令可以同时执行；同一个连接内的命令会按调用顺序排队，避免写入同一个 SSH PTY 时互相串线。旧调用不传 ID 时仍兼容当前活动连接。
+
+## 依赖
+
+- DSH web（`dsh web` / DSH Desktop）
+- `dsh-better-sidebar`（>= 0.12.0）——**只有「侧边栏面板」需要它**；Agent 的 SSH 工具不依赖 better-sidebar，单独装本插件即可用。
+
+> **可选增强**：未安装 better-sidebar 时，本插件只提供 Agent 的 SSH 工具（模型可连接、执行、断开，结果在对话里看到）；不显示侧边栏「SSH 终端」面板。
+
+## 安装
+
+```sh
+dsh plugin add github:sunzhyang1616-ui/dsh-ssh-terminal
+```
+
+装完**硬刷新浏览器**（Cmd/Ctrl+Shift+R）即可（Client 改动无需重启；仅 Host 改动才需重启 DSH）。
+
+## 本地安装（源码 / link 方式）
+
+```text
+1. 让 profile 使用本包：编辑 ~/.dsh/profiles/<profile>/package.json 的 dependencies 加入
+   "dsh-ssh-terminal": "link:<本目录绝对路径>"
+2. 挂载 bundle patch（package.json 已声明 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }）
+3. 在 profile 目录执行 pnpm install
+4. 硬刷新浏览器（Cmd/Ctrl+Shift+R）
+```
+
+## 文件说明
+
+| 文件 | 说明 |
+| --- | --- |
+| `lib/index.js` | **Host 半**：按 `connectionId` 启动和隔离多个 `ssh -tt`、维护转录、注册工具 + `/ssh-terminal/api` HTTP 路由 |
+| `lib/client.js` | **Client 半**：`ctx.betterSidebar.registerTab` 注册「SSH 终端」tab + 多连接列表和独立转录 UI |
+| `src/client/index.tsx` | Client 源码（tsdown 构建入口） |
+| `tsdown.config.ts` | client 构建配置 |
+| `cordis.patch.yml` | bundle 挂载补丁 |
+
+## 限制 / 说明
+
+- SSH 连接为 Host 进程态，DSH 重启即断（连接不自动重连）；**操作记录**会本机落盘、跨重启保留。
+- 密码仅本次调用内使用，不回显、不写入转录；推荐 `identity`（私钥文件）认证。
+- 若目标 DSH 版本对已安装插件不暴露 `harness`，Host 已改用 `ctx.tools.register` + `webServer` 路由，无需 `harness`。

package/README_EN.md

@@ -0,0 +1,59 @@
+# dsh-ssh-terminal
+
+🌏 [English](README_EN.md) · [中文](README.md)
+
+An SSH terminal tab for [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar): connect to a remote host and **watch the agent's commands and output step by step**, without touching the main conversation. Also ships SSH tools for the agent.
+
+![SSH terminal panel](docs/screenshot.png)
+
+## Features
+
+- **better-sidebar "SSH 终端" tab**: appears in the sidebar `+` menu. Opens a panel with a connection form, a command input, and a **live command→output transcript** (timestamps, theme-aware colors).
+- **Concurrent connections**: every `ssh_connect` creates an isolated SSH process, output buffer, and command queue. The sidebar lists all connections and switches to the selected transcript.
+- **Agent tools** (standalone): `ssh_connect` / `ssh_exec` / `ssh_disconnect` / `ssh_status` / `ssh_list`.
+- **Local history persistence**: the record survives restarts on this machine (saved to `~/.dsh/ssh-terminal-history.json`); the "清空当前" button clears only the selected connection's history.
+
+### Multi-task usage
+
+Parallel tasks must keep the `connectionId` returned by `ssh_connect` and pass it to subsequent `ssh_exec`, `ssh_status`, and `ssh_disconnect` calls. Different connection IDs can run concurrently; commands on one connection are queued in order so they cannot interleave writes to the same SSH PTY. Calls without an ID remain compatible with the current active connection.
+
+## Dependencies
+
+- DSH web (`dsh web` / DSH Desktop)
+- `dsh-better-sidebar` (>= 0.12.0) — **only needed for the sidebar panel**; the agent SSH tools work standalone.
+
+> **Optional**: without better-sidebar, this plugin only exposes the agent SSH tools (the model can connect, run commands, disconnect, and see results in the conversation); the sidebar "SSH 终端" panel is not shown.
+
+## Install
+
+```sh
+dsh plugin add github:sunzhyang1616-ui/dsh-ssh-terminal
+```
+
+After installing, **hard-refresh** the browser (Cmd/Ctrl+Shift+R). Client changes hot-load; only Host changes need a DSH restart.
+
+## Local install (source / link)
+
+```text
+1. Let a profile use this package: add to ~/.dsh/profiles/<profile>/package.json dependencies
+   "dsh-ssh-terminal": "link:<absolute path to this dir>"
+2. The bundle patch is declared by package.json ("dsh": { "bundle": { "patch": "./cordis.patch.yml" } })
+3. Run pnpm install in the profile dir
+4. Hard-refresh the browser (Cmd/Ctrl+Shift+R)
+```
+
+## Files
+
+| File | Purpose |
+| --- | --- |
+| `lib/index.js` | **Host half**: spawns and isolates multiple `ssh -tt` sessions by `connectionId`, keeps transcripts, registers tools + `/ssh-terminal/api` HTTP route |
+| `lib/client.js` | **Client half**: registers the "SSH 终端" tab via `ctx.betterSidebar.registerTab` + connection list and isolated transcript UI |
+| `src/client/index.tsx` | Client source (tsdown build entry) |
+| `tsdown.config.ts` | client build config |
+| `cordis.patch.yml` | bundle mount patch |
+
+## Limitations / Notes
+
+- The SSH connection is Host-process state; it drops on DSH restart (no auto-reconnect). The **operation record** is persisted locally and survives restarts.
+- Passwords are used only for that call and are never echoed or written to the transcript; prefer `identity` (private key file) auth.
+- The Host half uses `ctx.tools.register` + a `webServer` route (no `harness`), so it works for installed plugins.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-ssh-terminal bundle mount
+- insert:
+    - id: ssh-terminal
+      name: dsh-ssh-terminal

package/lib/client.js

@@ -0,0 +1,278 @@
+window.__ModuleLoader__.load({
+	id: "dsh-ssh-terminal",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		//#region src/client/index.tsx
+		const API = "/ssh-terminal/api";
+		function fmt(ts) {
+			const d = new Date(ts);
+			const p = (n) => String(n).padStart(2, "0");
+			return p(d.getHours()) + ":" + p(d.getMinutes()) + ":" + p(d.getSeconds());
+		}
+		const SSH_CSS = `
+.dshssh-body{display:flex;flex-direction:column;gap:8px;height:100%;box-sizing:border-box;padding:10px;color:var(--dsw-alias-label-primary,inherit);}
+.dshssh-head{display:flex;align-items:center;gap:8px;}
+.dshssh-title{font-weight:700;flex:1;}
+.dshssh-status{font-weight:600;}
+.dshssh-status.ok{color:var(--dsw-alias-state-success-primary,#22c55e);}
+.dshssh-status.off{color:var(--dsw-alias-label-tertiary,#94a3b8);}
+.dshssh-layout{display:flex;gap:8px;flex:1;min-height:0;}
+.dshssh-sessions{width:150px;min-width:125px;display:flex;flex-direction:column;gap:6px;min-height:0;}
+.dshssh-session-title{font-size:11px;font-weight:700;color:var(--dsw-alias-label-secondary,#d1d5db);}
+.dshssh-session-list{display:flex;flex-direction:column;gap:5px;overflow:auto;min-height:0;}
+.dshssh-session{display:flex;align-items:center;gap:6px;width:100%;padding:6px 7px;text-align:left;border-radius:7px;border:1px solid transparent;background:var(--dsw-alias-bg-layer-2,rgba(148,163,184,.08));color:var(--dsw-alias-label-primary,inherit);cursor:pointer;font-size:11px;}
+.dshssh-session:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(148,163,184,.15));}
+.dshssh-session.selected{border-color:var(--dsw-alias-accent,#60a5fa);}
+.dshssh-session-dot{width:7px;height:7px;flex:0 0 7px;border-radius:50%;background:var(--dsw-alias-label-tertiary,#94a3b8);}
+.dshssh-session-dot.ok{background:var(--dsw-alias-state-success-primary,#22c55e);}
+.dshssh-session-copy{min-width:0;display:flex;flex-direction:column;gap:2px;}
+.dshssh-session-name,.dshssh-session-meta{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
+.dshssh-session-name{font-weight:600;}
+.dshssh-session-meta{color:var(--dsw-alias-label-tertiary,#94a3b8);font-size:10px;}
+.dshssh-empty{padding:6px;color:var(--dsw-alias-label-tertiary,#94a3b8);font-size:11px;}
+.dshssh-main{display:flex;flex-direction:column;gap:8px;flex:1;min-width:0;min-height:0;}
+.dshssh-form{display:flex;flex-wrap:wrap;gap:6px;align-items:center;}
+.dshssh-input{padding:4px 7px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(148,163,184,.4));background:var(--dsw-alias-bg-layer-3,rgba(2,6,23,.5));color:var(--dsw-alias-label-primary,inherit);font-size:12px;min-width:70px;}
+.dshssh-input::placeholder{color:var(--dsw-alias-label-tertiary,#94a3b8);}
+.dshssh-btn{padding:4px 10px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(148,163,184,.4));background:var(--dsw-alias-interactive-bg-hover,rgba(148,163,184,.15));color:var(--dsw-alias-label-primary,inherit);cursor:pointer;font-size:12px;}
+.dshssh-btn:hover{background:var(--dsw-alias-interactive-bg-active,rgba(148,163,184,.28));}
+.dshssh-btn:disabled{opacity:.5;cursor:default;}
+.dshssh-log{flex:1;min-height:120px;overflow:auto;background:var(--dsw-alias-bg-layer-1,rgba(2,6,23,.55));border:1px solid var(--dsw-alias-border-l2,rgba(148,163,184,.25));border-radius:8px;padding:8px;font-family:var(--dsw-font-mono,ui-monospace,SFMono-Regular,Menlo,Consolas,monospace);font-size:12px;line-height:1.45;white-space:pre-wrap;word-break:break-word;}
+.dshssh-step{margin:0 0 6px;}
+.dshssh-cmd{color:var(--dsw-alias-accent,#93c5fd);}
+.dshssh-cmd::before{content:"❯ ";color:var(--dsw-alias-accent,#60a5fa);}
+.dshssh-out{color:var(--dsw-alias-label-secondary,#d1d5db);}
+.dshssh-connect{color:var(--dsw-alias-state-success-primary,#86efac);}
+.dshssh-disconnect{color:var(--dsw-alias-state-error-primary,#fca5a5);}
+.dshssh-system{color:var(--dsw-alias-label-tertiary,#94a3b8);font-style:italic;}
+.dshssh-err{color:var(--dsw-alias-state-error-primary,#fca5a5);}
+`;
+		async function callApi(action, extra = void 0) {
+			return await (await fetch(API, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					action,
+					...extra || {}
+				})
+			})).json();
+		}
+		function injectCss() {
+			if (typeof document === "undefined") return;
+			if (document.querySelector("style[data-plugin-css=\"dsh-ssh-terminal\"]")) return;
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "dsh-ssh-terminal";
+			tag.dataset.pluginCss = "dsh-ssh-terminal";
+			tag.textContent = SSH_CSS;
+			document.head.appendChild(tag);
+		}
+		function SshBody(props) {
+			const ctx = props.ctx;
+			const visible = props.visible === void 0 ? true : props.visible;
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [err, setErr] = (0, react.useState)("");
+			const [hostV, setHostV] = (0, react.useState)("");
+			const [userV, setUserV] = (0, react.useState)("");
+			const [portV, setPortV] = (0, react.useState)("22");
+			const [passV, setPassV] = (0, react.useState)("");
+			const [cmdV, setCmdV] = (0, react.useState)("");
+			const [sessions, setSessions] = (0, react.useState)([]);
+			const [connectionId, setConnectionId] = (0, react.useState)("");
+			const [connected, setConnected] = (0, react.useState)(false);
+			const [target, setTarget] = (0, react.useState)("");
+			const [steps, setSteps] = (0, react.useState)([]);
+			const [logEl, setLogEl] = (0, react.useState)(null);
+			const refreshSeq = (0, react.useRef)(0);
+			const selectedSession = sessions.find((s) => s.connectionId === connectionId);
+			const canRun = connected && !!selectedSession && !!selectedSession.connected;
+			async function refresh(preferredId) {
+				const seq = ++refreshSeq.current;
+				try {
+					const list = await callApi("list");
+					if (seq !== refreshSeq.current) return;
+					const nextSessions = Array.isArray(list && list.sessions) ? list.sessions : [];
+					setSessions(nextSessions);
+					const preferred = preferredId || connectionId;
+					const selected = nextSessions.some((s) => s.connectionId === preferred) ? preferred : list && list.activeConnectionId && nextSessions.some((s) => s.connectionId === list.activeConnectionId) ? list.activeConnectionId : (nextSessions.find((s) => s.connected) || nextSessions[0] || {}).connectionId || "";
+					if (selected !== connectionId) setConnectionId(selected);
+					if (!selected) {
+						if (seq !== refreshSeq.current) return;
+						setConnected(false);
+						setTarget("");
+						setSteps([]);
+						return;
+					}
+					const t = await callApi("status", { connectionId: selected });
+					if (seq !== refreshSeq.current) return;
+					setConnected(!!(t && t.connected));
+					setTarget(t && t.target || "");
+					setSteps(t && t.steps || []);
+				} catch (e) {}
+			}
+			(0, react.useEffect)(() => {
+				injectCss();
+				if (visible === false) {
+					refreshSeq.current += 1;
+					return;
+				}
+				refresh(connectionId);
+				const stop = ctx.interval(() => refresh(connectionId), 600);
+				return () => {
+					refreshSeq.current += 1;
+					try {
+						stop();
+					} catch (e) {}
+				};
+			}, [visible, connectionId]);
+			(0, react.useEffect)(() => {
+				const el = logEl;
+				if (!el) return;
+				if (el.scrollTop + el.clientHeight >= el.scrollHeight - 40) el.scrollTop = el.scrollHeight;
+			}, [steps, logEl]);
+			async function connect() {
+				setBusy(true);
+				setErr("");
+				try {
+					const r = await callApi("connect", {
+						host: hostV,
+						user: userV,
+						port: Number(portV) || 22,
+						password: passV || void 0
+					});
+					if (r && r.error) setErr(String(r.error));
+					await refresh(r && r.connectionId);
+				} catch (e) {
+					setErr(String(e && e.message || e));
+				} finally {
+					setBusy(false);
+				}
+			}
+			async function run() {
+				setBusy(true);
+				setErr("");
+				try {
+					const r = await callApi("exec", {
+						connectionId,
+						command: cmdV,
+						waitMs: 15e3
+					});
+					if (r && r.error) setErr(String(r.error));
+					await refresh(connectionId);
+				} catch (e) {
+					setErr(String(e && e.message || e));
+				} finally {
+					setBusy(false);
+				}
+			}
+			async function disconnect() {
+				setBusy(true);
+				setErr("");
+				try {
+					await callApi("disconnect", { connectionId });
+					await refresh(connectionId);
+				} catch (e) {
+					setErr(String(e && e.message || e));
+				} finally {
+					setBusy(false);
+				}
+			}
+			async function clearHistory() {
+				try {
+					if (window.confirm("确定清空当前连接的 SSH 操作记录吗？")) {
+						await callApi("clear", connectionId ? { connectionId } : void 0);
+						await refresh(connectionId);
+					}
+				} catch (e) {
+					setErr(String(e && e.message || e));
+				}
+			}
+			const onKey = (e) => {
+				if (e.key === "Enter" && canRun && !busy) run();
+			};
+			const status = connected ? "● " + target : selectedSession ? selectedSession.exited ? "○ 已退出" : "○ 未连接" : "○ 未选择连接";
+			return (0, react.createElement)("div", { className: "dshssh-body" }, (0, react.createElement)("div", { className: "dshssh-head" }, (0, react.createElement)("span", { className: "dshssh-title" }, "SSH 远程终端"), (0, react.createElement)("span", { className: "dshssh-status " + (connected ? "ok" : "off") }, status), (0, react.createElement)("button", {
+				className: "dshssh-btn dshssh-clear",
+				onClick: clearHistory
+			}, "清空当前")), (0, react.createElement)("div", { className: "dshssh-layout" }, (0, react.createElement)("div", { className: "dshssh-sessions" }, (0, react.createElement)("div", { className: "dshssh-session-title" }, "连接列表 (" + sessions.length + ")"), (0, react.createElement)("div", { className: "dshssh-session-list" }, sessions.length ? sessions.map((s) => (0, react.createElement)("button", {
+				key: s.connectionId,
+				className: "dshssh-session" + (s.connectionId === connectionId ? " selected" : ""),
+				onClick: () => {
+					setConnectionId(s.connectionId);
+					setErr("");
+				}
+			}, (0, react.createElement)("span", { className: "dshssh-session-dot" + (s.connected ? " ok" : "") }), (0, react.createElement)("span", { className: "dshssh-session-copy" }, (0, react.createElement)("span", { className: "dshssh-session-name" }, s.label || s.target || "SSH 连接"), (0, react.createElement)("span", { className: "dshssh-session-meta" }, s.connected ? s.busy ? "执行中" : "已连接" : s.historical ? "历史记录" : "已断开")))) : (0, react.createElement)("div", { className: "dshssh-empty" }, "暂无连接"))), (0, react.createElement)("div", { className: "dshssh-main" }, (0, react.createElement)("div", { className: "dshssh-form" }, (0, react.createElement)("input", {
+				className: "dshssh-input",
+				placeholder: "主机",
+				value: hostV,
+				onChange: (e) => setHostV(e.target.value)
+			}), (0, react.createElement)("input", {
+				className: "dshssh-input",
+				placeholder: "用户",
+				value: userV,
+				onChange: (e) => setUserV(e.target.value)
+			}), (0, react.createElement)("input", {
+				className: "dshssh-input",
+				style: { width: 54 },
+				placeholder: "端口",
+				value: portV,
+				onChange: (e) => setPortV(e.target.value)
+			}), (0, react.createElement)("input", {
+				className: "dshssh-input",
+				style: { width: 96 },
+				type: "password",
+				placeholder: "密码(可选)",
+				value: passV,
+				onChange: (e) => setPassV(e.target.value)
+			}), (0, react.createElement)("button", {
+				className: "dshssh-btn",
+				disabled: busy,
+				onClick: connect
+			}, "新建连接")), (0, react.createElement)("div", { className: "dshssh-form" }, (0, react.createElement)("input", {
+				className: "dshssh-input dshssh-cmdline",
+				style: { flex: 1 },
+				placeholder: "输入命令后回车或点执行",
+				value: cmdV,
+				onChange: (e) => setCmdV(e.target.value),
+				onKeyDown: onKey
+			}), (0, react.createElement)("button", {
+				className: "dshssh-btn",
+				disabled: busy || !canRun,
+				onClick: run
+			}, "执行"), (0, react.createElement)("button", {
+				className: "dshssh-btn",
+				disabled: busy || !canRun,
+				onClick: disconnect
+			}, "断开")), (0, react.createElement)("div", {
+				className: "dshssh-log",
+				ref: (el) => setLogEl(el)
+			}, steps.length ? steps.map((s, i) => (0, react.createElement)("div", {
+				key: i,
+				className: "dshssh-step dshssh-" + s.kind
+			}, fmt(s.ts) + "  " + s.text)) : (0, react.createElement)("div", { className: "dshssh-step dshssh-system" }, "还没有操作。")), err ? (0, react.createElement)("div", { className: "dshssh-err" }, String(err)) : null)));
+		}
+		const inject = ["timer", "betterSidebar"];
+		function apply(ctx) {
+			const bs = ctx.get("betterSidebar");
+			if (!bs) return;
+			ctx.effect(() => bs.registerTab({
+				id: "ssh-remote:terminal",
+				title: "SSH 终端",
+				order: 60,
+				single: true,
+				component: (p) => (0, react.createElement)(SshBody, {
+					ctx,
+					visible: p.visible
+				})
+			}));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useState","useRef","createElement"],"sources":["../src/client/index.tsx"],"sourcesContent":["import { createElement, useState, useEffect, useRef } from 'react'\n\nconst API = '/ssh-terminal/api'\n\nfunction fmt(ts) {\n  const d = new Date(ts)\n  const p = (n) => String(n).padStart(2, '0')\n  return p(d.getHours()) + ':' + p(d.getMinutes()) + ':' + p(d.getSeconds())\n}\n\nconst SSH_CSS = `\n.dshssh-body{display:flex;flex-direction:column;gap:8px;height:100%;box-sizing:border-box;padding:10px;color:var(--dsw-alias-label-primary,inherit);}\n.dshssh-head{display:flex;align-items:center;gap:8px;}\n.dshssh-title{font-weight:700;flex:1;}\n.dshssh-status{font-weight:600;}\n.dshssh-status.ok{color:var(--dsw-alias-state-success-primary,#22c55e);}\n.dshssh-status.off{color:var(--dsw-alias-label-tertiary,#94a3b8);}\n.dshssh-layout{display:flex;gap:8px;flex:1;min-height:0;}\n.dshssh-sessions{width:150px;min-width:125px;display:flex;flex-direction:column;gap:6px;min-height:0;}\n.dshssh-session-title{font-size:11px;font-weight:700;color:var(--dsw-alias-label-secondary,#d1d5db);}\n.dshssh-session-list{display:flex;flex-direction:column;gap:5px;overflow:auto;min-height:0;}\n.dshssh-session{display:flex;align-items:center;gap:6px;width:100%;padding:6px 7px;text-align:left;border-radius:7px;border:1px solid transparent;background:var(--dsw-alias-bg-layer-2,rgba(148,163,184,.08));color:var(--dsw-alias-label-primary,inherit);cursor:pointer;font-size:11px;}\n.dshssh-session:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(148,163,184,.15));}\n.dshssh-session.selected{border-color:var(--dsw-alias-accent,#60a5fa);}\n.dshssh-session-dot{width:7px;height:7px;flex:0 0 7px;border-radius:50%;background:var(--dsw-alias-label-tertiary,#94a3b8);}\n.dshssh-session-dot.ok{background:var(--dsw-alias-state-success-primary,#22c55e);}\n.dshssh-session-copy{min-width:0;display:flex;flex-direction:column;gap:2px;}\n.dshssh-session-name,.dshssh-session-meta{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}\n.dshssh-session-name{font-weight:600;}\n.dshssh-session-meta{color:var(--dsw-alias-label-tertiary,#94a3b8);font-size:10px;}\n.dshssh-empty{padding:6px;color:var(--dsw-alias-label-tertiary,#94a3b8);font-size:11px;}\n.dshssh-main{display:flex;flex-direction:column;gap:8px;flex:1;min-width:0;min-height:0;}\n.dshssh-form{display:flex;flex-wrap:wrap;gap:6px;align-items:center;}\n.dshssh-input{padding:4px 7px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(148,163,184,.4));background:var(--dsw-alias-bg-layer-3,rgba(2,6,23,.5));color:var(--dsw-alias-label-primary,inherit);font-size:12px;min-width:70px;}\n.dshssh-input::placeholder{color:var(--dsw-alias-label-tertiary,#94a3b8);}\n.dshssh-btn{padding:4px 10px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(148,163,184,.4));background:var(--dsw-alias-interactive-bg-hover,rgba(148,163,184,.15));color:var(--dsw-alias-label-primary,inherit);cursor:pointer;font-size:12px;}\n.dshssh-btn:hover{background:var(--dsw-alias-interactive-bg-active,rgba(148,163,184,.28));}\n.dshssh-btn:disabled{opacity:.5;cursor:default;}\n.dshssh-log{flex:1;min-height:120px;overflow:auto;background:var(--dsw-alias-bg-layer-1,rgba(2,6,23,.55));border:1px solid var(--dsw-alias-border-l2,rgba(148,163,184,.25));border-radius:8px;padding:8px;font-family:var(--dsw-font-mono,ui-monospace,SFMono-Regular,Menlo,Consolas,monospace);font-size:12px;line-height:1.45;white-space:pre-wrap;word-break:break-word;}\n.dshssh-step{margin:0 0 6px;}\n.dshssh-cmd{color:var(--dsw-alias-accent,#93c5fd);}\n.dshssh-cmd::before{content:\"❯ \";color:var(--dsw-alias-accent,#60a5fa);}\n.dshssh-out{color:var(--dsw-alias-label-secondary,#d1d5db);}\n.dshssh-connect{color:var(--dsw-alias-state-success-primary,#86efac);}\n.dshssh-disconnect{color:var(--dsw-alias-state-error-primary,#fca5a5);}\n.dshssh-system{color:var(--dsw-alias-label-tertiary,#94a3b8);font-style:italic;}\n.dshssh-err{color:var(--dsw-alias-state-error-primary,#fca5a5);}\n`\n\nasync function callApi(action, extra = undefined) {\n  const res = await fetch(API, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body: JSON.stringify({ action, ...(extra || {}) }),\n  })\n  return await res.json()\n}\n\nfunction injectCss() {\n  if (typeof document === 'undefined') return\n  if (document.querySelector('style[data-plugin-css=\"dsh-ssh-terminal\"]')) return\n  const tag = document.createElement('style')\n  tag.dataset.plugin = 'dsh-ssh-terminal'\n  tag.dataset.pluginCss = 'dsh-ssh-terminal'\n  tag.textContent = SSH_CSS\n  document.head.appendChild(tag)\n}\n\nfunction SshBody(props) {\n  const ctx = props.ctx\n  const visible = props.visible === undefined ? true : props.visible\n  const [busy, setBusy] = useState(false)\n  const [err, setErr] = useState('')\n  const [hostV, setHostV] = useState('')\n  const [userV, setUserV] = useState('')\n  const [portV, setPortV] = useState('22')\n  const [passV, setPassV] = useState('')\n  const [cmdV, setCmdV] = useState('')\n  const [sessions, setSessions] = useState([])\n  const [connectionId, setConnectionId] = useState('')\n  const [connected, setConnected] = useState(false)\n  const [target, setTarget] = useState('')\n  const [steps, setSteps] = useState([])\n  const [logEl, setLogEl] = useState(null)\n  const refreshSeq = useRef(0)\n\n  const selectedSession = sessions.find((s) => s.connectionId === connectionId)\n  const canRun = connected && !!selectedSession && !!selectedSession.connected\n\n  async function refresh(preferredId) {\n    const seq = ++refreshSeq.current\n    try {\n      const list = await callApi('list')\n      if (seq !== refreshSeq.current) return\n      const nextSessions = Array.isArray(list && list.sessions) ? list.sessions : []\n      setSessions(nextSessions)\n      const preferred = preferredId || connectionId\n      const selected = nextSessions.some((s) => s.connectionId === preferred)\n        ? preferred\n        : (list && list.activeConnectionId && nextSessions.some((s) => s.connectionId === list.activeConnectionId)\n          ? list.activeConnectionId\n          : ((nextSessions.find((s) => s.connected) || nextSessions[0] || {}).connectionId || ''))\n      if (selected !== connectionId) setConnectionId(selected)\n      if (!selected) {\n        if (seq !== refreshSeq.current) return\n        setConnected(false)\n        setTarget('')\n        setSteps([])\n        return\n      }\n      const t = await callApi('status', { connectionId: selected })\n      if (seq !== refreshSeq.current) return\n      setConnected(!!(t && t.connected))\n      setTarget((t && t.target) || '')\n      setSteps((t && t.steps) || [])\n    } catch (e) {}\n  }\n\n  useEffect(() => {\n    injectCss()\n    if (visible === false) { refreshSeq.current += 1; return }\n    refresh(connectionId)\n    const stop = ctx.interval(() => refresh(connectionId), 600)\n    return () => {\n      refreshSeq.current += 1\n      try { stop() } catch (e) {}\n    }\n  }, [visible, connectionId])\n\n  useEffect(() => {\n    const el = logEl\n    if (!el) return\n    const nearBottom = el.scrollTop + el.clientHeight >= el.scrollHeight - 40\n    if (nearBottom) el.scrollTop = el.scrollHeight\n  }, [steps, logEl])\n\n  async function connect() {\n    setBusy(true); setErr('')\n    try {\n      const r = await callApi('connect', { host: hostV, user: userV, port: Number(portV) || 22, password: passV || undefined })\n      if (r && r.error) setErr(String(r.error))\n      await refresh(r && r.connectionId)\n    }\n    catch (e) { setErr(String((e && e.message) || e)) } finally { setBusy(false) }\n  }\n  async function run() {\n    setBusy(true); setErr('')\n    try {\n      const r = await callApi('exec', { connectionId, command: cmdV, waitMs: 15000 })\n      if (r && r.error) setErr(String(r.error))\n      await refresh(connectionId)\n    }\n    catch (e) { setErr(String((e && e.message) || e)) } finally { setBusy(false) }\n  }\n  async function disconnect() {\n    setBusy(true); setErr('')\n    try { await callApi('disconnect', { connectionId }); await refresh(connectionId) }\n    catch (e) { setErr(String((e && e.message) || e)) } finally { setBusy(false) }\n  }\n  async function clearHistory() {\n    try {\n      if (window.confirm('确定清空当前连接的 SSH 操作记录吗？')) {\n        await callApi('clear', connectionId ? { connectionId } : undefined)\n        await refresh(connectionId)\n      }\n    } catch (e) { setErr(String((e && e.message) || e)) }\n  }\n\n  const onKey = (e) => { if (e.key === 'Enter' && canRun && !busy) run() }\n  const status = connected ? ('● ' + target) : (selectedSession ? (selectedSession.exited ? '○ 已退出' : '○ 未连接') : '○ 未选择连接')\n\n  return createElement('div', { className: 'dshssh-body' },\n    createElement('div', { className: 'dshssh-head' },\n      createElement('span', { className: 'dshssh-title' }, 'SSH 远程终端'),\n      createElement('span', { className: 'dshssh-status ' + (connected ? 'ok' : 'off') }, status),\n      createElement('button', { className: 'dshssh-btn dshssh-clear', onClick: clearHistory }, '清空当前'),\n    ),\n    createElement('div', { className: 'dshssh-layout' },\n      createElement('div', { className: 'dshssh-sessions' },\n        createElement('div', { className: 'dshssh-session-title' }, '连接列表 (' + sessions.length + ')'),\n        createElement('div', { className: 'dshssh-session-list' },\n          sessions.length\n            ? sessions.map((s) => createElement('button', {\n              key: s.connectionId,\n              className: 'dshssh-session' + (s.connectionId === connectionId ? ' selected' : ''),\n              onClick: () => { setConnectionId(s.connectionId); setErr('') },\n            },\n            createElement('span', { className: 'dshssh-session-dot' + (s.connected ? ' ok' : '') }),\n            createElement('span', { className: 'dshssh-session-copy' },\n              createElement('span', { className: 'dshssh-session-name' }, s.label || s.target || 'SSH 连接'),\n              createElement('span', { className: 'dshssh-session-meta' }, s.connected ? (s.busy ? '执行中' : '已连接') : (s.historical ? '历史记录' : '已断开')),\n            )))\n            : createElement('div', { className: 'dshssh-empty' }, '暂无连接'),\n        ),\n      ),\n      createElement('div', { className: 'dshssh-main' },\n        createElement('div', { className: 'dshssh-form' },\n          createElement('input', { className: 'dshssh-input', placeholder: '主机', value: hostV, onChange: (e) => setHostV(e.target.value) }),\n          createElement('input', { className: 'dshssh-input', placeholder: '用户', value: userV, onChange: (e) => setUserV(e.target.value) }),\n          createElement('input', { className: 'dshssh-input', style: { width: 54 }, placeholder: '端口', value: portV, onChange: (e) => setPortV(e.target.value) }),\n          createElement('input', { className: 'dshssh-input', style: { width: 96 }, type: 'password', placeholder: '密码(可选)', value: passV, onChange: (e) => setPassV(e.target.value) }),\n          createElement('button', { className: 'dshssh-btn', disabled: busy, onClick: connect }, '新建连接'),\n        ),\n        createElement('div', { className: 'dshssh-form' },\n          createElement('input', { className: 'dshssh-input dshssh-cmdline', style: { flex: 1 }, placeholder: '输入命令后回车或点执行', value: cmdV, onChange: (e) => setCmdV(e.target.value), onKeyDown: onKey }),\n          createElement('button', { className: 'dshssh-btn', disabled: busy || !canRun, onClick: run }, '执行'),\n          createElement('button', { className: 'dshssh-btn', disabled: busy || !canRun, onClick: disconnect }, '断开'),\n        ),\n        createElement('div', { className: 'dshssh-log', ref: (el) => setLogEl(el) },\n          steps.length\n            ? steps.map((s, i) => createElement('div', { key: i, className: 'dshssh-step dshssh-' + s.kind }, (fmt(s.ts) + '  ' + s.text)))\n            : createElement('div', { className: 'dshssh-step dshssh-system' }, '还没有操作。'),\n        ),\n        err ? createElement('div', { className: 'dshssh-err' }, String(err)) : null,\n      ),\n    ),\n  )\n}\n\nexport const inject = ['timer', 'betterSidebar']\n\nexport function apply(ctx) {\n  const bs = ctx.get('betterSidebar')\n  if (!bs) return\n  ctx.effect(() => bs.registerTab({\n    id: 'ssh-remote:terminal',\n    title: 'SSH 终端',\n    order: 60,\n    single: true,\n    component: (p) => createElement(SshBody, { ctx, visible: p.visible }),\n  }))\n}\n"],"mappings":"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"}

package/lib/index.js

@@ -0,0 +1,497 @@
+// dsh-ssh-terminal — Host half
+// Open one isolated interactive SSH session per connectionId, expose agent
+// tools (via the tools service) and an HTTP route (via webServer) that the
+// better-sidebar tab uses for connect/exec/disconnect/status.
+import { randomUUID } from 'node:crypto'
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+
+export const inject = ['timer', 'subprocess', 'webServer', 'tools']
+
+export function apply(ctx) {
+  const fs = ctx.get('fs')
+  const sessions = new Map()
+  const connectionMeta = new Map()
+  const HISTORY_PATH = join(homedir(), '.dsh', 'ssh-terminal-history.json')
+  const MAX_HISTORY = 1200
+  const MAX_STEPS = 600
+  const LEGACY_SESSION_ID = 'legacy'
+  let history = []
+  try {
+    const raw = readFileSync(HISTORY_PATH, 'utf8')
+    const parsed = JSON.parse(raw)
+    if (Array.isArray(parsed)) {
+      history = parsed.map((entry) => ({
+        connectionId: entry && entry.connectionId ? String(entry.connectionId) : LEGACY_SESSION_ID,
+        kind: entry && entry.kind ? String(entry.kind) : 'system',
+        text: entry && entry.text != null ? String(entry.text) : '',
+        ts: entry && Number(entry.ts) ? Number(entry.ts) : Date.now(),
+        ...(entry && entry.target ? { target: String(entry.target) } : {}),
+        ...(entry && entry.label ? { label: String(entry.label) } : {}),
+      }))
+    }
+  } catch (e) {}
+  if (history.length > MAX_HISTORY) history = history.slice(-MAX_HISTORY)
+
+  let activeSessionId = null
+  let lastTarget = ''
+  function persist() {
+    try {
+      mkdirSync(dirname(HISTORY_PATH), { recursive: true })
+      writeFileSync(HISTORY_PATH, JSON.stringify(history))
+    } catch (e) {}
+  }
+
+  function ensureMeta(connectionId) {
+    let meta = connectionMeta.get(connectionId)
+    if (!meta) {
+      meta = { connectionId, target: '', label: '', connected: false, lastActivityAt: 0 }
+      connectionMeta.set(connectionId, meta)
+    }
+    return meta
+  }
+
+  for (const event of history) {
+    const meta = ensureMeta(event.connectionId)
+    if (event.target) meta.target = event.target
+    if (event.label) meta.label = event.label
+    meta.lastActivityAt = Math.max(meta.lastActivityAt, event.ts)
+    meta.connected = false
+  }
+
+  function cleanStream(s) {
+    s = String(s)
+    s = s.replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
+    s = s.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, '')
+    s = s.replace(/\x1b[PX^_][^\x1b]*\x1b\\/g, '')
+    s = s.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, '')
+    return s
+  }
+
+  function appendStep(connectionId, kind, text, extra) {
+    const event = {
+      connectionId: connectionId || LEGACY_SESSION_ID,
+      kind,
+      text: String(text),
+      ts: Date.now(),
+      ...(extra && extra.target ? { target: String(extra.target) } : {}),
+      ...(extra && extra.label ? { label: String(extra.label) } : {}),
+    }
+    history.push(event)
+    if (history.length > MAX_HISTORY) history = history.slice(-MAX_HISTORY)
+
+    const meta = ensureMeta(event.connectionId)
+    if (event.target) meta.target = event.target
+    if (event.label) meta.label = event.label
+    meta.lastActivityAt = event.ts
+    if (kind === 'connect') meta.connected = true
+    if (kind === 'disconnect') meta.connected = false
+    persist()
+  }
+
+  function startDrain(s) {
+    const decoder = new TextDecoder()
+    const run = (async () => {
+      try {
+        for await (const chunk of s.handle.output) {
+          if (s.drainState.stopped || sessions.get(s.connectionId) !== s) break
+          const text = cleanStream(decoder.decode(chunk, { stream: true }))
+          if (!text) continue
+          s.log += text
+          s.lastActivityAt = Date.now()
+          tryPassword(s)
+        }
+      } catch (e) { try { console.error('ssh output stream error', e) } catch (e2) {} }
+      if (sessions.get(s.connectionId) === s && !s.drainState.stopped) {
+        s.exited = true
+        s.connected = false
+        const meta = ensureMeta(s.connectionId)
+        meta.connected = false
+        meta.lastActivityAt = Date.now()
+      }
+    })()
+    return run
+  }
+
+  function tail(s, n) { return s ? s.log.slice(-n) : '' }
+
+  function tryPassword(s) {
+    if (!s || !s.passwordPending || s.passwordSent) return
+    const t = s.log.trimEnd()
+    if (/password\s*:\s*$/i.test(t) || /password.*:\s*$/i.test(t.slice(-90))) {
+      const p = s.passwordPending
+      s.passwordPending = null
+      s.passwordSent = true
+      if (s.handle) s.handle.write(p + '\n').catch(() => {})
+    }
+  }
+
+  function makeConnectionId() { return 'ssh-' + randomUUID() }
+
+  function resolveConnectionId(value, allowHistorical) {
+    const requested = value == null || value === '' ? null : String(value)
+    if (requested) {
+      if (sessions.has(requested)) return requested
+      if (allowHistorical && connectionMeta.has(requested)) return requested
+      throw new Error('unknown SSH connection: ' + requested)
+    }
+
+    const active = activeSessionId ? sessions.get(activeSessionId) : null
+    if (active && (allowHistorical || (active.connected && !active.exited))) return activeSessionId
+    for (const [connectionId, s] of sessions) {
+      if (s.connected && !s.exited) {
+        activeSessionId = connectionId
+        return connectionId
+      }
+    }
+    return null
+  }
+
+  async function doConnect(opts) {
+    opts = opts || {}
+    const host = opts.host, user = opts.user, port = opts.port || 22
+    if (!host || !user) throw new Error('ssh_connect requires host and user')
+
+    const connectionId = opts.connectionId ? String(opts.connectionId) : makeConnectionId()
+    if (sessions.has(connectionId)) await doDisconnect(connectionId)
+
+    let sshBin = 'ssh'
+    try { sshBin = await ctx.subprocess.resolveExecutable('ssh') }
+    catch (e) { throw new Error('ssh executable not found: ' + ((e && e.message) || e)) }
+    const argv = [sshBin, '-tt', '-o', 'StrictHostKeyChecking=accept-new', '-o', 'ConnectTimeout=20']
+    if (port && String(port) !== '22') argv.push('-p', String(port))
+    if (opts.identity) argv.push('-i', String(opts.identity))
+    argv.push(user + '@' + host)
+    let cwd = '.'
+    try {
+      if (fs) { const t = await fs.resolve('.', {}); const p = fs.processPath(t); if (p) cwd = p }
+    } catch (e) {}
+    let handle
+    try { handle = await ctx.subprocess.spawnTerminal({ argv, cwd, rows: 30, cols: 120, graceMs: 5000 }) }
+    catch (e) { throw new Error('failed to spawn ssh: ' + ((e && e.message) || e)) }
+
+    const target = user + '@' + host + (String(port) !== '22' ? ':' + port : '')
+    const label = opts.label ? String(opts.label) : ''
+    const drainState = { stopped: false }
+    const s = {
+      connectionId,
+      label,
+      handle,
+      log: '',
+      lastActivityAt: Date.now(),
+      target,
+      connected: false,
+      exited: false,
+      exitCode: null,
+      busy: false,
+      queue: Promise.resolve(),
+      passwordPending: opts.password || null, passwordSent: false,
+      drainState,
+    }
+    sessions.set(connectionId, s)
+    activeSessionId = connectionId
+    lastTarget = target
+    const meta = ensureMeta(connectionId)
+    meta.target = target
+    meta.label = label
+    meta.connected = false
+    meta.lastActivityAt = s.lastActivityAt
+
+    s.drain = startDrain(s)
+    Promise.resolve(handle.done).then((o) => {
+      if (sessions.get(connectionId) !== s) return
+      s.exited = true
+      s.connected = false
+      s.exitCode = o && o.exitCode
+      const currentMeta = ensureMeta(connectionId)
+      currentMeta.connected = false
+      currentMeta.lastActivityAt = Date.now()
+    }).catch(() => {
+      if (sessions.get(connectionId) !== s) return
+      s.exited = true
+      s.connected = false
+      ensureMeta(connectionId).connected = false
+    })
+
+    appendStep(connectionId, 'system', 'Connecting to ' + target + ' ...', { target, label })
+    const start = Date.now()
+    let ready = false
+    let lateFail = null
+    while (Date.now() - start < 25000) {
+      if (sessions.get(connectionId) !== s) throw new Error('SSH connection was closed')
+      if (s.exited) break
+      tryPassword(s)
+      const t = s.log.trimEnd()
+      if (t.length > 0 && /[$#%>]\s*$/.test(t)) { ready = true; break }
+      if (/PERMISSION DENIED|CONNECTION REFUSED|CONNECTION TIMED OUT|NO ROUTE TO HOST|HOST KEY VERIFICATION FAILED|TOO MANY AUTHENTICATION|AUTHENTICATION FAILED|UNABLE TO NEGOTIATE/.test(s.log.toUpperCase())) { lateFail = s.log; break }
+      await ctx.timeout(250)
+    }
+    if (ready) {
+      s.connected = true
+      lastTarget = s.target
+      meta.connected = true
+      appendStep(connectionId, 'connect', 'Connected to ' + s.target, { target: s.target, label: s.label })
+      return { ok: true, connectionId, label: s.label, target: s.target, connected: true, logLength: s.log.length, logTail: tail(s, 300) }
+    }
+    if (s.exited || lateFail) {
+      const info = ((lateFail || tail(s, 400)) || 'host unreachable').trim()
+      await doDisconnect(connectionId)
+      throw new Error('SSH connection failed: ' + info)
+    }
+    s.connected = true
+    lastTarget = s.target
+    meta.connected = true
+    appendStep(connectionId, 'connect', 'Connected to ' + s.target, { target: s.target, label: s.label })
+    return { ok: true, connectionId, label: s.label, target: s.target, connected: true, logLength: s.log.length, logTail: tail(s, 300) }
+  }
+
+  function stripEcho(delta, cmd) {
+    if (!cmd) return delta
+    const nl = delta.indexOf('\n')
+    if (nl >= 0) { const first = delta.slice(0, nl); if (first.indexOf(cmd) >= 0) return delta.slice(nl + 1) }
+    else if (delta === cmd) return ''
+    return delta
+  }
+
+  function enqueue(s, task) {
+    const previous = s.queue || Promise.resolve()
+    const current = previous.catch(() => {}).then(task)
+    s.queue = current.catch(() => {})
+    return current
+  }
+
+  async function doExecNow(s, command, opts) {
+    if (sessions.get(s.connectionId) !== s || !s.connected || s.exited) throw new Error('no active SSH connection; call ssh_connect first')
+    const waitMs = opts.waitMs && Number(opts.waitMs) > 0 ? Number(opts.waitMs) : 12000
+    const idleMs = 700
+    s.busy = true
+    try {
+      appendStep(s.connectionId, 'cmd', command, { target: s.target, label: s.label })
+      const offset = s.log.length
+      s.lastActivityAt = Date.now()
+      try { await s.handle.write(command + '\n') }
+      catch (e) { throw new Error('failed to write to SSH: ' + ((e && e.message) || e)) }
+      const start = Date.now()
+      while (Date.now() - start < waitMs) {
+        await ctx.timeout(150)
+        if (s.exited) break
+        if (Date.now() - s.lastActivityAt >= idleMs && Date.now() - start >= 300) break
+      }
+      let delta = s.log.slice(offset)
+      delta = stripEcho(delta, command)
+      delta = delta.replace(/\r/g, '').replace(/[\t ]+$/gm, '').replace(/\s+$/, '')
+      if (delta) appendStep(s.connectionId, 'out', delta, { target: s.target, label: s.label })
+      return { ok: true, connectionId: s.connectionId, output: delta, exited: !!s.exited, exitCode: s.exitCode, logLength: s.log.length, logTail: tail(s, 300) }
+    } finally {
+      s.busy = false
+    }
+  }
+
+  async function doExec(command, opts) {
+    opts = opts || {}
+    const cmd = String(command == null ? '' : command)
+    if (!cmd) throw new Error('command is required')
+    const connectionId = resolveConnectionId(opts.connectionId, false)
+    const s = connectionId ? sessions.get(connectionId) : null
+    if (!s) throw new Error('no active SSH connection; call ssh_connect first')
+    return await enqueue(s, () => doExecNow(s, cmd, opts))
+  }
+
+  async function doDisconnect(requestedId) {
+    const connectionId = resolveConnectionId(requestedId, true)
+    if (!connectionId) return { ok: true, disconnected: false }
+    const s = sessions.get(connectionId)
+    if (!s) return { ok: true, connectionId, disconnected: false }
+
+    appendStep(connectionId, 'disconnect', 'Disconnected from ' + s.target, { target: s.target, label: s.label })
+    s.connected = false
+    s.exited = true
+    sessions.delete(connectionId)
+    if (s.drainState) s.drainState.stopped = true
+    if (activeSessionId === connectionId) {
+      activeSessionId = null
+      for (const [nextId, next] of sessions) {
+        if (next.connected && !next.exited) { activeSessionId = nextId; break }
+      }
+    }
+    const meta = ensureMeta(connectionId)
+    meta.connected = false
+    meta.lastActivityAt = Date.now()
+    try { if (s.handle) await s.handle.terminate() } catch (e) {}
+    return { ok: true, connectionId, disconnected: true, target: s.target }
+  }
+
+  function sessionSummary(s) {
+    return {
+      connectionId: s.connectionId,
+      label: s.label,
+      target: s.target,
+      connected: !!(s.connected && !s.exited),
+      exited: !!s.exited,
+      busy: !!s.busy,
+      historical: false,
+      lastActivityAt: s.lastActivityAt,
+      stepCount: history.reduce((count, event) => count + (event.connectionId === s.connectionId ? 1 : 0), 0),
+    }
+  }
+
+  function listSessions() {
+    const listed = new Map()
+    for (const s of sessions.values()) listed.set(s.connectionId, sessionSummary(s))
+    for (const meta of connectionMeta.values()) {
+      if (listed.has(meta.connectionId)) continue
+      listed.set(meta.connectionId, {
+        connectionId: meta.connectionId,
+        label: meta.label || (meta.connectionId === LEGACY_SESSION_ID ? '历史记录' : ''),
+        target: meta.target || (meta.connectionId === LEGACY_SESSION_ID ? '历史记录' : ''),
+        connected: false,
+        exited: true,
+        busy: false,
+        historical: true,
+        lastActivityAt: meta.lastActivityAt,
+        stepCount: history.reduce((count, event) => count + (event.connectionId === meta.connectionId ? 1 : 0), 0),
+      })
+    }
+    const sessionsList = Array.from(listed.values()).sort((a, b) => b.lastActivityAt - a.lastActivityAt)
+    return { sessions: sessionsList, activeConnectionId: activeSessionId && sessions.has(activeSessionId) ? activeSessionId : null }
+  }
+
+  function transcriptFor(connectionId) {
+    const s = sessions.get(connectionId)
+    const meta = connectionMeta.get(connectionId)
+    return {
+      connectionId,
+      label: s ? s.label : (meta && meta.label) || (connectionId === LEGACY_SESSION_ID ? '历史记录' : ''),
+      connected: !!(s && s.connected && !s.exited),
+      exited: !!(!s || s.exited),
+      busy: !!(s && s.busy),
+      target: s ? s.target : (meta && meta.target) || (connectionId === LEGACY_SESSION_ID ? '历史记录' : lastTarget),
+      steps: history.filter((event) => event.connectionId === connectionId).slice(-MAX_STEPS),
+    }
+  }
+
+  function transcript(requestedId) {
+    const connectionId = resolveConnectionId(requestedId, true)
+    if (connectionId) return transcriptFor(connectionId)
+    return { connectionId: null, connected: false, target: lastTarget, steps: history.slice(-MAX_STEPS) }
+  }
+
+  function clearHistory(requestedId) {
+    const connectionId = requestedId == null || requestedId === '' ? null : String(requestedId)
+    if (connectionId) {
+      history = history.filter((event) => event.connectionId !== connectionId)
+      if (!sessions.has(connectionId)) connectionMeta.delete(connectionId)
+    } else {
+      history = []
+      connectionMeta.clear()
+    }
+    persist()
+    return { ok: true, cleared: true, connectionId }
+  }
+
+  function textOut(a, v) {
+    let s = (v && typeof v === 'object') ? ((v.output !== undefined ? String(v.output) : JSON.stringify(v))) : String(v)
+    if (s.length > 6000) s = s.slice(0, 6000) + '\n...[truncated]'
+    return [{ type: 'text', text: s }]
+  }
+
+  const objParams = (properties, required) => ({ type: 'object', additionalProperties: true, properties, ...(required && required.length ? { required } : {}) })
+  const connectionIdParam = { type: 'string', description: 'Connection ID returned by ssh_connect; omit only for legacy active-session behavior' }
+
+  ctx.effect(() => ctx.tools.register({
+    name: 'ssh_connect',
+    description: 'Open an interactive SSH session. Each call creates an independent connection unless connectionId is supplied to replace that connection. Always keep and reuse the returned connectionId when several tasks are active.',
+    parameters: objParams({
+      connectionId: connectionIdParam,
+      label: { type: 'string', description: 'Optional human-readable name for this task/connection' },
+      host: { type: 'string', description: 'Remote hostname or IP' },
+      user: { type: 'string', description: 'SSH username' },
+      port: { type: 'number', description: 'Port (default 22)' },
+      password: { type: 'string', description: 'Password for password auth' },
+      identity: { type: 'string', description: 'Path to a private key file (-i)' },
+    }, ['host', 'user']),
+    output: { schema: { type: 'object', additionalProperties: true }, render: textOut },
+    timeoutMs: 30000,
+    async execute(args) { try { return await doConnect(args) } catch (e) { return { ok: false, error: ((e && e.message) || String(e)) } } },
+  }))
+
+  ctx.effect(() => ctx.tools.register({
+    name: 'ssh_exec',
+    description: 'Send one command to a specific SSH connection and return its output. Pass the connectionId from ssh_connect to keep concurrent tasks isolated; omit it only for the legacy active connection.',
+    parameters: objParams({
+      connectionId: connectionIdParam,
+      command: { type: 'string', description: 'Shell command to run on the remote host' },
+      waitMs: { type: 'number', description: 'Max milliseconds to wait for the command to settle (default 12000)' },
+    }, ['command']),
+    output: { schema: { type: 'object', additionalProperties: true }, render: textOut },
+    timeoutMs: 16000,
+    async execute(args) { try { return await doExec(args.command, args) } catch (e) { return { ok: false, error: ((e && e.message) || String(e)) } } },
+  }))
+
+  ctx.effect(() => ctx.tools.register({
+    name: 'ssh_disconnect',
+    description: 'Close one SSH connection. Pass connectionId for a specific task; omit it only for the legacy active connection.',
+    parameters: objParams({ connectionId: connectionIdParam }, []),
+    output: { schema: { type: 'object', additionalProperties: true }, render: textOut },
+    timeoutMs: 8000,
+    async execute(args) { try { return await doDisconnect(args && args.connectionId) } catch (e) { return { ok: false, error: ((e && e.message) || String(e)) } } },
+  }))
+
+  ctx.effect(() => ctx.tools.register({
+    name: 'ssh_status',
+    description: 'Show one SSH connection transcript. Pass connectionId to inspect a specific task; omit it for the legacy active-session behavior.',
+    parameters: objParams({ connectionId: connectionIdParam }, []),
+    output: { schema: { type: 'object', additionalProperties: true }, render: textOut },
+    async execute(args) { return transcript(args && args.connectionId) },
+  }))
+
+  ctx.effect(() => ctx.tools.register({
+    name: 'ssh_list',
+    description: 'List active and recently recorded SSH connections so concurrent tasks can select the correct connectionId.',
+    parameters: objParams({}, []),
+    output: { schema: { type: 'object', additionalProperties: true }, render: textOut },
+    async execute() { return listSessions() },
+  }))
+
+  async function readBody(req) {
+    const chunks = []
+    for await (const chunk of req) chunks.push(chunk)
+    const text = Buffer.concat(chunks).toString('utf8')
+    return text ? JSON.parse(text) : {}
+  }
+  function send(res, obj) {
+    res.setHeader('content-type', 'application/json')
+    res.end(JSON.stringify(obj))
+  }
+  function isLocal(req) {
+    const host = String(req.headers.host || '')
+    return /127\.0\.0\.1|localhost|\[::1\]/.test(host)
+  }
+
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/ssh-terminal/api',
+    handler: async (req, res) => {
+      if (!isLocal(req)) { send(res, { ok: false, error: 'forbidden' }); return }
+      try {
+        const data = await readBody(req)
+        const action = data && data.action
+        let out
+        if (action === 'clear') out = clearHistory(data.connectionId)
+        else if (action === 'list') out = listSessions()
+        else if (action === 'connect') out = await doConnect(data)
+        else if (action === 'exec') out = await doExec(data.command, data)
+        else if (action === 'disconnect') out = await doDisconnect(data.connectionId)
+        else out = transcript(data.connectionId)
+        send(res, out)
+      } catch (e) {
+        send(res, { ok: false, error: ((e && e.message) || String(e)) })
+      }
+    },
+  }))
+
+  ctx.effect(() => () => {
+    for (const connectionId of Array.from(sessions.keys())) void doDisconnect(connectionId)
+  })
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "dsh-ssh-terminal",
+  "version": "0.1.0",
+  "description": "SSH 远程终端：在 dsh-better-sidebar 侧边栏里连接远程主机，逐步查看命令与输出。",
+  "author": "sunzhyang1616-ui",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sunzhyang1616-ui/dsh-ssh-terminal.git"
+  },
+  "homepage": "https://github.com/sunzhyang1616-ui/dsh-ssh-terminal#readme",
+  "bugs": {
+    "url": "https://github.com/sunzhyang1616-ui/dsh-ssh-terminal/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "ssh",
+    "cordis",
+    "better-sidebar",
+    "dsh-better-sidebar"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "react": "^18.3.1",
+    "dsh-better-sidebar": ">=0.12.0"
+  },
+  "peerDependenciesMeta": {
+    "dsh-better-sidebar": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.0",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.1",
+    "lightningcss": "^1.33.0",
+    "react": "^18.3.1",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.6.3"
+  },
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "README_EN.md",
+    "cordis.patch.yml",
+    "docs",
+    "lib"
+  ]
+}