文档审阅功能可为您的写作提供结构化、可操作的反馈。与向 Assistant 提出一般性问题不同,文档审阅会对您的整篇文档进行分析,从结构、清晰度、完整性和整体质量等维度提供深入见解。 这有助于您在分享前发现问题、提升内容质量,并从旁观者的角度审视自己的作品——无需离开 Craft。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 将通读您的整篇文档,并按类别提供结构化反馈。文档审阅支持所有模型,但 Max 能提供最全面、最深入的反馈,尤其适合较长或较复杂的文档。如果只是快速检查,Fast 在深度与速度之间取得了很好的平衡。
文档审阅与普通 Assistant 对话的对比
| 功能 | 文档审阅 | 普通 Assistant 对话 |
|---|---|---|
| 用途 | 结构化文档反馈 | 开放式对话与任务处理 |
| 范围 | 全文分析 | 回答特定问题 |
| 输出格式 | 按反馈类别组织 | 对话式回复 |
| 分析深度 | 全面、多维度 | 聚焦于您的具体问题 |
| 适合场景 | 质量检查、发布前审阅 | 快速编辑、摘要、内容查询 |
| 后续提问 | 可进行澄清性追问 | 持续对话 |
| 使用量 | 较高(分析完整文档) | 因查询复杂度而异 |
何时使用文档审阅
文档审阅在以下场景最具价值:对外分享前
在发送演示文稿、提案或面向客户的文档之前,检查结构问题、表述不清或缺失的上下文。质量保证
定期审阅重要文档、团队维基或知识库文章,长期保持高质量和一致性。内容优化
为博客文章、报告或长篇写作获取可操作的改进建议。Assistant 可以识别需要扩展、简化或重构的部分。协作准备
在与团队成员共享之前,确保文档清晰、完整、结构良好,减少反复沟通,提高协作效率。学习与技能提升
通过审阅了解自己写作中的规律——反复出现的清晰度问题、结构倾向,以及持续需要改进的方面。您可以多次运行文档审阅。根据反馈进行修改后,再次审阅以确认问题是否已解决。这种迭代方式有助于您了解什么有效,并逐步完善内容。
理解反馈内容
文档审阅的反馈按清晰的类别组织。以下是如何解读和应用这些反馈:结构反馈
**它告诉您:**内容的流向是否顺畅、各章节是否平衡、信息架构是否合理。 反馈示例:- “引言部分相对于文档其余内容来说过长”
- “第 3 节缺乏从第 2 节的清晰过渡”
- “标题层级从 H2 直接跳到了 H4”
清晰度反馈
**它告诉您:**您的写作是否易于理解、句子是否过于复杂,以及读者可能在哪里感到困惑。 反馈示例:- “本段落大量使用被动语态,使内容较难跟读”
- “第一节中的专业术语可能让非专业读者感到困惑”
- “句子平均长度为 35 个词——建议拆分为更短的句子”
完整性反馈
**它告诉您:**内容中的缺口——缺失的上下文、未解答的问题,或需要更多细节的部分。 反馈示例:- “文档提到了’新流程’但从未给出定义”
- “第 2、3 步假设了读者具备引言中未涵盖的先验知识”
- “未提供结论或后续步骤”
质量反馈
**它告诉您:**语气的一致性、格式问题,以及润色内容的机会。 反馈示例:- “语气在不同章节之间从正式切换为随意”
- “项目符号格式不统一(有些以句号结尾,有些没有)”
- “这个概念被解释了两遍——建议合并”
使用量
文档审阅比简单提问消耗更多 AI 配额,因为它需要在单次请求中分析整篇文档。文档越长、越复杂,消耗越多。如需快速轻量的审阅,可使用 Fast。实际使用量取决于文档长度、结构、格式复杂度以及所选模型。您可以在 Assistant 菜单的使用量与限制中查看用量。
获得更好审阅结果的技巧
1. 先完善文档 在运行审阅之前,确保文档已相对完整。Assistant 对完成稿的反馈优于对粗略大纲的反馈。 2. 指明目标读者 在后续提示中告诉 Assistant 这篇文档的受众:- “这是写给熟悉产品的技术团队的”
- “受众是非技术背景的利益相关者”
- “写给从未使用过 Craft 的新用户”
- “我应该先解决哪 3 个问题?”
- “最关键的结构问题是什么?”
- “只关注清晰度问题”
- “检查这篇文章的语气一致性”
- “只检查完整性和缺失的上下文”
- “重点检查结构是否适合初学者受众”
- **本地模型:**不建议用于文档审阅(上下文有限)
- **Core:**对短文档进行快速结构检查
- **Fast:**适合大多数审阅任务(500-2000 词)
- **Max:**最适合长文档、复杂文档,或需要最深入反馈的情况
示例:发布博客文章前
Sarah 写了一篇关于在 Craft 中使用收藏集的博客文章。发布前,她想确保文章清晰完整。Assistant 分析文档并提供反馈:
- 结构:“引言部分很好,但第 2 节的篇幅是第 3、4 节合计的两倍,建议拆分为两部分。”
- 清晰度:“多个技术术语(关联、属性、视图)在定义前就已使用,建议添加术语表或在首次出现时给出定义。”
- 完整性:“文章解释了收藏集是什么,但没有涵盖何时使用它们,而非使用文件夹或标签。”
- 质量:“语气一致。结尾有一个冗余段落重复了引言内容——建议删除。”
局限性
文档审阅提供反馈,但不会直接应用更改。如需根据建议进行修改,请切换至 Fast 或 Max 模型的执行模式,让 Assistant 来实施推荐的更改。请参阅使用 Craft Assistant 编辑文档。 对于非常短的文档(不足 200 词),文档审阅可能价值有限——普通 Assistant 对话通常更适合快速任务。相关文章
使用 Craft Assistant
了解如何使用 Assistant 并开始对话
选择 AI 模型
为文档审阅和其他任务选择合适的模型
使用 Craft Assistant 编辑文档
在执行模式下直接应用审阅建议
自定义提示词
创建可复用的审阅指令以获得一致反馈
使用量与限制
了解文档审阅及其他功能的 AI 使用量