Oleafly

Oleafly ^beta

Deutsch | English | Español | Français | 日本語 | 한국어 | Português | Русский | 中文 | العربية

面向研究写作的 LaTeX、Typst 和 Markdown 实时协作编辑器。

Oleafly 是一款功能强大的研究写作编辑器，支持 LaTeX、Typst 和 Markdown。项目的源文件、PDF、引文、插图、检查项和 Git 历史都集中在一处。与合著者实时协作写作，在不同电脑间同步项目，还可以在项目中使用 Claude Code、Codex 或任何你喜欢的模型。

免费下载 · 阅读指南 · 运行服务 · 从源代码构建

永久免费 · 开源 · 无需 Oleafly 账号 · 不追踪用户

这里的所有功能都免费，包括其他编辑器仅在付费方案中提供的功能：邀请多少位合作者都能实时协作、完整版本历史、Git 和 GitHub 同步、Zotero、语法检查和 AI。

• 与合作者实时写作，共享光标和评论；实验室只需用一条命令即可设置服务器。
• 专为长文档打造的编辑器：标签、引文和命令补全，实时错误检查，整个项目的大纲，Vim 和 Emacs 按键，视觉模式，以及可搜索的 236 种 LaTeX 符号面板。
• 在自己的电脑上编译。内置 Tectonic、Typst 和 Pandoc；项目需要完整发行版时，则使用 TeX Live、MacTeX、MiKTeX 或 TinyTeX。
• 点击 PDF 即可跳转到源文件并返回；修复错误时，屏幕上会继续显示最近一次成功生成的 PDF。
• 每个项目都是一个 Git 仓库，你可以将其推送到 GitHub、GitLab、Gitea、Forgejo、Codeberg 或自己的 Git 服务；每次成功编译后，检查点都会保存一份快照。
• 输入时即可引用 Zotero 文献库中的文献，还能搜索 arXiv、Semantic Scholar、Crossref、PubMed 和 OpenAlex，无需离开编辑器。
• 针对学术写作优化的拼写和语法检查在你的电脑上运行。
• 提交前，预检会检查损坏的引用、缺失的图片、未嵌入的字体、无障碍问题，以及任何可能暴露评审身份的内容。
• 绘制的图表会保留为 TikZ、Typst 或 Mermaid 代码，还可以从 1,700 多个论文、学位论文、幻灯片、海报和简历模板开始创作。
• 从 Word、PDF、arXiv 源文件、Git 仓库或在线 LaTeX 账户导入。
• oleafly 命令可在任何终端或 CI 任务中构建、检查和同步项目，使用的编译器和设置与应用相同。
• 云同步可让你的项目在每台电脑上保持同步，你也可以离线继续写作。
• Claude Code、Codex 和另外 12 个 Agent 可在项目中工作；你也可以连接任何模型，包括本地模型。AI 是可选的，它所做的每项更改都会以差异形式呈现，供你审核和撤销。
• 研究任务会在项目的单独副本中执行文献综述、证据审查或修订检查，你可以在继续写作的同时进行这些任务，并选择保留哪些更改过的文件。这些功能目前处于实验阶段，默认关闭；前往 Settings > Experimentation 可启用。

实时协作写作

将项目共享到实验室的 Oleafly Server，所有人即可同时编辑相同的文件。你可以看到每个人的光标和选区、谁在线，以及你离开期间发生了哪些更改。点击某人的头像即可跳转到对方正在编辑的行。

• 在 LaTeX、Typst 或 Markdown 的任意选区上发表评论，然后回复、提及他人、解决或重新打开评论。被提及的合作者会收到一封邮件，也可以关闭邮件通知。
• 离线时所做的编辑会在重新连接后合并。如果编辑内容与他人的修改重叠，Oleafly 会同时显示两者，并在应用任何更改前征求你的确认。
• AI 编辑、Zotero 引文、重命名、删除和图表也会同步传输。如果两个人同时替换同一张图表，两个版本都会保留。
• 主文件、编译器、拼写检查语言和 Typst 选项会共享，因此整个团队都能以相同方式编译项目。
• 每个项目都有所有者、编辑者和查看者。通过电子邮件邀请的访客只能看到邀请他们加入的项目。

自行运行服务

Oleafly Server 只需一条命令即可安装到 Linux 机器上，无论是实验室工作站、大学 VM，还是小型云服务器：

curl -fsSL https://oleafly.com/server/install.sh | sudo sh

