Document Review 的功能
Document Review 从多个维度审视你的文档： 结构与组织：- 逻辑流与推进
- 标题层级与一致性
- 各部分的平衡与节奏
- 信息架构
- 句子复杂度与长度
- 行业术语与技术语言的使用
- 段落间的过渡
- 整体可读性评分
- 缺失的背景或上下文
- 解释中的空白或断层
- 未回答的问题
- 需要扩展的部分
- 语气一致性
- 格式问题
- 冗余与重复
- 改进机会
如何触发 Document Review
Craft Assistant 会阅读全文并按类别提供结构化反馈。
Document Review 可与所有模型配合使用，但 Max 在处理较长或更复杂文档时提供最全面、最细致的反馈。若需快速检查，Fast 在深度与速度之间提供良好平衡。
Document Review 与通用 Assistant 聊天的区别
| 功能 | Document Review | 通用 Assistant 聊天 |
|---|---|---|
| 目的 | 对文档进行结构化反馈 | 开放式对话与执行任务 |
| 范围 | 全文分析 | 回答具体问题 |
| 输出格式 | 按反馈类别组织 | 对话式回复 |
| 分析深度 | 全面、多维度 | 聚焦于你的特定问题 |
| 适用场景 | 质量检查、发布前审阅 | 快速修改、摘要、具体内容查询 |
| 后续提问 | 可以询问澄清问题 | 持续对话 |
| 积分使用 | 较高（分析全文） | 视查询复杂度而定 |
何时使用 Document Review
Document Review 在以下场景中最有价值：对外分享前
在发送演示、提案或面向客户的文档前进行审阅，以在外发前发现结构性问题、不清晰之处或缺失的上下文。质量保障
定期对重要文档、团队知识库或文档进行审查，以长期维持高质量与一致性。内容改进
为博客、报告或长文提供可操作的改进建议。Craft Assistant 能识别需要扩展、简化或重构的地方。协作准备
在与团队成员共享前，确保文档清晰、完整且结构良好。这能减少来回修改并提升协作效率。学习与技能提升
通过审阅了解自己写作中的模式 – 反复出现的清晰性问题、结构倾向或需要持续改进的领域。你可以多次运行 Document Review。根据反馈修改后再审阅，查看问题是否解决。通过这种迭代方式，你可以学习哪些改法有效，并逐步完善内容。
如何理解反馈
Document Review 的反馈按清晰的类别组织。以下是如何解读与执行这些建议：结构反馈
反馈说明： 内容是否流畅、各部分是否平衡、信息架构是否合理。 示例反馈：- “引言相较于文档其余部分过长”
- “第 3 部分与第 2 部分之间缺乏清晰的过渡”
- “标题层级从 H2 跳到 H4”
清晰度反馈
反馈说明： 写作是否易于理解，句子是否过于复杂，读者在哪些地方可能会困惑。 示例反馈：- “该段大量使用被动语态，导致难以跟随”
- “第一部分使用的技术术语可能会让非专业读者困惑”
- “句子平均长度为 35 个词 – 建议拆分为更短的句子”
完整性反馈
反馈说明： 内容中存在的空白 – 缺失的背景、未回答的问题或需要更多细节的部分。 示例反馈：- “文档提到‘新流程’，但未对其进行定义”
- “步骤 2 与步骤 3 假设了引言中未覆盖的先验知识”
- “未提供结论或后续步骤”
质量反馈
反馈说明： 语气是否一致、格式问题，以及可以提升的润色点。 示例反馈：- “各部分语气从正式切换到随意”
- “项目符号格式不一致（有的以句号结尾，有的没有）”
- “该概念被重复解释 – 建议合并”
积分使用说明
Document Review 根据文档长度与复杂度消耗 AI 积分：| 文档长度 | 估算积分消耗（Fast） | 估算积分消耗（Max） |
|---|---|---|
| 短（< 500 字） | ~0.5 积分 | ~1 - 2 积分 |
| 中（500 - 2000 字） | ~1 - 2 积分 | ~3 - 5 积分 |
| 长（2000 - 5000 字） | ~2 - 4 积分 | ~6 - 10 积分 |
| 超长（5000+ 字） | ~5+ 积分 | ~12+ 积分 |
以上为典型文档的估算值。实际消耗取决于文档结构、格式复杂度以及你选择的模型。可在 Assistant 菜单中检查你的积分余额。
提升审阅效果的小技巧
1. 先把文档完善到合理草稿 在运行审阅前，确保文档已处于相对完整的草稿状态。Assistant 对成稿的反馈优于对草稿大纲的反馈。 2. 指明目标读者 在后续提示中告诉 Craft Assistant 文档的受众：- “目标读者为熟悉产品的技术团队”
- “受众为非技术利益相关者”
- “面向从未使用 Craft 的新用户”
- “我应该先修复的 3 个问题是什么？”
- “最关键的结构性问题是什么？”
- “只关注清晰度问题”
- “只检查语气一致性”
- “只检查完整性与缺失的上下文”
- “关注结构是否适合初学者”
- On-device： 不建议用于 Document Review（上下文有限）
- Core： 适用于短文的快速结构检查
- Fast： 适合大多数审阅（500 - 2000 字）的平衡选择
- Max： 适合较长、复杂文档或需要最详尽反馈的场景
示例：在发布博客前
Sarah 正在写一篇关于在 Craft 中使用 集合 的博客。在发布前，她希望确保内容清晰且完整。Assistant 分析文档并给出反馈：
- 结构： “引言很强，但第 2 部分长度是第 3、4 部分之和的两倍。建议将其拆分为两个部分。”
- 清晰度： “在定义之前使用了若干技术术语（relations、properties、views）。请在首次出现时定义或增加术语表。”
- 完整性： “文章解释了 什么是 集合，但没有说明何时应使用集合而不是文件夹或标签。”
- 质量： “语气一致。最后有一段多余内容重复了引言 – 建议删除。”