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

# Codemaps

> 创建可共享的代码库层级地图，直观呈现代码执行流程和组件关系，便于浏览并与团队成员共享。

由专用 Agent 驱动，Codemaps 是一种可共享的工件，能够弥合人类理解与 AI 推理之间的差距，让你能够以精准且具备上下文的方式浏览、讨论和修改大型代码库。

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

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

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

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/codemaps/codemaps-overview.mp4?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=7d8126d4f920b432a89d0d52f15103e5" data-path="desktop/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/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/codemaps/create-codemaps.mp4?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=3ecbec63e167aee9815b113dababcd8b" data-path="desktop/assets/windsurf/codemaps/create-codemaps.mp4" />

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

你可以将 Codemaps 以链接形式分享给团队成员，他们可在浏览器中查看。

<Warning>
  对于 Enterprise 客户，分享 Codemaps 需要选择加入，因为这些内容需要存储在我们的服务器上。默认情况下，Codemaps 仅在你的团队内可见，且查看时需要身份验证。
</Warning>

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

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

你可以通过 `@-mention` 引用 Codemap，将 Codemap 信息作为上下文添加到你的 [Cascade](/zh/desktop/cascade) 对话中。

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