Aldine — 自托管 LaTeX 协作平台

Aldine 是一款精简的开源自托管 LaTeX 协作编辑平台，可作为 Overleaf 的替代方案。它支持多人实时协作编辑，每个项目都是完整的 Git 仓库，集成 Zotero 文献管理和 MCP 协议对接 AI 助手（如 Claude）。用户无需注册账号即可体验在线演示，部署仅需两个容器，维护成本极低。

核心功能

实时协作编辑

基于 Yjs CRDT 算法实现多人同时编辑，每位协作者的光标位置和修改内容实时可见，支持无限人数同时参与。由于采用 CRDT 结构，文档冲突在数学层面已消除，不会出现覆盖或丢失。

Git 原生版本管理

每个项目对应一个真实的 Git 仓库，用户可以在界面内创建分支、合并分支、查看历史记录。编辑内容以标准 commit 形式存储，可直接在 VS Code 等外部编辑器中继续工作，通过 Pull Request 将外部改动同步回 Aldine。

Zotero 文献集成

内置 Zotero 文献库同步面板，支持按标题搜索论文（调用 OpenAlex 接口）或直接粘贴 DOI 自动拉取引用信息。点击引用条目即可将 BibTeX 条目追加到文献文件，并在光标位置插入 cite 命令，文献引用全程无需手动编辑 BibTeX。

沙箱编译环境

LaTeX 编译运行在无外网访问的容器内（已降权、限制 shell escape），内置 TeX Live 和 latexmk，支持增量编译。冷启动后热编译约 2 秒出结果，编译错误会显示精确的文件名和行号，点击可跳转到编辑器对应位置。

MCP 协议 AI 协作（可选功能）

可选启用 MCP（Model Context Protocol）接口，连接 Claude 后 AI 可以直接写入文档、自动触发编译并在界面上展示 PDF 结果。AI 的每一步操作均以 "Claude" 作者身份生成 Git commit，用户可随时审查或回退。整个 AI 协作流程在同一个 git 历史中可完整回溯。

GitHub / GitLab 同步

支持从 GitHub、GitLab、Gitea 或 Forgejo 导入项目作为远程仓库，也支持将本地项目推送到上述平台。发布后可继续在 VS Code 等外部编辑器中工作，外部 commit 通过 Pull Request 合并回 Aldine。

技术实现

Aldine 的核心架构分为编辑器层、编译层和 Git 同步层三个部分。

编辑器层采用 CodeMirror 6 作为代码编辑组件，配合 Yjs 实现无冲突协作。每个在线用户的操作首先进入 Yjs 的 CRDT 文档，再通过 WebSocket 广播给所有连接用户，光标位置和用户身份信息通过 y-protocols 独立同步。

编译层使用 TeX Live 镜像作为基础环境，通过 latexmk 驱动增量编译流程。编译容器在 Kubernetes/Docker 环境中以无 egress 权限的安全上下文运行，网络访问仅限内部 API，文件系统写入范围受限于项目目录。

Git 同步层在服务端维护每个项目的 Git 工作目录，用户的分支操作、commit 推送均通过 libgit2 在服务端执行。外部编辑器推送的 commit 通过 webhook 或定时轮询同步到 Aldine 内部 Git 状态。

MCP 接口通过标准 MCP 协议连接外部 AI 模型服务，Claude Desktop、claude.ai 或任何兼容 MCP 的客户端均可接入。

快速上手

第一步：访问 https://demo.aldine.dev 进入在线演示环境（每日重置，无需注册）。或访问 https://aldine.dev 了解更多信息。

第二步：准备好一个 LaTeX 项目文件夹，将 ZIP 包拖拽上传到 Aldine 首页，系统会自动检测根目录的 .tex 文件并触发首次编译。

第三步：点击右上角 "Share" 复制协作链接，邀请同伴加入。所有人可在同一文档中实时编辑，Aldine 会实时显示各自身份光标。

第四步：启用 Zotero 面板（左侧工具栏），连接你的 Zotero 文献库，搜索并插入引用；或启用 MCP 功能，连接 Claude 让 AI 协助撰写和润色内容。

第五步：编辑完成后点击 "History" 查看完整 git 记录，或将项目推送到 GitHub 保存。后续可在 VS Code 中继续编辑，commit 自动同步回 Aldine。

适用人群

• 学术论文作者和研究团队，尤其是需要多人协作撰写长篇论文或学位论文的群体
• 理工科研究生和博士生，用于撰写期刊论文、毕业论文或项目报告
• 技术写作者和开源项目维护者，用于编写规范的技术文档
• 需要自建 LaTeX 协作环境、重视数据主权的高校实验室或企业内部团队
• 对接 AI 助手辅助写作、有完整 git 历史审查需求的写作者

出品方

由个人开发者 trahlöff 主导的开源项目，采用 AGPL-3.0 开源许可证。项目代码托管于 GitHub，欢迎 issue 和 Pull Request。