面向智能体的内容
一个只为人类构建的文档网站，对其他一切而言只是一堵 HTML 墙。智能体访问这样的网站时，必须猜测哪个页面重要，从散文中抓取事实，而且无法对读到的内容采取行动。Docsbook 通过机器可直接消费的四种界面发布相同的文档——因此智能体可以找到方法、读取文档语料库、浏览其结构并对其进行更改。
这四者并不是替代方案。它们依次回答智能体提出的四个不同问题：这项工作如何完成、我可以调用什么、这存在于何处以及究竟有什么。
每个界面带来的价值#
| 界面 | 代理的疑问 | 它获得的内容 | 它的成本 |
|---|---|---|---|
| SKILL.md 目录 | “如何正确完成这项工作？” | 从 GitHub 获取的工作流，其中包含防护措施、有序步骤和验收标准 | 无需付费——目录是公开的，且 find_skill 永远不会计量 |
| MCP 服务器 | “我可以调用什么，以及针对哪个项目？” | 一个 docsbook_expert 代理背后的 140 个工具、连接时的 instructions 块，以及指出下一步操作的结构化错误 |
根据项目余额按调用次数计费；发现调用免费 |
| 文档图 | “这个概念位于哪里，以及哪些内容链接到它？” | 作为独立节点命名空间的页面和标题、四种边、断开的链接和锚点冲突 | 所有方案均免费——它由你自己的 Markdown 构建 |
| llms.txt | “这个网站上到底有什么？” | 每个已发布页面的扁平、可获取索引，无需身份验证 | 免费，无需 Docsbook 账户即可阅读 |
各界面如何相互交接#
这些交接是设计使然，而非巧合。
- 技能指出需求，MCP 服务器满足需求。 Docsbook 的技能会说明某个步骤需要哪些证据（“先读取数字，再读取页面”），并让模型选择工具。这是有意为之：将工具名称硬编码的技能一旦工具被重命名就会失效，而且这种失败是无声的——代理会选择某个相近的工具，并在外观相同的报告背后即兴采用另一种方法。
- MCP 服务器告诉你的代理如何运行技能。 过去，四个工具用于在 Docsbook 的机器上执行操作，并返回运行 ID（
run_docs_*）；它们已于 12.09.2026 移除。docsbook_expert会改为返回方法、步骤以及每一步所需的工具，而你自己的代理——已经持有该代码库——负责执行这些内容。 - 图谱是内容工具读取的对象。
search_docs、read_doc和get_doc_outline不会 grep 文件；它们会查询根据你的代码库中的 Markdown 构建并缓存在服务器端的RichDocGraph。 - 对于两者都没有的代理，llms.txt 是备用方案。 没有令牌、没有代码检出、没有 MCP 客户端——只需通过已发布的网站发起 HTTP GET 请求。
为什么这是正确的方式（证据）#
| 规则 | 为什么它适用于使用它的机器 | 来源 |
|---|---|---|
| 将方法发布为代理按需加载的文件，而不是系统提示中的散文 | Anthropic 的 Agent Skills 设计会分阶段加载技能——“在触发技能之前，只有其名称和描述会占用上下文” | Agent Skills 概览 |
| 保持工具接口具有类型并使用明确的名称，而不是提供一个单一的“执行文档工作”端点 | MCP 工具“被设计为由模型控制”，模型会从 tools/list 中发现并调用它们 |
MCP 规范 2026-07-28，工具 |
| 不要一次性将所有内容加载到上下文窗口中 | “因此，必须将上下文视为一种边际收益递减的有限资源” | 有效的上下文工程 |
| 为大型目录提供模型可以搜索的结构，而不是扁平列表 | Anthropic 的测量表明，“当可用工具超过 30–50 个后，Claude 选择正确工具的能力会下降” | 工具搜索工具 |
| 为检索提供图，而不是页面集合 | 长上下文检索在中间位置会退化：“当模型必须访问长上下文中间的相关信息时，性能会显著下降”（Liu 等，TACL 2024） | 迷失在中间 |
其中两点值得给出经过测量的形式，而不是一句口号。对大型工具注册表的检索已经经过独立基准测试：RAG-MCP（arXiv 预印本 2505.03275，Gan 和 Sun，2025 年 5 月）报告称，与列出所有工具相比，检索工具时的工具选择准确率为“43.13% 对 13.62% 的基线”，同时将提示词令牌数削减“超过 50%”。一篇对“从 20 个到 3,251 个工具”不等的注册表进行基准测试的 2026 年预印本报告称，在固定的五工具候选列表上，采用自适应短名单的选择准确率为 93.1%，而固定短名单为 87.1%（arXiv 2605.24660）。两者都是未经同行评审的预印本；应将这一趋势视为得到充分支持，而将具体数字视为某个团队的测量结果。
限制与未决问题#
- 四个入口的费用并不相同。 技能目录、图谱和 llms.txt 在所有套餐中均免费。MCP 工具调用按次计费，从项目余额中扣除；而面向读者的 AI 聊天会消耗 Docsbook 的模型预算，从 Pro 套餐起提供。当前金额请参见定价页面；本文档特意不引用任何金额，因为复制到页面中的价格会在不知不觉中过时。
- “可供代理使用”描述的是结构，而不是排名。 Docsbook 可以向你展示某个页面是否可获取、其章节是否能够独立存在，以及其锚点是否能够解析。但之后任何特定助手是否会引用该页面，并不是本产品为你衡量的指标，也没有公开来源能够确立一个普遍适用的比例。关于可衡量的内容，请参见GEO。
- 工具数量会变化。 140 是此构建版本注册的工具名称数量。权威数量取决于
tools/list为你的令牌返回的结果；管理面板的 MCP 部分会实时读取该数量，而不是使用某个已记录的副本。 - MCP 规范在我们开发期间发生了变化。 修订版
2026-07-28使 MCP 变为无状态，并完全移除了initialize握手——“不存在协商握手”（版本控制与兼容性）。Docsbook 的服务器通过无状态 HTTP 传输提供服务，但仍使用其 SDK 支持的基于初始化的修订版——最新版本为2025-11-25——并将其引导文本置于initialize中，这是一个早于2026-07-28的位置。仅支持2026-07-28的客户端将无法连接。有关其余差异列表，请参见MCP 服务器安全性。 - 这里没有任何入口可以替代正确的文档。 即使代理能够完美地浏览文档库，它仍然只能报告文档库所写的内容。