Review功能通过运行语法、风格、清晰度、语气等检查，为内容提供AI驱动的质量保证。Review始终分析整个文档。如需针对选定内容或范围使用AI快捷方式，请参阅Quick Actions。在Review完成或被关闭之前，编辑器将处于只读Review模式。建议会显示在Review侧边栏和文档中；每项更改只有在被接受或拒绝后才会应用。该插件引入了直观的界面，可直接在文档中Review和管理AI建议的编辑，确保内容以最少的手动工作达到专业标准。API提供相同功能，支持灵活集成。

Review功能可通过插件UI和Reviews API使用。本页涵盖两者：

  • 插件章节描述面向用户的功能和配置（Review configuration）。

  • API章节介绍REST API访问（从Reviews API开始）。

Demo

下方的交互式demo加载了带有Review功能的编辑器。使用Review工具栏按钮打开Review侧边栏并运行内置Review。

HTML

<textarea id="tinymceai-review">
<h1>内容创作的未来：将GenAI整合到现代工作流中</h1>
<p>数字内容创作的格局正在经历一场重大变革。多年来，写作、编辑和发布的过程主要依靠手动操作，每一份草稿都需要大量的脑力劳动。然而，生成式AI（GenAI）的出现引入了一种新的模式。通过将智能直接嵌入到写作工具中，组织可以释放前所未有的生产力和创造力水平。</p>
<figure class="image"><img style="width: 566px; aspect-ratio: 1536 / 1024; display: block; margin-left: auto; margin-right: auto;" src="https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/preview/" sizes="(min-width: 1536px) 1536px, 100vw" srcset="https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/100x/ 100w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/200x/ 200w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/300x/ 300w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/500x/ 500w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/750x/ 750w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/1000x/ 1000w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/1250x/ 1250w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/resize/1500x/ 1500w,https://tiny.ucarecdn.com/c273f5d9-8931-4f66-86a4-347a6137ca88/-/preview/ 1536w" alt="红蓝半色调风格的复古波普艺术插图，展示一个友好的机器人与三名使用笔记本电脑和平板电脑的人员合作，象征AI辅助的内容创作与团队协作。" height="357">
  <figcaption>通过将智能直接嵌入到写作工具中，组织可以释放前所未有的生产力和创造力水平。</figcaption>
</figure>
<h2>从外部工具转向原生整合</h2>
<p>许多早期采用AI技术的用户依赖外部聊天界面。虽然功能强大，但这种“复制-粘贴”的工作流会产生阻碍并打断创作流程。原生整合——即AI存在于文本编辑器本身——使创作者能够保持专注。AI不再需要切换标签页来生成摘要或检查事实，而是作为理解当前文档上下文的协作伙伴。</p>
<h3>整合AI的关键优势</h3>
<ul>
  <li><strong>上下文感知：</strong> AI可以分析现有文本，以建议相关的后续要点或保持一致的品牌形象。</li>
  <li><strong>降低认知负荷：</strong> 通过自动化格式化和基础校对等重复性任务，作者可以专注于高层面的策略和叙事。</li>
  <li><strong>简化协作：</strong> 整合的工具允许团队在单一的共享环境中进行头脑风暴和完善想法，加快审批流程。</li>
  <li><strong>提升准确性：</strong> 当连接到内部知识库时，GenAI可以提供通用模型所缺乏的事实核查能力。</li>
