﻿# TermX 使用说明

> 绿色免安装 · 零外部依赖 · 不写注册表 · 运行目录由用户指定（除该目录外不创建任何文件夹）。

## 一、怎么用

1. 把 `TermX-1.4.20-portable.zip` 解压到任意目录（U 盘也可以）。
2. 双击 `TermX/TermX.exe` 即可运行，无需安装、无需联网、无需下载任何组件。
3. 换电脑：直接把整个 TermX 目录拷走；会话、配置、日志统一保存在运行目录，换机自动沿用。

运行目录策略：首次运行由用户选择数据保存位置（默认建议 `D:\TermX`），之后可在「全局选项 → 常规 → 运行目录」随时修改；除该目录外，软件不会在其他位置创建文件夹。覆盖安装时可选「关联已有数据目录」，已有文件优先保留、缺失文件自动迁入。命令行可用 `TermX.exe --data-dir-set 路径` 指定（留空恢复自动），`TermX.exe --data-dir` 可查看当前运行目录。

## 二、目录结构

```
TermX/
  TermX.exe                 主程序（启动约 0.6 秒）
  TermX_Bin/                全部外部组件，已随包携带
    openssh/                OpenSSH 9.5p1：ssh / scp / sftp / ssh-keygen 等
    runtime/                VC++ 运行库：msvcp140 / vcruntime140 等
    ssh1/                   plink 0.67（SSH-1 协议客户端）
    x11/                    便携 X Server（VcXsrv），X11 转发时自动启动
    fonts/                  开源等宽字体（私有加载，不写系统字体表）

运行目录（用户指定）/        用户数据（首次运行弹窗选择，默认建议 D:\TermX）
  settings.json             全局选项（含运行目录设置）
  sessions.json             会话库
  accounts.json             账号库（名称 / 用户名 / DPAPI 加密密码）
  device_templates.json     自建设备模板（随 settings.json 保存）
  ssh/config                SSH 配置（自动 Include 用户已有 ~/.ssh/config）
  ssh/known_hosts           主机指纹
  keys/                     生成的密钥对
  downloads/                Zmodem / SFTP 接收文件
  logs/  scripts/            日志与脚本
```

## 三、「不需要下载任何东西」的组件对照

| 功能 | 以前依赖 | 现在 |
| --- | --- | --- |
| SSH / SFTP / SCP | 系统自带 OpenSSH | 随包 `TermX_Bin/openssh` |
| SSH 运行库 | VC++ Redistributable | 随包 `TermX_Bin/runtime` |
| SSH-1 | 另找支持 SSH1 的客户端 | 随包 plink 0.67 |
| X11 转发 | 另装 VcXsrv / Xming | 随包 X Server，勾选 `-X` 自动拉起 |
| Zmodem 收发 | 本地 rz.exe / sz.exe | 软件内置纯 Python 协议栈 |
| VBScript / JScript | 系统 WSH (cscript) | 软件内置脚本引擎（可切回 WSH） |
| Telnet / Rlogin / Raw / 串口 | — | 纯 Python / Win32 实现 |
| 终端仿真 / 界面 | Python + Tcl/Tk | 已静态打进 exe |
| 字体 | 系统字体 | 随包字体，缺省自动注册 |

仍属操作系统本身、不算外部组件的：ConPTY / DPAPI / Win32 API（Windows 10 1809+ 内核提供）；本地 Shell 标签使用的 `cmd.exe` / PowerShell；远端 Linux 上的 rz / sz 命令（Zmodem 是双端协议，对端必须有发送方）。

## 四、常用操作

| 操作 | 说明 |
| --- | --- |
| `Ctrl+T` | 快速连接 / 新建会话（分组支持模糊查询，输入新分组名自动创建） |
| 会话树双击 | 打开已保存会话（保存过密码的会话自动登录） |
| 会话树拖拽 | 拖动会话到分组调整归属，目标行实时高亮 |
| `F11` | 批量下发脚本（按分组筛选 / 全选、变量替换、Excel 导入设备、结果导出） |
| `F10` | 脚本编辑器（Python / VBScript / JScript / 命令脚本） |
| 文件传输窗口 | scp 上传下载、交互式 SFTP 标签、Zmodem 上传 |
| 全局选项 → SSH | 可指定自己的 ssh.exe；默认 auto = 用随包内置版本 |
| 全局选项 → 自动化 | VBScript / JScript 引擎：builtin(内置) / wsh(系统) |
| `F9` / 查看 → 界面主题 | 卡片式主题选择器，点卡片即换肤，6 套主题即时生效 |
| 鼠标滚轮 | 终端区域或右侧滚动条上滚动 = 逐行回滚 |
| `Ctrl+Home` / `Ctrl+End` | 回到最早历史 / 回到底部；`PgUp` / `PgDn` 翻页 |

