GitLab 与 Google Drive 同步：在 Lattuce 中选择合适的方式
比较 Lattuce 中的 GitLab Notes 同步、Google Drive Library 同步和存储选项，为笔记、PDF 和可移植文件选择合适的设置。
选择 GitLab，将 Notes 文件夹保存为可移植的 Markdown 副本。选择 Google Drive，将文档导入 Library，并从 Drive 文件夹刷新来源。你可以在 lattuce.app 上的同一研究工作流中同时使用两者。
对于研究者和作者来说，关键在于哪些内容需要保持同步：自己的笔记、阅读的文档，还是账户背后的文件。Lattuce 通过不同的连接来处理这些内容。
| 你的目标 | Lattuce 选项 | 功能说明 |
|---|---|---|
| 将笔记以易读的 Markdown 格式保存在代码仓库中 | GitLab vault 同步 | 在所选 Notes 文件夹及其子目录与仓库子目录之间双向同步 |
| 将现有的 Drive 文档用作研究资料 | Google Drive Library 导入 | 将单个文件添加为 Library 来源 |
| 让 Library 来源与 Drive 文件夹保持一致 | Google Drive 文件夹同步 | 使用镜像或引用模式，从该文件夹刷新来源 |
| 选择来源文件和附件的存储位置 | 自带存储（BYOS，如已启用） | 使用已配置的存储后端保存文件数据 |
| 无需连接其他服务即可开始写作 | Lattuce 托管存储 | 提供默认的账户存储方式 |
这些连接取决于你的账户和安装环境启用了哪些功能。先查看设置中显示的选项；仅拥有服务提供商的账户，并不会自动启用集成。
开始之前
确定要连接哪些资料，并确保你有权访问目标位置。
- GitLab： 一个 Notes 文件夹、GitLab 仓库的访问权限、一个分支，以及仓库中的专用子目录。
- Google Drive： 文件或文件夹的访问权限、Library 中可用的 Google Drive 连接，以及连接授权。
- BYOS： 已启用的存储选项，以及访问该后端所需的权限。
先从一个内容熟悉的小文件夹开始。连接较大的资料集之前，先确认文件会出现在哪里，以及更新的处理方式。
1. 当笔记本身需要随你迁移时，选择 GitLab
假设你的文献综述笔记需要与研究文档一同保存在仓库中。GitLab vault 同步会将一个 Lattuce Notes 文件夹（包括其子目录）连接到指定分支和子目录。
这些文件采用兼容 Obsidian 的 Markdown 格式。同步是双向的，因此连接既能将仓库中的更改带回 Notes，也能将 Notes 中的更改发送到 GitLab。
必须指定子目录；仓库根目录不能作为同步目标。该子目录之外的更改不在此连接的范围内。这一边界有助于你在仓库中的其他资料旁边管理笔记。
GitLab 的一项突出优势是变更历史清晰易读。Git 提交会记录检查点，GitLab 可让你查看这些检查点之间的差异。当你需要找回早先的说明，或回顾一则笔记如何逐步形成时，这会很有帮助。GitLab 提交文档
打开 账户设置 → GitLab vault 同步，选择 Notes 文件夹，并配置仓库、分支和子目录。进行小幅编辑后，检查生成的 Markdown 文件和同步状态。
自动同步会在更改保存后短暂延迟再触发。请以显示的状态确认远端副本已更新；保存笔记并不保证 GitLab 已经收到它。
2. 当阅读资料存放在 Google Drive 时，选择它
Drive 很适合存放实验室中的 PDF、文档及其他辅助文件。它的优势在于熟悉：你可以继续在协作者已经使用的位置整理来源资料。
在 Lattuce 的 Library 中，Google Drive 面板支持导入单个文件，也支持连接文件夹以持续更新来源。文件夹同步有两种模式：
- 镜像副本： Lattuce 通过已配置的文件存储后端保存副本。
- 从 Drive 流式读取（引用）： 来源指向 Drive 中的原始文件，同时 Lattuce 仍会提取内容，并可能缓存处理所需的数据。
两种模式都会保留 Drive 中的原始文件。需要为 Library 工作流保存副本时，选择镜像模式。希望 Library 引用 Drive 原文件，而不是维护完整的镜像文件副本时，选择引用模式。引用模式下，Lattuce 仍会提取内容，并可能缓存数据。
单个文档使用 导入文件，小型文件夹使用 同步文件夹。选择模式并确认来源已就绪。然后更新一个文档，选择 立即同步，再确认 Library 中已反映更改。
如果已连接的文件被删除、移出同步范围或移至废纸篓，其 Library 来源可能会被标记为不可用。不要假设在 Drive 中移除文件就会删除 Lattuce 中与之关联的所有记录。
Drive 文件夹同步会刷新来自 Drive 的 Library 来源。这与将 Notes 文件夹作为 Markdown 文件双向同步是不同的工作流，也不会让 Lattuce 文档拥有类似 Google Docs 的实时协同编辑功能。
3. 将文件存储与账户同步区分开来
自带存储（BYOS）解决的是文件数据存放在哪里的问题。根据启用的选项，Lattuce 可使用 Drive 或兼容 S3 的存储来保存来源文件和附件。
选择文件后端，并不会将你的身份、账户元数据以及所有工作区记录都迁移到该服务提供商。Library 的 Drive 连接与 Drive 存储后端也有不同用途，尽管两者都使用 Google Drive。
托管云端的默认存储足以让你开始使用。使用 Lattuce 并不需要 GitLab 仓库。当存储位置成为必要条件时，请结合账户中可用的设置阅读 BYOS 指南。
4. 在依赖同步之前，了解冲突处理与恢复方式
如果同一条笔记在 Lattuce 和 GitLab 中都发生更改，可能需要你决定如何处理冲突。冲突会暂存以供检查，你可以选择保留本地版本、GitLab 版本，或同时保留两者。这是一个审核步骤，并不代表支持实时协同编辑。
GitLab vault 同步覆盖所选的 Notes 文件夹，不应被视为完整账户备份或完整附件库。Lattuce 自带的版本历史也是值得了解的恢复功能。
Notes 的本地缓存和设备同步队列也独立于 GitLab 连接。有关可用工作流和设置详情，请参阅 MCP 与本地同步。
Dropbox、OneDrive、Nextcloud 或 Syncthing 怎么样？
其他文件工具可以帮助你在 Lattuce 之外整理或同步普通导出文件。但这不意味着它们能作为 Notes 或 Library 的原生连接互换使用。请查看集成与同步指南，了解受支持的方式。
实用的研究设置可以用 Drive 管理共享来源文档，用 GitLab 保存可移植的阅读笔记，再用 Lattuce 完成将两者连接起来的研究和写作工作流。根据每种连接负责的资料来选择，然后先验证一次完整的更新流程，再扩大使用范围。