使用云同步

云同步是本地优先 Unfour 桌面应用中的可选能力。登录拥有有效 Pro 权益的账户后,为需要同步的工作区单独启用。API Client、SSH、数据库和 MCP 核心功能仍然免费且开源。

为工作区启用同步

  1. 在 Unfour 的设置 → 账号中登录,确认 Pro 权益有效;状态发生变化时使用“刷新账号”。
  2. 上传前阅读下方数据边界,移除脚本、命令模板、描述和其他共享文本中的秘密信息。
  3. 打开设置 → 云同步,确认“同步服务”已开启。在工作区菜单选择“启用云同步”,检查同步范围后选择“启用并上传”。
  4. 从工作区菜单打开“查看同步状态”,检查最近同步时间、待同步数量和问题。可暂停单个工作区,也可通过“同步服务”开关暂停所有同步。

哪些数据会同步

云同步交换经过筛选的记录,不会复制整份本地数据库。名称、主机地址、用户名、描述和普通变量值即使不是凭据,也可能属于机密信息。

工作区

名称、环境类型、MCP 策略、标识、时间戳、修订和删除状态。通用应用设置和工作区布局不属于该同步记录。

API 集合、文件夹和已保存请求

树形结构、名称、顺序、方法、URL、认证元数据、请求头、查询参数、请求体及其类型,以及保存的请求前和响应后脚本。可识别的秘密字段按下方规则脱敏。

变量与环境

环境名称和顺序;变量键名、标志、描述、顺序和非 Secret 值。标记 isSecret 的变量只同步元数据,不同步值。普通变量不会仅因名称看起来敏感就被排除。

SSH 与数据库连接

共享名称、类型、主机、端口和时间戳。SSH 还包括用户名和认证方式;数据库还包括驱动、数据库名、用户名、SSL 模式和只读设置。凭据、凭据引用和高级设备本地配置不参与同步。

SSH 任务与步骤

任务名称、描述、顺序和步骤定义,包括命令模板、远程路径和执行选项。上传/下载的具体本地路径转换为占位符,可移植变量模板可以同步。任务的连接/环境绑定、运行输入、结果和日志保留在本地。

哪些数据保留在本地

  • UI 偏好、标签页与布局、活动、诊断、缓存、当前工作区、当前环境、默认工作区和最近打开状态。
  • API 请求/响应历史、数据库查询历史与结果、保存的 SQL、SSH 终端与命令历史、任务运行与日志、传输文件内容,都不是云同步实体。
  • OS 钥匙串凭据及连接凭据引用;SSH 私钥与密钥路径;SQLite 文件和本地文件路径。每台设备都需要独立配置凭据和路径。
  • 工作区/环境变量中明确标记为 Secret 的值。适用时拉取会保留已有本地 Secret;新设备上的值可能为空,需要本地补填。这些变量值在本地未加密存储,Secret 标记不等于钥匙串或加密功能。

API 与自由文本中的秘密信息

API 快照会脱敏认证秘密值、可识别的敏感请求头与查询键、URL 密码及敏感查询值,以及 JSON 和表单请求体中的可识别秘密字段。认证类型、放置位置、键名和用户名可以同步。拉取脱敏字段时可以保留已有本地值;新设备可能需要重新填写。

推送、拉取、重试与删除

  • 已启用工作区的本地变更进入持久化上传队列。后台工作进程拉取远端变更并推送待同步本地变更,也会定期拉取;它不是实时协同编辑会话。
  • 离线时可以继续本地工作。可重试失败会保留队列变更;网络恢复、应用运行、服务及工作区同步开启且账户权限有效后,会继续重试。
  • 冲突编辑需要在本地与云端版本之间选择。打开“查看同步状态”或“处理同步问题”,检查“使用此设备版本”/“使用云端版本”。这不是自动逐字段合并。
  • 删除通过 tombstone(删除标记)传播,包括父记录删除时受支持的子记录。远端删除可能与本地编辑冲突。接受云端删除会移除对应本地记录;保留本地数据前可能需要先解决相关父级冲突。
  • 永久拒绝的变更停止自动重试,并显示在“需要恢复的更改”中。“按当前本地状态重试”会重新提交当前本地状态;“使用云端”可能丢弃该本地变更,无法安全替换时可能被阻止。破坏性恢复前请备份重要本地工作;云同步不是版本化备份。

在另一台设备打开工作区

  1. 在另一台设备安装同一个官方 Unfour 应用,登录拥有有效 Pro 权益的同一账户。
  2. 打开设置 → 云同步 → 打开云端工作区,选择可用工作区并点击“下载并打开”;不要通过创建重复的本地工作区代替此操作。
  3. 补填缺失的 Secret 值,配置本地凭据及密钥/文件路径,并在执行请求、命令或 SQL 前检查任务绑定与当前环境。
  4. 切换设备前等待待同步变更完成并检查冲突,同时检查工作区 MCP 策略:策略属于共享数据,而当前工作区选择属于本地状态。

个人 Pro 与设备限制

个人 Pro 适用于 1 位用户、最多 5 台设备。请在这些设备上使用自己的账户,它不是共享团队订阅。当前尚未启用自动设备数量限制,但许可上限仍然适用。价格与订阅条款读取共享 billing 配置,权益由可信账户服务判断。

常见问题排查

同步没有启动

检查设置 → 账号、有效 Pro 权益、设置 → 云同步 → 同步服务,以及当前工作区是否启用同步。如果本地同步上下文初始化失败,请刷新账号。

已登录但 Pro 未激活

确认桌面与网站使用同一账户,查看网站账户页,并在桌面使用“刷新账号”。结账回跳成功本身不代表权益已激活。

待同步或离线

在“查看同步状态”中检查最近同步时间与待同步数量,检查网络;离线状态会显示“重试”。恢复暂停的服务/工作区同步;会话过期提示要求重新登录时再操作。

需要处理或发生冲突

检查本地/云端选择与被拒绝的变更。普通“重试”不会解决冲突或永久拒绝的变更。只有确实要替换本地变更时才丢弃它。

下载或连接失败

本地存在同名工作区时可能需要先重命名。新设备缺失的凭据、本地路径、Secret 值或任务绑定需要本地配置;遇到协议版本错误提示时更新 Unfour。

问题仍未解决

使用工作区状态弹窗中的“高级诊断”,或设置 → 云同步 → 高级 → 复制诊断信息。私下发送给支持人员前检查内容,不要包含凭据或生产载荷。