GraphJin 受管数据与代码图谱连接器

它解决什么问题

Agent 要访问数据时，通常卡在两个死胡同里：要么只能看到对话上下文里的碎片，于是开始编造不存在的表和字段；要么集成方把连接串和 SQL 硬编码进工具，治理、审计和变更监控全部失效。代码资产同理——文件、索引、工作流散落在不同系统里，agent 很难在不破坏边界的前提下做受管的发现与操作。

GraphJin 的思路是把受管数据与代码图谱本身变成一层可查询的接口：数据库、文件、代码索引、工作流和策略统一以 GraphQL 暴露，agent 只跟这一层打交道。

技能如何工作

核心能力可以拆成三块：

• 统一端点：通过 MCP 与 agent 端点暴露 GraphQL，agent 用同一套查询语法做 schema 发现、读取和操作，不必为每种后端单独写工具。
• 受管操作：发现与执行都在策略约束下进行，哪些源已批准、哪些动作允许，由 GraphJin 侧的策略决定，而不是交给模型自由发挥。
• 持久记忆：保存的查询、片段和工作流落在按所有者隔离的 gj_artifacts 存储中；基于游标的监视器 gj_watch 在所有者权限下持续运行查询，状态不会随会话结束而消失。

典型接入流程：

1. 准备 GraphJin CLI 或服务器，以及已批准的数据库、文件、代码源。
2. 通过 MCP 把端点接入客户端（Codex、Claude Code 或其他支持 MCP 的工具）。
3. agent 先做 schema 发现，确认可用的实体与关系，再构造具体查询。

适用边界

• 这是基础设施层技能，不承载业务逻辑，也不该用来替代高风险变更的人工审批。
• 支持范围取决于 GraphJin 已接入的源和策略配置，未批准的源不会出现在图谱里。
• 必须搭配支持 MCP 的客户端使用，纯 prompt 工程解决不了端点连接问题。