发行说明 6.x.x - Ayakaleaf Pro

我们的 Ayakaleaf Pro 许可证允许你在任何环境中运行该应用程序，没有任何限制；强烈建议你准备一个非生产环境用于测试。

我们在 GitHub 上发布版本信息，请访问这里。

Ayakaleaf Pro 6.3.0

发布日期： 2026.10.03（重新发布；最初发布于 2026.09.24）参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.3.0

Ayakaleaf Pro 6.3.0 最初于 2026 年 9 月 24 日发布。本次重新发布修复了由上游更新导致的 AI 助手、Zotero 和 Mendeley 集成问题。之前发布的版本不会损坏你的数据。请拉取最新的 6.3.0 镜像并升级你的部署。已关联 Zotero 或 Mendeley 参考文献文件的现有安装还必须运行下面的迁移。 新安装无需执行此迁移。

现有安装的 Zotero / Mendeley 迁移

升级到重新发布的 6.3.0 镜像时，请使用以下脚本迁移现有的 Zotero/Mendeley 关联参考文献元数据。此迁移与修复 12031b8dfd 配套。它会将 zoteroGroupId / mendeleyGroupId 重命名为 group_id，将 importedByUserId 重命名为 importer_id，并删除 importedByName。运行迁移前，请备份 MongoDB 并停止应用程序。保持 MongoDB 运行。打开其 shell（将 mongo 替换为你的容器名称）：

docker exec -it mongo mongosh

在 mongosh 中运行以下内容（将 sharelatex 替换为你的数据库名称）：

use sharelatex

(async () => {
  let updated = 0
  await db.projects.find({}, { rootFolder: 1 }).forEach(async project => {
    const changes = {}
    function visit(folders, path) {
      for (const [i, folder] of (folders || []).entries()) {
        const folderPath = `${path}.${i}`
        for (const [j, file] of (folder.fileRefs || []).entries()) {
          const data = { ...file.linkedFileData }
          if (!["zotero", "mendeley"].includes(data.provider)) continue
          const groupKey = `${data.provider}GroupId`
          if (![groupKey, "importedByUserId", "importedByName"].some(key => key in data)) continue
          for (const [oldKey, newKey] of [[groupKey, "group_id"], ["importedByUserId", "importer_id"]]) {
            if (data[oldKey] != null && data[oldKey] !== "") {
              const value = String(data[oldKey])
              if (newKey in data && data[newKey] !== value) {
                throw new Error(`Conflicting ${newKey}: project ${project._id}, file ${file._id}`)
              }
              data[newKey] = value
            }
            delete data[oldKey]
          }
          delete data.importedByName
          changes[`${folderPath}.fileRefs.${j}.linkedFileData`] = data
        }
        visit(folder.folders, `${folderPath}.folders`)
      }
    }
    visit(project.rootFolder, "rootFolder")
    if (!Object.keys(changes).length) return
    const result = await db.projects.updateOne(
      { _id: project._id, rootFolder: { $eq: project.rootFolder } },
      { $set: changes }
    )
    if (!result.matchedCount) throw new Error(`Project changed during migration: ${project._id}`)
    updated += result.modifiedCount
  })
  print(`Updated ${updated} project(s).`)
})()

该脚本会处理嵌套文件夹，并且只修改 Zotero/Mendeley 元数据。它可以安全地重复运行：迁移完成后，再次运行会报告 Updated 0 project(s).。如果因冲突而停止，请检查报告的项目/文件；之前的项目可能已经迁移完成。启动更新后的应用程序，重新加载编辑器，并以原导入者的身份刷新现有的参考文献文件。历史快照不会被重写。如需降级到旧版应用程序，请恢复 MongoDB 备份。

我们非常自豪地宣布 Overleaf Pro 6.3.0 正式发布，它是社区中功能最强大、最丰富的在线 LaTeX 编辑器。我们始终致力于改善用户体验，本次发布带来了巨大的变化和出色的功能，包括 AI 助手和第三方参考文献集成，相信你一定会喜欢。

变更

