AgentIndex icon
AgentIndex
工具MCP 服务HOT分类热门最新选型清单对比指南
提交工具
工具MCP 服务HOT分类热门最新选型清单对比指南
首页/
代码助手/
Graft
Graft logo

Graft

活跃·★ 10.8k·MIT·更新于 2026-10-27
★ 最受欢迎★ 必备神器★ 时下流行

Graft 针对编程智能体的一种浪费:每个任务它们都是从零开始,靠 grep、打开文件、顺着 import 一路重新摸索仓库,会话结束后又把学到的东西丢掉。Graft 把这份理解只构建一次,写进你的仓库,成为一个由互相链接的 markdown 文件组成的文件夹,每个系统、API 或概念一个节点,用通俗的语言解释,而不是干巴巴的符号列表。

它没有向量嵌入或相似度索引:图就是智能体可以打开和 grep 的普通文件。它是本地缓存,`graft build` 会把它加入 .gitignore,每次查询都会先根据工作区重建结构图,README 称没有改动时不花钱、耗时约 3 毫秒。摘要由你选择的提供商和密钥来写(OpenAI、Anthropic、OpenRouter、Fireworks、Groq、LiteLLM 代理或本地模型)。安装是 `npm install -g @nanonets/graft` 然后 `graft init`,它会询问要接入哪些智能体(Claude Code、Cursor、Codex、Gemini 等),`--dry-run` 可以预览它会改动的每个文件。另有 MCP 服务、带 grep 和 map 命令的命令行、图的可视化,以及用于评审 PR 影响范围的可选 GitHub App。代码采用 MIT 许可证。

本文根据项目 README 和公开仓库数据整理,我们没有实际试用过该工具。数据截至 2026-10-24。

许可证
MIT
最新发布
没有 GitHub 发布版本
最近提交
2026-10-24
贡献者
47
复刻数
952
未关闭的 issue 和 PR
244
首次发布
2026-07-03

来源:GitHub、npm 和 PyPI 的公开接口。

#代码助手#LLM上下文#代码库分析#开发者工具#性能优化#代码图#Monorepo支持#代理集成
$ 安装
$ npm install -g @nanonets/graft && graft init
↗ 访问官网★ GitHub
01

功能特性

01生成可读的、链接的 Markdown 代码库图谱,用于上下文理解。
02提供系统各部分的真实解释及其连接,避免代理进行重复的代码探索。
03自动根据工作树刷新代码图,即使有未提交的更改也能实时保持准确性。
04支持多种 LLM 提供商生成摘要,允许用户使用首选模型和密钥。
05作为本地可再生缓存(`graft/` 文件夹),不提交到版本控制。
02

为什么选择它

+把仓库变成由互相链接的 markdown 笔记组成的图,智能体可以直接阅读和 grep,无需向量嵌入或保持热启动的索引。
+每次查询都会根据工作区重建结构图,所以能反映尚未提交的修改。
+摘要器可以自带:OpenAI、Anthropic、OpenRouter、Groq、LiteLLM 代理或本地模型。
+`graft init --dry-run` 会在改动任何东西之前列出它要写入的所有文件,并支持 Claude Code、Cursor、Codex 和 Gemini。
03

权衡点

!突出的数字(如少用 42% 的 token、少花 60% 的时间)来自项目自己在两个仓库上跑的 162 次基准测试,并非独立评估。
!写节点解释需要 LLM 提供商和密钥,第一次构建图时会产生费用。
!生成的图是本地缓存,需要重新构建,或通过它加入的配置来共享,而不是提交到仓库里。
05

维护状况检查

活跃检查日期: 2026-10-25
最近提交
2026-10-24
近 90 天提交数
100+
近 90 天发布数
0
最新发布
—
未关闭 issue
249
近期 issue 至少有一条评论的比例
0/11
近 12 周每周提交数
近 12 周每周提交数: 38, 20, 63, 29, 14, 5, 9, 20, 0, 14, 105, 0

最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。

状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

  • #323 0.13.0+ won't start on Windows without a C toolchain: [email protected] ships no prebuilds, so require() throws before any command ru5 条评论 · 2026-09-09
  • #374 Runaway upkeep child processes when ~/.graft is unwritable in a sandbox4 条评论 · 2026-09-13
  • #326 Using skill instead of AGENTS.md4 条评论 · 2026-09-09
  • #313 Do not clobber statusline on first install4 条评论 · 2026-09-09
  • #298 graft build --deep: hardcoded maxTokens=8192 truncates tool-call JSON, and file-node summaries discarded due to id-decoration mismatch4 条评论 · 2026-09-04

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