</ul>
<h2>评估工作流改进</h2>
<p>为了理解GenAI整合的影响，将传统工作流与AI增强型流程进行对比是有帮助的。下表突出了常见的内容任务，以及原生AI如何为不同利益相关者转变输出和效率。</p>
<table style="width: 100%; border-collapse: collapse; margin-top: 20px; margin-bottom: 20px; border: 1px solid rgb(206, 212, 217);" border="1">
  <thead>
    <tr>
      <th style="border-color: #ced4d9; background-color: #ecf0f1; width: 26.6364%;">工作流任务</th>
      <th style="border-color: #ced4d9; background-color: #ecf0f1; width: 35.8714%;">传统方法</th>
      <th style="border-color: #ced4d9; background-color: #ecf0f1; width: 37.4922%;">GenAI增强方法</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="border-color: #ced4d9; width: 26.6364%;"><strong>起草</strong></td>
      <td style="border-color: #ced4d9; width: 35.8714%;">从空白页开始。</td>
      <td style="border-color: #ced4d9; width: 37.4922%;">AI生成大纲和初始草稿。</td>
    </tr>
    <tr>
      <td style="border-color: #ced4d9; width: 26.6364%;"><strong>研究</strong></td>
      <td style="border-color: #ced4d9; width: 35.8714%;">在多个标签页中手动搜索。</td>
      <td style="border-color: #ced4d9; width: 37.4922%;">即时检索内外部数据。</td>
    </tr>
    <tr>
      <td style="border-color: #ced4d9; width: 26.6364%;"><strong>语气调整</strong></td>
      <td style="border-color: #ced4d9; width: 35.8714%;">针对不同受众手动重写。</td>
      <td style="border-color: #ced4d9; width: 37.4922%;">一键转换（例如，从随意到正式）。</td>
    </tr>
    <tr>
      <td style="border-color: #ced4d9; width: 26.6364%;"><strong>总结</strong></td>
      <td style="border-color: #ced4d9; width: 35.8714%;">阅读全文并手动压缩。</td>
      <td style="border-color: #ced4d9; width: 37.4922%;">自动生成关键要点。</td>
    </tr>
    <tr>
      <td style="border-color: #ced4d9; width: 26.6364%;"><strong>本地化</strong></td>
需要外部翻译服务。 编辑器内多语言支持和翻译。

克服采用挑战

虽然优势明显，但实施GenAI需要战略性方法。关于数据隐私、输出质量和“人文关怀”的担忧很常见。为解决这些问题，组织应优先选择提供“人机回环（human-in-the-loop）”功能的工具。AI应被视为助手——一个提供建议的副驾驶，同时将最终编辑控制权留在作者手中。

此外，技术团队必须关注“集成商”体验。为开发人员提供简洁的API和预构建的UI组件，可确保这些高级功能能够快速部署，而无需冒险从零开始构建复杂的AI基础设施。展望未来，目标很简单：让技术隐于幕后，赋能创作者减少摩擦地完成最佳工作。

JS

// 步骤1：设置会话 - 这应作为应用程序用户管理流程的一部分
// 以下开源插件仅用于编辑演示HTML（列表、链接、表格）。TinyMCE AI选项是重点
tinymce.init({
  selector: 'textarea#tinymceai-review',
  height: '800px',
  plugins: ['tinymceai', 'advlist', 'lists', 'link', 'autolink', 'table', 'wordcount'],
  toolbar: 'undo redo | tinymceai-chat ai-quickactions-translate tinymceai-review | styles | bold italic underline strikethrough | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link',
  sidebar_show: 'tinymceai-review',
  tinymceai_token_provider: async () => {
    return fetch('/api/tinymceai-token', { credentials: 'include' })
      .then(resp => resp.text())
      .then(token => ({ token }));
  },
  tinymceai_chat_fetch_sources: () => Promise.resolve([{
    label: 'TinyMCE resources',
    sources: [
      { id: 'docs', label: 'TinyMCE Documentation', type: 'web-resource' },
      { id: 'blog', label: 'Tiny Blog', type: 'web-resource' },
      { id: 'survey-2023', label: 'State of rich text editing 2023', type: 'web-resource' },
    ]
  }]),
  tinymceai_chat_fetch_source: (id) => {
    const urls = {
      'docs': 'https://www.tiny.cloud/docs/tinymce/latest/',
      'blog': 'https://www.tiny.cloud/blog/',
      'survey-2023': 'https://www.tiny.cloud/developer-survey-results-2023/',
    };
    return Promise.resolve({ type: 'web-resource', url: urls[id] });
  },
  tinymceai_quickactions_custom: [
    {
      type: 'chat',
      title: 'Challenge',
      prompt: 'Challenge statements, verify facts and identify assumptions'
    }
  ],
  tinymceai_languages: [
    { title: 'English', language: 'english' },
    { title: 'Chinese (Simplified)', language: 'chinese' },
    { title: 'Spanish', language: 'spanish' },
    { title: 'German', language: 'german' },
    { title: 'Japanese', language: 'japanese' },
    { title: 'Portuguese', language: 'portuguese' },
    { title: 'Swedish', language: 'swedish' },
    { title: 'Korean', language: 'korean' },
    { title: 'Hindi (Devanagari)', language: 'hindi devanagari' },
    { title: 'Italian', language: 'italian' },
    { title: 'Klingon', language: 'klingon' },
    { title: 'Dothraki', language: 'dothraki' },
  ]
});

