NOTEGEN.同步配置
使用 Git、S3、WebDAV、云盘文件夹或 NoteGen 自托管服务同步数据。
NoteGen 支持 GitHub、Gitee、GitLab、Gitea、S3、WebDAV、OneDrive、iCloud Drive 和实验性的 NoteGen 自托管同步。选择的平台会成为当前主要同步方式。
同步配置
配置同步仓库，同步记录、Markdown 文件和可移植系统配置。
同步对象
| 对象 | 行为 |
|---|---|
| Markdown 与资源 | 文件级上传、拉取、删除和编辑停止后的自动同步 |
| 记录、标签、聊天、画布与设置 | 以结构化数据手动或自动上传、下载，并检测跨设备冲突 |
工作区路径、界面缩放等设备特定设置默认排除。开启“不同步敏感配置”时还会排除 Token、密码、图床、MCP 等私密配置。
平台配置
GitHub / Gitee / GitLab / Gitea
填写 Token 和仓库名。GitLab、Gitea 支持自建实例。仓库不存在时，部分平台可由 NoteGen 创建私有仓库。
| 平台 | 已有仓库的最小权限 | 创建仓库时的附加权限 |
|---|---|---|
| GitHub | Fine-grained PAT，Contents 读写 | Administration 读写，并在创建后换成仅授权目标仓库的 Token |
| Gitee | user_info、projects | 相同 |
| GitLab | api | 相同 |
| Gitea | read:user、write:repository | write:user、write:repository；旧版可能只能选择 all |
S3
配置 Access Key ID、Secret Access Key、Region、Bucket、Endpoint 和可选路径前缀。兼容 AWS S3 及提供 S3 API 的对象存储。先保存并测试连接，再启用自动同步。
WebDAV
配置服务器 URL、用户名、密码和可选路径前缀。适用于群晖、QNAP、Nextcloud 及其他兼容服务。建议使用 HTTPS。
OneDrive / iCloud Drive
桌面端可以选择 OneDrive、iCloud Drive 或其他云盘中的本地同步文件夹。Android 可以通过系统文件选择器授权云盘目录；iOS 可以把工作区迁移到 NoteGen 的 iCloud Drive 容器。迁移完成后，Markdown 与资源文件由对应云盘服务在设备间同步，原工作区保留为安全副本。
iOS 使用 iCloud Drive 前需要登录 Apple 账户并开启 iCloud Drive。NoteGen 不会获得 Apple 账户密码，也不会通过 NoteGen 服务器中转 iCloud 文件。
NoteGen 自托管（实验性）
开启开发者模式后，可以在同步平台中选择自托管服务。填写部署完成的服务器地址，注册或登录账户，并把本地工作区关联到远程资料库。服务器部署参见自托管部署。
自托管模式支持管理资料库、成员与设备，并分别控制工作区文件和个人数据同步范围。连接前确认：
- 地址使用受信任的 HTTPS；
- 恢复密钥已离线保存；
- 当前本地工作区与目标资料库对应正确；
- 首次传输方向已经明确，并且本地 ZIP 备份可用。
自托管同步仍是实验性功能。升级客户端或服务端前固定版本并备份数据库、对象存储和本地工作区。
客户端登录、资料库、成员权限和冲突处理参见连接 NoteGen 自托管服务。
多工作区与仓库映射
Git 平台可以为不同本地工作区配置独立仓库。切换工作区后检查当前仓库映射，避免把两套目录推送到同一远程路径。系统 Git 不可用、凭证过期或工作树存在异常时，先停止自动同步并查看诊断信息。
笔记自动同步
可选择关闭或在停止编辑 2 秒至 2 分钟后自动同步。还可启用“打开文件时自动拉取”和“切换文件时自动拉取”。自动拉取可能用远程版本覆盖本地，请只在同步流程稳定后开启。
记录与配置自动同步
启用后，记录或设置变更会进入顺序队列并上传。首次启用时请选择：
- 上传本机数据；
- 拉取远程数据；
- 稍后处理。
新设备通常应拉取远程；已有未同步内容的设备应先备份再决定。
冲突处理
- 合并两边内容：保留双方新增记录，同一记录优先保留更新时间较新的版本，并按隐私规则合并设置。
- 拉取远程覆盖本机：丢弃本机未上传修改。
- 上传本机覆盖远程：可能丢弃其他设备的新修改。
处理高风险冲突前，建议先从标题栏同步菜单导出本地 ZIP 备份。