#安装

以下示例对应仓库中的 1.0.1 候选合同。正式发布前，Registry 的无版本安装仍可能取得 1.0.0；先用 npm view @devcodex/capability-graph version 核对版本。1.0.1 发布并通过公开安装验收后，下面的无版本安装才对应本页后续接口。

把包装在负责加载 Provider、向 Agent 提供 API/MCP 的 Node.js 接入项目中。Provider 定义目录只是数据目录，不必单独安装一份包；一个接入项目可以加载多个 Provider。

#前置条件

• Node.js ^20.19.0 || >=22.12.0，与包内 engines.node 完全一致。
• 使用 ESM。主包只提供根入口，不提供 CommonJS require() 入口或 ./mcp 子路径。
• 后续将创建 Provider 定义文件；安装命令本身不会生成它们。

#从空目录开始

mkdir capability-graph-demo
cd capability-graph-demo
npm init -y
npm pkg set type=module
npm install @devcodex/capability-graph

已有项目只需安装依赖，并确认模块配置。npm pkg set type=module 会在 package.json 写入 "type": "module"，让 .js 使用 ESM；已有 CommonJS 项目可以把接入脚本命名为 .mjs，无需改变整个项目的模块规则。

#验证包入口

在项目根创建 check.mjs：

import { CapabilityGraph } from '@devcodex/capability-graph';

console.log(typeof CapabilityGraph.open); // function

node check.mjs

预期输出是 function。这只证明包入口可加载；下一页创建 Provider 并成功调用 open() 后，才证明定义和加载配置有效。使用 .mjs 不需要 TypeScript 编译器。

#安装内容

主包包含 Core、TypeScript 类型、文件 Authority、本地 Document Reader，以及数据库 Authority、Runtime、两类 Retriever 和远程 Reader 的扩展合同。1.0.1 固定依赖 bcp-47 与 language-subtag-registry，用于独立于宿主 ICU 的语言标签校验。

它不安装 HTTP/MCP Server、数据库驱动、向量数据库、RAG 后端或 VextJS Adapter。MCP SDK 仅用于仓库的独立私有示例；要提供 MCP，由接入项目安装 SDK 并实现协议层。

#常见问题

安装后可用 npm ls @devcodex/capability-graph 查看项目实际使用的版本；1.0.0 不具备后文的 Selection 与多文档 Specification 接口。

#下一步

在创建第一个 Provider中建立 providers/acme-http/，完成第一次目录、关系和本地知识查询。