这些是 Tiny Cloud 和 TinyMCE Enterprise 的发行说明。有关 TinyMCE 最新社区版本的信息，请参阅 TinyMCE 更新日志。
概述
TinyMCE 8.9.0 于 2026 年 8 月 31 日（星期一）发布，适用于 TinyMCE Enterprise 和 Tiny Cloud。本发行说明概述了 TinyMCE 8.9.0 的变更，包括：
配套的 Premium 插件变更
改进
新增内容
变更
Bug 修复
配套的 Premium 插件变更
以下 Premium 插件更新与 TinyMCE 8.9.0 一同发布。
Comments
TinyMCE 8.9.0 版本包含配套发布的 Comments Premium 插件。
Comments 包含以下新增内容和改进。
新增选项 tinycomments_always_show_highlights，可在关闭侧边栏时保持评论高亮可见
此前，Comments 插件仅在 Comments 侧边栏打开时高亮显示评论内容。关闭侧边栏会移除编辑器内容的高亮显示，导致评论内容容易被忽略，用户可能会在无警告的情况下覆盖这些内容。
在 TinyMCE 8.9.0 中，Comments 插件提供了 tinycomments_always_show_highlights 选项。当此选项设置为 true 时，无论 Comments 侧边栏是否打开，评论内容都会保持高亮显示。此选项默认值为 false，即保留现有行为。
选择评论高亮会打开 Comments 侧边栏
此前，当 Comments 侧边栏关闭时，Comments 插件会移除高亮显示，因此用户无法从编辑器内容重新打开对话。
在 TinyMCE 8.9.0 中，当 tinycomments_always_show_highlights 选项设置为 true 时，选择高亮显示的内容会重新打开已关闭的 Comments 侧边栏。
Comments 侧边栏可调整大小，且默认更宽
此前，Comments 插件的内容样式将 Comments 侧边栏固定为 300 像素宽，用户无法更改该宽度。
在 TinyMCE 8.9.0 中，Comments 侧边栏注册时将 resizable 属性设置为 true，因此用户可以通过拖动侧边栏边缘来调整其大小。侧边栏打开时的宽度由 sidebar_width 选项设置，默认值为 440 像素，因此 Comments 侧边栏的默认宽度比早期版本更宽。将 sidebar_width 设置为 300 可恢复之前的宽度，并将该宽度应用于编辑器中的所有可调整大小的侧边栏。
有关 Comments 插件的信息，请参阅：Comments。
TinyMCE AI
TinyMCE 8.9.0 版本包含配套发布的 TinyMCE AI Premium 插件。
TinyMCE AI 包含以下修复、新增内容和改进。
文档过长导致快速操作或审阅失败时，改进了错误提示信息
此前，当文档内容超过 AI 服务的上下文限制时，快速操作或审阅会失败，并显示通用提示信息 An error occurred while processing the AI response.（处理 AI 响应时发生错误）。该提示信息未指出文档长度是导致问题的原因。
在 TinyMCE 8.9.0 中，当快速操作或审阅因文档过长而失败时，TinyMCE AI 插件会显示 This document is too long for the AI to process at once.（此文档太长，AI 无法一次性处理）。由于始终会将完整文档发送给 AI 服务，因此该提示信息仅说明限制，而不建议纠正措施。
将无效 URL 添加为上下文源时，改进了错误提示信息
此前，在 Chat 侧边栏中将格式错误的 URL 添加为上下文源时，会显示 Provided URL is not valid.（提供的 URL 无效）。该提示信息未指明需要更正的地址部分。
在 TinyMCE 8.9.0 中，遇到相同情况时，TinyMCE AI 插件会显示 This URL isn't valid. Check the full, correct web address and try again.（此 URL 无效。请检查完整、正确的网址，然后重试）。该提示信息针对地址格式。对于格式正确但指向无法访问页面的地址，仍会被接受并发送处理。
Chat 欢迎操作将焦点移至编辑器并重置内容滚动位置
此前，在 AI Chat 侧边栏中选择欢迎操作会在执行操作命令前将焦点移至编辑器。焦点聚焦到编辑器会将内容滚动到当前选中位置，若未进行任何选中，则滚动到内容开头。用户滚动浏览文档后，一旦选择欢迎操作，就会丢失该滚动位置。
在 TinyMCE 8.9.0 中，TinyMCE AI 插件执行欢迎操作命令时，不会将焦点移至编辑器。选择欢迎操作不会改变编辑器的滚动位置和焦点。欢迎操作通过 tinymceai_chat_welcome_actions 选项进行配置。
无法使用 Esc 键关闭工具提示
此前，TinyMCE AI 边栏中显示的工具提示不会响应 Esc 键。这些边栏使用其自身的工具提示，该工具提示未连接到关闭工具提示的编辑器键盘快捷键，因此打开的工具提示会一直保留在屏幕上，直到指针或焦点移动到其他位置。键盘用户无法关闭遮挡界面的工具提示。
在 TinyMCE 8.9.0 中，按 Esc 键将关闭 TinyMCE AI 边栏中打开的工具提示。
嵌套列表或表格旁边文本的更改在 Review 模式下未显示为差异
此前，同一容器内直接位于嵌套列表或表格旁边的文本未被追踪为块级更改，因此生成建议的比较过程会跳过该文本。即使审阅返回了该文本的建议，Review 模式也会显示该文本未更改。审阅者无法看到或操作这些建议，且建议的编辑内容在审阅完成后会丢失。
在 TinyMCE 8.9.0 中，TinyMCE AI 插件在准备文档进行比较时，会将嵌套列表或表格旁边的文本视为块级更改。这些文本的建议现在会与其他建议一起显示在 Review 边栏和文档中，并且每个建议都可以像往常一样接受或拒绝。
用于运行审阅的新命令
在 TinyMCE 8.9.0 中，TinyMCE AI 插件会为每个内置审阅注册一个编辑器命令，例如 TinyMCEAIReviewProofread 和 TinyMCEAIReviewToneProfessional。该插件还注册了 TinyMCEAIReviewCustom 命令，可通过自定义提示运行审阅，或通过标识符运行集成商定义的审阅。每个命令都会打开 Review 边栏并运行审阅，结果与在边栏中选择该审阅相同。此前，审阅只能从 Review 边栏启动，因此集成无法从其自身界面启动审阅。
有关命令标识符以及 TinyMCEAIReviewCustom 接受的值，请参阅 TinyMCE AI 插件命令。
添加文件上下文源失败时显示的错误消息得到改进
此前，当 AI 服务拒绝在 Chat 边栏中添加为上下文源的文件时，边栏会使用服务返回的消息（例如 Content too large）报告失败。这些消息描述的是服务响应而非文件本身，因此用户无法判断文件的哪个属性导致了失败，也无法知道应该尝试什么替代方法。
在 TinyMCE 8.9.0 中，TinyMCE AI 插件会针对其能识别的每个文件失败显示一条消息：
文件过大时显示
此文件过大，无法添加。请尝试一个较小的文件。文件页数过多时显示
此文件页数过多，无法处理。请尝试页数更少的文件。文件类型不受支持时显示
此文件类型不受支持。请尝试其他文件。
当无法识别原因时，插件会显示 此文件无法添加。请尝试较小的文件或其他文件类型。
聊天消息超出 AI 上下文限制时显示的错误消息得到改进
此前，当聊天消息与对话历史合并后超过 AI 服务的上下文限制时，Chat 边栏会使用通用消息 处理 AI 响应时发生错误。报告失败。该消息未指出请求大小是原因，因此用户无法判断应该缩短消息、开始新对话还是直接重试。
在 TinyMCE 8.9.0 中，当 AI 服务报告聊天请求超过上下文限制时，TinyMCE AI 插件会显示 此消息过长，AI 无法处理。请尝试更短的消息，或开始新的聊天。。该消息指明了原因并描述了两种后续操作方式。
聊天提示超过最大长度时显示的错误消息得到改进
此前，当在 Chat 边栏中输入的文本超过 AI 服务接受的单条消息最大长度时，请求会失败，Chat 边栏会使用通用消息 处理 AI 响应时发生错误。报告失败。该消息未指出输入文本长度是原因，因此用户无法判断缩短消息可以解决该问题。
在 TinyMCE 8.9.0 中，当输入文本超过该限制时，TinyMCE AI 插件会显示 此提示过长。请尝试更短的提示。。该消息仅适用于输入的消息本身，与消息和对话历史合并后超过 AI 服务上下文限制时显示的消息不同。
tinymceai_chat_fetch_sources 选项现可指定聊天对话的默认源。
此前，TinyMCE AI 插件仅将当前文档应用于新 AI Chat 对话的上下文。用户必须手动将每个其他上下文源（例如样式指南或参考文档）添加到每个新对话中。
在 TinyMCE 8.9.0 中，提供给 tinymceai_chat_fetch_sources 的函数可以解析为一个对象，该对象具有一个 menu 属性（包含在 sources 菜单中显示的来源组）和一个 defaults 属性（包含来源标识符的数组）。该插件会将 defaults 中列出的每个来源添加到每个新对话的上下文中，并在 sources 菜单中将其显示为已选中。用户可以从对话中移除默认来源，并从 sources 菜单中再次添加它。
在 defaults 中列出的标识符如果没有在 sources 中找到匹配的来源，则不会添加到上下文中，插件会在浏览器控制台中记录错误。
此选项仍然接受解析为来源组数组的函数，因此现有配置不会受到影响。
有关配置对话上下文的详细信息，请参阅 添加自定义上下文来源。
编辑器内容与 AI 预览之间的滚动位置保持不变
以前，编辑器内容和 AI 预览之间的滚动位置不会保留。打开预览、运行审查或应用快速操作可能会将视口移离正在处理的文档部分，因此用户会迷失位置。
在 TinyMCE 8.9.0 中，TinyMCE AI 插件会记录最接近当前滚动位置的内容块，并将视图恢复到该块。在打开预览、运行审查和应用快速操作时，位置会保持不变，即使内容在编辑器和预览中的高度不同，也会恢复到同一个块。
恢复了 AI 建议预览中仅含图标的按钮
在 TinyMCE 8.7.0 中，AI 建议预览中的仅含图标的按钮被替换为带有标签的 Apply 和 Skip 按钮。
在 TinyMCE 8.9.0 中，TinyMCE AI 插件恢复了 TinyMCE 8.7.0 之前使用的仅含图标的按钮。勾选按钮应用建议，关闭按钮跳过建议，每个按钮都会显示一个工具提示，说明其操作名称，Apply suggestion 和 Skip suggestion。应用按钮仍然是主要操作，预览工具栏的间距与 TinyMCE 8.7.0 相同。
有关 TinyMCE AI 插件的信息，请参阅：TinyMCE AI。
改进
TinyMCE 8.9.0 还包括以下改进：
现在可以通过拖动侧边栏的边缘来调整其大小，并且可以使用新的 sidebar_width 选项配置其宽度。
以前，应用于侧边栏内容的样式会固定该侧边栏的宽度。在宽编辑器中工作的用户无法为侧边栏提供更多空间，而在窄编辑器中工作的用户无法为可编辑区域收回空间。
在 TinyMCE 8.9.0 中，对于使用 resizable 属性设置为 true 注册的侧边栏，TinyMCE 会渲染一个调整大小的手柄，用户可以拖动该手柄来调整侧边栏的大小。由 Comments 和 TinyMCE AI 插件注册的侧边栏默认情况下是可调整大小的。当 tinymceai_sidebar_type 设置为 'floating' 时，TinyMCE AI 侧边栏不可调整大小。为了保持可编辑区域的可用性，无论用户请求的宽度如何，TinyMCE 都不会允许可编辑区域缩小到 280 像素以下。
帮助对话框将具有无效元数据的插件列为纯文本
以前，帮助对话框的 插件 选项卡会使用插件返回的元数据，而不会检查预期的字段是否存在且类型正确。一个提供了名称但没有 URL 的插件仍然会渲染为链接，并且选择该链接会导航到 /undefined。
在 TinyMCE 8.9.0 中，帮助对话框在渲染插件之前会检查插件提供的元数据。如果插件的元数据缺失或类型异常，则会将其列为纯文本而不是链接，如果提供了插件名称，则使用插件名称，否则使用插件标识符。
新增
TinyMCE 8.9.0 还包括以下新增内容：
配置可调整大小的侧边栏宽度的新选项
以前，侧边栏的内容样式决定了该侧边栏的宽度，并且没有编辑器选项可以设置该宽度。
在 TinyMCE 8.9.0 中，有三个新选项可用于配置任何通过 resizable 属性设置为 true 注册的侧边栏的宽度。sidebar_width 选项设置侧边栏打开时的宽度，默认值为 440。sidebar_min_width 和 sidebar_max_width 选项设置用户可以拖动侧边栏到的最小宽度和最大宽度，默认值分别为 300 和 800。这三个选项都以像素为单位设置宽度。为了保持可编辑区域的可用性，TinyMCE 不允许可编辑区域缩小到 280 像素以下，并且此限制优先于这三个选项。
新的 SidebarResizeStart 和 SidebarResized 事件用于跟踪侧边栏大小调整
在 TinyMCE 8.9.0 中，有两个新事件用于报告用户调整侧边栏大小的情况。当用户开始拖动调整大小手柄时，TinyMCE 触发 SidebarResizeStart 事件；当用户停止拖动时，触发 SidebarResized 事件。SidebarResized 事件携带一个 { width: number } 有效载荷，其中包含调整大小后侧边栏的宽度（以像素为单位）。
结合 sidebar_width 选项，这些事件允许集成存储用户选择的宽度，并在下次加载编辑器时恢复该宽度。例如，请参阅：持久化侧边栏宽度。
更改
TinyMCE 8.9.0 还包含以下更改：
新的 resizable 属性控制自定义侧边栏是否可调整大小
以前，通过 addSidebar 注册的侧边栏内容所应用的样式控制该侧边栏的宽度。可调整大小的侧边栏需要 TinyMCE 来控制该宽度，这种控制权的变更将改变每个现有自定义侧边栏的渲染方式。
在 TinyMCE 8.9.0 中，addSidebar 规范对象接受一个新的可选 resizable 属性，该属性默认为 false。未设置该属性注册的自定义侧边栏的渲染方式与早期版本相同，且不可调整大小，因此现有集成不受影响。将该属性设置为 true 可使侧边栏可调整大小，并要求侧边栏的内容遵循父元素的宽度。有关信息，请参阅：为可调整大小的侧边栏设置样式。
Comments 和 TinyMCE AI 插件注册的侧边栏将 resizable 设置为 true，默认情况下可调整大小。
错误修复
TinyMCE 8.9.0 还包含以下错误修复：
更新时，具有空 alt 文本的图像会添加 role="presentation" 而不是添加 alt 文本
以前，Image 插件将任何具有空 alt 属性的图像视为装饰性图像。当 a11y_advanced_options 被禁用时，插入/编辑图像对话框不会显示图像为装饰性图像选项，因此对话框没有提供更改该状态的方法。为此类图像输入替代文本并保存对话框时，会应用 role="presentation" 并使 alt 属性保持为空，丢弃已输入的文本。
在 TinyMCE 8.9.0 中，只有当插入/编辑图像对话框显示无障碍选项时，Image 插件才会将图像标记为装饰性图像。现在，为具有空 alt 属性的图像输入替代文本时，会将该文本应用到图像上。
从工具栏打开或关闭侧边栏会使编辑器滚动到选定内容
以前，当编辑器未聚焦时，从工具栏按钮打开或关闭侧边栏会使编辑器内容滚动到当前选定内容。切换侧边栏不是内容操作，因此视口会移开用户正在阅读的文档部分。
在 TinyMCE 8.9.0 中，从工具栏切换侧边栏不再将选定内容滚动到视图中。这适用于通过 editor.ui.registry.addSidebar 注册的所有侧边栏。更改内容的命令（如粗体）将继续像以前一样聚焦编辑器并滚动到选定内容。
editor.focus() 方法还接受一个对象参数，因此调用者可以在不将选定内容滚动到视图中的情况下聚焦编辑器，例如 editor.focus({ scrollToSelection: false })。scrollToSelection 属性默认为 true，传递布尔值时继续像以前一样工作。