它是一个独立的 Rust 二进制文件，使用 SQLite，将文件保存在磁盘或任何兼容 S3 的存储中，并可在完成配置后通过 SMTP 发送电子邮件。用户可以使用 GitHub 或任何 OpenID Connect 提供商登录，因此也支持大学的单点登录。它提供适用于 Docker Compose、Coolify、Render 和 systemd 的现成配置，以及 Railway、Cloudflare Tunnel 和大学证书的指南。

管理员可以在 Oleafly 中使用控制台管理用户、访问规则、项目、电子邮件和安全日志。每台设备都会为其更改签名，服务器则根据这些签名历史构建每个快照，而不是盲目信任上传内容。

请阅读服务指南，了解设置、备份以及完整的权限说明。

在多台计算机间云同步

开启云同步后，你的文库项目和应用设置会随你从一台计算机迁移到另一台计算机。每次下载都会先与记录核对，然后才替换文件；你正在编辑且尚未保存的文件绝不会被覆盖。

• 两台计算机同时编辑同一文件时，会保留两个版本，并分别以编辑该文件的计算机命名。
• 一次删除项目的大部分内容时，项目会暂时搁置，直到你确认，以免一次误操作导致所有设备上的项目都被清空。
• 在另一台计算机上删除的文件会移到此处的废纸篓，而不是直接消失。
• 在新计算机上，Oleafly 会询问一次，是保留此计算机的设置，还是使用同步的设置。

随身携带你的项目

要从在线 LaTeX 编辑器迁移过来？只需在 Oleafly 中登录一次你的账户，选择想要的项目，它们就会连同文件、编译器和主文件一起导入，可直接编译。大学自有服务器也支持此功能。

使用该账户的 Git 令牌，Oleafly 可以双向同步导入的项目，让仍在线协作的合著者继续按原有方式工作。双向同步使用服务自带的 Git 集成，项目所有者的账户需要拥有付费方案或大学方案。

你也可以从项目 ZIP 文件、GitHub 仓库、Word 文档、arXiv 源文件包或 PDF 开始，Oleafly 会将 PDF 重建为可编辑的 LaTeX。也可以直接打开已有项目文件夹。

在项目中工作的 AI Agent

从目录中选择一个 Agent，它就能在项目中工作，并随时访问源文件、PDF 和编译日志。每个 Agent 都使用自己的账号登录，并使用自己的模型。Oleafly 为它提供项目及其周边工具。

Claude Code	Codex CLI	Gemini CLI	Pi	OpenCode	OpenClaw	Cline
Hermes Agent	CodeBuddy	Kimi Code	Grok Build	Cursor	DeepSeek Harness	Qoder

_{这些标识用于标明兼容的工具，所有权归各自所有者所有。它们不代表任何背书。}

更喜欢聊天助手？连接托管服务提供商、任意 OpenAI 兼容端点，或本地 Ollama 模型。

• 每项文件更改都会以差异形式显示。逐项批准更改、让助手自主工作，或为每种工具设置规则；还可以撤销单个文件或整个轮次的更改。
• 规划模式会先梳理项目，再进行任何写入操作。
• 文献综述或修订工作可以在独立的 Git worktree 中运行，同时你继续写作。由你决定保留哪些已更改文件。
• 应用内置 39 项研究技能，包括文献检索、相关工作梳理、论点核查和回复信撰写。
• 本地 MCP 服务允许外部 AI 客户端使用相同的项目工具。它仅监听 127.0.0.1。
• oleafly mcp 通过 stdio 向 Claude Code、Codex、Cursor 和 Gemini CLI 提供项目工具，无论应用是否打开均可使用。

AI 是可选的。关闭 AI 后，编辑器、编译器、PDF、引文、校对和检查功能仍可正常使用。

在你的电脑上编译 LaTeX、Typst 和 Markdown

应用内置 Tectonic、Typst 和 Pandoc，因此新项目无需安装任何内容即可编译。如果项目需要完整的 TeX 发行版，可切换为使用 TeX Live、MacTeX、MiKTeX，或由 Oleafly 为你安装的 TinyTeX 的 latexmk。

• 点击 PDF 即可跳转到源代码，反之亦然。LaTeX 使用 SyncTeX，Typst 0.13 或更高版本使用 Tinymist。
• 编译错误会链接到导致错误的行；修复期间，屏幕上会保留上一次成功编译的 PDF。
• 视觉模式让你在类似页面的视图中编辑，并可一键查看源代码。
• 为整个项目中的标签、引用、命令、环境和文件路径提供补全与实时诊断。
• 拼写和语法检查在本地运行，并针对学术写作进行了优化。
• 支持 XeLaTeX、LuaLaTeX，以及用于日文文档的 upLaTeX 或 pLaTeX。

