SSH 文档

1. 1 打开 SSH 并创建连接。
2. 2 输入显示名称、主机、端口和用户名。
3. 3 选择密码、私钥或无认证。私钥认证需填写本地密钥路径，并可填写口令。
4. 4 先 Test connection，再 Save。密码和口令以本地凭据引用保存，重新打开表单不会显示秘密。

使用 SSH 侧栏搜索，按当前工作区的连接名称、主机、用户名或端口匹配。搜索不筛选 SSH Tasks 或终端会话，也不修改保存的连接。清空搜索可恢复正常列表。

1. 1 选择保存的连接并连接，打开基于 PTY 的终端会话。
2. 2 正常使用终端；会话会转发键盘输入，并随面板尺寸调整远程 PTY。
3. 3 可使用分屏、输出搜索、日志复制/导出，以及 Copy、Paste、Paste Selected Text、Select All 右键操作。
4. 4 结束后关闭会话。关闭仍处于连接状态的会话会先要求确认。

首次连接时，请先复核主机密钥指纹再信任。之后出现指纹不匹配时，Unfour 会拒绝连接，不会静默替换已信任密钥。

• ✓ 只信任通过独立渠道核验过的指纹。
• ✓ 服务器密钥确实发生变更时，从连接界面重置保存的指纹，再重连并复核新值。
• ✓ 失败和重连状态会保留，失败会话标签不会立即消失，便于查看错误。
• ✓ 重连恢复终端传输；继续被中断的命令前应先确认远程状态。

远程 Shell 回显命令后，Unfour 会记录结构化命令历史。历史按工作区和连接隔离、在本地限制数量，并进行保守脱敏。

• ✓ 在识别出的 Shell 提示符后输入至少两个字符，可看到最多六条匹配建议。
• ✓ 使用上下键选择、Tab 或点击插入、Escape 关闭；Enter 始终提交当前输入行。
• ✓ 密码提示符后的输入不会保存；无法安全分类的命令可能被排除或显示为已脱敏。
• ✓ MCP 可按当前工作区、连接、文本、时间范围和数量查询历史，但不会返回终端缓冲或原始会话日志。

从已连接终端会话中打开 Remote Files。SFTP 面板会使用该会话和连接浏览远程文件系统。

• ✓ 打开目录、输入远程路径、返回上级目录并刷新列表。
• ✓ 上传本地文件或拖放上传，并下载选中的远程文件。
• ✓ 创建文件夹、重命名条目、删除可丢弃路径，并复制远程路径。
• ✓ 查看并取消传输；每个 SSH 连接同一时间只流式执行一个上传或下载。

1. 1 连接可信的 SSH 服务器并打开 Remote Files，找到不超过 1 MiB 的 UTF-8 普通文本文件，例如小型配置文件或日志片段。
2. 2 打开文件的右键菜单，选择“预览”。在只读对话框中查看内容；仅在需要写入剪贴板时选择“复制内容”。
3. 3 查看后关闭对话框。预览不会编辑远程文件，也不会将内容持久化到历史或应用共享缓存。

支持带或不带 BOM 的 UTF-8。二进制、不支持的编码、非普通文件及超过 1 MiB 的文件会被拒绝。权限与连接错误会显示提示；读取在 30 秒后超时。

SSH Task 是按顺序执行的已保存步骤，可由 command、upload 和 download 组成。任务属于工作区，并可设置默认连接。

“使用上次参数”会明确恢复上次运行上下文；普通 Run 使用当前默认值。可从已完成的历史记录或结果面板准备重跑成功、失败或已取消的任务。开始前复核当前保存的任务、目标、环境与输入。可恢复安全的手动值，变量来源重新解析，敏感手动值需重新输入。缺失或已变化的资源须先处理；没有复用上下文的旧记录使用当前默认值。

1. 1 打开 Tasks，创建任务，并按需要的顺序添加步骤。
2. 2 在支持的命令和路径字段中使用 {{name}} 占位符。运行输入可从工作区全局变量和所选环境预填，敏感输入应标记为 secret。
3. 3 在 Run 对话框中复核目标连接、解析后的输入和启用步骤，再开始运行。
4. 4 查看实时输出和步骤状态，之后可检查持久化的运行摘要与日志；必要时可取消运行。
5. 5 向上滚动以暂停自动跟随，阅读较早输出。从其他模块返回时保留阅读位置；使用跟随控件恢复查看实时输出。