> 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.

# 运行时模型

Core 与 HTTP 参考实现可用

Static Capability 是 Provider 作者声明的稳定模型；Runtime Instance 是某个项目、工作区和环境中实际观察到的实例。二者是不同实体。

Runtime Adapter 显式采集：

- Provider、项目和环境；
- 实例身份与 `instanceOf` 静态能力；
- 观察时间、Runtime Revision 与来源静态修订；
- 当前可用、空、过期、部分、不可用等状态。

Runtime 观察不会写回静态图，也不形成通用 Runtime Graph。静态修订变化后，Adapter 可以确认兼容、要求刷新或标记未知；Core 不计算语义等价。

`CG_RUNTIME_DISABLED` 表示没有配置 Adapter，不等于当前环境没有实例。真实参考见 [Seed 端到端示例](https://devcodex-labs.github.io/capability-graph/examples/seed-provider.md#%E7%9C%9F%E5%AE%9E-runtime)。

## 同一个能力，不同的项目实例

在 Acme HTTP 扩展示例中，`route.http` 一直描述 HTTP 路由能力。开发项目 `demo-app` 的 `POST /users` 则是实例，其 `instanceOf` 为 `{ providerId: 'acme.http', capabilityId: 'route.http' }`。测试环境可能没有这条路由；查询必须同时指定项目和环境，不能从开发环境存在就推断生产环境也存在。

“给已有接口加校验”的任务先确认这个实例，再读取验证能力知识。读取实例不等于执行它，Core 不会向 `POST /users` 发起业务请求或修改 handler。