一、问题AI 根本“读不懂”你的项目最近在用 ChatGPT / Claude 做代码分析的时候遇到一个很现实的问题项目太大根本喂不进去压缩包读取费力幻觉严重具体表现仓库文件太多token 限制几万字直接爆直接复制代码 → AI 完全理解不了结构业务代码 配置 垃圾文件混在一起结果就是AI给的答案不准甚至直接完全胡说二、我做了个工具Repo2AI为了解决这个问题我写了一个小工具 Repo2AI把一个代码仓库转成AI可以阅读的具有结构的上下文文件包三、核心思路1️⃣ 分类代码比如 Java 项目Controller Service Entity SQL / Mapper AI 更容易理解结构2️⃣ 自动分片支持5MB / 10MB / 自定义大小 直接解决 token 限制问题3️⃣ 清理无用文件自动忽略target/ .git/ .idea/ logs/ node_modules/ 避免污染 AI 上下文四、效果是什么执行一条命令repo2ai scan ./my-project输出output/ ├── project-summary.md ├── controllers_01.md ├── services_01.md ├── entities_01.md ├── sql_01.md └── manifest.json这些文件可以 直接喂给 ChatGPT / Gemini五、适合什么场景阅读老项目用 AI debug 复杂系统做代码分析给 Cursor / Copilot 提供上下文新人快速理解项目结构六、为什么不用现有工具比如一些 repo 打包工具如 repomix问题在于只是全文复制进txt没有结构不利于ai理解ai幻觉严重。而 Repo2AI按代码类型分类支持分片专门为 AI 设计七、目前支持Java 项目优先优化CLI 使用Markdown / TXT 输出八、后续计划v0.2 - GUI 界面 - ZIP 导出 v0.3 - Spring Boot 深度解析 - 多语言支持九、开源地址 https://github.com/fichil/Repo2AI有 Demo GIF可以直接看效果十、最后如果你也在用 AI 做开发这个工具应该能帮你省不少时间。欢迎试用有问题可以提 issue。