脚本设备模板内置华为 / 华三 / 锐捷 / 思科，全部模板支持新建、重命名、删除；运行目标可选具体会话、按分组多选、全部会话，或输入网段（如 `10.36.36.0/24`）匹配。

### 串口连接

`Ctrl+T` 打开快速连接，协议选 Serial，表单切换为专用串口界面：串口(COM) / 波特率 / 数据位 / 校验位 / 停止位 / 流控 / 编码，另有「检测串口」按钮自动枚举本机 COM 口。也可在会话属性 →「串口」页为已保存会话配置同样参数。串口由内置 Win32 驱动直接打开（CreateFileW + DCB），支持 COM1–COM32；USB 转串口只要系统装好芯片驱动、设备管理器出现 COM 编号即可用。

### 老旧网络设备（ssh-rsa 主机密钥）

连接老交换机 / 路由器若报 `Unable to negotiate ... no matching host key type found. Their offer: ssh-rsa`，是 OpenSSH 8.8+ 默认禁用了 SHA-1 签名的 ssh-rsa。默认开启「全局选项 → SSH → 兼容老旧设备算法」，用 `+` 追加 `ssh-rsa` 主机密钥、SHA-1 KEX 与 CBC 加密（不覆盖默认列表，现代设备仍优先 ed25519 / rsa-sha2），SSH / SFTP / SCP 同时生效；若只用现代算法，可在该选项关闭。

### 账号库

「工具 → 账号管理」添加 / 编辑 / 删除账号：每个账号含名称、用户名和密码，密码用 Windows DPAPI 加密保存在运行目录 `accounts.json`（添加时必须填账号和密码；编辑时密码留空表示不修改）。三处可直接调用：

- 新建会话 / 会话属性：「账号(选择)」下拉，选中后自动填入用户名和密码，保存后自动登录。
- 快速连接：表单顶部同样有账号下拉（串口 / 本地 Shell 不显示），选中即填好凭据。
- 登录时：标签右键 →「选择账号登录...」，选账号后立即应答当前 `login:` / `Password:` 提示并接管后续提示（含 sudo 二次密码），凭据同时写回会话。

### 回滚查看历史与时间戳行号

鼠标滚轮在终端区域或右侧滚动条上逐行回滚，拖动滑块可跳到任意位置，拖到底部回到最新输出。终端左侧显示 `[HH:MM:SS]` 时间戳与全局递增行号：时间为执行该行命令的时刻（命令行与其输出行共用同一时刻），当前行高亮，回滚时一起回滚。可在「全局选项 → 外观」关闭「鼠标滚轮优先回滚」「终端左侧显示时间戳与行号」。

## 五、自检（不需要联网）

在 TermX.exe 所在目录打开命令行：

```
TermX.exe --selftest --out 自检结果.txt
TermX.exe --smoke    --out 冒烟结果.txt
```

自检包含「内置组件清单」与「隔离 PATH 下 OpenSSH 独立运行」两项；后者在完全排除系统 OpenSSH 的环境里运行随包 `ssh.exe -V` 验证。`--smoke` 会短暂弹出窗口再自动关闭。

## 六、两个版本怎么选

- **绿色免安装包 .zip（推荐）**：解压为完整目录，`TermX_Bin/` 内 5 组组件齐全，双击即用，冷启动约 0.6 秒，适合日常使用。
- **单文件版 .exe（备用）**：同样组件压进一个约 70 MB 的 exe，方便放 U 盘或发给同事；代价是每次启动要把约 100 MB 组件展开到临时目录，冷启动约 25 秒，只适合偶尔分发。

两个版本都不写注册表，不需要 .NET / VC++ 运行库 / Python / OpenSSH / X Server / WSH 的任何系统安装。

## 七、注意事项

- SSH-1 是已废弃的不安全协议，仅在对接老旧设备时使用；PuTTY 私钥需 `.ppk` 格式。
- X11 转发首次启用会自动启动随包 X Server（托盘图标），关闭会话不强制结束；系统已有 X Server 在 6000 端口则直接复用。防火墙首次弹窗选「允许访问」（仅本机回环显示用）；不可信网络环境建议不用 X11。
- 生成的 SSH 密钥默认落在运行目录 `keys/`，不污染用户 `.ssh` 目录。
- 内置 VBScript / JScript 引擎覆盖 SecureCRT 常用语法与 crt API；极冷门特性可在全局选项切到系统 WSH 引擎。
- 请勿删除 `TermX_Bin` 目录，删除后 SSH / X11 / SSH-1 功能将不可用。
- 旧版本若曾出现启动报「Item s:xxx already exists」，是 `sessions.json` 存在重复会话 ID；当前版本启动时会自动去重修复并写回，无需手工删除数据文件。

## 相关页面

- [官网首页](https://tx.qgoo.cn/) · [首页 Markdown 版](https://tx.qgoo.cn/index.md)
