代码库分析

用内置的分析工具理解代码结构——项目概览、文件语义、跨文件符号追踪，为重构与调试打底。

内置分析工具

ChengYoung 内置了代码分析扩展（默认开启），为 Agent 提供 analyze 工具：理解代码结构、追踪符号使用、探索跨文件调用图，支持多种主流编程语言。你不需要记参数——用自然语言说需求即可。

三种分析模式

项目结构概览

分析一个目录，了解项目组织、识别大文件、看整体指标：

• 「分析一下 src/ 目录的结构」
• 「这个项目的主入口在哪？」

文件语义详情

查看单个文件的函数、类与导入关系：

• 「main.py 里有哪些函数？」
• 「给我看看 src/utils.py 的结构」

符号跨文件追踪

聚焦某个函数或类，看它在哪里定义、被谁调用、调用了谁——重构与调试的利器：

• 「追踪 authenticate 函数的调用链」
• 「UserClass 在哪些地方被使用？」

处理大输出

分析结果超过 5 万字符时，工具会返回警告而不是完整结果。此时可以：

• 缩小范围：只分析具体的子目录或文件；
• 降低深度：目录分析限制子目录层级；
• 让 Agent 分段汇总：先分析再让它总结要点，避免一次性灌入超长输出。

实践建议

• 从小范围开始（具体文件或子目录），再扩展到整个项目；
• 用 .gitignore 排除 node_modules/、构建产物等无关目录，分析更快更聚焦；
• 分析结论要与实际代码对照——工具给出的是结构事实，业务含义由你判断。

本页基于上游开源文档（Apache-2.0）改写，已修改；来源与变更见 /legal/provenance。