今天凌晨,一个叫CodeFuse的项目悄悄开源了。
才15个Stars,但解决的问题很实在:让AI Agent不再"瞎grep"。
传统AI coding agent探索代码的方式:grep → read_file → grep → read_file...
这种方式有个致命问题:每次都要重新扫描整个项目。
CodeFuse的做法不一样:把代码变成一个文件系统,Agent用ls/cat就能找到函数。
为什么grep效率低?
传统AI agent探索代码的流程:
1. grep "HelloWorld" → 找到一堆匹配(包括注释、字符串)
2. read_file → 读取文件内容
3. grep "HelloWorld" -A 10 → 找到定义
4. read_file → 读取另一个文件
5. grep "getUser" → 又是重复扫描
...问题:
举个例子:
grep HelloWorldAgent要花5-10次调用才能分辨哪个是真正的定义。
CodeFuse的核心创新
CodeFuse把代码变成了一个虚拟文件系统(VFS)。

传统方式 vs CodeFuse方式
Agent不再"瞎grep",而是直接"导航":
ls .codefuse/vfs/symbols/
cat .codefuse/vfs/symbols/HelloWorld使用方法论
第一步:安装
go install github.com/zzszmyf/codefuse/cmd/codefuse@latest第二步:索引项目
codefuse index ./my-project第三步:查询符号
codefuse query HelloWorld
codefuse query "use*"
codefuse query "*Handler"
codefuse query "get?User"
codefuse query "Api*" -k class输出:
Found 42 result(s) for 'use*':
function useAuth
File: src/hooks/useAuth.ts:4
function useDebounce
File: src/hooks/useDebounce.ts:7第四步:生成VFS视图
codefuse vfs generate项目会生成 .codefuse/vfs/ 目录:
my-project/
├── src/
│ └── main.go
└── .codefuse/
├── index.json
├── manifest.json
└── vfs/
├── symbols/ # 每个符号一个文件
│ ├── HelloWorld
│ └── ApiClient
├── outline/ # 每个源文件一个大纲
│ └── src_main.go
└── references/ # 调用关系(开发中)Agent可以直接:
ls .codefuse/vfs/symbols/ # 列出所有符号
cat .codefuse/vfs/symbols/HelloWorld # 读取符号定义支持哪些语言?
Go用的是官方go/ast解析器,零依赖,100%准确。
其他语言用tree-sitter(需要安装CLI)或regex回退。
tree-sitter vs regex
tree-sitter首次运行较慢,但后续只重新解析改过的文件。
FUSE挂载:把代码变成真正的文件系统
更酷的是:CodeFuse可以把索引挂载为真正的文件系统。
mkdir -p /tmp/mymount
codefuse mount /tmp/mymount
ls /tmp/mymount/symbols/ # 所有符号
cat /tmp/mymount/symbols/main # 符号详情
ls /tmp/mymount/outline/ # 所有源文件
cat /tmp/mymount/outline/src_main.go # 文件大纲
umount /tmp/mymount这意味着Agent可以用标准的文件操作(ls/cat/find)探索代码,不再需要特殊工具。
CodeFuse vs CodeGraph
互补关系:
• CodeFuse:快速符号查找
• CodeGraph:架构理解
适用谁?
适合:
• 使用AI coding agent的人
• 大型项目,grep扫描慢的人
• 需要让Agent"理解"代码结构的人
• Go/TypeScript/Python项目
不适合:
• 小项目(grep够用)
• 不使用AI agent的人
• 只用传统开发方式的人
项目地址
GitHub:https://github.com/zzszmyf/codefuse
README很详细,进去看看命令列表就能上手。
如果你的AI Agent每次都要"瞎grep"才能找到代码,这个工具值得今天就试试。
核心价值:把代码变成文件系统 → Agent用ls/cat就能导航 → 效率提升10倍。
夜雨聆风