NOTEGEN.连接 NoteGen 自托管服务
从客户端登录自托管实例，绑定资料库、邀请成员并安全处理冲突。
本页说明 NoteGen 客户端操作。开始前应由管理员完成自托管部署，确认 HTTPS、就绪检查、数据库和对象存储备份正常。自托管同步当前属于实验性功能。
同步配置
配置同步仓库，同步记录、Markdown 文件和可移植系统配置。
同步方式
GitHub
配置同步仓库，同步记录、Markdown 文件和可移植系统配置。
连接
同步选项
准备
- 在现有设备导出本地 ZIP，并备份 Markdown 工作区。
- 向管理员确认服务器 URL、账户方式和兼容的客户端版本。
- 在“高级设置”启用开发者模式，使自托管平台出现在同步设置中。
- 不要让其他同步引擎同时写入准备绑定的工作区。
登录实例
打开“设置 → 同步配置 → NoteGen 自托管”，确认实验性功能提示后填写服务器 URL。优先使用浏览器授权；实例允许时也可以用登录名、密码和可选 TOTP 登录。
NoteGen 不会把已经使用 HTTPS 的地址自动降级为 HTTP。若局域网测试必须使用 HTTP，客户端会显示不安全警告；不要通过公网使用明文连接。
绑定资料库
连接后，NoteGen 会为当前工作区准备默认资料库。也可以：
- 新建资料库并为它创建独立本地目录；
- 将当前工作区切换到已有资料库；
- 查看资料库是只读还是可写；
- 在不同资料库之间切换本地工作区。
绑定前核对当前工作区路径和资料库名称。选择远程资料库可能切换本地工作区，不等于把原目录直接重命名。
成员与邀请
有权限的成员可以按登录名邀请账户，并选择 Viewer、Editor 或 Manager 角色，再细分查看历史、恢复、邀请、管理成员、重命名或删除资料库等能力。邀请可以由对方账户列表接受，也可以复制邀请链接。
只授予完成协作所需的最低权限。移除成员不会自动撤销对方已经导出的本地副本。
个人数据和冲突
工作区文件与记录、标签、聊天、画布、设置等个人数据可以分别控制同步范围。首次连接应明确上传本机还是采用远端状态。
如果一个本地工作区被错误绑定到多个资料库，客户端会显示冲突。选择正确目标后可以转移到资料库，或保留本地副本。处理前先关闭自动同步并导出 ZIP，不要连续尝试覆盖。
断开与恢复
断开连接不会自动删除本地工作区。准备重新连接前保留服务器地址、账户、恢复信息和本地备份。无法登录时先检查服务器就绪、证书、设备时间和浏览器授权回调，再联系实例管理员；不要通过公开 Issue 发送密码、TOTP、恢复密钥或邀请链接。
个人数据开关与附件
个人空间的标签、记录、会话、消息、记忆和配置可分别暂停。关闭标签时，依赖标签的记录、关联笔记、画布与消息也暂停；关闭会话时，消息暂停。重新启用会补齐远端快照；覆盖同一条目之前，会先保存仍待同步的本地修改。关闭领域不会删除已经下载的数据。
附件同步处理 NoteGen 管理的本地资源；指向外部位置的文件仍需单独备份。关闭个人附件传输不会删除已经下载的文件。工作区中的笔记附件随工作区同步。
登录令牌和同步密钥使用系统凭据库保存：macOS Keychain、Windows Credential Manager、Linux Secret Service，以及移动端既有的 Keychain / Keystore 存储。Linux 需要可用且解锁的桌面密钥环。系统凭据库不可用时连接会明确失败；旧版明文凭据只有在迁移并逐项核验成功后才删除。
切换失败时恢复本地快照
新版客户端在切换前保存文件、个人数据库和同步映射，并校验备份。若切换失败，在差异核对窗口选择“恢复切换前的数据”：
- 客户端在每次恢复或重试前另存当前状态的安全副本，保留先前副本。
- 原笔记与附件复制到独立恢复目录，故障时的原工作区保留。
- 个人数据恢复到切换前，客户端切换到本地存储，远端数据保留。
- 完成后核对文件与记录，再重新选择同步方式。窗口会显示恢复目录与安全副本位置。
恢复期间进度窗口会保持打开。如果安全副本生成后本机记录又有变化，客户端会停止数据库替换，核对后可重试。恢复设置时，备份与当前客户端任一方开启了敏感配置排除，就保留当前敏感配置。恢复开始后若中断，重启客户端并继续恢复；不要在恢复未完成时启用同步。旧版仅含文件与 personal-data.json 的快照仍可打开目录手动取回，不能用于新版自动恢复。