> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 Craft Assistant 编辑文档

> 让 Assistant 直接在您的文档中进行更改——添加内容、应用样式、创建子页面等。

Craft Assistant 可以直接更新您的文档。您可以让它添加内容、应用样式、创建子页面、重新整理章节等。

## 探索与执行模式

Craft Assistant 提供两种模式：

* **探索（Explore）** — Assistant 读取您的文档并提议更改方案，您审阅并确认后才会进行任何修改。
* **执行（Execute）** — Assistant 读取您的文档并直接应用更改，您可以实时看到编辑效果。

在 Assistant 面板底部使用模式选择器进行切换。

<img src="https://mintcdn.com/craft-support/8R3j8_MOUDKwTvNH/images/ai-assistant/editing/en/content/mode-selector.png?fit=max&auto=format&n=8R3j8_MOUDKwTvNH&q=85&s=c2a4928c6e76279109d71d4a69aaa6de" alt="Mode selector showing Explore and Execute options" width="442" height="136" data-path="images/ai-assistant/editing/en/content/mode-selector.png" />

## Assistant 在执行模式下能做什么

Assistant 可以：

* **创建和修改文本** — 标题、段落、列表、标注框和代码块
* **为文档添加样式** — 高亮、颜色、背景、分隔线和视觉样式
* **创建子页面** — 在文档内嵌套添加新页面
* **创建新文档** — 在您的空间中添加文档或复制现有文档
* **创建文件夹** — 将内容整理到新文件夹中
* **移动文档和文件夹** — 重新排列空间结构
* **删除内容** — 移除内容块、文档或文件夹
* **重新整理章节** — 移动和重构内容

## 会话

* 会话**跨设备同步**。
* 您可以**并行运行多个会话**。
* 会话在**5 分钟**无操作后暂停，对话历史会被保留——随时可从会话列表中重新打开。
* 后台会话完成时，会出现**通知圆点**。

## 开始编辑会话

<Steps>
  <Step>
    打开您想要编辑的文档。
  </Step>

  <Step>
    打开 Assistant 面板。
  </Step>

  <Step>
    切换至**执行**模式。
  </Step>

  <Step>
    描述您想要进行的更改。
  </Step>

  <Step>
    在文档中查看结果。
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/8R3j8_MOUDKwTvNH/images/ai-assistant/editing/en/content/execute-session.png?fit=max&auto=format&n=8R3j8_MOUDKwTvNH&q=85&s=e7d358f19991a87b7cb76dd831671763" alt="Assistant executing edits in a document" width="1568" height="900" data-path="images/ai-assistant/editing/en/content/execute-session.png" />

## 撤销与还原

<Tip title="一键撤销">
  **⌘Z（Ctrl+Z）** 可撤销 Assistant 上一次操作的全部内容——不是单个编辑，而是 Assistant 在上一次回复中所做的所有操作。重复按 ⌘Z 可撤销多个操作。
</Tip>

您也可以直接让 Assistant 还原或调整它所做的更改。

## 获得更好效果的技巧

* 明确说明您希望修改的内容。
* 先从小范围编辑开始，再进行大规模重写。
* 先试试 **Fast**——它能很好地处理大多数编辑，且消耗配额较少。对于复杂的多章节重构，再切换至 **Max**。
* 每次请求后检查更改结果。

## 哪些模型支持编辑

| 模型       | 是否支持编辑 | 说明      |
| -------- | ------ | ------- |
| **Max**  | 是      | 最适合复杂编辑 |
| **Fast** | 是      | 适合快速编辑  |
| **Core** | 否      | 仅限只读对话  |
| **本地模型** | 否      | 只读，本地运行 |

## 使用量

编辑任务比只读对话消耗更多配额，因为 Assistant 需要执行多个步骤（读取、规划和应用）。实际使用量取决于文档大小和请求复杂度。对于简单编辑，使用 **Fast** 以保持高效。

## 平台支持情况

<Tabs>
  <Tab title="macOS">
    文档级别和空间级别均完全支持编辑。
  </Tab>

  <Tab title="iOS">
    在 iPad 和 iPhone 上，文档级别和空间级别均完全支持编辑。
  </Tab>

  <Tab title="Windows">
    Assistant 可用，执行模式即将推出。
  </Tab>

  <Tab title="Web">
    Assistant 可用，执行模式即将推出。
  </Tab>
</Tabs>

## 相关文章

<CardGroup cols={2}>
  <Card title="使用 Craft Assistant" href="/zh-Hans/ai-assistant/using">
    了解如何开始对话并使用各种模式
  </Card>

  <Card title="选择 AI 模型" href="/zh-Hans/ai-assistant/models">
    为编辑任务选择最合适的模型
  </Card>

  <Card title="使用量与限制" href="/zh-Hans/ai-assistant/usage">
    了解编辑及其他任务的 AI 使用量
  </Card>

  <Card title="自定义提示词" href="/zh-Hans/ai-assistant/custom-prompts">
    创建可复用的编辑指令
  </Card>

  <Card title="文档审阅" href="/zh-Hans/ai-assistant/document-review">
    在应用编辑之前获取 AI 反馈
  </Card>
</CardGroup>