📋 编辑总结
一个 Rust 程序把仓库变成代码图谱,并记住文档、决策与过去的 agent 会话,按你设的 token 预算给 agent 返回带文件行号的引用。本地运行,无需 API key、无账号、无遥测,一个 MCP server 同时供图谱与记忆;支持跨仓库回忆与团队自建服务端。Apache-2.0,当前 v0.1.18(2026-11-16):新增 OpenCode 接入与大图谱更新提速;近期版本还补了 PostgreSQL 16+ 可选存储。 定价:免费(Apache-2.0 开源);本地运行无需账号与 API key,团队共享服务端自行部署。

Graphicle 是什么?

Graphicle 是一个用 Rust 写的单程序:把你的仓库映射成代码图谱,同时记住项目文档、决策和过去的 agent 会话,然后按你设定的 token 预算,给编码 agent 返回带引用的片段——具体到文件和行号。Apache-2.0 许可,当前 v0.1.18(2026-11-16),官方把它定位成 Graphify 的重写版,仓库里有从 Graphify 迁移的文档。

它跑在你自己机器上:不需要 API key、不需要账号、没有遥测;唯一的自动请求是每天检查一次新版本,可用 GRAPHICLE_NO_UPDATE_NOTIFIER=1 关掉。

装与用

macOS 用 brew install graphicle-ai/tap/graphicle,或者用安装脚本(会校验 SHA-256、装到 ~/.local/bin、不用 sudo)。然后在仓库里跑 graphicle setup:索引仓库、建代码图谱、自动连接它找到的编码 agent(Claude Code 写 .mcp.json、Codex 写 ~/.codex/config.toml,Cursor、VS Code、Claude Desktop 各有位置,其他 MCP 客户端给一段 JSON),打开会话捕获,往 AGENTS.md 加两行,并装 git hook 保持同步;每个改过的文件都先备份成 .graphicle-bak,graphicle disconnect 全部撤销。

常用命令:graphicle ask "税是在哪里加上的?"(没有配模型时只给证据,graphicle config set model anthropic|openai|ollama 后才写答案)、graphicle open 在浏览器里看图谱、源码与记忆并批准记忆、graphicle graph affected "retry()" 看改动影响面、graphicle doctor 自检。

关键设计

代码图谱用 tree-sitter 解析,不调模型。记忆锚定到代码符号:一条记忆是关于哪个函数的,那个函数变了记忆就过期,文件别处的改动通常不影响。文档里的代码提及会链接到对应定义。可以跨仓库回忆(graphicle context --workspace),团队也可以自建一个 Graphicle 服务端共享仓库、文档和已审记忆,浏览器访问、agent 走 HTTPS。一个 MCP server 同时提供图谱工具(沿用 Graphify 的工具名 query_graph、get_neighbors、shortest_path)与记忆工具;加 --pull-requests 还能用 GitHub CLI 提供 PR 工具。

性能与边界

官方基准:在 13 个代码库上,0.1.1(预发布)的记忆引擎在全部 39 次测量里比 Graphify 0.9.91 快 3.0–22.7 倍,峰值内存是对方的 0.29–0.97 倍;两份图谱有细微差异(节点数差 4.7% 以内、边数差 2.0% 以内)。它明确说在「找代码」上只是与 grep 打平,不主张省 token。平台是 macOS 11+、Linux(x86-64/arm64,glibc 2.35+),Windows 只有未签名的 x86-64 预览版。项目很新(仓库 2026-10-14 创建),版本 0.1.x,适合愿意尝鲜的团队。

版本记录

  • 2026-11-17 版本核查 v0.1.2→v0.1.18:GitHub releases API 核实 stable 链 0.1.7(10-25)→0.1.18(11-16,Latest)全 prerelease=false。v0.1.18 新增 OpenCode 接入(graphicle setup 自动发现 OpenCode,connect/disconnect 管理 OpenCode 全局 MCP 配置,兼容 OpenCode 2 的 mcp.servers 结构)、大图谱更新提速、不完整依赖失效上报;v0.1.14 新增 PostgreSQL 16+ 可选存储(GRAPHICLE_DATABASE_URL + import-sqlite 迁移);v0.1.15 图谱引擎吸收 Graphify 0.9.96–0.9.103、捆绑 SQLite 升 3.54.1(RUSTSEC-2026-0459);v0.1.17 Python SDK 未声明 readOnlyHint 的工具不再按只读提供、Qdrant 集合强制 cosine 距离;官方公开基准现为 0.1.11 vs Graphify 0.9.100(v0.1.15 发布说明确认)。
  • 2026-10-21 首次收录:核对 GitHub 仓库(Apache-2.0、★332、创建 2026-10-14)与 README、docs/install.md、docs/team.md、v0.1.2 发布记录。