AI 写代码总跑偏？试试给 AI 画张地图

你有没有遇到过这种情况：让 Claude Code 或者 Cursor 去改个功能，它吭哧吭哧打开了一堆文件，二十分钟后才找到真正需要改的地方——然后告诉你这个需求做不了，因为"架构不支持"。

这事儿我遇到过不止一次了。说实话，现在 AI 编程助手最大的短板就是这个：上下文感知能力几乎为零。

为什么 AI 总在乱翻？

AI 编程助手本质上是个"盲人"。

你给它正确的上下文，它能写出漂亮的代码。但你要是让它自己去找该看哪些文件，那完了——它可能按字母顺序翻，可能按 import 顺序翻，也可能随机翻。反正就是不知道你项目里谁是谁、谁依赖谁、哪些是核心逻辑、哪些是祖传代码没人敢动。

于是就出现了文章开头那一幕：四十个文件看完了，脑子里一团浆糊，改出来的东西跟你项目完全不搭。

Mycelium 是什么？

Mycelium 做的事情很简单：给你的代码库画一张地图。

不是那种简单的文件列表，而是包含所有依赖关系、文件功能的完整图谱。AI 想要改东西的时候，直接问这张地图，Mycelium 告诉它："你需要看这 4 个文件，分别是干这个的、那个的……"

使用流程也不复杂：

npx @kopikocappu/mycelium init

跑一遍，Mycelium 会：

• 解析整个代码库
• 解析所有 import 关系
• 构建依赖图谱
• 用 Claude Haiku 给每个文件写一段"人话"描述

之后每次让 AI 干活之前，先跑一下 /preflight，告诉它你要做什么，它就返回真正相关的文件——4 个，不是 40 个。

几个实用的功能

可视化图谱

打开浏览器就能看到你整个项目的结构图。文件是节点，import 是连线，一目了然。新人入职看两眼就大概知道项目怎么组织的了，这个功能我觉得挺值回"票价"的。

修改记录

每次 AI 改了什么文件、什么时间、改了什么任务，全部记下来。这东西以前 AI 编程工具里是没有的，现在终于有了审计日志。

语义搜索

不用记文件名。搜"支付逻辑"，就算代码里从来没出现过"支付"这两个字，Mycelium 也能给你找到相关文件。对于那种代码写了七八年、命名已经放飞自我的项目，这个功能相当救命。

本地运行，隐私有保障

有一点对企业和团队很重要：Mycelium 跑在你本地机器上，端口 localhost:47821。你的代码不会上传到任何地方，不是什么云端服务在分析你的商业逻辑——就是个本地小工具，安安静静干活。

值不值得装？

说句实在话，如果你就写个小项目，代码文件一只手数得过来，那确实没必要折腾。

但如果你是团队作战、项目上了规模，或者经常被 AI 助手气得想把键盘扔了——Mycelium 确实能帮你省不少时间。装一次，后续每次都省心。

说白了，就是给你的 AI 编程助手配一张地图。别再让它蒙着眼睛乱跑了。