保管库同步与版本管理
Termia 的资料在本机保存。可选云同步、本地 Git 版本和 ZIP 导入/导出是三种独立机制;它们都不能直接等同于完整凭据与工作环境备份。
登录与退出
从 标签栏头像 → 设置 → 账号 发起登录,应用会在系统浏览器打开配置的服务登录页,完成后通过本地回调建立会话。等待时可以取消;失败或超时后重试。源码构建的终端、主机库与 BYOK 都无需账号,云服务与内置模型则需要配置可用服务。
退出登录默认保留本机资料。启用云同步后,选择清理本地资料会在核对云端副本后删除资料库文件,包括主机与主密钥。清理前查看确认内容,需要保留本机资料时选择保留。使用内置 Provider 的 TT Agent 会停止,BYOK 会话不依赖平台登录。
当前云同步范围

打开 设置 → 同步,或主机库同步状态。可启用 Termia 同步、自动同步、设置间隔或手动同步;状态显示最近成功/失败时间、错误与受影响文件。云同步只发生在本机与自己的账号之间。
| 数据 | 当前行为 |
|---|---|
| 片段、环境变量、笔记 | 可云同步;正文与变量值可能包含敏感信息,请先检查。 |
SSH 密钥库 keys.yaml | 以独立口令封装的形式同步;另一设备仍需该口令解锁。 |
主机 hosts.yaml | 同步已保存主机及加密密码,供登录同一账号的设备使用。 |
主密钥 master.key | 随主机库同步,使另一设备能读取主机加密密码。 |
| 界面偏好、完整工作区、记忆绑定、模型 API Key | 不属于此资料云同步机制。 |
主机与主密钥使用现有账号服务同步。主密钥先采用云端版本,再同步主机文件。主动更换主密钥后,先上传新密钥,再同步重新加密的主机资料。
冲突与错误
资料按最后共同版本比较并尝试逐条合并;同一条目在两边有不同修改时会记录冲突。界面显示冲突数和文件名,但尚无保留本地、采用云端或手动合并界面。重试可以恢复网络故障,不能决定哪份冲突内容应获胜。不要反复修改两边来碰运气;保留两份资料,避免覆盖要保留的版本。
主机密码安全

两端 设置 → 安全 → 主机密码安全 显示本地主密钥状态、待升级旧密码与不可读密码数量。点击刷新/重试重新检查并尝试升级。新存储采用随机 nonce 的版本化认证加密;能够用当前本地主密钥解密的旧格式会升级,不可读值保留原密文并显示警告。
主机编辑器不回显已存密码。留空保留现有值;不可读时可以恢复原主密钥或重新输入该主机密码。不可读凭据尚未恢复时,改变主机身份或更换主密钥会被拒绝,防止把无法恢复的数据悄悄改写。
更换本地主密钥会重新加密可读取的主机密码,需要确认。它不是 SSH 密钥库口令,也不会恢复丢失的旧主密钥。master.key 存在本地配置目录的 vaults 下,以仅文件所有者可读写权限保存;本地文件系统被访问时,这不是系统钥匙串或全盘加密的替代品。
两端同时升级
首次启动此版本前,请关闭两端,备份完整的本地数据与配置目录,包括 vaults/hosts.yaml 和 vaults/master.key,然后同时升级 Electron 与原生 macOS 端。资料库迁移到 v2 密码格式后,禁止再用旧版客户端打开同一份资料库:旧版无法读取 v2,并可能清理它认为不可读的密码。需要降级时,将迁移前备份恢复到独立资料目录,同时保留已升级的资料目录。ZIP 导出不包含主密钥,不能单独用于此类回退。
本地 Git 版本

打开 保管库的 Git / 同步与版本页面,先初始化仓库,再有意识地提交检查点。Git 使用桌面电脑上的系统 Git 与其凭据配置;该资料仓库和普通本机仓库的 Git 面板都不操作服务器仓库。
Electron 页面可暂存/取消暂存、审查差异、丢弃变更、提交、浏览历史与推送/拉取。原生 Mac 的资料历史面板提供初始化、提交全部、设置远程、推送/拉取和提交记录。分支、恢复旧提交、复杂合并冲突仍需在 shell 中操作 Git。
Termia 会在资料仓库操作前添加忽略规则并取消跟踪 master.key、keys.yaml、.sync-base/,以阻止后续提交它们;不会清理已经提交或推送的历史。不要把含密码、秘密变量或运维资料的仓库推到公开远程。若密钥曾暴露,忽略规则不能撤销泄漏,需要处理远程历史并轮换凭据。
ZIP 导入与导出
资料库更多菜单中的导出只包含四个文件:hosts.yml、snippet.yml、envvars.yml、notebook.yml。它不包含主密钥、SSH 密钥库、绑定、设置或工作区,不是完整备份。
导入按条目 ID 添加或更新,不会删除只存在于本机的条目;同 ID 条目可能被导入内容更新,建议先导出保留当前资料。完成后检查新增/更新数量与错误;部分分类失败可能产生部分成功的结果。
导出的主机密码仍是原密文。换机器导入而缺少对应本地主密钥时无法解密;需要重新输入密码或另行安全迁移凭据。勿将 ZIP 当成可无条件恢复登录的备份,也不要公开上传它。