> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codemaps

> 创建可共享的代码库分层映射，用于可视化代码执行流程和组件关系，并支持导航与团队共享。

由专用代理驱动，Codemaps 是可共享的产物，连接人类理解与 AI 推理，使你能够在充分语境下精准地浏览、讨论并修改大型代码库。

<div id="what-are-codemaps">
  ## 什么是 Codemaps？
</div>

虽然 [DeepWiki](/zh/windsurf/deepwiki) 提供符号级文档，Codemaps 通过梳理各部分如何协同运作来帮助理解代码库——展示代码与文件的执行顺序，以及不同组件之间的关联关系。

要浏览 Codemap，点击任意节点即可立即跳转到对应的文件和函数。Codemap 中的每个节点都直接链接到你代码中的相应位置。

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/codemaps-overview.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=e8b8990690ec210cced0f78ba1969fac" data-path="assets/windsurf/codemaps/codemaps-overview.mp4" />

<div id="accessing-codemaps">
  ## 访问 Codemaps
</div>

你可以通过以下两种方式访问 Codemaps：

* **活动栏**：在活动栏 (左侧面板) 中找到 Codemaps 界面
* **命令面板**：按下 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) ，然后搜索“Focus on Codemaps View”

<div id="creating-a-codemap">
  ## 创建 Codemap
</div>

要创建新的 Codemap：

1. 打开 Codemaps 面板
2. 通过以下方式创建新的 Codemap：
   * 选择一个推荐主题 (推荐内容基于你最近的导航历史)
   * 输入自定义提示
   * 从 Cascade 生成：在 Cascade 对话底部创建新的 Codemap
3. Codemap agent 会探索你的代码库，识别相关文件和函数，并生成分层视图

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/create-codemaps.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=ea5da928e3e72962b2bb5f2b75b659c6" data-path="assets/windsurf/codemaps/create-codemaps.mp4" />

<div id="sharing-codemaps">
  ## 分享 Codemaps
</div>

你可以通过链接将 Codemaps 与队友分享，链接可在浏览器中查看。

<Warning>
  对于 Enterprise 客户，共享 Codemaps 需要选择加入，因为它们需要存储在我们的服务器上。默认情况下，Codemaps 仅在你的 Team 内可用，查看时需要身份验证。
</Warning>

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/share-codemaps.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=ca21fbc4275a16bef9c59026ac3b4f63" data-path="assets/windsurf/codemaps/share-codemaps.mp4" />

<div id="using-codemaps-with-cascade">
  ## 在 Cascade 中使用 Codemaps
</div>

你可以在与 [Cascade](/zh/windsurf/cascade) 的对话中，通过使用 `@-mention` 引用某个 Codemap，将其信息作为对话上下文包含进去。

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/codemap-cascade.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=500ca2181f5ec83c309a3994e70499dc" data-path="assets/windsurf/codemaps/codemap-cascade.mp4" />