# Capability Graph

> 面向 Provider 的能力建模、发现与知识导航基础设施

## v1

- [快速开始](https://devcodex-labs.github.io/capability-graph/getting-started/index.md): 从安装到第一次能力查询，完成 Capability Graph 的最小真实接入。
- [安装](https://devcodex-labs.github.io/capability-graph/getting-started/installation.md): 安装 Capability Graph，并确认 Node.js、ESM 和包入口要求。
- [创建第一个 Provider](https://devcodex-labs.github.io/capability-graph/getting-started/first-provider.md): 创建 provider.json 和第一组能力定义，并用真实文件权威打开它们。
- [Provider 自有 API](https://devcodex-labs.github.io/capability-graph/getting-started/provider-owned-api.md): 在 Provider 自己的 API 中暴露渐进式能力发现，而不把 Core 变成统一服务。
- [核心概念](https://devcodex-labs.github.io/capability-graph/concepts/index.md): 理解 Capability Graph 的产品边界、身份、关系、知识、Runtime、范围与修订语义。
- [产品边界](https://devcodex-labs.github.io/capability-graph/concepts/product-boundary.md): 区分 Capability Graph Core、Provider 接入层、Agent 与第三方能力执行系统的职责。
- [Provider 与能力](https://devcodex-labs.github.io/capability-graph/concepts/provider-and-specification.md): 理解 Provider 身份、定义权威、Specification 边界和静态能力建模原则。
- [身份与关系](https://devcodex-labs.github.io/capability-graph/concepts/capability-identity.md): 使用二元能力身份和显式关系，避免跨来源歧义、错误复用与隐式图边。
- [知识模型](https://devcodex-labs.github.io/capability-graph/concepts/knowledge.md): 区分本地 Document、Collection、Retriever 与 Reader 的职责和可追溯证据。
- [运行时模型](https://devcodex-labs.github.io/capability-graph/concepts/runtime.md): 将静态能力与项目环境中的运行实例、观察修订和兼容状态分离。
- [作用域、修订与完整性](https://devcodex-labs.github.io/capability-graph/concepts/provider-scope.md): 理解 Effective Provider Scope、静态与运行时修订，以及完整、截断和部分结果。
- [使用指南](https://devcodex-labs.github.io/capability-graph/guides/index.md): 按真实任务建模 Provider、设计关系、接入知识和 Runtime，并处理生命周期与部分结果。
- [建模 Provider](https://devcodex-labs.github.io/capability-graph/guides/model-a-provider.md): 从职责边界、身份、能力目录、关系、知识和验证六步完成 Provider 建模。
- [设计关系](https://devcodex-labs.github.io/capability-graph/guides/design-relations.md): 选择正确关系类型，验证端点、方向和独立环约束。
- [添加本地知识](https://devcodex-labs.github.io/capability-graph/guides/add-local-knowledge.md): 为已选能力关联并安全读取 Provider 根目录内的本地 Document。
- [使用运行时](https://devcodex-labs.github.io/capability-graph/guides/use-runtime.md): 配置 RuntimeAdapter，按 Provider、项目和环境查询真实运行实例及观察状态。
- [使用多个 Provider](https://devcodex-labs.github.io/capability-graph/guides/multiple-providers.md): 在明确 Effective Provider Scope 内联合发现多个 Provider，同时保持图和修订隔离。
- [管理生命周期与重新加载](https://devcodex-labs.github.io/capability-graph/guides/lifecycle-and-reload.md): 正确管理 open、reload、current/previous 视图和 close 的资源所有权。
- [处理错误与部分结果](https://devcodex-labs.github.io/capability-graph/guides/errors-and-partial-results.md): 按错误阶段、NextAction、ResultMeta 和逐项结果恢复，而不是把失败统一成空数据。
- [集成](https://devcodex-labs.github.io/capability-graph/integrations/index.md): 将 Capability Graph 接入 Node.js、Provider-owned MCP 和可插拔 Adapter。
- [Node.js API 接入](https://devcodex-labs.github.io/capability-graph/integrations/node-api.md): 在 Node.js ESM 应用中打开、查询、刷新并关闭 Capability Graph。
- [Provider 自有 MCP](https://devcodex-labs.github.io/capability-graph/integrations/provider-owned-mcp.md): 用少量 Provider-owned MCP 工具实现主能力、意图收窄和子能力的渐进发现。
- [RuntimeAdapter 接入](https://devcodex-labs.github.io/capability-graph/integrations/runtime-adapter.md): 实现 Provider 专属 Runtime 数据源，并保持项目、环境、修订和资源所有权清晰。
- [检索 Adapter 接入](https://devcodex-labs.github.io/capability-graph/integrations/capability-retriever.md): 接入能力召回与知识检索后端，并由 Core 校验身份、范围、修订、证据和排名。
- [KnowledgeReader 接入](https://devcodex-labs.github.io/capability-graph/integrations/knowledge-reader.md): 为非本地 KnowledgeRef 实现受预算约束的精确读取，并避免泄露私有来源根。
- [DatabaseAuthorityAdapter 接入](https://devcodex-labs.github.io/capability-graph/integrations/database-authority-adapter.md): 提供稳定只读数据库快照、严格扫描顺序、关系反查和可验证资源生命周期。
- [示例](https://devcodex-labs.github.io/capability-graph/examples/index.md): 查看 Capability Graph 的可运行 Seed 组合和明确标记的概念性集成。
- [Seed 端到端示例](https://devcodex-labs.github.io/capability-graph/examples/seed-provider.md): 查看共享 Seed Provider 如何串联 Provider-owned API、MCP 和真实 Runtime 采集。
- [多 Provider 示例](https://devcodex-labs.github.io/capability-graph/examples/multi-provider.md): 查看联合目录如何保留 Provider 身份、隔离修订和限制跨 Provider 图边。
- [VextJS 集成](https://devcodex-labs.github.io/capability-graph/examples/vextjs-integration.md): 说明 VextJS 项目接入 Capability Graph 的概念结构，不宣称已有可运行适配器。
- [API 参考](https://devcodex-labs.github.io/capability-graph/reference/index.md): 查阅 Capability Graph 的公共 API、定义字段、错误、Adapter 与结果元数据合同。
- [Core 与生命周期](https://devcodex-labs.github.io/capability-graph/reference/capability-graph.md): CapabilityGraph、BoundProviderGraph、打开配置、Authority 和重新加载合同参考。
- [查询接口](https://devcodex-labs.github.io/capability-graph/reference/queries-and-results.md): Catalog、Detail、Neighbor、Selection 与文档发现的输入、分页和修订参考。
- [定义与身份](https://devcodex-labs.github.io/capability-graph/reference/provider-definition.md): Provider、Capability 定义字段、验证矩阵和二元身份合同参考。
- [知识接口](https://devcodex-labs.github.io/capability-graph/reference/knowledge.md): 文档路由、显式读取、Specification 与检索目标合同参考。
- [运行时接口](https://devcodex-labs.github.io/capability-graph/reference/runtime.md): QueryRuntimeQuery、RuntimeInstance、RuntimeObservation 和 QueryRuntimePage 参考。
- [Adapter 接口](https://devcodex-labs.github.io/capability-graph/reference/runtime-adapter.md): Runtime、能力检索、知识检索、Reader 与数据库 Authority Adapter 的统一合同参考。
- [结果与控制元数据](https://devcodex-labs.github.io/capability-graph/reference/result-meta.md): 解释 ResultMeta、批量槽位、作用域、修订、分页、预算与完整性合同。
- [错误与恢复动作](https://devcodex-labs.github.io/capability-graph/reference/errors.md): Capability Graph 公开 ErrorCode、NextAction、触发条件和调用方恢复语义参考。
- [故障排查](https://devcodex-labs.github.io/capability-graph/troubleshooting/index.md): 按症状定位配置、范围、修订、Runtime、知识、Adapter、预算和超时问题。
- [配置与作用域](https://devcodex-labs.github.io/capability-graph/troubleshooting/open-and-configuration.md): 诊断 open、Authority、定义校验、Provider scope、身份与选择问题。
- [修订、预算与分页](https://devcodex-labs.github.io/capability-graph/troubleshooting/revision-and-reload.md): 诊断修订不匹配、刷新失败、预算不足、部分结果和游标问题。
- [运行时与超时](https://devcodex-labs.github.io/capability-graph/troubleshooting/runtime-states.md): 区分 Runtime 未启用、不可用、观察为空、过期、部分、结果不匹配和等待超时。
- [知识与 Adapter](https://devcodex-labs.github.io/capability-graph/troubleshooting/knowledge-read.md): 诊断知识关联、Reader、路径、Retriever、索引证据和 Adapter 合同问题。