你有没有遇到过这种情况:
打开一个项目,里面塞了几百个文件——src、docs、scripts、SQL、配置文件、几份 PDF、一些截图、还有零散的 Markdown 笔记。你让 Hermes 帮你理一理。
它很努力。读了几个文件,搜了一些关键词,跑了几条命令。
但问题来了。它知道有这个文件,却不知道这个文件跟哪个模块有关;它看懂了一个函数的内部逻辑,却没串起这个函数跟数据库、配置项、接口的关联;它读到 README 里的说明,却漏掉了 docs 里更详细的架构描述。
更难受的是:你昨天刚跟 Hermes 解释过一个设计决策,今天开了新会话,它又问一遍。
这不止是 Hermes 的问题。所有 Agent 工具,只要没有先建好"项目结构认知"和"跨会话记忆",都会变成"每天重新带新人"的状态。
GitHub 上已经有几个项目专门解决这两个问题。
一、graphify:先把项目画成地图
Graphify 的定位很直白:在有 AI 编程助理的终端里输入 /graphify .,它就把当前文件夹里的代码、文档、PDF、图片甚至视频,全部扫一遍,生成一个可查询的知识图谱。
跑完以后,你会得到三个核心产物:
- graph.html:交互式可视化图
- GRAPH_REPORT.md:文本报告
- graph.json:完整图谱数据
在一个工作区跑了 14,247 个文件,约 1.6 亿词——graphify 生成了 90,688 个节点、100,210 条边、14,775 个社区。
这种感觉就像——一个项目文件夹,终于有了一张卫星地图。
为什么特别适合配 Hermes?
Hermes 很擅长干活:读文件、搜内容、跑命令、写代码。但在大项目里,最致命的一步是"先搞清楚全貌"。
更稳的走法是:先用 Graphify 生成 GRAPH_REPORT.md;再把这份报告喂给 Hermes 作为项目上下文;然后再问具体模块、路径、影响范围。
安装:
uv tool install graphifyy && graphify install
graphify install --platform hermes
避坑提醒:
- 大项目第一次跑可能需要几分钟到几十分钟
- 先写 .graphifyignore,排除 node_modules/、dist/、build/ 等
- 文档、PDF、图片的语义提取会发给模型 API,注意隐私边界
二、agentmemory:让你的 Agent 记住上次干了什么
Graphify 解决的是"项目结构"问题。但还有一个更烦人的问题:跨会话记忆。
你今天教 Hermes 用了一个特定的代码规范、一起调试了两小时排除了一个坑、确认了一个库的版本选择。明天开新会话——全清零。
agentmemory 像一个坐在 Hermes 身后的记录员,自动捕获 Agent 做了什么,压缩成结构化记忆,存进本地索引,下次会话自动把相关上下文注入回去。
它用了混合搜索(hybrid search)来匹配"当前任务需要回忆过去的哪些经验"。1,067 个测试全部通过。
对 Hermes 用户的实际意义:
你可以在自己的项目里跑 agentmemory,把它配成 Hermes 的记忆层。之后每次 Hermes 干活,它就把关键决策、踩过的坑、成功的命令序列记录下来。下回你再让 Hermes 做类似的事,它自动调出上次的经验——不用你再解释。
安装:
npm install -g agentmemory
避坑提醒:
- 记忆质量取决于你用的嵌入模型
- 它记录的是"Agent 做了什么",不是"项目架构是什么"
- 最佳用法是 graphify + agentmemory 配合
三、graphiti:如果你需要更精细的时序记忆
graphify 管"现在长什么样",agentmemory 管"过去干了什么"。
但还有一种更复杂的需求:如果 Agent 需要知道"事实是什么时候变的、谁说的、可靠度如何"——那就需要 graphiti 这类时序知识图谱。
graphiti 是 Zep 公司开源的上下文图谱引擎。核心能力是"带时间轴的知识图谱":不仅记录实体和关系,还记录每条事实是什么时候成立、什么时候改变、来源是什么。支持 FalkorDB 和 Neo4j 两种图数据库后端。
最近发布了 MCP Server 1.0,可以直接接入 Claude Desktop、Cursor 或任何支持 MCP 的 Agent 工具。
跟 Hermes 怎么接?
graphiti 通过 MCP 协议接入。你装好 graphiti MCP server,配进 Hermes 的 MCP 配置,Agent 就能直接读写你的知识图谱。
避坑提醒:
graphiti 比前两个工具重。它需要图数据库后端,对新手来说部署成本不低。如果需求只是"让 Agent 记住上次干了什么",agentmemory 更轻量直接。如果需要"记录知识随时间演化的完整链条",那 graphiti 是对的。
三个工具怎么配?
新手/个人用户:先装 graphify。把项目地图建起来,这一步收益最大。
每天都在用 Agent:再加上 agentmemory。项目地图 + 会话记忆,组合拳。
团队共享/长期项目/需要审计知识来源:再上 graphiti。它重,但稳。
装完以后的工作流:
- 进项目,跑 /graphify .,等它生成 GRAPH_REPORT.md
- 让 Hermes 先读报告,建立全局理解
- 在日常工作中,agentmemory 自动记录关键决策和调通路径
- 下次开新会话,Hermes 自动调取相关记忆,不用你重新解释
现在就去试
这三个项目都在 GitHub 上开源,Star 数摆在那里——50.5k、11.9k、20k+——被成千上万的开发者验证过。
最小上手路线:
# 1. graphify - 给项目画地图
uv tool install graphifyy && graphify install
graphify install --platform hermes
cd your-project && /graphify .
# 2. 让 Hermes 读地图
# 在 Hermes 里说:请先阅读 graphify-out/GRAPH_REPORT.md…
# 3. agentmemory - 装上记忆层
npm install -g agentmemory
# 按 Hermes 插件文档接入
先挑你手上一个文件夹试。跑一遍,看报告,让 Hermes 沿着图谱回答几个关系型问题。你大概十分钟就能感受到区别。
让 Agent 先认路,再干活——这件事不难,但能省掉后面无数的重复解释。