04

适合谁

适合选它的情况
  • 希望为自己的代码库自动生成轻量、互相链接的 Markdown 知识图谱,让 Claude Code、Cursor 等编程智能体直接 grep 和阅读,无需维护重型向量库。
  • 想要减少智能体在大型代码库中来回摸索产生的 Token 浪费,让模型一目了然看清模块依赖与调用路径。
建议换别的情况
  • 需要基于 Neo4j 图数据库、混合向量检索与复杂 Cypher 图查询的企业级代码图谱;那种架构 code-graph-rag 更适合。
  • 代码库非常小(仅单文件或几百行脚本),无需额外构建上下文索引。
06

与同类的区别

code-graph-rag logovs code-graph-rag★ 5.3k

Graft 将仓库编译为无需外部数据库的静态 Markdown 图,智能体可直接本地 grep;Code-Graph-RAG 则采用 Neo4j + 向量检索的图数据库方案,适合复杂语义分析。

完整横向对比 →
07

兼容性

Node.js
运行时
已通过文档验证
TypeScript
语言
已通过文档验证
Python
语言
已通过文档验证
Go
语言
已通过文档验证
Java
语言
已通过文档验证
R
语言
已通过文档验证
08

快速开始

1
$ npm install -g @nanonets/graft
2
$ graft init
09

使用场景

↳加速编程代理,实现更快速、更经济的代码理解和生成。
↳通过提供预先映射的上下文,帮助新开发人员或代理熟悉复杂代码库。
↳识别代码更改的爆炸半径,以了解潜在影响。
↳提高代理解决真实 GitHub 问题(经 SWE-bench 验证)的正确性。
↳为LLM驱动的编程工作流优化工具调用、令牌和延迟节省。
10

同类工具

⚡热门对决:
VScode-graph-rag★5.3k→VSagentpack★18→VSagents-best-practices★2.4k→VScode-context-engine★440→
code-graph-rag logo
code-graph-rag★ 5.3k
一个精确的检索增强生成(RAG)系统,它使用Tree-sitter分析多语言代码库,构建全面的知识图谱,并支持对代码库结构、关系进行自然语言查询以及编辑功能。
VS对比→
agentpack logo
agentpack★ 18
Agentpack为AI编码代理提供仓库本地的任务状态连续性。
VS对比→
agents-best-practices logo
agents-best-practices★ 2.4k
面向 Codex 与 Claude Code 的中立 Agent 技巧库,涵盖 Agentic 运行时框架设计最佳实践
VS对比→
code-context-engine logo
code-context-engine★ 440
索引你的代码库,让AI通过搜索而非重新读取文件来获取上下文,实现94%的token节省。
VS对比→
ffmpeg-skill logo
ffmpeg-skill★ 3.1k
给编程智能体用的本地视频剪辑工具:42 个 FFmpeg 工具,带机器可读契约和 MCP 服务器,适用于 Claude Code、Cursor、Codex
VS对比→
agent-shadow-brain logo
agent-shadow-brain★ 38
第一个开源的大脑,机器上的每个AI编码代理都可以共享。
VS对比→
pmb logo
pmb★ 287
为 AI 编程智能体(Claude Code、Cursor、Codex)通过 MCP 提供的本地优先持久记忆,所有数据存在磁盘上的一个 SQLite 文件里,无需 API Key。
VS对比→
mcp-video logo
mcp-video★ 223
面向AI代理的视频编辑MCP服务器。
VS对比→
查看全部替代品 →

评论

登录后发表评论

暂无评论,来发表第一条吧

本页内容
01功能特性02为什么选择它03权衡点05维护状况检查04适合谁06与同类的区别07兼容性08快速开始09使用场景10同类工具
trailhq /
Graft
↗

为你的代码库生成 markdown 知识图谱,让编程智能体少做重复探索

10.8k952MIT
最后更新1天前
状态活跃
分类代码助手
贡献者47
链接
文档↗讨论↗问题↗版本↗
推荐云部署
Ad

在 DigitalOcean 上一键部署

为你的 MCP 服务、Docker 容器与智能体提供即开即用云服务器,新用户立享 $200 免费额度(60天有效)。

立即领取 $200 免费额度
© 2026 AgentIndex.app|由十年 iOS 开发者构建。
按场景挑选关于我们联系我们广告合作隐私政策使用条款QYSGitHub请作者喝咖啡 ☕

按分类浏览

MCP 服务器代码助手工作流自动化RAG / 知识库多智能体浏览器自动化大模型基础设施开发者工具可观测性

与 Anthropic, OpenAI 或 Microsoft 无关。