审查侧边栏和内置审查

下图是审查模式下审查侧边栏在返回任何建议前的静态截图。内置审查按类别分组（校对、改善清晰度、提高可读性、调整长度、调整语气和风格）。展开类别可阅读描述并选择运行来分析整个文档。本例中提高可读性已展开。

审查侧边栏显示审查类别，其中提高可读性已展开且可运行

集成

要开始使用审查功能，请在plugins配置选项中添加tinymceai。这将自动将审查图标 审查工具栏按钮和菜单项添加到默认的TinyMCE工具栏和菜单中。

有关安装和启用AI功能的更多信息，请参阅插件参考文档。

在审查模式标签页中选择一个可用审查后，AI将分析文档并提出一系列建议：

TinyMCE AI在内容中的审查建议

在审查模式下，编辑器保持只读状态，允许浏览建议。建议可在侧边栏中点击或在编辑器内容中选择（带下划线）：

TinyMCE AI审查侧边栏显示建议

审查建议可单独跳过或通过点击相应按钮应用。用户做出选择后，建议卡片会显示已应用或已跳过状态，变更在界面中变灰，卡片提供撤销按钮。撤销将建议恢复到待处理状态。侧边栏顶部的“完成”按钮可执行以下操作：

  • 批量跳过或应用剩余建议

  • 使用当前已应用的建议完成审查（跳过其余建议）

  • 中止审阅并退出（所有已应用的更改将被撤销）

内置审阅

内置系统审阅如下表所示。编辑器列是审阅在编辑器中可用时，审阅侧边栏中的标签。API 审阅列列出了Reviews API在/v1/reviews/system/{reviewName}/calls路径中接受的reviewName值。具有多个选项的编辑器审阅，每个选项对应一个 API 审阅。

编辑器API 审阅描述编辑器界面API

校对

correctness

检查语法、拼写和标点符号；correctness API 审阅还处理事实性错误。

✓

✓

提升清晰度

clarity

改善逻辑结构、精确性、句子结构、词语选择和流畅性。

✓

✓

提升可读性

readability

通过句子结构、段落结构、过渡、词语选择和阅读水平提升可读性。

✓

✓

调整长度

make-longer
make-shorter

在保留关键信息的同时缩短或延长文本。编辑器提供更长和更短选项，每个选项运行其自己的 API 审阅。

✓

✓

调整语气和风格

make-tone-casual
make-tone-direct
make-tone-friendly
make-tone-confident
make-tone-professional

调整语气和风格。编辑器包括随意、直接、友好、自信和专业选项，每个选项运行其自己的 API 审阅。

✓

✓

自定义审阅

—

自定义审阅：自定义提示和模型；像其他审阅一样流式传输。

✓

✓（自定义审阅调用端点）

translate

在不同语言之间进行翻译，并适应文化差异。

✓

  • 编辑器界面列中的勾号表示，当该审阅类型在tinymceai_reviews中列出时，它可以出现在审阅侧边栏中。

  • 自定义审阅默认包含在审阅侧边栏中。自定义审阅（API）部分描述了用于相同流式审阅流程的 REST 端点。

  • 翻译审阅仅限 API 使用（不在审阅侧边栏中列出）；请参阅上表中的翻译行。若要从编辑器进行翻译，请参阅快速操作参考表中的翻译。

