面向 AEO 的知识库：让用户能照着说明完成任务
读者可能没有相应权限，套餐里可能不含这项功能，界面上的菜单名也可能已经改了。这时只写一句“打开设置，启用功能”是不够的。帮助文档要先交代这些条件，让用户判断这套步骤适不适用于自己的账号。
为 AEO 整理知识库，第一件事是确认用户读得懂说明、照着做得成。内容要准确，也要完整：文档就算被 AI 引用了，漏掉的那一步照样会把用户卡住。
先写条件，再写操作
步骤之前先写明：适用于谁，对应哪个产品版本或部署方式，需要提前准备什么。缺了它整个流程就走不通的条件，不能留到结尾才说。
GitLab 的双重身份验证文档把使用条件、操作步骤和恢复访问的相关链接都列了出来。检查自己的指南时，先问两件事：用户知道动手前要准备什么吗？失去访问权限以后，他找得到恢复办法吗？
把一项操作写完整
下表拿“导出订单”做教学示例，列出一份完整的操作指南该有哪些部分。它描述的不是真实产品界面。写自己的指南时，权限、格式和菜单名称都要逐项核实。
| 部分 | 发布前确认 |
|---|---|
| 任务 | 用户要导出哪些订单 |
| 条件 | 权限、功能可用性、日期范围限制 |
| 步骤 | 当前界面中的真实路径 |
| 结果 | 文件在哪里出现，包含什么 |
| 异常 | 文件或记录缺失时先检查什么 |
| 求助 | 无法解决时向哪里求助 |
找一个合适的测试账号把流程走一遍，权限不足的情况也要试。文档要让用户看得出自己卡在哪里，别把人引向一个他根本看不到的按钮。公开示例里不要出现客户数据、访问密钥或内部操作流程。
按任务拆分，按需要链接
导出操作和文件字段说明，用户如果会分开来查，就写成两页，在需要详细解释的地方加链接。同一流程的步骤要能连着读下来，不要为了多凑几个短答案页面把它拆散。
旧版本的说明要标明适用范围。流程换掉以后，先确认还有没有人用得着旧说明，再决定删除还是重定向。光写一个产品名称，读者看不出操作对应哪个版本、哪种部署方式。
不只安排作者，也安排维护人
每个页面要有一位负责人，功能一有变化他就能知道。把文档检查排进产品发布流程：菜单、限制或操作结果变了，对应的说明和译文都要复查。页面上的更新日期，只有在内容确实检查过之后才改。
结构化标记和给爬虫看的文件，都代替不了维护。Google 不要求特殊 AI 文件来支持其 AI 功能。至于这类文件本身的用途，见 llms.txt 指南。
知识库很大的话，先挑一项常用操作，连同相关页面一起检查。AEO 实施可以包含约定的结构调整、文稿修订和技术修改；产品功能和限制，仍要由您的团队确认。
发布日期： · 由 geo-rank.ai 编辑团队审核 · 检查方法