Graft：开源 AI 编程助手上下文增强与加速工具

是由 Nanonets 推出的开源 AI 编程助手（Coding Agent）上下文增强与加速工具。

1. 平台介绍

Graft 是一款专注于增强 AI 编程助手（如 Claude Code、Cursor、Codex、Gemini 等）对代码库理解能力的本地化 CLI 工具。

传统方案通常依赖向量检索（RAG）或将整个代码库作为巨大上下文塞给 LLM，导致 Token 消耗巨大且模型经常“迷路”或跳过工具调用。Graft通过在本地将代码库提炼为一套互相链接的 Markdown 节点图（Markdown Context Graph），并结合 Hook 机制在交互时自动将精准的架构与上下文注入给 AI，从而实现：

1. 更快、更省、更准的 AI 辅助编程。

2. 主要功能

Graft 提供了以下核心能力以优化开发体验：

1. 代码库结构化图谱构建：基于 Tree-sitter 进行本地确定性解析，将代码库按照模块、API 及系统概念抽离为清晰的 Plain English 关联节点图（Markdown node graph）。
2. 自动化 Hooks 注入：无需依赖 Agent 主动调用外部 MCP 工具，Graft 会通过 Agent Hook（如 .claude/ 钩子）在每次 Prompt 时自动拉取匹配的代码节点，无感嵌入上下文。
3. 显著降低 Token 与耗时：

• Token 节省：平均节省约 42% 的上下文 Token。
• 工具调用减少：减少约 46% 的 Tool-call 次数。
• 响应加速：大幅缩短墙上时间（Wall-clock time），加速 32%~60%。
• 准确率提升：在 SWE-bench Verified 测试中，解决率相比冷启动从 54% 提升至 66%。

3. 适用人群

1. AI 编程工具深度依赖者：日常频繁使用 Claude Code、Cursor、Gemini 等 Agent 进行代码重构与开发的工程师。
2. 大型/复杂代码库开发者：面对大型项目、Monorepos 或是接手不熟悉代码库，需要 AI 迅速理解全局依赖关系的架构师与开发者。
3. 成本与速度敏感型团队：希望在使用 LLM 辅助编码时大幅削减 API Token 账单并获得快速响应的个人或团队。

4. 免费付费情况与定价说明

Graft 本身完全开源且免费提供，具体计费逻辑如下：

1. 基础代码结构提取（graft build）：纯本地 Tree-sitter 解析，不调用任何 LLM，不消耗任何费用。
2. 深度摘要提炼（graft build --deep）：会调用您配置的 LLM API Key（如 Anthropic、OpenAI、OpenRouter 等）生成高层级概念节点，费用直接按您对应的 API 供应商标准扣除。
3. 官方资源链接：

• Graft 开源仓库与免费声明页面：https://github.com/nanonets/graft

5. 如何使用

步骤 1：全局安装 CLI

在终端中运行以下命令进行安装：

bash

npm install -g @nanonets/graft

步骤 2：在项目目录初始化并绑定 Agent

进入您的代码库目录并运行：

bash

graft init

• 命令提示：自动提示选择需要绑定的 AI 编程代理（如 Claude Code）。
• 配置写入：自动在本地生成 graft/ 节点图，并将 Statusline 及 Hooks 配置写入 Agent 目录（例如 .claude/）。

步骤 3：正常使用 AI 编程助手

配置完成后，直接像平常一样启动您的 AI 助手（例如运行 claude），Graft 会在后台跟随会话并在每次提问时自动注入精准的代码上下文节点。

常用命令备忘列表

1. 生成/更新图谱：使用 graft build（带深度总结可加参数 --deep，需提前设置环境变量）。
2. 可视化检查图谱：运行 graft viz 查看生成的结构。
3. 检索与定位：使用 graft grep <关键词> 或 graft map。

6. 注意事项

在使用 Graft 之前请务必确认以下事项，以确保团队协作和隐私安全：

1. Git 忽略项配置：运行 graft init 会自动将 graft/ 文件夹添加到 .gitignore 中（图谱属于本地可再生的缓存，类似 node_modules）。
2. 协作流程：团队协作时只需提交 .claude/ 钩子配置；其他成员拉取代码后运行一次 graft build 即可。
3. API 密钥与模型环境变量：如果使用深度摘要功能（--deep），需确保配置好相应的环境如 GRAFT_PROVIDER、GRAFT_API_KEY、GRAFT_MODEL 等。
4. 隐私与安全性保障：Graft 本身零遥测（No Telemetry）、无分析数据上报。所有的网络请求仅限于您主动配置并调用的 LLM API 端点，保护本地代码安全。