当前功能指南
本页介绍当前 Alpha 版本已经接通的功能、典型使用流程及边界。截图来自对应客户端的中文界面;英文手册使用英文界面截图。
终端与工作区

终端支持搜索、选区、粘贴、滚动回看、IME、主题与快捷键配置。标签页中可以排列多个面板,调整大小和焦点;工作区分开管理多组标签页。原生 Mac 使用 Ghostty,Electron 使用 xterm.js,设置与快捷键以各自手册为准。
保存布局不等于保存仍在运行的远端进程。重新连接会建立新的 shell;需要保持任务时,请在服务器上使用 tmux/screen。
广播输入只对当前标签页中已选择的终端生效,新面板不会自动加入。断连或仍在连接的成员不会缓存与重放输入。它用于重复交互输入,不提供逐主机结果汇总、重试、滚动发布或回滚。
完成一项终端任务
- 打开本机终端,运行
pwd或ls等无修改命令。 - 在旁边添加文件或监控面板;解释远端数据前先核对面板连接。
- 搜索命令输出、在面板间切换焦点,并为标签页取任务名称。
- 需要重新打开布局时保存工作区;远端进程需跨断连继续运行时另用服务器上的 tmux/screen。
核对结果: 布局与标识应清楚说明输入会发往哪台机器;恢复布局不表示任务仍在运行。
主机与资料库

在主机库新建主机,填写地址、用户名、端口与认证信息,保存后连接。支持文件夹组织、搜索与快速连接、ssh-agent/密钥/密码认证,以及 ProxyJump 跳板。Match 条件会被忽略;ProxyCommand 和用户端口转发管理尚未实现。主机页快速连接目前对 IPv6 地址校验存在限制,可使用支持该地址的连接入口或系统 SSH。
片段、笔记和环境变量用于复用命令与上下文。绑定按全局或单个终端面板生效,不能按主机/文件夹自动关联。插入片段后仍由用户确认执行。密码不可读时会保留原密文并提示重新输入,避免一次编辑把旧凭据清空;见同步与凭据说明。
先保存主机,再连接
- 用测试服务器的地址、用户与端口创建条目,并填写便于以后搜索的名称。
- 选择密码、身份文件或已存密钥;接受新主机指纹前通过可信渠道核对。
- 连接后检查终端上的连接标识。
- 应用片段、笔记或环境变量前,核对全局或当前终端绑定范围。
核对结果: 保存的主机应以预期身份与连接重新打开;资料绑定不会自动跟随主机文件夹。
文件与传输

双栏文件界面、文件面板和预览支持本机/远端浏览,创建、重命名、删除、上传下载及冲突决策。传输中心提供进度、速度、取消与失败原因。删除通常直接从磁盘移除,请先检查确认提示。
界面中的“SFTP”实际使用 SSH 上的 wsh helper,不是标准 SFTP 独立客户端;只允许 SFTP 或禁止安装 helper 的服务器不可用。当前没有字节级断点续传及重启恢复队列。原生 Mac 是轻量文本/代码编辑器;Electron 使用 Monaco。文件类型和大小限制见各客户端文件说明。
核验一次文件操作
- 选择本机与远端位置,并确认远端助手可用。
- 先预览小文件,编辑或复制前核对路径。
- 先复制一个文件;对同名目标明确选择覆盖、合并或跳过。
- 观察传输状态并检查目标文件;发生失败时取消或排查,不要假定已经续传。
核对结果: 目标文件存在且传输状态完成,比仅点击上传更能说明结果;大文件中断后不支持按字节偏移续传。
监控与运维

监控还可自动切换为极简竖栏或横栏,并最小化到终端底部实时缩略栏,悬停展开详情。完整操作与截图参见资源监控指南,包括布局、恢复、历史跨度和石墨/霓虹皮肤。
监控显示 CPU、内存、磁盘、网络、主机信息与进程,并可切换 1m/5m/30m/12h 趋势;聚合桶保留平均值和峰值。后端每分钟及正常退出时保存聚合历史,重新打开面板可继续查看已有数据。关闭应用、无采集订阅或断连期间没有新样本,不具备后台常驻采集、告警或团队事故管理。
运维工具集提供命令模板,并对服务、Docker、端口和进程提供结构化查看。它并非完整的部署、备份或回滚编排系统。插件页管理固定的 11 个 CLI 工具的检测、安装与卸载,不是扩展市场;第三方 CLI 仍需按其自身规则安装依赖与认证。
先排查,再修改
- 选择目标连接,等待真实资源采样到达。
- 对照 CPU、内存、磁盘与网络,选择符合问题时段的趋势范围。
- 检查进程或服务/容器信息,并在旁边的终端阅读日志。
- 完成有意的修改后重复观察,对照结果。
核对结果: 图表需要实际采样;关闭应用或连接断开会停止采集,这不是无人值守告警系统。
把空间留给终端
收窄监控可变成竖栏,降低高度可变成横栏,也可以最小化到终端底边。读数持续更新,悬停展开详情;执行命令时仍能随时关注资源变化。


Agent 与命令纠错

选择 Provider 与模型,再在终端模式栏打开 TT Agent,或输入 tt "分析这个服务的错误日志"。这是带初始提示词的交互会话。本机 Agent 可通过 wsh 操作远端;桌面退出后不会作为远端后台 Agent 继续运行。自定义 OpenAI-compatible Provider(BYOK)无需 Termia 登录,内置服务则需要配置和账号。
命令纠错在失败后提出建议,用户检查后执行或忽略。它不是输入前自动补全或主动故障检测。Git 面板只操作本机仓库;Agent 修改远端代码后,需要在远端终端审查 diff。
给 Agent 一个有边界的任务
- 打开 AI 设置,为内置 TT Agent 选择 Provider。
- 选择 Provider 与模型,在 Provider 配置里填写自己的凭据。
- 明确选择本机或远端目标,再从终端模式入口启动 TT Agent。
- 先尝试只读请求,例如:“列出内存使用最高的五个进程,不要修改任何内容。”
- 审查建议命令,并在终端验证结果;远端代码修改用远端
git diff审查,图形 Git 面板处理的是本机仓库。
核对结果: 截图展示配置与入口,不表示模型已成功运行,也不表示 AI 答案已被独立验证。
同步、导出与恢复

云同步可同步主机资料及其主密钥、片段、笔记、环境变量与独立口令封装的 SSH 密钥库。加密主机密码随已保存的主机资料同步。云冲突能被检测与列出,但当前界面还不能选择本地/云端版本或手动合并;重复点击同步不会解决同一项冲突。
ZIP 只导出主机、片段、变量和笔记四类资料,导入会按 ID 添加或更新,不删除仅本机存在的条目。它不包含 SSH 密钥、主密钥、绑定、偏好或完整工作区,不是整机备份。跨机器使用主机密码时必须安全地迁移所需凭据,或重新输入密码;不要把密钥文件提交到 Git 或公开分享。
同步前先准备恢复
- 打开安全设置,检查迁移与不可读凭据状态。
- 把本地恢复密钥与加密主机数据一起安全备份;知道正确替代值时才替换单个不可读密码。
- 仅同步当前支持的资料类型,阅读冲突与失败信息。
- ZIP 是部分资料导出,不是完整应用备份;按需另存 SSH 密钥、绑定与设置。
核对结果: 更新客户端不能撤销历史云端或 Git 副本;两端应同时升级,不要用旧版打开已迁移数据。