面向智能体的内容
一个只为人类构建的文档网站，对其他一切而言只是一堵 HTML 墙。智能体访问这样的网站时，必须猜测哪个页面重要，从散文中抓取事实，而且无法对所读内容采取行动。Docsbook 通过机器可直接使用的四种界面发布同一份文档——因此智能体可以找到方法、读取语料库、浏览其结构，并对其进行更改。
这四种界面并非互相替代。它们分别回答智能体依次提出的四个不同问题：这项工作如何完成、我可以调用什么、这存在于何处，以及究竟有哪些内容。
每个界面带来什么#
| 界面 | 代理的问题 | 它获得的内容 | 它付出的代价 |
|---|---|---|---|
| SKILL.md 目录 | "如何正确完成这项工作？" | 一个包含防护措施、有序步骤和验收标准的工作流，从 GitHub 获取 | 无需付费 — 目录是公开的，且 find_skill 从不计量 |
| MCP 服务器 | "我可以调用什么，以及针对哪个项目？" | 310 个工具、连接时的 instructions 块，以及指出下一步操作的结构化错误 |
按调用次数从项目余额中计费；发现调用免费 |
| 文档图 | "这个概念位于哪里，以及哪些内容链接到它？" | 作为独立节点命名空间的页面和标题、四种边、失效链接和锚点冲突 | 所有方案均免费 — 它由你自己的 Markdown 构建 |
| llms.txt | "这个网站上到底有什么？" | 每个已发布页面的扁平、可获取索引，无需身份验证 | 免费，且无需 Docsbook 账户即可阅读 |
各个界面如何相互交接#
这些交接是设计使然，而非偶然。
- 技能提出需求，MCP 服务器作出响应。 Docsbook 的技能会说明某一步需要哪些证据（“先读取数字，再读取页面”），并让模型选择工具。这是有意为之：硬编码工具名称的技能会在工具重命名的瞬间失效，而这种失败是无声的——代理会选择某个相近的工具，并在外观相同的报告背后临时采用不同的方法。
- MCP 服务器可以代你运行技能。
run_docs_analyze、run_docs_create、run_docs_manage和run_docs_automate会在 Docsbook 的机器上，针对你的工作区执行四个编排器技能中的一个，并返回运行 ID，而不是结果。 - 图谱是内容工具读取的对象。
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 工具调用按次计费，从项目余额中扣除；另外两项会消耗 Docsbook 模型预算的功能——代理运行（
run_docs_*、agent_*）和面向读者的 AI 聊天——从 Pro 套餐起提供。当前金额请参阅定价页面；本文档特意不引用任何金额，因为复制到页面中的价格会在不知不觉中变得过时。 - “为代理就绪”是形态声明，而不是排名声明。Docsbook 可以向你展示某个页面是否可获取、其各个章节是否能够独立存在，以及其锚点是否能正确解析。但任何特定助手是否会引用该页面，并不是本产品为你衡量的内容，也没有公开来源能够确定一个通用比例。关于可衡量的内容，请参阅 GEO。
- 工具数量会变动。310 是此构建版本注册的工具名称数量。权威数量取决于
tools/list为你的令牌返回的结果；管理面板的 MCP 部分会实时读取该结果，而不是读取某个记录下来的副本。 - MCP 规范在我们使用期间发生了变化。修订版
2026-07-28使 MCP 变为无状态，并完全移除了initialize握手——“不存在协商握手”（版本与兼容性）。Docsbook 的服务器通过无状态 HTTP 传输提供服务，但仍使用其 SDK 支持的、基于初始化的修订版——最新版本为2025-11-25——并将其说明文本放在initialize中，这是一个早于2026-07-28的位置。仅支持2026-07-28的客户端将无法连接。有关其余差异，请参阅 MCP 服务器安全性。 - 这里的任何一种表面都不能替代正确的文档。即使代理能够完美地浏览语料库，它报告的内容仍然取决于语料库中的信息。