AI 聊天助手：通过你自己的服务提供商，直接在编辑器中与 AI 模型对话。
LaTeX 错误助手：为 LaTeX 编译错误获取 AI 建议的修复方案。
Mendeley 集成：与 Zotero 类似，从 Mendeley 导入参考文献。
Open in Overleaf API：新增用于在 Overleaf 中打开内容的 API。
模板库：新增服务器端分页、搜索和排序，大型模板库不再需要在浏览器中加载全部模板。
翻译：更新了 6.3.0 的翻译补丁，包括所有受支持语言中的新界面文本。
上游 Overleaf 6.3.0：包括标签页式文件编辑、为浅色和深色主题分别设置页眉 Logo，以及依赖项和基础镜像更新。
新增 OVERLEAF_HEADER_IMAGE_URL_LIGHT 和 OVERLEAF_HEADER_IMAGE_URL_DARK，以支持为浅色和深色主题分别设置页眉 Logo 图片。
现在可以在编辑器的不同标签页中打开文件。
新增对可配置 HTTP(S) 代理（包括本地托管的代理）的支持，通过 OVERLEAF_LINKED_URL_OUTBOUND_PROXY 进行配置，Open in Overleaf API 也会使用该设置。

功能 01：AI 助手现已推出

AI is all you need，设置教程请参阅：AI 集成

功能 02：Open in Overleaf API

该功能默认启用，你可以生成自己的链接，在你自己的 Overleaf 实例中打开 LaTeX 项目。只需访问 your.overleaf.com/devs 即可查看详情。参见：Overleaf Import API

现在，你可以在你的网站、博客或模板库中添加一个”Open in Overleaf”按钮，让用户一键导入 LaTeX 代码片段、远程文件或 ZIP 项目。内容会作为新项目在你的实例中打开，可直接编辑和编译——无需手动复制或上传。

功能 03：Mendeley 集成

与 Zotero 集成类似，参见：Mendeley 集成

功能 04：模板分页

模板库现在在 MongoDB 中进行分页、排序和搜索。它无需任何准备即可使用；如果有数千个模板，你仍然可以添加以下索引来保持其快速运行（可安全重复运行，mongo/sharelatex = 你的容器名和数据库名）：

docker exec mongo mongosh sharelatex --quiet --eval '
db.templates.createIndex({category:1,lastUpdated:-1},{name:"category_1_lastUpdated_-1",background:true});
db.templates.createIndex({lastUpdated:-1},{name:"lastUpdated_-1",background:true});
db.templates.createIndex({category:1,name:1},{name:"category_1_name_1_ci",collation:{locale:"en",strength:2},background:true});
db.templates.createIndex({name:1},{name:"name_1_ci",collation:{locale:"en",strength:2},background:true});
'

请保持两个 *_ci 索引上的 collation 与上面写的一致——模板库使用相同的 collation 进行查询，而 MongoDB 只会使用匹配的索引。

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.3.0

官方发行说明

发布日期： 2026-08-28TexLive 2026 现已可用于运行沙盒编译的 Server Pro 实例。升级说明请查阅文档，该版本引入的主要变化请参阅发行说明。新功能

新增 OVERLEAF_HEADER_IMAGE_URL_LIGHT 和 OVERLEAF_HEADER_IMAGE_URL_DARK，以支持为浅色和深色主题分别设置页眉 Logo 图片。
现在可以在编辑器的不同标签页中打开文件。

其他变更

基础镜像和已安装软件包的安全更新。

来源：https://docs.overleaf.com/on-premises/release-notes/release-notes-6.x.x

Ayakaleaf Pro 6.2.2

发布日期： 2026.07.23 参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.2.2

变更

向后移植上游 Overleaf 6.2.2（基于 6.2.1）中发布的官方热修复补丁：

不再将项目邀请令牌密钥泄露到日志中。邀请令牌加密器在每次加密/解密时都会记录自身配置，其中包含由 OVERLEAF_INVITE_TOKEN_SECRET 派生的加密密码。
将外发邮件从已停止维护的 AWS SES v1 客户端迁移到 SESv2。配置了 ses 邮件驱动的实例可能完全无法发送邮件；现在发送改为通过 SESv2Client 进行。
将分享项目下拉菜单中的群组条目置于新的 group-link-sharing 功能开关之后，因此在不适用的实例上不再提供群组链接分享。
修复协作者的分享项目弹窗。以非所有者身份打开，或在禁用 sharing-updates 流程时打开，会发出一个总是失败的请求，并显示”出现了一些问题”的错误。
为 document-updater 新增 scripts/flush_docs_with_pending_updates.js，这是一个维护脚本，用于恢复在项目被刷新或彻底删除后，在 Redis 中留下卡住的 PendingUpdates 队列的文档。支持 --dry-run 和 --estimated-docs 安全检查。
更新依赖项：multer 2.2.0、form-data 2.5.6、protobufjs 7.6.3、@grpc/grpc-js 1.14.4。

