ONLYOFFICE 文档开发者版10.0更新：AI 功能、安全防护与 API 能力全面升级

ONLYOFFICE 10.0 为基于编辑器构建应用的开发者带来了一系列重要更新：新增端点简化了文件处理流程，Document Builder 现已支持 PDF 编辑，插件 API 也得到升级并引入了异步方法。本次更新还增加了 AI 功能的控制选项，并进一步强化了服务器端的默认安全设置。

下面将简要介绍与集成开发最相关的更新，以及升级前需要留意的行为变更。

AI 工具、自定义选项与服务端 AI 管理

ONLYOFFICE 文档 10.0 为各个编辑器引入了 AI 工具。这些工具不仅能生成文本，还能理解文档结构、识别其中的元素、关联不同章节的内容，并生成可点击的引用，方便用户在文档中导航。你可以接入所需的 AI 模型，包括适用于隐私敏感场景的本地模型，并为不同任务分配不同模型。

在 ONLYOFFICE 文档 10.0 企业版中，管理员可以通过管理面板统一配置 AI 提供商。配置完成后，用户无需单独输入 API 密钥，即可使用预先配置的 AI 工具。管理员还可以为不同任务分配模型、连接 MCP 服务器以访问外部工具，并控制是否启用网络搜索。保存服务端配置后，用户只能使用获准的提供商和模型，无法再添加自己的密钥或更改所用模型。了解更多

你可以自行决定是否在产品中启用 AI 工具。10.0 版本提供了两级控制方式：

• 按编辑器实例： 使用 editorConfig.customization.ai 和 disabled 参数，在特定编辑器配置中隐藏 AI 功能。
• 服务器范围： 使用 aiSettings.enable 服务器设置关闭 AI 功能，并从 /plugins.json 中排除 AI 工具。

如果你的产品面向不同层级的客户，或某些部署因合规要求必须禁用 AI，这些控制选项就会非常实用。

模块化应用

ONLYOFFICE 文档 10.0 引入了模块化应用——一种无需修改编辑器核心即可扩展功能的新方式。AI 智能体、表单、房间和文件等应用可以与 ONLYOFFICE 文档集成，为其扩展更多功能。

对开发者而言，这意味着你可以按需启用用户需要的功能，让集成保持精简，并随着产品发展逐步扩展。

安全与架构改进

10.0 版本将多项安全措施设为“默认启用”，让新集成从更安全的默认配置开始。

• 默认启用 JWT：JWT 现已在 default.json 中默认启用。
• 更严格的令牌处理：如果密钥为空或未配置（包括租户密钥），ONLYOFFICE 文档将拒绝相关令牌，不再对其进行验证或签发。
• 服务 API 的令牌范围限制：/converter、/docbuilder 和 /command 不再接受来自编辑器配置的令牌。新增的 operation 字段在这些请求中为可选项，但对 /converter/from-file 和 /docbuilder/from-file 则为必填项。
• 下载文件的完整性校验：如果集成请求中包含完整性校验请求头，服务器将据此验证下载文件的完整性。支持的请求头包括 Content-Digest、Repr-Digest、x-amz-checksum-* 和 WOPI SHA256。该功能由 services.CoAuthoring.requestDefaults.checksumVerification 控制，默认为 true。
• 显式指定 WOPI 主机：WOPI 主机必须通过 IP 过滤规则明确放行。仅配置通配符 allow: * 已不再足够，还需要明确指定允许的主机。
• API 访问控制：你可以通过 services.CoAuthoring.server.convertServiceEnable 和 services.CoAuthoring.server.docbuilderEnable 关闭公共转换 API 和 Document Builder API。这两项配置的默认值均为 true。
• 更严格的运行时配置：现在只能通过 runtime.json 修改 log4js 的日志级别。

深入了解最新的安全修复

Document Builder 中的 PDF 编辑

Document Builder 现已支持 PDF 编辑，为更多自动化应用场景提供了可能：

• OpenFile 可根据 PDF 类型选择打开方式：在 ONLYOFFICE 中创建的 PDF 表单会在文档编辑器中打开；其他 PDF 则会在 PDF 编辑器中打开，并可使用完整的 PDF API。
• 受密码保护的 PDF：OpenFile 中新增的 m_sPassword 参数可用于打开受密码保护的文件。
• 创建 PDF 表单：将 CreateFile 与 pdf 类型配合使用，即可创建 PDF 表单。

在服务器端，保存为普通 PDF 的表单现在会在用户提交时自动签名。这有助于简化表单提交流程，并为相关工作流增加一层信任保障。

Alexander Trofimov，ONLYOFFICE 编辑器开发团队负责人：

