ARTICLE · 1229855

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

发布时间：2026-10-22 18:37:37 最近访问：2026-10-22 18:37:21

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

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

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

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

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

你可以自行决定是否在产品中启用 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：https://api.onlyoffice.com/zh-CN/docs/office-api/usage-api/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：https://api.onlyoffice.com/zh-CN/docs/docs-api/additional-api/conversion-api/request-from-file
POST /docbuilder/from-file：https://api.onlyoffice.com/zh-CN/docs/docs-api/additional-api/document-builder-api

这两个端点均接受 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 的完整变更列表：https://api.onlyoffice.com/zh-CN/docs/plugins/more-information/changelog

开始基于 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 会负责托管、维护和定期更新。

请查看完整更新日志，了解所有详细变更：https://api.onlyoffice.com/zh-CN/changelog/2026/10/15/version-10-0-0