跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

文档审阅功能可为您的写作提供结构化、可操作的反馈。与向 Assistant 提出一般性问题不同,文档审阅会对您的整篇文档进行分析,从结构、清晰度、完整性和整体质量等维度提供深入见解。 这有助于您在分享前发现问题、提升内容质量,并从旁观者的角度审视自己的作品——无需离开 Craft。

文档审阅的功能

文档审阅从多个维度对您的文档进行检查: 结构与组织:
  • 逻辑流向与层次递进
  • 标题层级与一致性
  • 章节平衡与节奏感
  • 信息架构
清晰度与可读性:
  • 句子复杂度与长度
  • 专业术语与技术语言的使用
  • 段落间的过渡衔接
  • 整体可读性评分
完整性:
  • 缺失的上下文或背景信息
  • 说明中的逻辑断层
  • 未解答的问题
  • 需要扩展的部分
质量信号:
  • 语气的一致性
  • 格式问题
  • 冗余与重复
  • 可改进之处
审阅结果客观、具体、可操作——您获得的是有针对性的具体建议,而非模糊笼统的评价。

如何触发文档审阅

1
打开您想要审阅的文档。
2
点击底部角落的 Assistant 图标。
3
选择新建对话
4
在模式选择器中选择文档审阅
5
等待分析完成(通常需要 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 中使用收藏集的博客文章。发布前,她想确保文章清晰完整。
1
Sarah 在 Craft 中打开她的博客草稿。
2
她点击 Assistant 图标,选择文档审阅
3
Assistant 分析文档并提供反馈:
  • 结构:“引言部分很好,但第 2 节的篇幅是第 3、4 节合计的两倍,建议拆分为两部分。”
  • 清晰度:“多个技术术语(关联、属性、视图)在定义前就已使用,建议添加术语表或在首次出现时给出定义。”
  • 完整性:“文章解释了收藏集是什么,但没有涵盖何时使用它们,而非使用文件夹或标签。”
  • 质量:“语气一致。结尾有一个冗余段落重复了引言内容——建议删除。”
4
Sarah 根据反馈进行调整:拆分第 2 节、添加定义、加入”何时使用收藏集”章节,并删除冗余内容。
5
她再次运行文档审阅。Assistant 确认问题已解决。
6
Sarah 自信地发布文章,知道内容清晰完整。

局限性

文档审阅提供反馈,但不会直接应用更改。如需根据建议进行修改,请切换至 FastMax 模型的执行模式,让 Assistant 来实施推荐的更改。请参阅使用 Craft Assistant 编辑文档 对于非常短的文档(不足 200 词),文档审阅可能价值有限——普通 Assistant 对话通常更适合快速任务。

相关文章

使用 Craft Assistant

了解如何使用 Assistant 并开始对话

选择 AI 模型

为文档审阅和其他任务选择合适的模型

使用 Craft Assistant 编辑文档

在执行模式下直接应用审阅建议

自定义提示词

创建可复用的审阅指令以获得一致反馈

使用量与限制

了解文档审阅及其他功能的 AI 使用量