CodeBuddy 提供五种高效解析项目结构的方法：一、计划模式静态分析整体目录与入口；二、@文件引用实现上下文增强式提问；三、自动生成分层架构图并支持点击展开；四、框架专属工作流深度拆解集成机制；五、模块依赖逆向查询与调用统计。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚加入一个新项目或需要快速掌握某个陌生开源项目的内部组织方式，则可能是由于缺乏上下文和文档导致理解成本过高。以下是 CodeBuddy 协助您高效解析项目结构的具体操作路径：
一、使用计划模式进行只读式代码库分析
计划模式专为探索性任务设计，它不修改任何文件，仅通过静态分析提取模块依赖、入口路径、核心类分布及调用关系图，适合首次接触项目时建立整体认知。
1、在项目根目录下启动 CodeBuddy CLI 交互模式：codebuddy
2、输入指令：切换到计划模式
3、发送自然语言请求：请分析当前项目的整体结构，列出所有顶层目录及其职责说明
4、等待 CodeBuddy 输出结构化摘要，包含各目录功能定位、关键文件作用及潜在主流程入口点。
二、基于文件引用的上下文增强式提问
通过显式引用目标文件，可强制 CodeBuddy 将其内容载入上下文，从而生成精准的模块职责说明与调用链路推演，避免泛泛而谈。
1、确认待分析的关键文件路径，例如：src/core/auth/index.ts
2、在提示中使用 @ 符号引用该文件：@src/core/auth/index.ts
3、提出具体问题：这个文件在整个认证模块中扮演什么角色？它导出了哪些函数？哪些其他文件会导入并使用它们？
4、CodeBuddy 将结合被引用文件的实际内容与项目内跨文件引用关系，给出带调用示例的职责描述。
三、触发架构图生成与分层解读
CodeBuddy 能自动识别常见架构模式（如 MVC、Hexagonal、Plugin-based），并绘制对应层级关系图，帮助您跳过手动梳理阶段，直接获取抽象模型。
1、进入已登录状态的 CodeBuddy IDE 插件界面
2、右键点击项目根目录，选择：“生成架构概览”
3、等待插件扫描完成，查看自动生成的分层视图，包括：接口层、业务逻辑层、数据访问层、配置与工具层
4、点击任一层级节点，展开该层所含文件列表及各文件的核心行为摘要。
四、执行技术框架深度解析工作流
当项目重度依赖特定框架（如 Next.js、Spring Boot、FastAPI）时，CodeBuddy 可启动预设工作流，逐层拆解框架集成方式、约定目录语义及扩展机制。
1、在 CLI 中输入：启动框架解析工作流
2、确认框架类型，例如：Next.js 14 (App Router)
3、CodeBuddy 将依次输出：路由定义位置、数据获取模式（server action / fetch）、布局嵌套规则、服务端组件与客户端组件边界
4、针对每个子项提供真实代码片段佐证，标注其在项目中的实际路径。
五、发起模块间依赖关系查询
理解模块耦合程度是判断可维护性的关键，CodeBuddy 支持逆向追溯依赖来源，快速定位高扇出或高扇入模块。
1、选定一个核心模块，例如：utils/validation.ts
2、发送查询指令：哪些文件导入了 utils/validation.ts？它们分别调用了其中的哪些导出项？
3、CodeBuddy 返回表格化结果，含每处导入的文件路径、调用函数名、调用频次统计
4、识别出被高频调用的验证函数，进一步询问：该函数是否具备副作用？是否依赖外部状态？
