协作编辑

与主流平台 Overleaf 的“所见即所得、实时同步”协作模式不同，LoongTeX 秉承了更为严谨与可控的协作理念，借鉴了 Git 版本控制系统的精髓，将**代码提交（commit）**作为团队协作的核心机制。

1. 协作理念

LoongTeX 深信：版本可追溯、变更可控、合并可回滚，是专业学术文档与团队项目管理的核心诉求。通过 Git 的提交、分支、合并等机制，LoongTeX 平台能够让协作者：

• 精确掌控每一次变更：只有主动提交，才会保存并共享你的修改，极大降低了误操作和无意识同步带来的困扰。
• 安全地整合多方贡献：每个人的工作都通过一次次提交被记录，历史清晰、责任明确，合并时可充分讨论和审查。
• 有效解决冲突与误差：如遇到内容冲突，Git 机制可帮助你比对、选择、甚至回退到历史版本，保证文档质量和一致性。
• 多角色协作更灵活：团队成员可以各自独立完成部分内容，无需担心同步冲突，最终通过合并机制高效协作。

2. 与 Overleaf 协作模式的对比

平台	协作方式	变更生效时机	冲突管理	适用场景
Overleaf	实时自动同步	编辑即同步	基本无冲突（后编辑覆盖前内容）	小型协作、草稿快速讨论
LoongTeX	Git 提交合并	提交后同步	有效检测并提示，需手动解决	论文、项目、需严谨审稿

LoongTeX 适合对文档质量、版本历史和团队协作流程有更高要求的场景，尤其是高校论文、科研项目报告等需要明确责任归属和历史追溯的文档协作。

3. 协作流程概述

在 LoongTeX 上协作，推荐如下流程：

1. 获取最新版本：定期拉取（fetch/pull）团队最新内容，确保在最新基础上编辑。
2. 本地编辑与保存：在自己的工作区编辑文档，保存不会立即同步给他人，确保编辑过程私密且可控。
3. 主动提交（commit）：编辑完成后，务必手动点击“提交”，将本次修改归档并上传至项目版本库。
4. 同步与合并：遇到多人同时修改时，系统会提示合并操作。可浏览冲突内容并选择保留方式，确保团队协作不丢失任何贡献。
5. 历史回溯与版本管理：随时查看历史版本，对任意时间点进行回退或比较，提升文档安全性。

4. 协作精神

LoongTeX 希望每位协作者都能：

• 尊重他人劳动成果，主动沟通合并变更；
• 充分利用“提交”与“合并”机制，保障文档质量；
• 善用版本回溯，勇于创新也无惧出错。

5. 具体协作流程

LoongTeX 的协作流程，遵循严谨的版本控制理念，保障每一位协作者的内容安全和变更可追溯。请按照以下步骤进行团队协作：

1. 获取最新版本

每次打开项目后，第一步就是拉取（Pull）团队的最新内容。

这样可以确保你是在所有成员最新提交的基础上进行编辑，避免后续合并冲突。建议养成“随时拉取”的习惯。

2. 本地编辑与保存

你可以放心地在自己的工作区进行文档编辑。保存操作只会保存到本地，不会立即同步到其他协作者。

这一机制为你的编辑提供了充分的私密性和自由度，在提交前可多次修改和调整，不必担心被他人看到未完成内容。

（当有新的内容时，协作图标上面会出现绿色的标记，用来提醒我们可以进行主动提交了）

3. 主动提交（commit）

编辑完成后，务必点击“同步更新”按钮，将当前修改归档并上传到项目版本库。

每次提交都会生成独立的版本快照，便于后续查阅和追溯。

只有提交之后，你的修改才会被其他成员看到。

4. 同步与合并

当多人同时对同一文档进行修改时，在你提交后，系统会自动检测是否存在版本冲突。 若有冲突，界面会弹出合并提示，你可以预览具体的差异内容，选择保留自己或他人的修改，或手动合并两者内容。

处理完成后，再次提交即可完成协作合并，确保每一份贡献都不会丢失。