> ## 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 自信地发布文章，知道内容清晰完整。 ## 局限性 文档审阅提供反馈，但不会直接应用更改。如需根据建议进行修改，请切换至 **Fast** 或 **Max** 模型的**执行**模式，让 Assistant 来实施推荐的更改。请参阅[使用 Craft Assistant 编辑文档](/zh-Hans/ai-assistant/editing)。 对于非常短的文档（不足 200 词），文档审阅可能价值有限——普通 Assistant 对话通常更适合快速任务。 ## 相关文章 了解如何使用 Assistant 并开始对话 为文档审阅和其他任务选择合适的模型 在执行模式下直接应用审阅建议 创建可复用的审阅指令以获得一致反馈 了解文档审阅及其他功能的 AI 使用量