一、问题：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。