项目与模块概览生成

解决的问题

接手陌生仓库时，README 往往只说明“能做什么”，很少回答“内部如何分工、从哪里开始读代码、关键调用链如何走”。project-overview-generator 把代码结构、入口文件、依赖关系和典型流程整理成一份面向工程师的 Markdown 说明，降低阅读源码前的准备成本。

工作方式

• 范围识别：先判断输入是本地路径还是 Git 链接，再选择项目级或模块级分析。
• 结构提取：识别语言、框架、入口、核心目录、核心函数/类，并梳理模块间依赖。
• 文档生成：输出架构、关键流程、真实代码片段与 Mermaid 图；模块级还会枚举对外 API 和上游调用方。

适用边界

它不是代码审计、安全扫描或性能分析工具。输出质量依赖仓库命名、注释、目录约定和公开程度；私有仓库需要可访问凭据。模块级文档不假设模块可独立启动，无法从代码推断的信息会标记为待补充。