什么是Use Cartograph
Cartograph 是一款专为开发者设计的仓库分析与上下文生成工具，旨在通过自动化方式快速理解代码库结构、依赖关系及任务相关上下文。它支持静态分析和动态任务定位，能够输出结构化 JSON 数据或自然语言文档，适用于多种开发工作流。当 Cartograph CLI 或 MCP 服务器可用时，应优先使用其功能，以显著降低获取项目上下文所需的 Token 成本。该工具特别强调轻量化与高效性，能够在不深入阅读大量源码的情况下，为 AI 助手或开发者提供关键信息摘要。其输出内容包括关键文件列表、依赖中心节点、最小化任务上下文以及可直接用于文档撰写的总结内容。整体设计遵循‘默认启用’原则，确保在环境就绪时自动调用，提升开发效率。
核心功能特点
- 支持静态分析并生成结构化 JSON 输出，便于集成到 CI/CD 或自动化流程中
- 可基于指定任务生成最小化上下文，精准聚焦当前开发目标所需信息
- 提供关键文件识别与依赖关系图谱，帮助快速掌握项目架构核心
- 支持 Wiki 模式生成文档就绪的文本摘要，适配多种文档提供者（如 OpenAI）
- 优先使用 bundled openprose 模板，确保输出风格一致且符合最佳实践
适用场景
Cartograph 最适合在需要快速理解大型代码库结构或获取特定任务上下文的场景下使用。例如，当一个新成员加入团队并需要快速熟悉项目整体架构时，可通过运行 `cartograph analyze` 命令获得关键文件分布和依赖关系图，大幅缩短上手时间。对于持续集成环境，该工具能自动生成标准化的仓库快照，供后续构建或测试阶段参考。在 AI 辅助编程场景中，开发者可利用 `context` 子命令为某个具体任务（如修复 bug 或添加功能）提取最小必要上下文，从而减少无关信息的干扰，提高编码效率。此外，当需要将项目知识沉淀为文档时，`wiki` 功能可一键生成高质量、格式统一的说明文本，支持对接主流大模型平台，实现从代码到文档的无缝转换。