> ## 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.
# 文件審閱
> 獲得 AI 針對文件結構、清晰度和完整性的意見回饋。
文件審閱功能可為您的寫作提供有結構、可行動的意見回饋。與其向 Assistant 提出一般性問題，文件審閱會分析您的整份文件，並針對結構、清晰度、完整性及整體品質提出具體建議。
這有助於您在分享前發現問題、提升內容品質，並從旁觀者的角度檢視自己的作品——全程無需離開 Craft。
## 文件審閱的功能
文件審閱會從多個維度審視您的文件：
**結構與組織：**
* 邏輯流程與段落銜接
* 標題層級的一致性
* 各節的比例平衡與節奏
* 資訊架構
**清晰度與可讀性：**
* 句子複雜度與長度
* 術語與專業用語的使用
* 段落間的過渡
* 整體可讀性評分
**完整性：**
* 缺少的背景或前言
* 說明的空白
* 未解答的問題
* 需要擴充的部分
**品質指標：**
* 語氣的一致性
* 格式問題
* 重複與冗餘
* 改進空間
審閱結果客觀、具體且可採取行動——您將獲得實際建議，而非模糊的評語。
## 如何啟動文件審閱
開啟您想審閱的文件。
點擊角落的 Assistant 圖示。
選擇**新對話**。
從模式選擇器中選取**文件審閱**。
等待分析完成（通常需要 10-30 秒）。
Assistant 將閱讀您的整份文件，並以分類方式提供有結構的意見回饋。
文件審閱適用於所有模型，但 **Max** 能提供最深入細緻的回饋，尤其對較長或較複雜的文件效果更佳。若需快速檢查，**Fast** 在深度與速度之間取得良好平衡。
## 文件審閱與一般 Assistant 對話的比較
| 功能 | 文件審閱 | 一般 Assistant 對話 |
| -------- | ---------- | --------------- |
| **用途** | 有結構的文件回饋 | 開放式對話與任務 |
| **範圍** | 整份文件分析 | 回答特定問題 |
| **輸出格式** | 按回饋類別整理 | 對話式回應 |
| **分析深度** | 全面、多維度 | 聚焦於您的特定問題 |
| **最適合** | 品質檢查、發布前審閱 | 快速編輯、摘要、內容查詢 |
| **後續提問** | 可提出進一步問題 | 持續對話 |
| **用量** | 較高（分析整份文件） | 依查詢複雜度而異 |
需要對整份文件進行全面回饋時，請使用**文件審閱**；有特定問題或任務時，請使用**一般對話**。
## 適合使用文件審閱的時機
文件審閱在以下情況最具價值：
### 對外分享前
審閱簡報、提案或面向客戶的文件，在送出前找出結構問題、不清楚的段落或缺少的背景。
### 品質保證
定期審閱重要文件、團隊知識庫或說明文章，長期維持高品質與一致性。
### 內容優化
為部落格文章、報告或長篇寫作獲取可行建議。Assistant 可找出需要擴充、簡化或重構的部分。
### 協作前準備
在與團隊成員分享前，確認文件清晰、完整、組織良好，減少來回溝通並提升協作效率。
### 學習與技能提升
利用審閱了解寫作中的規律——反覆出現的清晰度問題、結構傾向，或需要持續改進的地方。
您可以多次執行文件審閱。根據回饋進行修改後再次審閱，確認問題是否已解決。這種反覆的方式有助於學習什麼有效，並逐步精進內容。
## 理解回饋內容
文件審閱的回饋依明確類別整理。以下說明如何解讀並採取行動：
### 結構回饋
**告訴您什麼：** 內容的流暢程度、各節是否平衡，以及資訊架構是否合理。
**回饋範例：**
* 「前言相對於文件其他部分過長」
* 「第 3 節缺乏從第 2 節過渡的清楚銜接」
* 「標題層級從 H2 直接跳至 H4」
**如何處理：** 重新整理段落、調整節奏、修正標題層級，或新增過渡內容。
### 清晰度回饋
**告訴您什麼：** 寫作是否容易理解、句子是否過於複雜，以及讀者可能感到困惑的地方。
**回饋範例：**
* 「這個段落大量使用被動語態，使內容較難跟讀」
* 「第一節的專業術語可能讓非專業讀者感到困惑」
* 「句子平均長度為 35 個字——考慮拆分為較短的句子」
**如何處理：** 簡化句子、以白話文取代術語，或為專業詞彙加入定義。
### 完整性回饋
**告訴您什麼：** 內容的缺口——缺少的背景、未解答的問題，或需要更多細節的部分。
**回饋範例：**
* 「文件提到「新流程」但從未加以定義」
* 「步驟 2 和 3 預設了前言中未涵蓋的先備知識」
* 「未提供結論或後續步驟」
**如何處理：** 補充缺少的背景、擴充薄弱的段落，或加入摘要與結論。
### 品質回饋
**告訴您什麼：** 語氣一致性、格式問題，以及內容潤色的機會。
**回饋範例：**
* 「各節之間語氣從正式切換至隨性」
* 「項目符號格式不一致（部分有句號，部分沒有）」
* 「這個概念被解釋了兩次——考慮合併」
**如何處理：** 統一格式、維持一致語氣、移除冗餘內容。
## 用量
文件審閱比一般問題使用更多 AI 配額，因為它會一次性分析整份文件。文件越長越複雜，用量越多。若需較快速的輕量審閱，請使用 **Fast**。
實際用量取決於文件長度、結構、格式複雜度及所選模型。您可在 Assistant 選單的**用量與限制**中查看用量。
全面的回饋往往比多次個別查詢更能節省時間並提升品質。
## 提升審閱效果的技巧
**1. 先完善您的文件**
請確認文件有一定的完整度再執行審閱。Assistant 對完成草稿的回饋優於對粗略大綱的回饋。
**2. 說明您的目標讀者**
在後續提問中，告訴 Assistant 這份文件的對象是誰：
* 「這份文件的讀者是熟悉產品的技術團隊」
* 「目標受眾是非技術的利害關係人」
* 「為從未使用過 Craft 的新用戶撰寫」
這些背景資訊有助於 Assistant 將回饋調整為符合您需求的方向。
**3. 要求優先排序的回饋**
若審閱發現許多問題，可要求 Assistant 排列優先順序：
* 「我應該先修改哪 3 個問題？」
* 「最關鍵的結構問題是什麼？」
* 「只聚焦於清晰度問題」
**4. 要求特定類型的回饋**
您可以透過聚焦分析來引導審閱方向：
* 「審閱這份文件的語氣一致性」
* 「只檢查完整性和缺少的背景」
* 「聚焦於結構是否適合初學者閱讀」
**5. 選擇合適的模型**
* **本地端：** 不建議用於文件審閱（情境長度有限）
* **Core：** 對短文件進行快速結構檢查
* **Fast：** 大多數審閱的良好選擇（500-2000 字）
* **Max：** 最適合長篇、複雜文件，或需要最深入回饋時
## 範例：發布部落格文章前
Sarah 撰寫了一篇關於在 Craft 中使用集合的部落格文章。在發布前，她想確認內容清晰且完整。
Sarah 在 Craft 中開啟她的草稿。
她點擊 Assistant 圖示並選擇**文件審閱**。
Assistant 分析文件後提供以下回饋：
* **結構：**「前言有力，但第 2 節的篇幅是第 3 和第 4 節加起來的兩倍，考慮拆分為兩個部分。」
* **清晰度：**「多個技術術語（關聯、屬性、視圖）在定義前就已使用，建議加入詞彙表或在首次出現時加以定義。」
* **完整性：**「文章解釋了集合*是什麼*，但沒有說明*何時*使用集合相對於資料夾或標籤。」
* **品質：**「語氣一致。結尾有一個重複的段落複述了前言——考慮刪除。」
Sarah 根據回饋進行調整：拆分第 2 節、加入定義、新增「何時使用集合」一節，並移除冗餘內容。
她再次執行文件審閱，Assistant 確認問題已解決。
Sarah 充滿信心地發布文章，確信內容清晰且完整。
## 功能限制
文件審閱提供回饋，但不會直接套用變更。若要根據建議採取行動，請切換至 **Execute** 模式並搭配 **Fast** 或 **Max** 模型，要求 Assistant 實作建議的修改。請參閱[使用 Craft Assistant 編輯文件](/zh-Hant/ai-assistant/editing)。
對於非常短的文件（不足 200 字），文件審閱可能價值有限——一般 Assistant 對話通常更適合快速任務。
## 相關文章
學習如何使用 Assistant 並開始對話
為文件審閱及其他任務選擇合適的模型
在 Execute 模式下直接套用審閱建議
建立可重複使用的審閱指令以獲得一致回饋
瞭解文件審閱及其他功能的 AI 用量