读取解析结果
解析结果用于回答“选中了什么、为什么带上这些能力、哪些条件还没满足”。Graph 不执行结果里的能力；由应用决定展示说明、补充事实、加载缺失来源或交给实际框架处理。
先运行第一个图谱，该页保留文件式与内联式的真实完整 JSON。这里解释如何消费，不改变 API 的返回结构。
按顺序读结果
capability.relations 是能力本身声明的关系，edges 是本次请求实际展开的边。指定 relations:[] 时，节点仍可保留声明的 requires，但不会展开依赖，不能靠节点的关系字段推断本次子图内容。
安全读取可选说明
以下片段的 result 来自 await graph.resolve(...)。将它放在已打开 Graph 的脚本中，不要当独立程序运行：
for (const { capability, origin, applicability } of result.nodes) {
const instructions = capability.usage?.instructions;
console.log(`${capability.id} (${origin}, ${applicability.status})`);
console.log(instructions ?? '该能力没有提供使用说明');
}
没有 usage 或 usage.instructions 是合法声明。可以展示 ID、名称和描述，提示作者补说明；不要直接访问 capability.usage.instructions，也不要虚构执行代码。条件为 unknown 时补事实，inapplicable 时重新选择；二者与依赖是否完整是不同维度，见Context和关系。
需要展示输入、输出、示例及契约时，可在同一循环中继续读取：
const usage = capability.usage;
console.log('输入：', usage?.input ?? '作者未提供输入说明');
console.log('输出：', usage?.output ?? '作者未提供输出说明');
for (const example of usage?.examples ?? []) console.log('示例：', example);
if (usage?.contract) {
console.log('已有契约：', usage.contract.format, usage.contract.uri);
}
这里的capability仍来自上面循环，不是未定义的全局变量。examples缺省按空数组处理；contract只展示引用，不代表Graph自动获取或执行契约。可校验的完整usage声明见编写Provider。
读取目录、详情与知识正文
最小示例没有知识文件。需要列目录、拿说明、按声明 ID 读取长文时，运行独立的 details.mjs。
前提：在你的 ESM 项目安装 @devcodex/capability-graph，完整复制包内 examples/（复制方法）。保留下面三份文件的相对位置，命令在项目根目录执行：
examples/minimal/
├── details.mjs
├── details.provider.json
└── knowledge/guide.md
details.provider.json 在最小两节点声明上增加 documents，引用同目录下的 knowledge/guide.md；该文件随示例分发。这些是说明性示例，不会注册真实 HTTP 路由。
details.mjs
import { CapabilityGraph, GraphError } from '@devcodex/capability-graph';
import { fileURLToPath } from 'node:url';
let graph;
try {
graph = await CapabilityGraph.open({
providers: [{ file: fileURLToPath(new URL('./details.provider.json', import.meta.url)) }]
});
const catalog = await graph.listCatalog();
const details = await graph.getCapabilities({ ids: ['acme::route'] });
const document = await graph.readDocument({ capabilityId: 'acme::route', documentId: 'guide' });
console.log(JSON.stringify({ catalog, details, document }, null, 2));
} catch (error) {
if (!(error instanceof GraphError)) throw error;
console.error(JSON.stringify({ code: error.code, phase: error.phase, nextAction: error.nextAction }));
process.exitCode = 1;
} finally {
await graph?.close();
}
node examples/minimal/details.mjs
stdout 是一个完整对象 {catalog, details, document}，三个值分别为 API 原结果，没有摘要投影。
本例应返回两项目录、一项详情及 guide 正文。file 来源自动以声明文件所在目录为文档根；无需为文件式另设 documentRoot。缺文件在真正读取时失败，URL 引用不会自动联网；完整根目录、安全边界、编码与哈希语义见关联知识文件。
继续处理模型结果
match() 的 graph 也是同一种 ResolveResult；外层还有模型选择状态 status 和 selection。先区分模型业务状态、节点适用性和关系完整度，不能把 matched 直接等同可以执行。见匹配与结果处理。