概览

Docsbook 如何证明其所声称的内容

文档平台常常用形容词来销售——先进、智能、优化。形容词无法证伪,因此不包含任何信息。这些文档遵循的规则则相反:能力页面必须让持怀疑态度的工程师能够检验我们。如果一句话经不起“谁说的?”这个问题,它就不会发布。

本页面本身就是这条规则,因此你可以据此要求我们做到。

每个能力页面包含的内容#

SEOGEOAEO适合智能体的内容AI 聊天分析翻译下的每个页面都包含四个区块,顺序如下。

区块 必须包含的内容 检查方式
你将获得什么 以你的术语描述结果——页面、面板或 API 中会出现什么 打开你自己的网站并查看
如何构建 只有阅读过实现的人才能写出的机制细节:阈值、优先顺序、回退方案、失败时会发生什么 与渲染后的 HTML、API 响应或导出的数据进行比较
证据 将每条规则写成规则 → 机器或读者为何会以这种方式行动 → 指向主要来源的链接 打开链接
限制 该功能不会做什么、不会测量什么、哪些内容取决于我们无法控制的模型版本 判断我们是否遗漏了任何内容

没有限制区块的页面就是宣传册,而宣传册只会让人更不相信,而不是更相信。

这里什么算作来源#

我们会对来源进行分级,这种分级会体现在声明的措辞中。

  1. 规范和供应商文档 — Google Search Central、schema.org、W3C、IETF、模型上下文协议规范、llms.txt 规范,以及相关模型提供商发布的文档。基于其中任何一种来源的声明都会直接陈述。
  2. 经过同行评审或预印本研究,并明确说明方法和样本量。 会附带方法进行陈述:“在 10,000 个查询上进行测量”能让你了解应在多大程度上信任它。
  3. 公开发布方法的独立研究。 始终在句子中注明来源 — “X 测量得出”,而不是“众所周知”。
  4. 供应商报告的结果,包括我们自己的结果。 会标注为供应商报告的结果。我们自己的内部测量结果会标注为我们的结果。

低于这一标准的内容都不是证据,也不会出现。

我们明确不做出的承诺#

这些是文档供应商通常应当做出的承诺,也是我们不做出这些承诺的原因。

  • 不承诺引用率提升。 没有人能够诚实地保证,启用某项功能后,Perplexity 或 ChatGPT 引用你的频率会提高 N%。在受控工作中测量到的结果,比营销版本的说法更为有限,而 GEO 会明确说明测量了什么以及由谁测量。
  • 不承诺 AI 答案准确率百分比。 使用我们自己的语料库和评分器生成的数字,并不能证明你的语料库具有同样的表现。AI chat 描述了该流程如何确保基于可靠内容,以及它测量的内容,而不会凭空编造分数。
  • 不保证排名。 搜索排名不是合同,Google 在其自身文档中也明确说明了这一点。SEO 区分了 Google 已记录的内容与推断得出的内容。
  • 不声称拥有尚未取得的合规状态。 MCP security 说明了当前情况,并明确指出目前尚未提供的内容。

“存疑”区块#

当这些文档中的一项声明无法得到验证——机制发生了变化、事实证明来源并未说明引用它所要支持的内容,或者没有人发布过测量结果——我们不会删除这句话,也不会将其弱化为含糊其辞的表述。它会成为一个明确的区块:

存疑。 该声明。 可验证的内容:其中可以验证的部分。 无法验证的内容:其中无法验证的部分,以及原因。 在测量之前,将其视为假设。

该区块是我们流程的承诺:我们无法支持的声明会清楚地呈现给你,而不是被悄悄删除。

这些主张为何成立#

文档会在不知不觉中偏离产品,而这正是 Docsbook 存在要解决的问题——因此,同样的机制也应用于这些文档。

  • 每项面向用户的变更都会在更新日志中留下一条记录,说明这项变更旨在带来什么,而不只是说明改动了什么。
  • 更新日志会被映射到按成果划分的页面中,因此你可以阅读某项成果的历史记录——AI 引用、支持负载、自然流量——而不是一份扁平的列表。
  • 页面会显示从修改页面的提交中获取的最后修改日期,因此过时的页面无法假装自己是最新的。请参阅GEO

发现错误了吗?#

如果这些页面上的某项说明与产品实际行为不符,那就是一个缺陷;与其让它一直存在,我们更希望由您告诉我们。

  • 概览 — Docsbook 从头到尾的功能。
  • 价格 — 计量的内容,以及项目余额的支付项目。
  • 常见问题 — 费用、取消、同步、隐私和数据所有权。

Updated

此页面对您有帮助吗?