自定义审阅

审阅侧边栏默认包含一个自定义审阅类别。当tinymceai_allow_model_selection允许时，可以输入自然语言提示并选择 AI 模型；审阅从运行开始。文档会像内置审阅一样通过流式建议进行分析；在输入提示并选择模型之前，运行将保持禁用状态。若要隐藏自定义审阅，请从tinymceai_reviews中移除'ai-reviews-custom'。

后端使用自定义审阅调用（POST /v1/reviews/custom/calls），请求体中包含content、prompt和model。如果审阅失败，审阅侧边栏中的错误消息会提供重试选项，该选项会使用相同的参数重新运行上一次审阅（适用于系统审阅和自定义审阅）。

配置

可以使用tinymceai_reviews选项配置哪些内置审阅出现在审阅侧边栏中。有关详细信息，请参阅插件参考中的tinymceai_reviews。

Reviews API

审阅插件功能基于 Reviews API 构建，该 API 提供了对审阅功能的 REST API 访问。审阅运行整个文档工作流：编辑器分析整个文档，流式传输建议，并且仅在审阅侧边栏中接受或拒绝后应用更改。快速操作是对所选内容或范围进行离散 AI 操作的快捷方式（例如预览转换、翻译或上下文聊天）——不是相同的端到端审阅流程。

审阅与快速操作的比较：审阅协调整个文档的分析和审阅模式中的跟踪建议。快速操作从快速操作菜单中公开单个 AI 功能，无需进入该工作流。有关可用快捷方式和行为，请参阅快速操作。

审阅使用 Server-Sent Events 的流式输出，以便在建议生成时提供实时反馈。每种审阅类型都针对特定的改进任务进行了优化，可对文本结构、风格和质量提供一致且高质量的分析。审阅会针对内容改进提供具体且可操作的建议。

系统审阅

系统审阅是面向常见用例的内置审阅，请求中不需要指定模型。API 提供一个用于运行系统审阅的端点：Call a system review，该端点在其路径中从 API review 列获取审阅名称。请求内容中的每个 HTML 元素都需要一个唯一的 data-id 属性。

内置系统审阅（包括 API 名称、描述，以及每种类型是在 Review 侧边栏中可用还是仅通过 API 可用）汇总在 Built-in reviews 中。

关于每个系统审阅所需的 token scopes，请参阅 Reviews permissions。

有关端点详情、请求和响应 schema、身份验证以及流式行为，请参阅 Reviews API。

自定义审阅（API）

集成方也可以直接调用 Custom Review API endpoint。它以与系统审阅相同的方式流式传输建议，但会在请求体中传入文档 content 以及自定义的 prompt（和 model）。自定义审阅可以很简单，例如检查特定单词或短语；也可以很复杂，例如应用包含业务逻辑、特定术语等的公司风格指南。有关端点、参数和示例，请参阅 Reviews API。

用户也可以通过 Review 侧边栏中的 Custom review 类别，直接在编辑器中运行自定义审阅。

自定义审阅需要在 JWT token 中具备 ai:reviews:custom 权限。请参阅 Reviews permissions。

流式响应

审阅使用 Server-Sent Events（SSE）进行实时流式结果输出。详细实现信息请参阅 Streaming responses guide。关于事件及其 payload，请参阅 API 参考中的 Call a system review 和 Call a custom review。

API 参考

Reviews API 参考文档（交互式 OpenAPI 文档）是关于端点、请求与响应 schema、身份验证、系统与自定义审阅调用、示例以及流式审阅响应的完整来源。

相关功能

  • AI chat：用于结合文档分析与上下文进行交互式讨论。

  • Quick actions：对选区或范围执行单个 AI 操作的快捷方式（转换、翻译、聊天和自定义操作）。

  • Multi-editor mode：用于在页面上的多个编辑器之间共享 Chat、Review 和 Quick Actions。