故障排查
云同步不只是“网络通不通”的问题。
Contextify 同步只连接一个已配置的目标：托管版 Contextify Cloud，或你的自托管服务器。如果这个目标无法访问，即使其他网站都能正常打开，应用也可能处于离线状态。
状态说明
| 状态 | 含义 | 处理方法 |
|---|---|---|
| “Healthy”（正常） | 最近一次检查时，Cloud 同步已是最新状态。 | 无需操作。 |
| “Syncing”（同步中） | Contextify 正在上传最近的更改，或下载远端的更改。 | 等它完成即可。本地导入完成后，大规模补同步仍可能需要一些时间。 |
| “Waiting”（等待中） | 需要先完成对话记录导入，才会开始同步。 | 等本地索引稳定下来。参见 导入与同步。 |
| “Deferred”（已推迟） | 导入对话记录期间，同步会暂停。 | 它会自动重试，你也可以稍后手动同步。 |
| “Offline”（离线） | 无法连接已配置的云端目标。 | 检查目标 URL、DNS、VPN 和服务器健康状态。 |
| “Attention needed”（需要处理）或“Error”（错误） | 最近一次同步尝试失败，或同步进度需要检查。 | 在“Settings → Cloud”（云端设置页）中使用“Retry”（重试）和“Copy Diagnostics”（复制诊断信息）。 |
从“Settings → Cloud”开始
-
查看最新错误
错误框显示最近一次本地或服务器端的同步失败，也会显示已配置的目标，以及上次检查状态的时间。
-
点击“Retry”
“Retry”会重新加载已保存的云端配置、触发同步、刷新状态，并刷新账号详情。
-
复制诊断信息
“Copy Diagnostics”复制的内容包括服务提供方、服务器、设备名称、状态、上次检查时间，以及脱敏后的状态错误和账号错误。
托管版 Cloud 检查
托管版 Cloud 使用 cloud.contextify.sh。如果其他网站都能访问，唯独托管版 Cloud 不行，不要急着认定“网断了”。请检查这个具体目标。
curl -i https://cloud.contextify.sh/api/v1/health
contextify cloud status --json托管版 Cloud 的 DNS 解析失败可能在重试后恢复。如果一直失败，通常说明本地 DNS 设置有问题、所在网络屏蔽了访问，或服务端出现了故障。
自托管检查
自托管同步严格依赖已保存的服务器 URL。请检查协议、主机名、端口、VPN 和 TLS 证书名称。
curl -i https://your-server.example.com/api/v1/health
contextify cloud status --json
contextify cloud sync --json
对于通过 Tailscale .ts.net 域名访问的服务器，DNS 解析失败往往说明 macOS 上的 MagicDNS 解析器状态异常。你可能需要重新连接 Tailscale，或重置它的 VPN 配置。
怎样最快获得支持
“Copy Diagnostics”在设计上会省略机密信息，但发送前仍请检查一遍。请附上诊断信息、去掉机密信息的服务器 URL、目标是托管版还是自托管，以及 curl 能否访问 /api/v1/health。
还请说明：出现同步问题时，这台 Mac 是否仍在建立索引，或仍在处理大量本地历史记录。
不要发送原始 API 密钥、浏览器 Cookie、邮件登录链接（magic link）、OTP 验证码或配置令牌。
最后更新：2026 年 5 月 6 日