Graphicle-AI/graphicle

开发工具

把代码图谱和项目记忆装进一个本地程序,通过 MCP 给编程 Agent 返回带出处的片段。

356
27
Rust
Apache-2.0
上线 10 天

值得在跨文件调用较多的中等以上仓库里试一次,尤其当 Agent 反复盲搜、上下文不够用时;速度数据是作者自测,回答质量尚无定论。

解决什么问题

你想让编程 Agent 回答“失败请求在哪重试”,或者“改 retry() 会牵动什么”。现在它得猜关键词、反复 grep、整文件读入,常常还没找到函数就耗光上下文。Graphicle 换掉的就是这一步:setup 建好索引并连接 MCP 客户端,之后 Agent 请求的是从代码、文档、会话和已审核记忆中排序出的摘录,每条都标回文件和行号区间,你可以在引用位置核对答案。

有什么不同

代码图谱由 tree-sitter 解析生成,不调用模型,所以索引代码不需要 API key。更有意思的是记忆部分:捕获的 Agent 会话和 Agent 提出的记忆都会成为来源,但提出的记忆要等你在应用里批准后才生效。README 的定位是本地优先:一个 SQLite 存储、只监听回环地址、无账号无遥测,联网只发生在你点名的具体命令里。

代价是这些工具本身不调用模型,回答质量仍取决于 Agent 的模型是否会使用结构化摘录,而且 README 明确说长会话和跨会话积累的记忆尚未测试。基准里声称记忆引擎在 13 个代码库上比 Graphify 用时更少,这是作者自测,不是回答更好的独立证据。graphicle disconnect 能撤销 setup 加入的内容,改动过的文件也先备份,但这只是文件恢复层面的说明,并不保证以后每次升级都顺利。代码图谱引擎本身是 Graphify 的 Rust 移植,如果你已经在用 Graphify,新增价值主要来自记忆和单程序打包。

谁值得试

适合:手上是有不少跨文件调用的代码库,用 Claude Code、Cursor、Codex 或其他 MCP 客户端,希望项目决策和历史会话能跨会话保留,并且愿意逐条审核记忆而不是全盘信任的人。想要本地 ask 命令和可浏览图谱、又不想单独搭记忆服务的人,也合适。

不适合:小仓库里 grep 一轮就能回答的问题;以及需要先有回答质量证据才愿意采用的团队。代码索引不用模型,但完整的 graphicle graph extract 会把文档和图片发给它找到 key 的 LLM,所以“完全离线”是另一种配置,不是默认状态。

使用条件与边界

安装走 Homebrew、安装脚本或发布包。Windows 只有 x86-64 预览版,签名策略说明发布构建尚未使用受信任证书签名,Windows 程序使用测试证书或干脆不签名,那里要先看发布说明。setup 会修改 Agent 配置和 AGENTS.md,并安装 Git 钩子,你得接受它会改动仓库文件;备份和 disconnect 能兜底,但让仓库保持最新会成为持续的维护动作。每日更新检查默认开启,会向 GitHub 请求最新版本,可用 GRAPHICLE_NO_UPDATE_NOTIFIER=1 关闭。记忆只有在你真正审核 Agent 提出的条目时才会变好,这是习惯问题。

HotRepo 点评

HotRepo 从 2026-10-24 开始追踪,目前唯一记录是 2026-10-25 新项目榜(rust)第 22 名、356 总星,这只是快照而非增长。Hacker News 的 Show HN 帖在 2026-10-14 有 48 分、15 条评论;一位评论者称其非严格评测中此类记忆系统不如直接用 ripgrep 的原生流程,也有回复认为这类工具对弱模型有帮助、对前沿模型只是更慢更贵。仅凭两个追踪日期无法判断热度能否持续。决定投入前,建议对照项目说明,在你自己的仓库上跑它的 Agent 基准并与日常 grep 流程对比。

Hacker News 讨论

Show HN: Graphicle, a Rust port of Graphify with memory for coding agents
▲ 48 · 15 条评论 · 2026年10月14日

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。