Google 开源文档主题 Docsy 加入 Linux Foundation，并扩展 AI 智能体支持

随着 AI 智能体成为文档读者，Google 的 Docsy 加入 Linux 基金会。

布拉格——在我开始学习编程的年代，如果你看不懂代码或操作系统里的某些东西，别人会叫你去读那本该死的（啊，对，好）手册（RTFM）。当然，那时候我们确实有手册和文档。自那以后，好的文档就逐渐被弃置一旁了。正如 Jon Corbet 所说——他是 LWN的编辑，这是最深入的 Linux 刊物，也是 Linux 内核文档的监管者——“没有任何一个人的工作是专门为内核撰写文档。”2026 年在Linux Plumbers，Corbet 表示，今天依然如此。

然而如今，想要优质、最新文档的不只是心怀不满的系统管理员和程序员；AI 智能体同样需要可靠的文档。从来没有人愿意花钱让人类获得好的参考资料，但有了 AI 智能体，情况就不同了。没有好的信息，AI 就容易陷入垃圾进、垃圾出（GIGO）。这正是Docsy的用武之地，它是由 Google 技术文档工程师创建的开源文档主题。

在Open Source Summit Europe上，Google 宣布 Docsy 已将其大本营迁至 Linux 基金会。它还——惊喜！——扩展了对 AI 智能体的支持。

此举让 Docsy 与已经使用它的生态系统联系得更加紧密。Erin McKean 是 Google 的高级开发者关系工程师，也是该项目指导委员会成员，她表示，从沙盒阶段的项目到 Kubernetes，Linux 基金会的项目都已依赖 Docsy。

McKean 为该项目辩护的出发点是一个更常见的开源问题：文档需要投入工作，而维护者需要帮助来产出文档。她说，更好的文档可以减轻回答那些用户本可自行解决的问题的负担。

Docsy 的开发者正在调整文档发布方式，以服务两类受众：阅读网站的人和检索指令以回答问题或编写代码的 AI 工具。正如 McKean 在主题演讲中所说：“你可以把 Markdown 直接放在文档旁边，供偏好这种格式的工具使用。”

Docsy 在 0.15.0 版本中引入了第一阶段智能体支持。这些实验性的、需主动启用的功能会生成一个 llms.txt 文档索引、主页、章节和各个页面的 Markdown 替代版本，以及一个“查看 Markdown”链接。

为什么这很重要？因为人和 AI 阅读文档的方式不同。文档网站的 HTML 为你我提供导航、布局和呈现。而Markdown 替代版本则暴露底层的说明、标题、链接和代码示例，采用更简单的、面向文本的格式，适合 AI。

正如 Anthropic 所解释的，现代 AI 需要这样的文档来实现更好的上下文工程。这是一种策略，用于“在 LLM 推理期间策划和维护最优的 token（信息）集合，包括所有可能落在提示词之外的其他信息”。

在实践中，使用 Docsy 文档时，智能体可以查阅索引，选择与其任务相关的页面，并获取它们的 Markdown 版本。这些文档随后成为语言模型的上下文。智能体可以利用这些信息来构建答案或选择下一步行动。Anthropic 将这种方法描述为即时检索，即智能体动态加载信息，而不是将所有内容都放入其上下文中。

Docsy 的发布文档将这些功能描述为帮助智能体“发现并使用你的网站内容”，而不是承诺某个特定的模型结果。

对于 AI 编程助手来说，这可能意味着在编写请求之前检索 API 的身份验证说明和端点文档。这是一种在任务期间查阅已发布文档的方式，而不是重新训练模型的机制。

Docsy 本身相当简单。它是Hugo 静态网站生成器的一个主题。它为技术文档网站提供导航、站点结构和其他组件。其代码在 Apache License 2.0 下提供。

对 McKean 来说，根本目标仍然是帮助人们使用软件，即使 AI 助手站在读者和文档之间。“但当我们制作技术文档时，信息如何对人类有用其实并不重要，只要它有用就行，”她说。“如果有人告诉我，有证据表明，你知道，歌剧是触达项目用户的最佳方式，那我就会去写歌剧。”