Capability Graph

    产品与接入路线

    Capability Graph 是静态 JSON 声明驱动的能力图谱引擎。Provider 作者描述已有能力，Graph 校验定义、授权、适用条件与关系，应用或宿主决定如何使用。它不执行能力或依赖。

    你的场景最短路径模型来源
    程序知道能力 IDJSON → open → Catalog/Detail/Resolve无需模型
    已有 Codex 等宿主MCP → Catalog → 选择 ID → Resolve宿主当前模型
    程序需要自然语言匹配open({model}) → match显式 ModelExecutor

    安装后运行第一个图谱：只建声明和脚本两个文件，无需知识目录和模型。先用文件式完成第一次依赖解析；已有内存对象时可选同页的内联式，输出相同结构。

    拿到结果后看结果指南，再按任务补充声明、条件或关联知识。已有 Agent/MCP 服务可嵌入工具层，全部方式见下方接入清单。

    Provider 声明、用户请求、模型输出和知识正文都是待校验的数据。Graph 不自动探测项目事实，不做 RAG、Embedding、关键词 Matcher、数据库、Agent Runtime 或能力执行。

    本手册对应 v2.0.1。运行环境、MCP 协议和各接入方式的条件见版本与兼容。

    完整接入清单

    各入口共用一份 Graph 定义与授权语义。Skill 是指导、Plugin 是分发、setup 是登记，均可与 MCP 组合。

    接入方式模型来源入口
    SDK 静态查询无CapabilityGraph.open → Catalog/Detail/Resolve
    SDK OpenAI 主动匹配显式 API 模型createOpenAIExecutor → match
    SDK 独立 Codex CLI独立只读进程createCodexExecutor → match
    SDK 自定义模型调用方现有模型ModelExecutor.select → match
    通用 Agent Tool Adapter通常宿主当前模型createGraphTools
    已有 MCP Server宿主当前模型或显式服务端模型合并工具列表/分流调用，保留原传输
    独立 MCP stdio通常宿主当前模型客户端启动 serve --transport stdio
    独立 MCP HTTP通常宿主当前模型服务端启动，客户端连接 URL
    ChatGPT Work远程宿主当前模型真实 HTTPS MCP + 宿主连接配置
    Codex 便捷登记当前模型setup → stdio MCP + 官方 Skill
    Skill 单独安装当前模型已连通的 MCP + Skill 指导
    Plugin当前模型宿主 Plugin 安装机制 + MCP/Skill 清单

    默认五工具：capability_graph_list_providers、capability_graph_list_catalog、capability_graph_get_capabilities、capability_graph_resolve、capability_graph_read_document。配置服务端 executor 且 enableMatch:true 才增加 capability_graph_match。普通已有模型宿主默认不再调用第二个模型。

    推荐应用用 SDK；普通 Codex 用户用便捷登记；已有 Agent/MCP 服务嵌入工具；共享/远程宿主用 HTTPS；Plugin 供需要整体分发的宿主使用。状态和限制见兼容页。

    读这些术语时先看任务

    术语白话含义何时看
    Provider框架、SDK或项目的能力声明来源接入或维护声明
    Catalog给选择者看的精简能力目录选真实ID，尚未读取长说明
    Detail能力的完整说明、关系及文档引用看usage和使用前提
    Subgraph / ResolveResult选中根及展开关系的结果看依赖为何出现、哪些目标不可用
    Context调用方提供的平面事实与备注判断条件，不授予权限
    Revision授权静态图谱视图的标识比较跨请求是否同一声明

    推荐路径：安装→最小运行→结果→编写Provider，再选择本页路线。API与配置用于查表，维护者内容后置。