kakitiro.com

QuickTerminal - 指南

QuickTerminal 是一款功能齐全的终端仿真器,支持 SSH、Telnet、Mosh、Serial、AWS SSM 和 GCP IAP 连接,集成 SFTP 浏览器、AI 代理、命令片段、执行策略和会话管理。本指南涵盖充分使用该产品所需的一切。

入门

  1. 启动应用 — 进入主屏幕,其中列出已保存的会话,并有一个用于开始新连接的按钮。
  2. 启动本地 shell — 点击 Local Shell,立即在您的机器上打开一个终端会话。
  3. 创建远程会话 — 点击 New Session,选择协议(SSH、Telnet、Mosh、Serial、AWS SSM 或 GCP IAP),并输入连接信息。
  4. 保存会话 — 为其命名并分配到分组。随时一键重新连接。
  5. 探索 Command Palette — 按 Ctrl + Shift + P,从一个可搜索的列表中访问所有操作。
首次连接到远程服务器时,QuickTerminal 会在建立连接前提示您验证主机指纹。
--- --- --- --- ---

界面概览

侧边栏

可折叠的侧边栏用于组织您的工作区:

  • Sessions — 按项目或环境分组的所有已保存会话
  • SFTP — 为当前连接打开图形化文件浏览器
  • Snippets — 已保存的命令库
  • AI Agent — 启动 AI 助手面板
  • Settings / Help — 位于侧边栏底部

终端区域

中心工作区显示:

  • 具有完整输入输出的活动终端
  • 用于在多个打开的会话间切换的标签栏
  • 底部的状态栏,显示连接状态、协议和会话计时器
  • 可选的分屏视图,可并排运行多个终端

Command Palette

按 Ctrl + Shift + P 打开 Command Palette。输入以筛选操作,然后按 Enter 执行。QuickTerminal 中的每个功能都可通过 Command Palette 访问。

--- --- --- --- ---

Local Shell

QuickTerminal 内置了一个完全集成的本地 shell,用于在您自己的机器上运行命令。

  • Shell 检测 — 自动检测并使用您的默认 shell(bash、zsh、fish、PowerShell)
  • 工作目录跟踪 — 状态栏始终显示当前目录
  • 命令历史 — 跨会话持久化,可使用 Ctrl + R 搜索
  • 环境变量 — 自动继承您的 shell 配置文件和环境
$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection
您可以同时打开多个本地 shell 标签页。每个都作为独立进程运行,拥有自己的工作目录。
--- --- --- --- ---

SSH 连接

SSH 是安全远程访问的主要协议。QuickTerminal 支持所有现代 SSH 功能。

认证

  • 密码 — 在连接时输入凭据,或安全地保存在会话中
  • 基于密钥 — 使用 RSA、Ed25519 或 ECDSA 密钥。从文件导入或生成新的密钥对
  • 代理转发 — 将本地 SSH 代理转发到远程主机,实现无缝多跳访问
  • 键盘交互 — 支持双因素认证和质询-响应提示

端口转发

  • 本地转发 — 将远程端口隧道到本地机器
  • 远程转发 — 向远程主机暴露本地服务
  • 动态转发 — 通过 SSH 隧道创建 SOCKS 代理

会话配置

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80
默认启用主机密钥验证。如果主机密钥意外更改,QuickTerminal 会发出警告并阻止连接,直到您明确接受新密钥。
--- --- --- --- ---

其他协议

Remote Shell
Telnet
适用于不支持 SSH 的遗留系统、网络交换机和设备的经典非加密协议。
Remote Shell
Mosh
一种可在网络变动、高延迟和间歇性连接下保持的移动 shell。漫游友好。
Hardware
Serial
面向嵌入式设备、路由器、交换机和 IoT 硬件的直连串口连接。可配置波特率、数据位和校验位。
Cloud
AWS SSM
通过 AWS Systems Manager Session Manager 连接 EC2 实例。无需入站端口或堡垒主机。
Cloud
GCP IAP
通过 Identity-Aware Proxy 隧道连接到 Google Cloud 虚拟机。基于 IAM 的控制,安全且无需防火墙配置。

Telnet

配置主机和端口。Telnet 连接未加密,仅在受信任的网络或必须使用的设备上使用。

Mosh

需要在远程主机上安装 Mosh 服务器。QuickTerminal 自动处理初始 SSH 握手和 UDP 会话建立。非常适合移动或不稳定的网络环境。