本版本还包括以下来自 Ayakaleaf Pro 的修复和改进：

新增 16 种语言的完整翻译（cs、da、de、es、fi、fr、it、ja、ko、nl、no、pl、pt、ru、sv、tr），修复了密码重置页面等未翻译的字符串。修复 #38。
修复管理面板中”显示另外 N 个项目”按钮的条目计数，该数字因复数占位符未正确传递而显示错误。
修复 GitHub 导出验证错误，现在通过静态 i18n 键而非原始消息进行渲染，并移除了 GitHub Sync 弹窗不再使用的错误键。

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.2.2

官方发行说明

发布日期： 2026-07-20问题修复

#1499：修复设置中忽略 OVERLEAF_INVITE_TOKEN_SECRET 的问题
修复 SES API 邮件传输失效的问题
LDAP：修复使用邮箱地址作为用户名时出现的”invalid email address”错误
Git：修复从外部 URL 轮询日志级别时出现的”fetch”错误
修复项目分享弹窗中显示的错误提示

其他变更

引入 flush_docs_with_pending_updates 脚本，用于管理卡住的文档
更新内部依赖项

来源：https://docs.overleaf.com/on-premises/release-notes/release-notes-6.x.x

Ayakaleaf Pro 6.2.1

发布日期： 2026.07.18 参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.2.1

变更

向后移植上游 Overleaf 6.2.1（基于 6.2.0）中发布的官方热修复补丁：

使用严格的验证模式加固实时 applyOtUpdate 消息，不再接受任意对象，拒绝格式错误的编辑操作。
放宽该模式，使 meta.tc 变为可选，以免有效更新被更严格的验证拒绝。
修复编辑器（ShareJS 客户端），使归约为空操作的操作——被远程/并发操作抵消，或被撤销完全还原——被直接丢弃而不是发送到服务器，并且文档能正确地报告为已保存。防止在撤销和并发编辑时出现虚假的同步/“未保存更改”问题。

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.2.1

Ayakaleaf Pro 6.2.0

发布日期： 2026.07.10 参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.2.0 我们自豪地宣布 Overleaf Pro 6.2.0 正式发布，它是社区中功能最强大、最丰富的在线 LaTeX 编辑器。特别感谢 yu-i-i 和 davrot 的宝贵贡献。他们增强了 GitHub Sync，并引入了高级引用搜索和 Zotero 集成。

注意事项

引入了一个新的必需环境变量 OVERLEAF_INVITE_TOKEN_SECRET。你必须使用 openssl rand -base64 32 生成它。如果未配置，你的 Overleaf 实例将无法启动。
如果你启用了 GitHub Sync，则必须配置 GITHUB_TOKEN_CIPHER_PASSWORD 环境变量。该变量用于安全地加密 GitHub 访问令牌。没有它，你的 Overleaf 实例将无法启动。

新增 DEFAULT_LATEX_COMPILER 环境变量，用于设置新项目使用的默认编译器（pdflatex、latex、xelatex 或 lualatex）。
重新设计的编辑器现在是唯一可用的选项。

变更

本版本包含以下改进和新功能。

MAX_UPLOAD_SIZE 现在可以配置，不再被限制为 50 MB。
修复了禁用沙盒编译时容器反复重启的问题。
对 OAuth2 强制执行按所有者范围删除 PAT。
修复了一个 LDAP 导入问题。

新功能包括：

新增基于浏览器的 Python 运行器。
新增 Pandoc 支持，可导入和导出 Markdown、DOCX 及其他格式。
新增 GitHub Sync。
新增完整的中文翻译。
新增 Zotero 集成。
新增 DEFAULT_LATEX_COMPILER。

功能 01：GitHub Sync

让你的 LaTeX 项目与 GitHub 仓库保持同步，实现无缝的开发工作流。直接在编辑器中推送和拉取更改，通过拉取请求进行协作，并与现有的 CI/CD 流水线集成。版本控制让你可以轻松跟踪修订、审查更改，并维护可复现的学术或技术文档。参见：GitHub 同步

功能 02：Pandoc 导入/导出

