快速上手
当前功能指南汇总各项已实现能力与边界。
系统要求
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 密钥库——具体同步哪些内容以及如何处理 冲突,见账号与同步。不登录的本地资料库同样功能完整。