Serial

选择串口、波特率(9600、19200、38400、57600、115200 等)、数据位、停止位、校验位和流控。终端显示原始串行数据,并支持发送 break 信号。

AWS SSM

使用您的 AWS 凭据或 IAM 角色进行认证。按 ID 或名称选择目标实例。QuickTerminal 调用 SSM 会话插件建立连接。

GCP IAP

使用您的 Google Cloud 账户进行认证。选择项目、区域和实例。QuickTerminal 使用您的 IAM 权限通过 IAP 建立隧道。

Telnet 以明文传输数据,包括密码。避免在不受信任的网络上使用 Telnet。尽可能使用 SSH 或 Mosh 进行安全连接。
--- --- --- --- ---

SFTP 浏览器

内置的 SFTP 浏览器为任何 SSH 连接的主机提供图形化文件管理器。

  • 浏览目录 — 使用熟悉的树形和列表视图浏览远程文件系统
  • 上传文件 — 从本地机器拖放文件或使用上传按钮
  • 下载文件 — 选择文件并下载到本地目录
  • 远程编辑 — 在内置编辑器中打开文本文件并直接保存到服务器
  • 权限 — 查看和修改文件权限、所有权和时间戳
  • 搜索 — 在当前目录树中按名称查找文件
SFTP 浏览器共享 SSH 会话的认证。无需额外凭据 — 在连接时直接打开 SFTP 面板即可。
--- --- --- --- ---

AI 代理

QuickTerminal 的 AI 代理协助您进行命令编写、输出分析和任务自动化。

AI 代理能做什么

  • 命令生成 — 用自然语言描述您的需求,代理会建议合适的命令
  • 输出说明 — 将终端输出粘贴或管道给代理,获取可读性强的解析
  • 错误诊断 — 分享错误消息,获得带说明的修复建议
  • 多步自动化 — 描述工作流程,代理生成命令序列
  • 脚本生成 — 请代理为重复任务创建 shell 脚本

使用代理面板

  1. 从侧边栏打开 AI Agent 面板,或按 Ctrl + Shift + A。
  2. 用自然语言输入您的请求。
  3. 查看建议的命令或说明。
  4. 点击 Insert 将命令粘贴到终端,或点击 Copy 复制到剪贴板。
AI 代理在设备上处理数据。您的命令、输出和对话不会发送到外部服务器。代理完全在 QuickTerminal 内部运行。
--- --- --- --- ---

Snippets

Snippets 让您可以保存、整理并快速插入常用命令。

创建片段

  1. 从侧边栏打开 Snippets 面板。
  2. 点击 New Snippet。
  3. 输入命令、名称和可选描述。
  4. 对参数化模板使用 ${variable_name} 语法。
  5. 保存到您的片段库中。

模板变量

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

插入参数化片段时,QuickTerminal 会在插入最终命令之前提示您填写每个变量。

整理片段

  • 分配标签以对相关片段进行分组(例如 deployment、monitoring、database)
  • 按名称、内容或标签搜索片段
  • 置顶最常用的片段,以便在列表顶部快速访问
您可以将片段插入任何活动的终端会话。命令会粘贴在光标位置,可进行编辑或执行。
--- --- --- --- ---

Command Palette

Command Palette 是一个通用的操作启动器,可在 QuickTerminal 的任何位置访问。

  • 按 Ctrl + Shift + P 打开
  • 输入以筛选操作 — 模糊匹配可快速找到所需内容
  • 操作包括:创建会话、打开 SFTP、切换设置、运行片段等
  • 最近使用的操作显示在顶部,便于快速重复访问
# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies
Command Palette 是浏览 QuickTerminal 最快的方式。无需离开键盘即可访问任何功能。
--- --- --- --- ---

Execution Policies

Execution Policies 让您能定义安全规则,防范意外或破坏性命令。

策略类型

策略 作用 示例
Block 完全阻止命令执行 阻止 rm -rf /
Confirm 执行前要求明确确认 确认任何 DROP TABLE
Sandbox 将执行限制在特定目录或环境中 沙盒化到 ~/projects
Log 在审计轨迹中记录命令而不阻止 记录所有 sudo 命令

配置策略

  1. 进入 Settings > Execution Policies。
  2. 点击 New Policy。
  3. 定义模式 — 要匹配的命令前缀、正则表达式或关键词。
  4. 选择操作(block、confirm、sandbox 或 log)。
  5. 设置作用域 — 应用于所有会话、特定分组或单个会话。