将 Microsoft Word 和 Markdown 文档导入为完全可编辑的 LaTeX 项目，或一键将 LaTeX 项目导出为 Markdown 和 DOCX。该功能由 Pandoc 驱动，在尽可能保留文档结构的同时，实现学术写作、协作编辑和出版工作流之间的无缝互通。参见：Pandoc 导入与导出

功能 03：高级参考文献搜索

从多个学术数据库中搜索并插入参考文献，支持智能过滤和即时引用。快速发现论文、预览元数据并构建准确的 BibTeX 条目，无需在不同的研究网站之间切换，显著提高文献综述的效率。

功能 04：Python 运行器

无需离开编辑器，即可直接在项目中执行 Python 代码。非常适合生成图表、处理数据集、自动化文档工作流或运行可复现的研究脚本。结果可以集成到你的 LaTeX 文档中，使科学计算和写作成为统一工作流的一部分。

功能 05：Zotero

将你的 Zotero 文献库直接接入写作工作流，无需离开编辑器即可管理参考文献。搜索你的个人 Zotero 收藏，一键插入引用，并自动生成和同步 BibTeX 条目。该集成可让你的参考文献保持最新，简化学术论文、学位论文和技术文档的文献管理。参见：Zotero 集成

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.2.0

官方发行说明

破坏性变更

引入了一个新的必需环境变量 OVERLEAF_INVITE_TOKEN_SECRET。使用以下命令生成：
openssl rand -base64 32
最小长度：16 个字符。

新功能

重新设计的编辑器现在是唯一可用的选项。
新增 DEFAULT_LATEX_COMPILER。

问题修复

在禁用时，移除了从其他项目或外部 URL 插入图片的选项。

其他变更

更新了邮件样式。
更新了基础镜像、软件包和内部依赖项。

Ayakaleaf Pro 6.1.2

发布日期： 2026.02.21 参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.1.2

变更

回退 ayaka-notes 的 filestore 补丁（PDF 封面旋转问题已在上游修复）
为 filestore 安装 poppler-utils（Overleaf 官方）
使用 pdftocairo 代替 convert 将 PDF 封面转换为 PNG（Overleaf 官方）
调整预览图（1000）和缩略图（700）的宽度（Overleaf 官方）

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.1.2

已知问题

此版本中 LDAP 无法正常工作。只要不启用 LDAP，就不会影响其他功能。我们已向上游报告了相关错误，并将在下一个版本中更新 LDAP 依赖。

Ayakaleaf Pro 6.1.1

发布日期： 2026.02.20 参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.1.1

变更

在 Overleaf 中启用整体主题。

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.1.1

注意事项

迁移：如果你是现有的 CE/Overleaf 用户，由于我们在 6.1.0 中启用了历史回退功能，你需要更新现有项目才能使用此功能。详细信息请参阅 Overleaf Pro v6.1.0 的发布说明。

官方发行说明

问题修复

修复了当 OVERLEAF_PROXY_LEARN 未设置为 true 时显示无效文档链接的问题。
移除了重新设计的编辑器设置弹窗中无效的订阅链接。
移除了菜单中无效的”联系我们”链接。

其他变更

更新了内部依赖项。

Ayakaleaf Pro 6.0.1

发布日期： 2026.02.20 测试补丁版本，参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.0.1 这是一个用于次要版本发布的测试版本，没有新增功能。本版本修复了最新 runc 更新后出现的若干编译问题。

Server CE/Pro 6.0.1 所需的最低 MongoDB 版本现为 MongoDB 8.0。你可以在这里查看有关升级 MongoDB 的文档。

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.0.1

Ayakaleaf Pro 6.0.0

发布日期： 2026.02.17 测试版本，参见：https://github.com/ayaka-notes/ayakaleaf-pro/releases/tag/pro-v6.0.0 这是一个测试版本，也是我们 Overleaf Pro 的初始版本。该版本不包含 Server Pro 的任何功能，因此仅作为我们的起点。我们将在之后添加新功能，例如管理面板和 git-bridge 等。在本版本中，我们推出了适用于 ARM 的 Overleaf Docker 镜像。如果你有 Mac 或基于 ARM 的服务器，可以尝试使用，但某些功能可能无法正常工作（尚未测试）。

Docker 镜像

