Graphicle
一个 Rust 程序为编码智能体同时提供代码图谱与项目记忆，本地运行，返回带引用的代码证据。
- Star 数
- ★ 432
- 最近更新
- 1 天前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 92/100 · 表现优秀
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在大型陌生仓库中工作的开发者，想让 Claude Code 快速定位「失败请求在哪重试」之类的代码位置并附带行号引用
- 不适合
- 需要托管团队版（商业版仍在私测）的团队
- 希望自动记忆无需人工审批的用户
- 需要 Windows 正式签名的严格环境（当前为预览版）
- 源码审查
- 92/100 · 表现优秀
这个 Agent 能做什么，适合哪些场景？
Graphicle 把仓库映射为代码图谱（基于 tree-sitter 解析文件、函数、类、调用与导入，无需调用模型），并保存项目文档、经审阅的决策和过往 Claude Code / Codex 会话作为可检索记忆。它通过一个 MCP 服务器向 Claude Code、Codex、Cursor、VS Code 等客户端提供代码图谱工具和记忆工具，检索结果以「文件 + 行号」引用形式在 token 预算内返回。整套程序是单个 Rust 二进制，数据存在一个本地 SQLite 文件中，无需 Python、Docker、数据库服务器或账号。记忆锚定到代码符号，相关代码变更后记忆会标记为过期；智能体提议的记忆需在应用中人工审批。项目由 KarLex AI 开发，Apache-2.0 许可，代码图谱引擎是 Graphify 的 Rust 移植。
运行 graphicle setup 后，它索引仓库（尊重 .gitignore、跳过 .env 与密钥）、构建代码图谱、为检测到的编码智能体配置 MCP 连接、开启会话捕获、向 AGENTS.md 追加两行说明并安装 Git 钩子（post-commit / post-merge / post-checkout）保持数据最新；graphicle disconnect 可全部撤销。graphicle ask/context 返回带文件与行号引用的片段；graphicle graph extract . --code-only 加 graphicle graph affected "retry()" 分析符号影响面；graphicle pack 在最多 200 万 token 预算内打包架构、焦点代码、调用路径与测试清单；graphicle mcp 提供 query_graph、get_neighbors、shortest_path 等工具，加 --pull-requests 时还提供 list_prs、get_pr_impact、triage_prs；另有 graphicle review（分支变更评审）、graphicle fix（在新分支修 issue 并跑测试）、graphicle see/pixel（从屏幕定位代码）和 graphicle open 浏览应用。
- 在大型陌生仓库中工作的开发者，想让 Claude Code 快速定位「失败请求在哪重试」之类的代码位置并附带行号引用
- 长期维护同一项目、希望文档、决策和历史会话能跨会话复用且必须本地保存的工程师
- 评估代码变更影响面的维护者，用 graph graph affected 查看谁依赖某个符号
- 需要自动评审分支改动并只在引用成立时保留评论的团队，配合 GitHub Action 在 PR 上发布评审
- 想给长上下文模型打包完整相关代码（含调用路径与测试）以做架构理解或规划的智能体用户
- 希望在修 bug 时从网页截图定位绘制该元素的代码并自动补丁、跑测试的开发者
如何安装或部署这个 Agent？
macOS / Linux 可用 Homebrew 安装：
brew install graphicle-ai/tap/graphicle没有 Homebrew 时用安装脚本：
curl -fsSL https://github.com/graphicle-ai/graphicle/releases/latest/download/install.sh | shWindows 提供 x86-64 预览版（尚未正式代码签名）。无需 API key、账号或模型即可使用代码图谱、context、MCP 服务器、会话捕获和应用。
如何使用这个 Agent？
在仓库根目录执行一次性配置：
cd your-repo
graphicle setup它会索引仓库、连接检测到的智能体并安装 Git 钩子。之后可从终端提问：
graphicle ask "where is tax added to prices?"或让智能体「use graphicle to find where failed requests are retried」。可选：graphicle config set model anthropic（或 openai、ollama）启用书面回答；graphicle open 在浏览器查看图谱与记忆并审批提议的记忆；graphicle disconnect 撤销 setup 的全部改动；graphicle doctor 检查配置。
这个 Agent 有哪些优点和局限？
- 单一 Rust 程序 + 一个 SQLite 文件，无需 Python、Docker 或数据库服务器，安装与撤销（graphicle disconnect）都很干净
- 检索返回文件名与行号的引用，且无需调用模型，本地优先、无遥测，代码默认不出机器
- 记忆锚定到代码符号：相关函数变更后记忆自动过期，其他编辑通常不影响其有效性
- 自报基准称在 kubernetes 上 0.1.8 的 context 调用中位耗时 1.34 s，峰值内存从 3.5 GB 降至 0.6 GB；与七个记忆系统对比中 LoCoMo-10 准确率领先或持平
- 智能体提议的记忆需人工审批，长期记忆的价值依赖审阅投入
- Windows 构建是未正式签名的预览版，严格的合规环境可能无法使用
- 检索基准（SWE-bench Top 5 为 75 vs BM25 61）未做端到端智能体修复率测试，作者也未声称节省 token
- 与云服务或托管团队功能相比，商业团队版仍在私测，多人共享需自建团队服务器
这个 Agent 与同类方案有什么区别？
自报数据方面：在 13 个代码库上，其 0.1.1 预发布内存引擎比 Graphify 0.9.91（Python）快 3.0–22.7 倍、峰值内存更低（0.29–0.97 倍），两者图谱略有差异（节点数差 4.7% 内、边数差 2.0% 内）。与单独组合「代码图谱工具 + 独立记忆服务器」相比，Graphicle 主张一次安装、一个 MCP 服务器、一个 SQLite 存储并统一提供引用与审阅。与七个记忆系统（Hindsight、Mem0 OSS、MemMachine、Honcho、Cognee、Graphiti、Mastra）的对比中，LoCoMo-10 得分 87.7，超过除 Hindsight（87.3，视为持平）外的全部对手，且摄入时模型调用约 12 次/会话，远低于 Hindsight（约 160）与 Mem0（约 332）。这些均为项目自报数据，方法与局限见其 docs/benchmarks.md。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Graphicle 当前 | 92 · 表现优秀 | 命令行工具免费 + 模型费 | ★ 432 | 1 天前 | Rust | Codex · Claude Code |
| GraphMind 代码知识图谱 | 64 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 216 | 14 天前 | Rust | Claude Code · Claude.ai |
| mex 项目记忆 | 71 · 存在缺口 | 命令行工具免费 | ★ 1.8k | 2 天前 | TypeScript | Codex · Claude Code |
| Graphify – 将任何代码库转换为可查询的知识图谱 | 64 · 存在缺口 | 命令行工具免费 | ★ 138k | 2 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示极小权限与透明写盘：setup 列出每个改动文件并先备份为 .graphicle-bak，disconnect/uninstall 可完整撤销；记忆仅作草稿须人工批准；会话捕获先剔除凭据与 <private> 内容。网络行为被逐一列出（仅每日 GitHub 更新检查，可关闭）。扣分点：凭据 'skips secrets' 与会话清洗仅为文档声明，未见静态证据证明其完备性；sensitive_data_handling 因此记 2。
文档高度自洽：quickstart、configuration、troubleshooting、FAQ 相互引用且版本（0.1.9）、路径、配置项一致；doctor 与失败消息设计详尽（doctor 打印修复命令）。扣分点：依赖可用性仅凭 Homebrew/发布归档/源码构建描述，实际可用性与测试未在静态证据中验证，记 2。
受众（Claude Code/Codex/Cursor/VS Code/任意 MCP 客户端）与场景（个人、团队服务器、Windows 预览）覆盖清晰；边界明确（100k 文件、1 GiB 限制、Windows 预览排除项、未测试的长会话记忆）；触发精度有详细的 code_first/query_focus/identifier_arm 规则；环境适配（glibc 版本、macOS/Intel/ARM、签名缺失的 SmartScreen 提示）非常具体。接近满分。
信息架构优良：README 入口表、quickstart、install、FAQ、troubleshooting 各司其职，锚点链接清晰。扣分点：CHANGELOG 内容未在证据中出现（仅被引用），维护响应（issue/Discord/SECURITY.md）只是断言，未见实际维护记录；工具命名沿用 Graphify 名称有兼容理由但仍存在两套名称带来的认知成本，各记 2。
输出可用性强：每次摘录附文件与行号引用，token 预算、spend 日志、单次/每日费用上限设计周到。扣分点：边际价值部分自认与 grep 在找代码上打平且'不声称节省 token'，检索提升（Top5 75 vs 61）来自作者自测，静态证据无法独立确认，记 2。
几乎所有数据都标明方法、日期、机器、CI 与局限，并区分'tie'与显著差异，事实与推断分离出色，链接到 benchmarks.md 的具体锚点。扣分点：跨源印证依赖作者自己发布的对比结果与 'published result files' 的转述，无第三方独立复核，记 2。
- 静态审查未执行任何命令：'skips secrets'、会话凭据清洗与安装脚本行为均仅为文档声明，实际效果未经独立验证。
- 安装脚本 curl|sh 与未签名的 Windows 预览二进制存在供应链与拦截风险；建议改用 Homebrew 或先下载归档校验 SHA-256 后安装。
- setup 默认连接全部发现的客户端并开启会话捕获与 Git 钩子，属较大范围默认行为；建议用 --clients/--no-capture/--no-hooks 收窄，并审阅 .graphicle-bak 备份。
- --allow-learning 默认开启记忆提案；若不希望代理写入记忆草稿，请显式关闭。
- 性能与记忆基准均来自作者自测，无第三方复现；勿据此单独做采购决策。
- 发布方未经企业注册表验证，身份未知；核心代码不在本次证据范围内。