引用、插图、检查与模板

输入时即可引用 Zotero 条目 输入 @ 和作者、标题或年份的一部分，即可引用 Zotero 文献库中的条目。Oleafly 只会将该条目添加到项目的 .bib 文件中。引用搜索涵盖 arXiv、Semantic Scholar、Crossref、PubMed 和 OpenAlex。	绘制图表，代码始终保留 图表编辑器可在画布上绘图，并生成 TikZ、用于 Typst 的 fletcher 或 Mermaid 代码。修改绘图或代码，另一方也会随之更新。
提交前先检查 Preflight 会查找失效的引用、缺失的插图、未嵌入的字体、无障碍问题，以及任何可能在盲审中暴露作者身份的内容。它提供适用于 arXiv、IEEE、ACM、期刊和学位论文的配置。	从 1,700 多个模板开始 提供文章、学位论文、Beamer 演示文稿、海报、简历和会议风格论文，每个模板都可在创建项目之前预览渲染效果。

Git、历史记录和终端

每个项目都是普通文件夹，包含一个普通的 Git 仓库。你可以在源代码管理面板中暂存、查看差异、提交、推送、拉取，并发布到 GitHub、GitLab、Gitea、Forgejo、Codeberg 或自己的服务；也可以使用自己的终端，因为没有任何内容对它隐藏。每次成功编译后，检查点都会保存本地快照，因此无需创建提交即可回滚。

编辑器下方有一个终端停靠区，每个项目最多可打开十个标签页。在输出中按住 Cmd 并点击（Ctrl 并点击）文件路径，即可在对应行打开文件。

oleafly 命令可通过任意终端操作同一批项目：构建、监视、提交前检查、与在线 LaTeX 服务同步，或运行 Oleafly Agent，无需打开应用。每条命令都可以输出 JSON，并为脚本和 CI 提供稳定的退出代码。请参阅命令行指南。

还有更多

1. 下载 Oleafly 到你的电脑。
2. 使用模板创建项目、导入项目，或打开已有文件夹。
3. 按 Cmd+Enter（Windows 和 Linux 上按 Ctrl+Enter）进行编译。
4. 如需与他人共同写作，请点击 分享，并将项目发送到你所在实验室的 Oleafly Server。

平台	安装包	下载
macOS · Apple Silicon	DMG
Windows · x86_64	MSI 或 EXE
Linux · x86_64	AppImage、DEB 或 RPM
Linux · ARM64	AppImage、DEB 或 RPM

在 x86_64 上，Linux 安装包需要 glibc 2.35 或更高版本（Ubuntu 22.04 或更高版本）。ARM64 安装包基于 Ubuntu 24.04 构建。发行版包含经过签名的更新文件，应用内更新程序会在安装任何内容之前检查签名。

常见问题

了解更多

• 产品指南
• Oleafly Server
• 功能一览
• 编辑器指南
• PDF 预览
• 引用与文献
• 工具库
• 预检与无障碍检查
• 模板
• 图表编辑器
• Git 与源代码管理
• 检查点
• AI Copilot
• 技能
• MCP 集成
• 命令行工具
• 开发环境设置
• 更新日志

社区与支持

加入 Oleafly 的 Discord 社区，提出问题、解决棘手的构建问题、展示你的写作成果，并为下一步开发内容投票。社区免费向所有人开放。更喜欢 GitHub？请在 GitHub Issues 中报告错误或提出功能请求。

Oleafly 由 Prajwal Murthy 和贡献者共同构建。欢迎为代码、模板、文档作出贡献，也欢迎提供反馈。阅读贡献指南，了解如何参与。

⭐ 帮助我们触达更多研究人员和开发者，壮大 Oleafly 社区。为此仓库点星！

引用 Oleafly

@software{oleafly,
  author  = {Venkateshmurthy, Prajwal S. and {The Oleafly contributors}},
  title   = {Oleafly: a local-first workspace for research writing},
  year    = {2026},
  version = {0.4.8},
  url     = {https://github.com/Oleafly/Oleafly},
  license = {AGPL-3.0-or-later}
}

安全 · 行为准则 · AGPL-3.0-or-later

点星历史