> ## 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 可以直接更新您的文件。您可以要求它新增內容、套用樣式、建立子頁面、重新整理段落等。

## Explore 與 Execute 模式

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="顯示 Explore 與 Execute 選項的模式選擇器" width="442" height="136" data-path="images/ai-assistant/editing/en/content/mode-selector.png" />

## Assistant 在 Execute 模式下可以執行的操作

Assistant 可以：

* **建立與修改文字** — 標題、段落、清單、提示方塊和程式碼區塊
* **設定文件樣式** — 醒目提示、顏色、背景、分隔線和視覺樣式
* **建立子頁面** — 在文件內新增巢狀頁面
* **建立新文件** — 在空間中新增文件或複製現有文件
* **建立資料夾** — 將內容整理至新資料夾
* **移動文件和資料夾** — 重新安排空間結構
* **刪除內容** — 移除區塊、文件或資料夾
* **重新整理段落** — 移動並重構內容

## 工作階段

* 工作階段會**跨裝置同步**。
* 您可以**同時執行多個工作階段**。
* 工作階段在閒置 **5 分鐘**後暫停。對話記錄會保留——隨時可從工作階段清單重新開啟。
* 背景工作階段完成時，會顯示**通知點**。

## 開始編輯工作階段

<Steps>
  <Step>
    開啟您想編輯的文件。
  </Step>

  <Step>
    開啟 Assistant 面板。
  </Step>

  <Step>
    切換至 **Execute** 模式。
  </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 在文件中執行編輯" 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 可用。Execute 模式即將推出。
  </Tab>

  <Tab title="Web">
    Assistant 可用。Execute 模式即將推出。
  </Tab>
</Tabs>

## 相關文章

<CardGroup cols={2}>
  <Card title="使用 Craft Assistant" href="/zh-Hant/ai-assistant/using">
    學習如何開始對話並使用各種模式
  </Card>

  <Card title="選擇 AI 模型" href="/zh-Hant/ai-assistant/models">
    選擇最適合編輯任務的模型
  </Card>

  <Card title="用量與限制" href="/zh-Hant/ai-assistant/usage">
    瞭解編輯及其他任務的 AI 用量
  </Card>

  <Card title="自訂提示詞" href="/zh-Hant/ai-assistant/custom-prompts">
    建立可重複使用的編輯指令
  </Card>

  <Card title="文件審閱" href="/zh-Hant/ai-assistant/document-review">
    套用編輯前先獲取 AI 回饋
  </Card>
</CardGroup>