Romany-splay794/RepoMap-AI

GitHub: Romany-splay794/RepoMap-AI

一款面向 AI 辅助编程场景的代码库依赖图谱工具,通过 tree-sitter 解析和 PageRank 排序为大型项目构建精简的结构视图,帮助 LLM 突破上下文窗口限制。

Stars: 0 | Forks: 0

# 🗺️ RepoMap-AI - 清晰的代码图谱,更快的开发效率 [![下载 RepoMap-AI](https://img.shields.io/badge/Download-RepoMap--AI-1f6feb?style=for-the-badge&logo=github)](https://github.com/Romany-splay794/RepoMap-AI/releases) ## 🚀 RepoMap-AI 的功能 RepoMap-AI 帮助您理清代码库。它会扫描文件,构建各部分如何连接的图谱,并为 AI 工具提供一个更小、更清晰的项目视图。 当一个项目大到无法一眼看穿时,它非常有用。您无需逐个阅读文件,而是可以使用图谱优先找到关键所在。 RepoMap-AI 通过 MCP 与 Cursor、VS Code 和 Claude Desktop 等工具协同工作。它还支持 Python、TypeScript 及其他常见语言的代码。 ## 📥 下载 RepoMap-AI 访问此页面下载 Windows 版本: [从 GitHub Releases 下载 RepoMap-AI](https://github.com/Romany-splay794/RepoMap-AI/releases) 在 Releases 页面上,选择最新版本并下载与您的系统相匹配的 Windows 文件。如果您看到多个文件,请选择适用于 Windows 的那个。 ## 🪟 在 Windows 上安装 1. 打开下载页面。 2. 下载 Windows 发布文件。 3. 打开您的“下载”文件夹。 4. 找到您刚刚下载的文件。 5. 双击该文件以启动它。 6. 如果 Windows 请求权限,请选择“运行”或“是”。 7. 按照屏幕上的提示操作,直到安装完成。 如果文件在 .zip 压缩包中,请右键单击它并选择“全部提取”,然后再打开应用程序。 ## ⚡ 首次运行 1. 安装后启动 RepoMap-AI。 2. 打开您想要映射的代码库所在的文件夹。 3. 让应用程序扫描文件。 4. 等待依赖图构建完成。 5. 打开您的 AI 编辑器或桌面应用程序。 6. 如果应用程序要求提供设置详细信息,请通过 MCP 进行连接。 首次扫描在较大的项目上可能会花费一些时间。之后,当您再次打开同一个代码库时,应用程序可以重用该图谱。 ## 🧭 使用方法 RepoMap-AI 专为简单的日常使用而构建: 1. 选择一个项目文件夹。 2. 让应用程序读取文件。 3. 查看已排序的文件链接图谱。 4. 使用图谱查看哪些文件最重要。 5. 在需要更多上下文时,将结果发送给您的 AI 工具。 这有助于您回答以下问题: - 应用程序从哪里启动? - 哪些文件依赖于这个文件? - 代码的哪些部分属于同一块? - 我应该先阅读哪些文件? ## 🛠️ 功能特性 - 扫描代码文件夹并构建项目图谱 - 读取 Python、TypeScript 和其他受支持类型的文件 - 使用 tree-sitter 解析代码结构 - 对文件链接进行排序,使关键部分优先显示 - 通过 MCP 暴露图谱 - 与 Cursor、VS Code 和 Claude Desktop 协同工作 - 帮助 AI 工具保持上下文精简和专注 - 支持大型项目中的代码库导航 ## 🖥️ 系统需求 RepoMap-AI 应可在标准的 Windows PC 上运行。 建议配置: - Windows 10 或 Windows 11 - 现代的 64 位 Intel 或 AMD CPU - 8 GB 或更多 RAM - 200 MB 的可用磁盘空间(用于安装应用) - 用于存放大型代码库的额外空间 - 首次下载需要连接互联网 为获得最佳效果,请在内存足以支持您要扫描的代码库的机器上使用。 ## 🔌 连接 AI 工具 RepoMap-AI 可以将其图谱发送给支持 MCP 的工具。这使得 AI 助手无需一次性加载整个项目就能更轻松地处理您的代码。 常见用途: - Cursor:用于代码编辑和审查 - VS Code:用于本地开发 - Claude Desktop:用于基于对话的帮助 如果您的工具支持自定义连接,请在应用程序运行后在其中添加 RepoMap-AI。 ## 📁 扫描内容 RepoMap-AI 主要针对源代码和项目文件。它最适合处理: - Python 文件 - TypeScript 文件 - JavaScript 文件 - 其他由 tree-sitter 支持的语言 - 项目使用的配置文件 它专注于结构、导入和文件链接,以便图谱能够展示代码是如何组合在一起的。 ## 🔍 适用场景 在以下情况使用 RepoMap-AI: - 项目文件过多,无法一次性阅读时 - 您想要快速查看重要的代码路径时 - 您需要为 AI 编码工具提供更好的输入时 - 您想查看文件之间的相互依赖关系时 - 您需要为大型代码库缩减上下文窗口时 ## 🧩 典型工作流 1. 从 GitHub Releases 下载应用程序。 2. 在 Windows 上安装或打开它。 3. 选择包含您代码的文件夹。 4. 构建图谱。 5. 打开您的 AI 编辑器。 6. 使用图谱来指导提问和编辑。 这能避免您手动在整个项目中进行盲目搜索。 ## 🧰 故障排除 如果应用程序无法启动: 1. 检查下载是否已完全完成。 2. 确保 Windows 没有阻止该文件。 3. 尝试以管理员身份再次运行它。 4. 确认您的杀毒软件没有将其删除。 如果应用程序打开但未显示图谱: 1. 检查您是否选择了正确的文件夹。 2. 确保该文件夹包含源文件。 3. 等待扫描完成。 4. 先尝试一个较小的项目。 如果您的 AI 工具无法连接: 1. 确认 RepoMap-AI 正在运行。 2. 检查编辑器中的 MCP 设置。 3. 重启编辑器和应用程序。 4. 再次尝试连接 ## 📌 项目重点 RepoMap-AI 围绕几个明确的目标而构建: - 保持代码上下文精简 - 使大型项目更易于阅读 - 将重要文件排在前面 - 支持常见的 AI 编码工具 - 帮助用户更轻松地浏览代码 ## 📝 文件类型与解析 该应用程序使用 tree-sitter,以便能够可靠地读取代码结构。这有助于它找到导入、符号以及文件之间的链接。 它可以处理许多常见的项目布局,包括: - 应用程序源码文件夹 - 测试文件夹 - 配置文件 - 共享库 - 包和构建文件 ## 🪄 图谱为何重要 依赖图显示了文件是如何连接的。这很重要,因为代码库通常包含许多肉眼难以察觉的链接。 借助排序后的图谱,RepoMap-AI 可以帮助您: - 优先找到最重要的文件 - 梳理逻辑的流向 - 了解更改可能会波及的范围 - 减少猜测所花费的时间 ## 📎 再次下载 如果您再次需要安装程序,请使用此处的发布页面: [https://github.com/Romany-splay794/RepoMap-AI/releases](https://github.com/Romany-splay794/RepoMap-AI/releases) 选择最新的 Windows 版本并下载适用于您系统的文件。 ## 🔐 隐私与本地使用 RepoMap-AI 旨在与您的本地代码库配合使用。由您选择文件夹,应用程序读取您机器上的文件来构建图谱。 ## 🏷️ 主题 ai, ai-coding, claude-code, code-analysis, codebase-navigation, context-window, cursor, dependency-graph, llm, mcp, pagerank, python, repomap, token-efficient, tree-sitter, typescript, vscode
标签:AI编程助手, Claude Desktop, Cursor, DLL 劫持, LLM辅助编程, MCP, Model Context Protocol, Python, Repo Map, TypeScript, VS Code, 上下文窗口, 上下文管理, 代码依赖解析, 代码可视化, 代码地图, 代码库分析, 代码搜索, 代码生成辅助, 代码索引, 依赖关系图, 大语言模型, 威胁情报, 安全插件, 开发效率, 开发者工具, 无后门, 网络可观测性, 逆向工具, 错误基检测, 静态代码分析