风帆冲浪代码图谱：在你感受之前理解代码

In this article:

在这篇文章中：

• Why Codemaps?
• 为什么选择 Codemaps?
• Our solution: Just-in-Time mapping for any problem
• 我们的解决方案：及时映射任何问题
• Fight back against Vibeslop
• 反击 Vibeslop
• What’s Next
• 接下来是什么

“Your code is your understanding of the problem you’re exploring. So it’s only when you have your code in your head that you really understand the problem.” — Paul Graham

“你的代码是你对正在探索的问题的理解。因此，只有当你在脑海中有了代码，你才真正理解这个问题。” — Paul Graham

Software development only becomes engineering with understanding. Your ability to reason through your most challenging coding tasks is constrained by your mental model of how things work — in other words, how quickly and how well you onboard to any codebase for solving any problem. However most AI vibe coding tools are aimed at relieving you of that burden by reading → thinking → writing the code for you, increasing the separation from you and your code. This is fine for low value, commodity tasks, but absolutely unacceptable for the hard, sensitive, and high value work that defines real engineering.

软件开发只有在理解的基础上才能成为工程。你在最具挑战性的编码任务中推理的能力受到你对事物运作方式的心理模型的限制——换句话说，你多快、多好地适应任何代码库以解决任何问题。然而，大多数AI vibe编码工具旨在通过阅读→思考→为你编写代码来减轻你的负担，增加你与代码之间的隔离。这对于低价值的商品任务来说是可以的，但对于定义真正工程的艰难、敏感和高价值的工作来说绝对不可接受。

We all need more AI that turns your brain ON, not OFF.

我们都需要更多能让你的大脑开启，而不是关闭的 AI。

Today we are announcing Windsurf Codemaps, which are first-of-its-kind AI-annotated structured maps of your code, powered by SWE-1.5 and Claude Sonnet 4.5. Building on our popular work from DeepWiki and Ask Devin, Codemaps is the next step in hyper-contextualized codebase understanding, grounded in precise code navigation.

今天我们宣布Windsurf Codemaps，这是首个AI注释的结构化代码地图，由SWE-1.5和Claude Sonnet 4.5提供支持。基于我们在DeepWiki和Ask Devin中的热门工作，Codemaps是超上下文化代码库理解的下一步，基于精确的代码导航。

Why Codemaps?

为什么选择 Codemaps?

Every engineering task — debugging, refactors, new features — starts with understanding. Great engineers aren’t just good at writing code; they’re good at reading it, building mental models that span files, layers, and systems.

每个工程任务——调试、重构、新特性——都始于理解。优秀的工程师不仅擅长编写代...