夜雨聆风
今天用 gh cli 查了一下 star 数。codegraph 六万五千多颗，iwe 一千三百多颗。差着五十倍。这两个工具做的事其实一样，只是对象不同。codegraph 给代码建图，iwe 给笔记建图。接进同一个 AI 编程助手之后，token 账单能砍掉六成。
先说 codegraph 解决的麻烦
AI coding agent 接手一个陌生项目，干活之前要先摸清结构。它的方式是 grep、列目录、读文件，一个文件一个文件翻，在脑子里重新拼出调用关系。这套动作每开一次新会话重来一遍，token 全花在认路上。
codegraph 官方做过一组对照实验。用 Claude Opus 4.8 在七个开源项目上跑同一个架构问题，一边有图，一边没图。Excalidraw 那个仓库，没图的 agent 调了 43 次工具，读了 18 个文件，耗时两分四十二秒。有图的那边，2 次调用，45 秒，一次文件都没读。
这组数字里我最在意的倒是另一个细节。做实验的人发现，对照组 28 次运行里有 26 次，agent 自己从 PATH 里摸到了 codegraph 的命令行，偷偷用上它。为了让对照成立，他们只好把两边的 CLI 都锁掉。agent 比谁都清楚哪条路省力。
装起来三条命令。Windows 上用 PowerShell 跑官方安装脚本，或者 npm 全局安装。然后 codegraph install 让它自动配置机器上的 agent，Claude Code、Cursor、Codex、Gemini CLI 都认。最后在项目目录里 codegraph init，索引建好，之后不用管。它有一个文件监听器，你保存一次文件，零点几秒后图就同步了。
# 安装（二选一）irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iexnpm i -g @colbymchenry/codegraph# 接入你的 agent，自动检测本机装了哪些codegraph install# 在项目目录里建图codegraph init原理不复杂。它用 tree-sitter 把代码解析成符号和调用边，存进项目目录下的一个本地 SQLite 数据库。agent 通过 MCP 提问，MCP 就是给 AI 接外部工具的那套标准协议。一次调用拿回相关源码、调用路径、改动影响范围。官方把这叫 surgical context，一次取准，不逐文件扫。数据全程不出本机，也不用 API key。
平均下来，七个仓库上工具调用少 88%，耗时快 53%，token 省 62%。
这里有个代价，README 自己也写了，我劝你留意。它省的是处理的 token，占住的上下文反而更多。一次调用返回的上下文太密集，会留在窗口里不走。官方测下来，多轮会话结束的时候，窗口里残留的检索内容比逐文件读的 agent 多八成上下。VS Code 那个仓库，67k 对 18k。小窗口跑长会话，要提前有数。敢把反面数字放进 README 的项目不多，这一条我反而因此更信它。
iwe 管的是笔记和项目记忆
安装之后 cd 到笔记目录，iwe init，完事。一个 markdown 文件夹，从此是一张图。
iwe 的规矩很简单。一个链接单独占一行，表示这篇笔记包含那篇。行内链接是普通引用。同一份笔记可以挂在好几个主题下面，不用复制文件。人在编辑器里用，VS Code、Neovim、Zed、Helix 都有 LSP，跳转、反链、重命名自动更新链接。AI agent 用 CLI 或 MCP，模糊搜索找到入口，一次 retrieve 把上下文连同父级笔记一起带出来。Rust 写的，官方口径两万份文档一秒内处理完。
它对 agent 还留了一手防护。agent 想写笔记，必须先声明这次改动碰几个文档、几个块，超出范围直接拒绝。frontmatter 有 schema 校验。AI 往你的知识库里写东西，得先报清单，这个设计我头一回见。
iwe 的 README 里有段话，值得单独拎出来。它说指令文件放规则，可以，CLAUDE.md、AGENTS.md 都干这个。项目记忆不要往里堆。决策、纠正、进行到哪一步，这些东西堆在一个平铺文件里，矛盾会挨着越堆越多，每条看着都像最新结论，而 agent 每次会话都要把整份重读一遍。
iwe 的做法是把记忆存成一张张互相链接的小文档，agent 用查询代替重读，图里其余部分不进上下文。笔记是 markdown，在 git 里，agent 信了什么你随时能打开看，改了哪里能 diff。已经用惯指令文件的人，可以先做一次记忆拆分，把堆在里面的决策、踩坑、进度抽出来，各自写成一篇笔记。iwe 官方还有一个 dev-workspace 模板，专门给 coding agent 当项目记忆，可以直接拿来当起点。
两个都接上以后，问题往哪边问
两个工具接进同一个 agent，分工很清楚。我把常见的问题归了一张表。
改一次代码的流程大概是 agent 先用 iwe 把相关决策笔记拉出来，再用 codegraph 一次性取回入口源码和调用路径，给出方案之前用 codegraph 预判影响面，改完把新的决策写回 iwe，写入范围它得先声明。
怎么选
你天天用 Claude Code 或 Cursor 干活，项目超过十万行，codegraph 装上的回报立竿见影，它现在六万五千颗星不是白来的。笔记超过几百篇，或者你已经在给 agent 写指令文件、感觉它越写越健忘，试试 iwe。
codegraph 六万五千星，iwe 一千三百多。我倒是建议趁 iwe 还小去试试。一千三百星的项目，接口、模板都还在稳定期，现在进去的人，意见提得最管用。
这两个工具干的其实是同一件事，让 AI 看着图纸干活，不用每次都把机器拆一遍重新认。
来源见下，数字均出自两个项目 README 的官方基准测试，日期和方法论在页面里都能查到。
• https://github.com/colbymchenry/codegraph • https://github.com/iwe-org/iwe