#版本与兼容

本手册对应 Capability Graph v2.0.1，包名为 @devcodex/capability-graph。

#运行环境

Provider 的 version 描述其声明版本，与 SDK 的 npm 版本独立。Graph Revision 标识当前授权视图，也不等同于 npm 版本。

#MCP 协议与宿主

新宿主或新版本应先确认其协议和认证支持，再检查工具列表与一次完整的 Catalog → 选择 → Resolve 调用。Codex 的 HTTP 配置见 MCP，远程连接见 HTTPS 接入。

#模型与可选依赖

独立Codex匹配不支持原生Windows，也不会退回无隔离执行。WSL、容器等Linux环境仍需实际满足bubblewrap、CLI版本和挂载权限，未验证时不能仅凭platform=linux声称可用。不满足平台、版本或隔离条件时返回CG_MODEL_EXECUTOR_UNSAFE。普通Codex宿主经MCP使用当前模型，不需要独立匹配的隔离环境。

模型选择受输入、Context、目录描述及模型影响。Graph 校验已有 ID、权限、关系和适用条件；调用方仍需处理 ambiguous、needs_context、unknown 和 partial。参见 match 与结果处理。

#示例版本

VextJS 案例 使用 vextjs@2.0.0，只描述带请求校验的 greeting 流程及其依赖。使用其他框架版本时，应由 Provider 作者更新声明、使用说明和 appliesTo 条件。

#站点版本与可验证范围

站点随main更新，可能先于npm版本发布。默认安装统一 npm install @devcodex/capability-graph；在使用项目执行 npm ls @devcodex/capability-graph 核对实际resolved版本。文档标签2.0.1、Provider schemaVersion:1、Provider.version和结果revision是不同标识，不可互换。

代码提供一条接入路线，并不等于你的模型账号、原生CLI隔离、Plugin安装或远程HTTPS连接已经验证。真实验证至少包括工具发现/目录非空/选择真实ID/完整Resolve，模型路线再确认实际模型调用。受控executor只验证状态处理；doctor的modelVerification:not_run不是账号可用性证明。

当前接口没有expectedRevision参数，也不自动抛CG_REVISION_MISMATCH；跨请求视图变更由调用方对照revision后刷新。新增公开接口或协议支持须随真实实现和消费者证据更新，不从历史草案恢复能力。