---
title: "将建议应用到编辑器内容"
description: "了解如何在 Tiptap 编辑器中应用、拒绝和高亮 AI 建议。更多内容请查阅文档！"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/suggestion/features/apply-suggestions"
---

# 将建议应用到编辑器内容

了解如何在 Tiptap 编辑器中应用、拒绝和高亮 AI 建议。更多内容请查阅文档！

AI Suggestion 扩展提供命令，将建议应用到编辑器内容。这些命令允许你接受或拒绝建议，并将其应用到编辑器内容中。

## 应用单个建议

要将建议应用到编辑器内容中，使用 `applyAiSuggestion` 命令。

一个建议可以有多个替换选项。要应用特定的替换选项，请提供 `replacementOptionId` 属性。如果你不提供该属性，默认应用第一个替换选项。

注意：如果你使用 Tiptap Content AI Cloud API 生成建议， 每个建议只有一个替换选项。但如果你使用自己的后端和大型语言模型（LLM），可以提供多个替换选项。

你可以通过提供 `format` 属性来自定义替换文本的格式。默认格式是“plain-text”（纯文本）。如果你想让替换文本格式为富文本，请使用“rich-text”格式。当建议修改了样式，比如加粗或斜体格式时，这会很有用。

```ts
editor.commands.applyAiSuggestion({
  suggestionId: '1',
  replacementOptionId: '1',
  format: 'plain-text',
})
```

## 应用所有建议

要一次性应用所有建议，使用 `applyAllAiSuggestions` 命令。

```ts
editor.commands.applyAllAiSuggestions()
```

这将为每个建议应用其第一个替换选项到编辑器内容。

如果有些建议相互重叠，AI Suggestion 扩展会自动解决冲突，忽略后续应用的重叠建议。这通常不是问题，因为在每次更改后建议都会重新加载，AI Suggestion 扩展会根据更新后的内容生成新的建议。

## 拒绝建议

你可以使用 `rejectAiSuggestion` 命令拒绝建议。

```ts
editor.commands.rejectAiSuggestion('suggestionId')
```

当你拒绝一个建议后，它将不再显示在编辑器中。不过，它仍然保存在扩展的存储对象中，你可以通过调用 `storage.getSuggestions()` 来获取它。你可以通过读取 `isRejected` 属性来检查某个建议是否被拒绝。

你也可以通过调用 `storage.getRejections()` 访问被拒绝建议的列表。

## 应用建议后高亮替换文本

要高亮或添加任意标记到被建议替换的文本，你可以将 `applyAiSuggestion` 命令与设置标记到建议范围的命令链式调用。

```ts
editor
  .chain()
  // 应用建议
  .applyAiSuggestion({
    suggestionId: suggestion.id,
    replacementOptionId: option.id,
  })
  // 选择被修改的文本
  .command(({ tr, commands }) => {
    // 需要映射被修改文本的位置，因为应用建议后它们可能已发生变化
    return commands.setTextSelection({
      from: tr.mapping.map(suggestion.deleteRange.from),
      to: tr.mapping.map(suggestion.deleteRange.to),
    })
  })
  // 对被修改文本应用样式。例如，加粗样式
  .setBold()
  // 将光标设置到被修改文本的末尾
  .command(({ tr, commands }) => {
    return commands.setTextSelection(tr.mapping.map(suggestion.deleteRange.to))
  })
  .focus()
  .run()
```

## 与协作功能一起使用

当在 Tiptap 协作功能中使用 AI Suggestion 时，建议对于每个用户都是私有的。这允许基于用户偏好或上下文显示不同的建议。一旦接受，建议将对所有连接用户可见（[了解更多](https://tiptap.zhcndoc.com/content-ai/resources/collaboration.md)）。