跳到主要内容

快速上手

当前功能指南汇总各项已实现能力与边界。

系统要求​

macOS 版 Termia 需要 macOS 13(Ventura)或更高版本。它完全运行在你的 Mac 本机上:打开本地终端、 把主机存进资料库都不需要账号,也不需要网络连接。登录是可选的;云同步和内置模型需要登录,BYOK 不需要。

首次启动​

从实际启动页选择本机终端或已保存主机。
从实际启动页选择本机终端或已保存主机。查看原图 ↗

Termia 是单实例应用:在它已经在运行时再次打开,只会把已有窗口带到前台,而不会启动第二份实例。 用 open -a Termia <文件夹> 打开某个目录,或把文件夹拖到 Dock 图标上时,Termia 会在启动完成后 打开这个目录。

Termia 第一次在某台机器上启动时,会根据是否发现已有数据来决定显示什么:

  • 全新安装会显示一个可以直接输入的本地终端。
  • 如果 Termia 发现已有数据库,或者资料库里已经保存过主机——比如你是从 Electron 版迁移过来的 (见从 Electron 版迁移)——它会改为显示主机库,让你回到熟悉的 界面。

这个首次决定会写进设置里的启动页(见下文),此后每次启动都只按设置执行,不会重新判断。

启动页设置​

选择适合日常工作流的启动页行为。
选择适合日常工作流的启动页行为。查看原图 ↗

设置 → 通用 → 启动 → 启动页 决定应用启动或新窗口打开时显示什么(从 Dock 重新打开会恢复保留的 窗口;菜单里的「新建窗口」总是新建一个)。有三个选项:

选项看到什么
本地终端一个可以直接输入的本地 shell。
恢复上次恢复上次的活动标签页、面板焦点、布局与窗口位置,和你离开时一模一样。
主机库主机库先出现。

「恢复上次」不会重新执行任何命令——它只恢复哪个标签页和面板拥有焦点、面板布局,以及窗口的 位置和大小。如果当时的活动标签页连着一个远端连接,除非打开下面这项设置,否则不会自动重连。

自动重连​

设置 → 通用 → 启动 → 恢复远端标签页时自动重连 默认关闭。关闭时,恢复出来的远端标签页会显示 「未连接」和一个「重连」按钮,而不是自己连上——由你决定什么时候重连。打开它,这些标签页会在 启动时自动重连。

无论开关如何,断开连接背后的远端进程都不会在断开后存活——连接一断,那里正在跑的东西也就结束了。 如果希望远端会话能在断开后继续跑,请在远端主机上使用 tmux 或 screen。

打开你的第一个本地终端​

如果启动页设为「本地终端」(全新安装的默认值),你已经有一个了。要再开一个,用 ⌘L(文件 → 新建本地终端)新建一个标签页,或者用面板标题条的「+」在当前标签页里再加一个终端面板。

连接你的第一台主机​

先填写主机身份,再选择认证方式并打开会话。
先填写主机身份,再选择认证方式并打开会话。查看原图 ↗

打开主机库(文件 → 主机库,或把启动页设为「主机库」)。点击工具栏里的「新建主机」打开主机编辑 表单,填好地址和连接信息后保存。回到资料库列表,双击主机卡片——或者选中它按回车——即可连接, Termia 会在新标签页里打开这个连接。

你也可以直接在资料库的搜索框里输入,比如 user@host,按回车会直接连接,不需要先建一条保存的 条目。

选择界面语言与外观​

设置 → 通用 → 语言 设置界面语言。选项有跟随系统、中文、English、日本語和 Español。改动会立即 在所有打开的窗口和菜单栏生效,不需要重启。

设置 → 外观 → 主题 设置应用外观:跟随系统、深色或浅色。

配置与数据的位置​

Termia 把文件存在 ~/Library/Application Support/ 下以应用命名的文件夹里,分成两个子目录:

  • config/——settings.json、keybindings.json,以及你的 Vaults 资料库(主机、片段、笔记与 环境变量),还有 user.json、connections.json 等文件。
  • data/——本地数据库,以及 Agent 设置等其他工作文件。

日常使用不需要直接编辑这些文件;需要时可以在 设置 → 高级 里从应用内查看和编辑 settings.json。

登录​

登录是可选的。在主机库侧栏的账号一行会显示「本地资料库」,并提示登录后可跨设备同步。点击它会 打开浏览器完成登录。登录后,这一行会改为显示你的邮箱地址。

登录后可同步主机及其主密钥、片段、笔记、变量与独立口令封装的 SSH 密钥库——具体同步哪些内容以及如何处理 冲突,见账号与同步。不登录的本地资料库同样功能完整。