# 会话 — Liu Terminal

> Liu Terminal 会话。完整的 SSH 客户端，包含文件浏览器、SFTP、端口转发、Mosh 和 known-hosts TOFU。

URL: https://liu.software/zh/docs/sessions/  
Language: zh  
Updated: 2026-10-17

本地 PTY 运行 AI 代理。相同的 Session 抽象也支持 SSH、SFTP、Mosh、Telnet 和串行连接——尽管产品不再以远程 Shell 为主打，但因为仍有大量用户需要，这些功能依然保持关联。

## 什么是会话

Liu 中的每个标签页和分屏面板都是一个会话。其中大多数是运行您登录 Shell 的本地 PTY — 这也是 AI 代理（Claude、Codex、Copilot 等）实际运行的基础。会话也可以是远程的：SSH、SFTP、Mosh、Telnet、串行。它们共享一个抽象层、一个渲染管道和一个回滚缓冲区。

## 本地 PTY

新标签页 (⌘ T) 会在父标签的当前工作目录 (cwd) 下生成一个新的本地 PTY。当从 Finder 或 Dock 启动时，Liu 会检测到继承了 / 作为当前目录，并在子进程中隐式执行 chdir($HOME)，以便您的命令行在合理的位置打开。

Shell 的工作目录通过 OSC 7 进行跟踪。将 printf '\\\\e\]7;file://%s%s\\\\e\\\\\\\\' "$HOSTNAME" "$PWD" 插入 PROMPT\_COMMAND 后，Liu 的侧边栏、分屏继承以及 Agent History 的 cwd 范围都会自动生效。

## SSH（底层支持，依然保留）

基于 libssh2。支持密码、公钥、代理和键盘交互式认证。~/.ssh/config 中的 Host、Match、Include、ProxyJump、IdentityFile 等相关指令均受支持。Liu 内部复用连接，但 ssh config 中的 ControlMaster / GSSAPI 行尚未解析为活动会话。

- 从金库面板生成 ED25519 / RSA-3072 密钥；私钥在静态时保持加密状态。
- SSH\_AUTH\_SOCK 用于出站认证。代理转发按主机设置，默认关闭。
- 支持多跳 ProxyJump + SOCKS5。ssh config 中的 GSSAPI/Kerberos 行尚未接入活动会话。

## 已知主机

首次连接时会显示 SHA-256 指纹和随机艺术图预览以请求确认。已接受的条目将以兼容 OpenSSH 的格式存入 ~/.config/Liu/known\_hosts。如果主机密钥发生变更，将阻止输入，直到您重新确认。

## 其他协议

- SFTP — 从侧边栏对任何已保存的主机打开。支持拖放，断线后可恢复。
- Mosh — 与 SSH 主机配对以获得漫游和自适应重传功能。
- Telnet 和串行 — 适用于旧式设备。相同的会话界面，无加密。

## 端口转发

每个主机都带有一个转发规则列表——本地、远程和动态（SOCKS）——在连接时生效。它们在状态栏中显示，绑定成功时为绿点，绑定失败则为红点。

```
{ "type": "local",   "from": "8080",  "to": "localhost:80" }
{ "type": "remote",  "from": "9000",  "to": "127.0.0.1:9000" }
{ "type": "dynamic", "from": "1080" }
```

[下一步 文件浏览器 →](https://liu.software/zh/docs/file-browser.md)