AI 编码工具公司 Cognition 宣布推出 Windsurf Codemaps——一项专注于帮助开发者快速理解大型代码库结构的新功能，旨在解决工程师在进入陌生项目、切换任务时面临的高成本“代码理解”难题。

Cognition 指出，许多工程师往往需要数周甚至数月才能熟悉复杂系统，而现有 AI 工具更偏向代码生成，缺乏对“跨文件、跨模块结构理解”的支持。Codemaps 的目标是补足这一短板。

Codemaps 的核心能力包括：

• 自动分析仓库结构，生成清晰的代码地图，以层级方式展示功能与文件的关系。

• 提供文本视图与可视化图形视图，用户可点击节点直接跳转到对应代码位置。

• 可在 Windsurf 的 Cascade agent 中通过 @{codemap} 调用地图，为调试、修复、重构等任务提供结构化的上下文。

• 支持两种模型模式：Fast（SWE-1.5）和 Smart（Sonnet 4.5），以平衡速度与质量。

使用流程：

1. 在 Wind­surf 中打开代码库，触发 Codemaps（点击地图图标或快捷键 Cmd+Shift+C）

2. 输入你当前任务（如“找到 auth 流程在哪里”）或使用系统建议。

3. 选择模型等级：“Fast”（基于 SWE-1.5）或“Smart”（基于 Sonnet 4.5）

4. 系统生成：

   • 一个文本结构化 map，分组、嵌套展示代码相关功能、组件、文件。

   • 可切换到“可视化图形视图”，点击节点即可跳转到具体代码位置。

   • 在生成的 trace guide 中可展开更详细的解释，说明为何这些代码行被归为同一组。

5. 在 Wind­surf 的 Cascade agent 环境中，你还可以在 prompt 中通过 @{codemap} 插入该 map（整体或部分）以为 agent 提供结构化上下文，从而提升相关任务（比如调试、理解、重构）的效率与准确度。

Cognition 强调，Codemaps 的理念是让开发者在利用 AI 写代码之前，先“看懂系统结构”，避免盲目生成代码带来的质量风险。官方也透露未来将探索团队协作标注、共享 codemap 以及潜在的通用 .codemap 文件格式等方向。