Execution Policies 是针对本地 shell 的建议性防护措施。它们无法阻止由服务器直接处理输入的远程主机上执行的命令。
--- --- --- --- ---

设置

外观

  • 主题 — 带系统偏好检测的浅色和深色模式
  • 字体系列 — 为终端选择您偏好的等宽字体
  • 字号 — 可调节的终端文本大小
  • 配色方案 — 从内置终端调色板中选择或导入自定义方案

终端

  • 回滚缓冲区 — 配置在内存中保留的历史行数
  • 光标样式 — 方块、下划线或竖条
  • 响铃行为 — 视觉闪烁、系统声音或静音
  • 选中即复制 — 自动将高亮文本复制到剪贴板

连接

  • 默认 SSH 端口 — 为新 SSH 会话设置自定义默认端口
  • Keep-alive 间隔 — 定期发送数据包以防止连接超时
  • 断开时重连 — 自动尝试恢复丢失的连接

Execution Policies

  • 管理 block、confirm、sandbox 和 log 规则
  • 按会话分组启用或禁用策略
--- --- --- --- ---

键盘快捷键

快捷键操作
Ctrl + Shift + P打开 Command Palette
Ctrl + Shift + N新建会话
Ctrl + Shift + T新建本地 shell 标签页
Ctrl + Shift + A打开 AI Agent 面板
Ctrl + Shift + S打开 Snippets 面板
Ctrl + Shift + F打开 SFTP 浏览器
Ctrl + Tab切换到下一个标签页
Ctrl + Shift + Tab切换到上一个标签页
Ctrl + W关闭当前标签页
Ctrl + Shift + D切换分屏
Ctrl + R搜索命令历史
Ctrl + C复制选中内容(或发送中断)
Ctrl + V从剪贴板粘贴
Ctrl + ,打开设置
F1打开帮助
--- --- --- --- ---

技巧 & 窍门

对需要在不同服务器上运行的命令使用参数化片段。定义 ${host} 和 ${user} 等变量,每次动态填入。
按项目或环境(生产、预发、开发)设置会话分组,以便在服务器列表扩展时侧边栏保持整洁。
为长时间运行的会话启用设置中的断开时重连。QuickTerminal 会自动恢复丢失的 SSH 和 Mosh 连接。
使用 AI Agent 解释陌生的命令输出。选中文本、打开代理并请求解析。
将 Execution Policies 与会话分组结合,对生产与开发环境应用不同的安全规则。
SFTP 浏览器支持从系统文件管理器拖放。将文件拖入浏览器可直接上传。
--- --- --- --- ---

故障排查

问题解决方案
SSH 连接被拒绝检查主机、端口以及远程服务器上的 SSH 服务是否在运行。检查防火墙和安全组。
主机密钥验证失败服务器密钥已更改。如果这是预期的(服务器重建),请删除旧密钥后重连。如果非预期,请先调查再接受。
Mosh 连接立即断开确保远程主机上安装了 Mosh 服务器,并且 UDP 端口 60000-61000 已开放。
未检测到串口检查设备是否连接以及是否安装了正确的驱动。尝试不同的 USB 端口或电缆。
AWS SSM 会话失败检查 AWS 凭据、IAM 权限,以及目标实例上是否运行着 SSM 代理。
GCP IAP 隧道超时检查您对该实例的 IAM 权限,并确保项目中已启用 IAP API。
SFTP 传输停滞在慢速连接上大文件可能看起来停滞。检查传输进度指示器。尝试减少并发传输数量。
AI Agent 无响应代理在设备上处理数据。若设备负载较高,代理可能需要更长时间响应。关闭未使用的标签页以释放资源。
片段变量不提示确保变量使用 ${name} 语法。没有花括号的普通文本(如 $name)不会触发提示。
Execution Policy 未阻止策略在本地匹配命令模式。检查正则模式和作用域。策略不适用于远程主机上执行的命令。
--- --- --- --- ---

隐私

  • QuickTerminal 不需要账户或登录。
  • 不收集使用数据、分析或遥测信息。
  • 所有凭据均使用平台原生密钥库进行加密。
  • AI 代理完全在设备上运行 — 不向外部服务器发送数据。
  • 会话历史和片段在设备本地存储。
  • SFTP 传输直接在您的设备与远程主机之间进行。
  • 应用在本地 shell 和串口连接下可完全离线工作。