Cognition（Windsurf）宣布在其 IDE 上线 Codemaps 功能，核心目标是为工程师与 AI 建立对同一代码库的共享理解，减少“低理解度快改动”带来的质量滑坡。官方博客于 2025 年 10 月 29 日发布介绍，称 Codemaps 能按任务即时生成代码地图，展示结构、数据流与依赖，并可在列表与可视化两种视图间切换，点击节点直达相关代码行。产品传播语强调“Fight slop with Codemaps”，突出“先理解、再修改”的工作流。
从公开演示与社区帖可见，Codemaps 已在 Windsurf 内侧边栏启用，用户可通过快捷键或图标打开，输入任务提示后生成对应映射；生成时可选择 Fast（SWE-1.5）与 Smart（Sonnet 4.5）模式。相关讨论认为，该功能与此前的 DeepWiki、Cascade 等能力协同，适用于在大型或遗留代码库中定位变更影响、梳理控制流与依赖。不过，具体效果仍取决于仓库规模、索引完整度与模型选择，实际收益需要在团队场景中验证。
常见问题
Q：Codemaps 具体做什么？
A：在 Windsurf IDE 内基于当前仓库与任务提示生成“代码地图”，以结构视图与可视化图展示模块关系、数据流和依赖，节点可一键跳转到对应代码位置。
Q：什么时候上线的？
A：官方博客在 2025 年 10 月 29 日详述该功能；随后在官方 X 与社区帖中以“Codemaps is now live”进行传播，面向用户推送。
Q：需要哪些模型或配置？
A：生成地图时可在 Fast（SWE-1.5）与 Smart（Sonnet 4.5）间选择；不同模式在速度、细节与成本上权衡，适配不同任务。
Q：与 DeepWiki、Cascade 有何关系？
A：Codemaps侧重“即时理解与导航”，可与文档化（DeepWiki）与自动化执行（Cascade/代理）配合，先建立共享认知，再驱动修改与实现。
Q：是否能解决“AI slop code”问题？
A：Codemaps通过提升代码理解度以降低风险，但并非保证质量的单点解；代码评审、测试与依赖安全等工程实践仍必不可少。