借助 ONLYOFFICE 文档 10.0，我们让编辑器对你的集成更加安全。此外，本次发布为 Document Builder 带来了完整的 PDF 支持，开发者和终端用户都可以直接在 Builder 中创建、编辑和管理 PDF，而无需依赖变通方案或第三方工具。

部署与管理更新

10.0 版本也简化了 ONLYOFFICE 文档在生产环境中的部署与管理：

• 管理面板随服务器启动：在企业版中，管理面板现已默认自动启动。面板还新增了查看 JWT 密钥的区域，以及打开测试示例、启动或停止测试的按钮。
• 通过 CLI 创建管理员：现在，你可以通过主机 CLI 工具 documentserver-admin，使用 create-admin 和 reset-admin-password 创建首位管理员，无需再依赖原先基于 bootstrap 日志的网页操作方式。
• 自动恢复未保存的更改：如果服务器关闭，未保存的更改会自动恢复到“遗忘文件”中。原先独立使用的 changes2forgotten 脚本现已移除。
• 新的默认端口：DEB 和 RPM 安装的默认端口现为 8083。请检查并相应更新代理和防火墙规则。
• 更好的监控：新增的 coauth.connections 指标包含 mode（edit、liveview、view）和 replica 标签。
• 桌面端更新标志：在 Windows 上，使用 --prefer-alternate-url 命令行标志，可让桌面编辑器从备用源下载更新。
• 焕新的欢迎页面：服务器欢迎页面经过了重新设计。

新增文件格式支持

10.0 版本新增了两项文件格式相关功能，帮助你减少自定义处理工作，支持更多文档格式：

• OFD 查看与转换：你可以打开并转换 ofd 文件。与 xps 一样，它们以只读模式打开。
• 转换为 XLS：你可以将任何电子表格格式转换为经典的 xls 格式。当用户或合作伙伴仍在使用旧系统时，这项功能尤其有用。

支持直接上传文件的多部分端点

此前，转换服务和 Document Builder 服务需要通过 URL 下载源文件，因此文件必须托管在服务器可访问的位置。10.0 版本新增了两个端点，可省去这一环节：

• POST /converter/from-file
• POST /docbuilder/from-file

这两个端点均接受 multipart/form-data 格式的数据。你可以直接在请求中发送文件或脚本，无需通过临时 URL 暴露文件。

对于许多工作流而言，这是一种更简洁的方案。例如，后端服务可以即时转换用户上传的文件，或直接运行 Document Builder 脚本，无需预先暂存文件。

请求示例：将 TXT 转换为 DOCX

curl -f -X POST "https://documentserver/converter/from-file" \
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Example Document Title.txt"}' \
  -F 'file=@example.txt' \
  -o "Example Document Title.docx"

插件 API 现代化

插件和宏 API 迎来了一次重要更新。

全新的全局 Editor 对象

这些方法现在可以像普通函数一样调用，并返回 Promise。你无需再通过 window.Asc.plugin.executeMethod 调用每个方法，可以直接编写简洁的异步代码：

const text = await Editor.GetSelectedText();

这样写出的代码更加简洁、易读，也更容易融入现代 JavaScript 项目。

新增方法与事件

10.0 版本还新增了一些方法和事件，帮助你构建功能更丰富的插件：

• 方法： Editor.RunMacro、GetRestrictions、SetButtonDisabled、GetOFormRole
• 事件： onFloatActionButtonClick、onSelectionEnd、onSelectionCancel

例如，选区相关事件可让插件在用户完成选择或取消选择时及时响应。

查看插件 API 的完整变更列表

开始基于 ONLYOFFICE 10.0 进行开发

10.0 版本带来了更简洁的 API、更强的自动化能力和更安全的默认配置。你可以按照以下步骤快速上手：

• 查看行为变更：检查令牌用法、WOPI IP 过滤规则和新的默认端口。
• 更新你的插件：切换到全局 Editor 对象，并更新已重命名或移除的方法调用。
• 试用新端点：在转换工作流中测试 /converter/from-file 和 /docbuilder/from-file。
• 确定 AI 配置方案：配置 editorConfig.customization.ai 或 aiSettings.enable，以匹配你的产品需求。

下载开发者版本

正在使用 ONLYOFFICE 文档云端版进行开发？ 不妨试试 Docs Connect，它可以帮助你更轻松地将编辑器连接到外部平台和服务。与需要自行部署和维护编辑器的 ONLYOFFICE 文档自托管版不同，Docs Connect 会负责托管、维护和定期更新。

请查看完整更新日志，了解所有详细变更；也欢迎在 ONLYOFFICE 社区论坛分享你的反馈。期待看到你基于 ONLYOFFICE 打造的作品！