AI 编码工具公司 Cognition 宣布推出 Windsurf Codemaps—— 一项专注于帮助开发者快速理解大型代码库结构的新功能，旨在解决工程师在进入陌生项目、切换任务时面临的高成本 “代码理解” 难题。
Cognition 指出，许多工程师往往需要数周甚至数月才能熟悉复杂系统，而现有 AI 工具更偏向代码生成，缺乏对 “跨文件、跨模块结构理解” 的支持。Codemaps 的目标是补足这一短板。
Codemaps 的核心能力包括：
-
自动分析仓库结构，生成清晰的代码地图，以层级方式展示功能与文件的关系。
-
提供文本视图与可视化图形视图，用户可点击节点直接跳转到对应代码位置。
-
可在 Windsurf 的 Cascade agent 中通过
@{codemap}调用地图，为调试、修复、重构等任务提供结构化的上下文。 -
支持两种模型模式：Fast（SWE-1.5）和 Smart（Sonnet 4.5），以平衡速度与质量。
使用流程：
-
在 Windsurf 中打开代码库，触发 Codemaps（点击地图图标或快捷键 Cmd+Shift+C）
-
输入你当前任务（如 “找到 auth 流程在哪里”）或使用系统建议。
-
选择模型等级：“Fast”（基于 SWE-1.5）或 “Smart”（基于 Sonnet 4.5）
-
系统生成：
-
一个文本结构化 map，分组、嵌套展示代码相关功能、组件、文件。
-
可切换到 “可视化图形视图”，点击节点即可跳转到具体代码位置。
-
在生成的 trace guide 中可展开更详细的解释，说明为何这些代码行被归为同一组。
-
在 Windsurf 的 Cascade agent 环境中，你还可以在 prompt 中通过
@{codemap}插入该 map（整体或部分）以为 agent 提供结构化上下文，从而提升相关任务（比如调试、理解、重构）的效率与准确度。
Cognition 强调，Codemaps 的理念是让开发者在利用 AI 写代码之前，先 “看懂系统结构”，避免盲目生成代码带来的质量风险。官方也透露未来将探索团队协作标注、共享 codemap 以及潜在的通用 .codemap 文件格式等方向。
