- 社区热度
- 8.7k Stars
- GitHub 收藏
- 最近活跃
- 2026/9/19
- 近 30 天还在更新
- 授权协议
- MIT
- 宽松协议
为什么值得关注
不是看 Star 排名,而是看它解决了什么问题、实际有没有用,以及方法为什么值得关注。
解决的问题
AI 代码 Agent 在每次执行任务时都会从零重新探索代码库,导致大量的 Token 消耗、工具调用冗余与时间浪费。
实际价值
利用 tree-sitter 确定性解析代码结构并配合 LLM 生成 Markdown 节点图谱。测试显示其可减少 46% 的工具调用与 42% 的 Token 开销。
创新 / 差异化
放弃了复杂的向量数据库与远程检索服务,直接将代码库上下文存储为可随 Git 同步的 Markdown 文件图谱。
扩展潜力
通过 npm CLI 分发,提供 `graft init` 一键挂载钩子,兼容 Claude Code 与 MCP 协议,无需后台守护进程。
为什么是现在
随着 Claude Code 等 Agent 快速普及,Agent 在复杂代码库中的上下文探索成本与效率瓶颈变得尤为突出。
社区活跃度
近 90 天新增 39 个 Issue、98 个 PR;窗口内抽取的 Issue/PR 样本中有 27 位 Issue 发起者、21 位 PR 贡献者,并发布 0 个版本。
维护者响应
窗口内 39 个 Issue 样本关闭率 54%,98 个 PR 样本合并率 45%。维护者响应统计覆盖该 Issue 样本的 100%,响应率 36%,首次响应中位数 3.6 天。
核心亮点
- 结构化文档生成:将代码库转化为互相链接的 Markdown 节点文件
- 确定性解析:通过 Tree-sitter 提取代码结构,无需消耗 Token 检索语法
- 兼容主流 Agent:支持 Claude Code、Cursor、Gemini 等 AI 编程助手
快速开始
安装方式、上手难度、开始步骤。
装在哪
待确认
难不难
待确认
- 01使用 npm 全局安装 Graft 工具包:
npm install -g @nanonets/graft - 02在项目根目录下运行初始化命令,生成图表并配置 AI 助手:
graft init - 03将生成的配置文件与钩子提交至 Git 仓库:
git add .claude && git commit -m "wire in graft"
更适合谁
- 希望数据放在自己服务器上的团队
- 想在本机直接跑起来试用的开发者
- 习惯用 Docker 部署的人
更多介绍
Graft 是一个面向 AI 编程 Agent 的上下文映射工具。在开发过程中,AI 助手往往在处理新任务时需要频繁寻找文件和调用工具。Graft 能够一次性分析代码库并生成包含架构与概念说明的 Markdown 关联网络。Agent 可以直接查阅该文件目录,无需重复执行全局搜索,从而在保持准确度的同时缩短响应时间并降低 Token 消耗。
信息来源
每条信息都标注了状态与出处,可展开查看。
14 条 · 展开
信息来源
每条信息都标注了状态与出处,可展开查看。
capability tags
已核验来源: admin_cms · cms editor · 2026/8/30
editor note
已核验{"en":"Graft solves the issue of AI coding agents re-exploring codebases on every prompt. By using Tree-sitter for AST parsing and custom LLM calls for summaries, it provides agents with structured context to skip unnecessary file searches.","zh":"Graft 解决了 AI 编程工具每次执行任务都需要重新探索代码库的问题。它使用 Tree-sitter 进行确定性语法解析,并利用自定义 LLM 生成模块说明文档,减少模型盲目搜索导致的消耗。"}
来源: admin_cms · cms editor · 2026/8/30
how to use
已核验{"steps":[{"en":"Install the Graft package globally using npm: `npm install -g @nanonets/graft`","zh":"使用 npm 全局安装 Graft 工具包:`npm install -g @nanonets/graft`"},{"en":"Run the initialization command in your repository root to build the graph and configure agents: `graft init`","zh":"在项目根目录下运行初始化命令,生成图表并配置 AI 助手:`graft init`"},{"en":"Commit the generated configuration and hooks to Git: `git add .claude && git commit -m \"wire in graft\"`","zh":"将生成的配置文件与钩子提交至 Git 仓库:`git add .claude && git commit -m \"wire in graft\"`"}],"installAt":"unknown","difficulty":"unknown"}
来源: admin_cms · cms editor · 2026/8/30
intro
已核验{"en":"Graft serves as a context understanding layer for AI coding agents. Instead of forcing AI tools to re-explore files on every task, Graft analyzes the codebase once and builds a network of markdown documentation files detailing systems and API relations. Agents can directly reference these files to execute actions faster and use fewer tokens while maintaining code correctness.","zh":"Graft 是一个面向 AI 编程 Agent 的上下文映射工具。在开发过程中,AI 助手往往在处理新任务时需要频繁寻找文件和调用工具。Graft 能够一次性分析代码库并生成包含架构与概念说明的 Markdown 关联网络。Agent 可以直接查阅该文件目录,无需重复执行全局搜索,从而在保持准确度的同时缩短响应时间并降低 Token 消耗。"}
来源: admin_cms · cms editor · 2026/8/30
许可证
已核验MIT
来源: GitHub 官方接口 · license.spdx_id=MIT · 2026/9/20
needs api key
已核验是
来源: admin_cms · cms editor · 2026/8/30
一句话用途
已核验{"en":"Open-source context layer that builds structural codebase maps for AI coding agents","zh":"为 AI 编程 Agent 提供代码库结构与上下文映射的开源工具"}
来源: admin_cms · cms editor · 2026/8/30
平台
已核验windows、macos、linux
来源: admin_cms · cms editor · 2026/8/30
分类线索
根据材料推断ai-apps
来源: 项目说明文档 · hint=ai-apps · 2026/8/17
product forms
已核验cli、library_framework
来源: admin_cms · cms editor · 2026/8/30
role tags
已核验来源: admin_cms · cms editor · 2026/8/30
supports docker
已核验是
来源: 仓库文件 · dockerfile=true; compose=false · 2026/9/20
supports local
已核验是
来源: admin_cms · cms editor · 2026/8/30
supports self host
已核验是
来源: admin_cms · cms editor · 2026/8/30
相关项目
根据分类、能力和适用角色匹配的其他已核验项目。
claude-code
运行在终端中的 Agent 编程工具,可理解代码库、执行日常开发任务、解释代码并处理 Git 工作流。
spec-kit
一套遵循「规范驱动开发」流程的开源 CLI 工具包,配合 AI 编程 Agent 按照规范生成与执行代码。
llama.cpp
基于 C/C++ 实现的轻量级大语言模型推理引擎,支持多种硬件加速与模型量化。
codex
运行在本机的 OpenAI 编程 Agent,可通过终端使用,也提供 IDE 和桌面应用入口。
graphify
将代码库、文档和配置文件转化为可查询知识图谱的 AI 辅助工具
supabase
基于 PostgreSQL 的开源后端即服务平台,提供自动生成的 API、用户认证与实时数据订阅。

