AB
AB
AiBoss

すべてのカテゴリ

project

graphicle - 为编码智能体提供代码图谱与项目记忆的 Rust 单程序

graphicle 是 Graphicle-AI 用 Rust 编写的开源工具，把仓库解析成代码图谱，并把项目文档、决策与过往智能体会话存成可检索的记忆，通过 MCP 向编码智能体返回带文件与行号引用的片段。项目采用 Apache-2.0 许可，截至 2026-11-04 获 501 星标。

graphicle 是 Graphicle-AI 维护的一个开源工具，用项目自己的话说，它把「代码图谱与记忆装进一个 Rust 程序」。它做两件事：一是把仓库解析成代码图谱，记录文件、函数、类、调用与导入关系；二是把项目的文档、决策记录和过往智能体会话保存为可检索的记忆。当编码智能体提问时，它从这两部分里取出带出处（具体文件与行号）的片段返回。据项目说明，它适合希望让 Claude Code、Cursor、Codex、VS Code、Claude Desktop 或其他 MCP 客户端在本地获得仓库上下文的开发者，也适合需要把项目知识沉淀下来、供人和智能体共同查阅的团队。

维护者与状态

项目由 Graphicle-AI 维护，仓库创建于 2026-10-14，最后一次提交在 2026-11-03。最新正式版本为 v0.1.12，发布于 2026-11-03。截至 2026-11-04 读取数据时，仓库获得 501 个星标。项目另有一个官网页面，用于介绍产品与文档入口。

主要能力

以下能力均据项目自述（README）整理，未经本站独立验证。

  • 代码图谱。使用 tree-sitter 解析文件、函数、类、调用与导入，据项目说明不依赖模型。可通过 graphicle graph 搜索图谱、解释某个符号、追踪路径，并导出可交互的 HTML 图。执行 graphicle graph extract . --code-only 后，graphicle graph affected "retry()" 可列出依赖某个符号的内容。
  • 项目记忆。把 Markdown、PDF、Office、HTML 等文档，经过审阅的决策与流程，以及过往 Claude Code 与 Codex 会话纳入检索，与代码一起被搜索。
  • 按预算返回带引用的上下文。graphicle context 与 MCP 工具在用户设定的 token 预算内返回带来源的片段，据项目说明此过程不调用模型。
  • 面向长上下文模型的 pack。graphicle pack 在最多 2,000,000 token 的预算内填入问题所需的代码，包括架构、带行号的聚焦代码、调用路径、测试与清单；graphicle ask --pack 与 graphicle plan 可把 pack 发给模型。
  • 单一 MCP 服务器。graphicle mcp 同时提供代码图谱工具（沿用 Graphify 的工具名，如 query_graph、get_neighbors、shortest_path）与记忆工具；加 --pull-requests 后还会提供 list_prs、get_pr_impact、triage_prs 等拉取请求工具，依赖 GitHub CLI。
  • 记忆与代码绑定。据项目说明，经审阅的记忆会绑定到相关函数，当对应代码发生变化时记忆会过期。

README 还描述了 graphicle see、graphicle pixel、graphicle fix 等围绕缺陷复现与修复的命令，这些命令需要配置 Meta Model API 的密钥。项目同时给出了与若干记忆系统的对比数据，但那些数字来自项目自述的预发布版本评测，本站未做复核，此处不转述具体分数。

使用入口

仓库地址为 Graphicle-AI/graphicle，产品与文档入口见 官网。

据 README，macOS 上可通过 Homebrew 安装，然后在仓库目录执行初始化：

brew install graphicle-ai/tap/graphicle
cd your-repo
graphicle setup

没有 Homebrew 时，README 给出的替代方式是用 curl 执行安装脚本。graphicle setup 会索引仓库、构建代码图谱并连接它找到的编码智能体，同时开启会话捕获、向 AGENTS.md 追加两行说明，并安装保持项目更新的 Git 钩子。项目称它会列出并备份每一个改动的文件，graphicle disconnect 可撤销全部改动。

终端提问示例：

graphicle ask "where is tax added to prices?"

据项目说明，未配置模型时 ask 只展示证据片段；通过 graphicle config set model anthropic（或 openai、ollama）可增加书面回答。其他常用命令包括 graphicle open（浏览图谱、来源与记忆）和 graphicle doctor（检查运行状态）。

许可与限制

项目采用 Apache-2.0 许可证。

据 README 说明的已知限制与边界：

  • Windows 目前只有 x86-64 预览版，且尚未进行代码签名。
  • 项目称其本地运行、无需账号、无遥测；唯一的自动请求是每日检查新版本，可用环境变量 GRAPHICLE_NO_UPDATE_NOTIFIER=1 关闭。
  • 代码图谱、记忆、MCP 服务器、Web 应用与命令行都在一次安装中提供，使用单个 SQLite 文件，据项目说明不需要 Python、Docker 或数据库服务器。
  • README 明确表示不声称能节省 token，并称在其测试中查找代码的表现与 grep 持平；这些属于项目自述，读者应结合自身仓库评估。
  • 部分命令（如 see、pixel、fix）需要额外的模型 API 密钥，属于可选能力而非开箱即用。
戻る