# 跨设备同步部署

将新包解压到 /opt/www，网页目录仍为 /opt/www/ai-trainer-quiz/www。

安装后端（Node.js 24，无需 npm 安装依赖）：

```sh
sudo bash /opt/www/ai-trainer-quiz/install-sync.sh
curl http://127.0.0.1:3500/api/health
```

在现有 Caddy 配置中只修改题库站点，保留其他域名：

```caddyfile
aitrainer.lsily.cn {
    root * /opt/www/ai-trainer-quiz/www
    encode gzip
    header Cache-Control "no-cache"
    reverse_proxy /api/* 127.0.0.1:3500
    file_server
}
```

```sh
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
```

电脑、手机使用完全相同的用户名（区分大小写）登录。无密码，知道用户名即可访问此人的记录。
首次云端没有存档时导入当前浏览器记录；云端已有记录时优先读取云端，避免另一设备覆盖。
默认用户只保存本机记录，不读取或上传服务器。切换到具名账号时导入默认用户的本地记录；具名账号启用跨设备同步。
离开前等待“已同步到服务器”。其他设备每15秒检查更新；同时操作发生冲突时按提示刷新。
离线修改先保存在本机，但若云端已有新版本，刷新会以云端为准。
存档位于 /var/lib/ai-trainer-quiz，更新网站不会删除。请定期备份这个目录。
本地 file:// 预览仍使用浏览器存档，跨设备同步必须访问部署后的网址。

诊断：systemctl status ai-trainer-quiz；journalctl -u ai-trainer-quiz -n 50。