> For AI agents: the complete documentation index is available at https://devcodex-labs.github.io/capability-graph/llms.txt, the full documentation bundle is available at https://devcodex-labs.github.io/capability-graph/llms-full.txt.

# 查询接口

可用

## CatalogQuery

`requestProviderScope`、`requiredStaticRevision`、`capabilityIdPrefix`、`parent`、`cursor` 和 `limit`。过滤用于发现，不提供授权。

`CatalogPage` 返回 `items`、`meta` 和可选 `nextCursor`。每项包含完整二元 `id`、`qualifiedId`、用途、使用时机、区别和来源修订。

## CapabilityDetailQuery

支持 `requiredStaticRevision`、`neighborLimitPerKind`、`knowledgeLimit` 和每能力知识续页游标。详情只返回有界关系摘要和 KnowledgeRef，不递归读取邻居或正文。

## NeighborQuery

可指定关系种类、每组游标、页大小和静态修订。结果为八组固定键：`parents/children`、`specializes/specializedBy`、`related/relatedBy`、`requires/requiredBy`。每组独立报告完整性和续页位置。只有 `requires` 参与 Selection 闭包；`requiredBy` 是由它派生的反向发现关系。

## Provider 查询

`listProviders()` 返回页级 `meta`，Specification 只给 `documentCount`。`getProvider()` 增加有界 `specificationDocuments` 首屏与 `meta`；`listSpecificationDocuments()` 按 `knowledgeId` 续取。公开摘要不会携带内部完整规范文档列表。

## Selection

`ResolveSelectionQuery` 提供非空 `selected`、可选的范围收窄和逐 Provider 指定修订。原始选择最多 32 项，即使重复也计入；闭包最多 128 个能力和 256 条真实依赖边。`SelectionResult` 返回首次出现顺序的 `requested`、排序后的 `resolved/added`、全部 `requiresEdges`，以及每个节点的 `SelectionReason.requested/requiredBy`。任何节点、边、Scope 或修订错误都会使整次调用失败，不交付半个闭包。多 Provider 返回 `servedFromByProvider`、`staticRevisionByProvider` 与组合修订；`servedFrom` 可能是 `mixed`。

## 文档发现

`DocumentPageQuery` 以修订、页大小和游标绑定一次分页。`KnowledgeMembersQuery` 需要能力身份和 Collection ID，`KnowledgeMembersPage` 返回成员的完整路由元数据；`SpecificationDocumentsPage` 只返回该 Provider 的规范文档元数据。默认 20 项、最大 100 项，须检查 `completeness` 和 `nextCursor`。