从 Electron 版迁移
如果你在这台 Mac 上用过旧版基于 Electron 的 Termia,原生客户端可以把主机、设置和工作区从那里 导入过来。这一页说明什么情况下会问你、到底会拷贝什么、什么不会被拷贝。
什么时候会问你

Termia 只在某台机器上第一次启动、还没打开自己的数据库之前查找 Electron 数据。只有同时满足 以下两点才会弹出询问:
- 这是一次全新安装——原生应用自己的数据库还不存在。
- 找到了已有的 Electron 安装数据:一个数据库文件和一个配置目录。
如果找到了,会弹出一个对话框,给出三个选择:
- 完整迁移——导入配置、主机库,以及数据(数据库、Agent 设置等相关文件)。
- 仅配置和主机库——只导入配置和主机库,数据(数据库、Agent 设置)保持不动。
- 暂时跳过——原生应用什么都不导入就启动,之后的启动也不会再问。以后仍然可以把这个对话框 叫回来,见下文。
对话框明确写着原始的 Electron 数据永远不会被修改,所以选择任一种导入都不是不可逆的操作。
会导入什么
配置(「完整迁移」与「仅配置和主机库」都会导入):基本上是 Electron 应用配置目录里的一切——
settings.json、keybindings.json、你的 Vaults 资料库(主机、片段、笔记与环境变量),以及
user.json、connections.json 等文件。
数据(仅「完整迁移」):本地数据库,加上一组固定的数据文件——命令纠错的历史记忆、TT Agent 设置、Agent 附件、环境变量更新历史,以及 Vaults 的工作缓存。Termia 会自行重建的临时 SQLite 日志文件会被跳过。
拷贝完成后,Termia 会校验导入的数据库完整性,并确认 Vaults 文件数量与源目录一致;带凭据的文件 会被收紧文件权限。只要任何一项检查没通过,这次导入就会被报告为失败,不会留下一半导入的状态。
什么不会被导入
只有上面那组固定的数据文件会被拷贝——Electron 应用数据目录里的其余内容(浏览器缓存、锁文件、 socket、日志,以及可以重新生成的辅助二进制文件)都不会带过来。导入不会改变两个应用各自的数据 目录:你的 Electron 安装保留自己的数据不受影响,原生应用也保留自己的一份——这是一次性的拷贝, 不是两边之间的持续联动。
迁移前请备份 Electron 源目录与原生端目标目录,包括完整配置、数据和 vaults/master.key,并先将两端同时升级到此版本。资料库升级到 v2 主机密码格式后,旧版客户端无法读取,并可能清理不可读密码:禁止再用旧版打开已升级资料库。降级需要将升级前备份恢复到独立资料目录。参见主机密码升级。
迁移的前提条件
迁移发生时 Electron 应用必须没有在运行:它打开着的时候数据库处于锁定状态,迁移碰到锁定的源 目录会直接拒绝执行。如果看到提示这一点的错误,先退出 Electron 版再试。
如果原生应用的目标数据目录里已经有内容——比如你在决定导入之前就已经开始用原生应用——这些已有 数据会先备份到一个带时间戳的独立目录,再被替换掉,所以在已有原生数据之上做完整迁移不会悄悄 丢掉任何东西。
之后再次导入
如果当初选了「暂时跳过」后来改变主意,或者想在 Electron 版里又做了些改动之后重新导入,可以打开
设置 → 高级,在「Termia 数据」下点击「导入 Termia 数据…」。因为导入必须在数据库打开之前执行,
它会安排到你下一次启动时进行;设置页会在排入队列后给出确认提示。这条路径每次都会先备份再替换
你当前的原生数据——它是为"以 Electron 那边为准重新开始"设计的,不是把两边的改动合并在一起。