你可以在这里找到 Docker 镜像：https://github.com/ayaka-notes/overleaf-pro/pkgs/container/overleaf-pro 多架构镜像请参见这里。

docker pull ghcr.io/ayaka-notes/overleaf-pro:6.0.0

二进制文件迁移

此新版本将二进制文件的存储占用减少了一半。 5.5 版本中包含一个在线迁移，可在升级过程中将停机时间降至最低。在升级到 Server Pro v6 之前，请确保你已经运行最新版本的 Server Pro v5.5（发行说明 5.x.x）并已执行迁移。查看完整的迁移说明。

MongoDB 升级到 v8

本版本将最低 MongoDB 版本提升至 8.0。如果你当前使用的是 MongoDB v6 或更早版本，需要一次升级一个主版本（v6 → v7 → v8）。

请确保在升级之前备份数据库。如需回滚，你需要恢复数据库备份。

有关如何将 MongoDB 从 v6 → v7 → v8 升级的说明，请参阅我们的分步指南这里。

Redis 升级到 v7.4

本版本还将最低 Redis 版本提升至 7.4。将 config/overleaf.rc 中的 REDIS_IMAGE 更新为 REDIS_IMAGE=7.4。

新功能

现在可以通过 OVERLEAF_DISABLE_LINK_SHARING=true 禁用链接分享。
现在可以使用 OVERLEAF_MAINTENANCE_MESSAGE 和 OVERLEAF_MAINTENANCE_MESSAGE_HTML 自定义维护页面的标题和内容。
可以配置 OVERLEAF_USER_HARD_DELETION_DELAY 和 OVERLEAF_PROJECT_HARD_DELETION_DELAY（以毫秒为单位），以修改已删除用户/项目的过期延迟（默认为 90 天）。

问题修复

修复了包含链接的页脚渲染问题。
改进了 SAML 登录错误时的错误消息。
修复了在 SSO 登录时更新用户管理员状态后未添加审计日志条目的问题。
修复了 Redis 启用 TLS 时历史面板报错的问题。
使用非沙盒编译时，现在可以停止编译。

其他变更

所有指向状态页面（通过 OVERLEAF_STATUS_PAGE_URL 设置）的链接现在都使用 HTTPS，并在新的浏览器标签页中打开。

​Ayakaleaf Pro 6.3.0

​变更

​功能 01：AI 助手现已推出

​功能 02：Open in Overleaf API

​功能 03：Mendeley 集成

​功能 04：模板分页

​Docker 镜像

​Ayakaleaf Pro 6.2.2

​变更

​Docker 镜像

​Ayakaleaf Pro 6.2.1

​变更

​Docker 镜像

​Ayakaleaf Pro 6.2.0

​注意事项

​变更

​功能 01：GitHub Sync

​功能 02：Pandoc 导入/导出

​功能 03：高级参考文献搜索

​功能 04：Python 运行器

​功能 05：Zotero

​Docker 镜像

​Ayakaleaf Pro 6.1.2

​变更

​Docker 镜像

​已知问题

​Ayakaleaf Pro 6.1.1

​变更

​Docker 镜像

​注意事项

​Ayakaleaf Pro 6.0.1

​Docker 镜像

​Ayakaleaf Pro 6.0.0

​Docker 镜像

​二进制文件迁移

​MongoDB 升级到 v8

​Redis 升级到 v7.4

​新功能

​问题修复

​其他变更

Ayakaleaf Pro 6.3.0

变更

功能 01：AI 助手现已推出

功能 02：Open in Overleaf API

功能 03：Mendeley 集成

功能 04：模板分页

Docker 镜像

Ayakaleaf Pro 6.2.2

变更

Docker 镜像

Ayakaleaf Pro 6.2.1

变更

Docker 镜像

Ayakaleaf Pro 6.2.0

注意事项

变更

功能 01：GitHub Sync

功能 02：Pandoc 导入/导出

功能 03：高级参考文献搜索

功能 04：Python 运行器

功能 05：Zotero

Docker 镜像

Ayakaleaf Pro 6.1.2

变更

Docker 镜像

已知问题

Ayakaleaf Pro 6.1.1

变更

Docker 镜像

注意事项

Ayakaleaf Pro 6.0.1

Docker 镜像

Ayakaleaf Pro 6.0.0

Docker 镜像

二进制文件迁移

MongoDB 升级到 v8

Redis 升级到 v7.4

新功能

问题修复

其他变更