用途
Code Cartographer 用于分析和映射遗留代码库中的架构、数据流与风险,将复杂、缺乏测试的代码转化为可视化图表与可操作建议。
主要能力
- 定位目标:根据函数名或文件路径,使用 Glob 查找文件、Grep 定位具体函数或类。
- 映射调用关系:追溯调用方(谁使用了它)和被调用方(它使用了什么)。调用栈向上最多 5 层,依赖树向下最多 3 层。
- 检测副作用:识别全局状态变更(全局变量、单例修改、静态类变量)、外部系统交互(数据库查询、HTTP 请求、文件系统操作、环境变量读取)以及隐藏行为(事件监听、定时器注册、日志监控、抛出的异常)。
- 过滤噪声:排除 node_modules、vendor、third_party、dist、build、out、.next 等目录,以及测试文件和生成文件,聚焦 src、lib、app 下的应用代码和自定义业务逻辑。
- 可视化与总结:生成 Mermaid 流程图,标注外部系统与全局状态,并给出风险清单和简明摘要。
使用方式
输入函数名或文件路径即可触发分析。工作流分为五步:
- 使用 Glob 查找文件,再用 Grep 定位函数或类。
- 追踪调用方与被调用方,限制分析深度以避免无限递归,在标准库、框架方法、第三方库边界处停止。
- 扫描目标及其直接依赖中的风险信号,涵盖全局状态修改、外部系统交互、隐藏行为。
- 排除 vendor、node_modules、构建产物、测试与生成文件,聚焦自定义业务逻辑。
- 输出 Mermaid 流程图、"Don't Touch" 列表和英文简明摘要。
Mermaid 图使用颜色编码:红色/粉色(#ff9999)表示外部系统(数据库、API),橙色(#ffcc99)表示全局状态或副作用,蓝色/白色表示纯函数与本地逻辑。
"Don't Touch" 列表用于标识:被 5 个以上文件调用的高耦合文件、包含关键副作用(数据库模式、认证逻辑、支付处理)的文件、缺乏测试且修改敏感状态的文件。
适用场景
适用于以下请求:
- "这个函数是做什么的?"
- "这段代码在代码库中被用在哪里?"
- "我想重构但担心破坏其他部分。"
- "梳理 [功能/模块] 的架构。"
- "调用它会有什么副作用?"
- "谁依赖这个文件?"
限制
不适用于简单语法问题、单行代码解释,也不用于生成新代码。分析设有搜索深度限制:调用栈最多向上 5 层,依赖树最多向下 3 层,并在框架和库边界停止。