CodeCompass

CodeCompass 是什么？

🛠️ CodeCompass 是一个基于 Node.js 的开发辅助工具，它连接你的 Git 仓库和主流 AI 模型（如 Claude、Ollama、OpenAI），把代码库转化为可交互的智能上下文源。它不生成营销话术，也不承诺自动写完所有功能，而是专注于解决一个实际问题：让 AI 更懂你正在写的代码。

为什么需要它？

以往你在 IDE 里向 AI 提问，比如“这个函数为什么报错”，AI 往往只能看到当前文件甚至几行片段。你要额外解释依赖关系、项目结构、最近的修改逻辑，沟通成本高，回答也容易跑偏。更麻烦的是，团队来了新人，没人能立刻理清三年前那个模块为什么这样设计。

CodeCompass 改变了这一点。它直接接入 Git 仓库，自动分析历史提交、文件结构和注释内容，并将这些信息结构化存储在 Qdrant 向量数据库中。当你提问时，系统不会盲猜，而是从已知的代码脉络里提取相关片段，提供给 AI 作为上下文。你不需要再手动复制粘贴背景信息，AI 的回复自然更准、更快。

核心能力速览

自动代码库索引：工具会定期扫描 Git 仓库，提取函数定义、模块依赖和关键注释，存入向量数据库。数据按语义关联组织，查询时能快速定位到相关代码段，而不是全文检索。

动态上下文注入：你在 VSCode 或 Cursor 中提问时，CodeCompass 自动拼接当前编辑位置 + 相关模块摘要 + 最近变更记录，形成完整的上下文发送给 AI。这意味着你问“这里怎么改”时，AI 知道“这里”指的是哪个版本下的哪次重构遗留问题。

变更同步追踪：每次 Git 提交后，工具会对比差异，更新向量库中的对应节点，并打上时间戳。AI 不会引用已被删除的接口或过时的配置，建议始终基于最新状态生成。

跨文件理解支持：面对复杂的调用链，比如前端组件触发后端 API 再调用第三方服务，CodeCompass 能串联多个文件的关键路径，帮助 AI 理解整体流程，而不仅限于单个文件内容。

适合谁？怎么用？

⚡ 如果你是使用 VSCode 或 Cursor 的前端、后端或全栈开发者，经常需要快速理解陌生代码、修复历史遗留 bug，或者在复杂项目中做重构，CodeCompass 能减少重复的信息整理工作。

它特别适合维护中大型项目、多人协作频繁、文档更新滞后的团队。新成员接入时，可以直接通过问答方式获取上下文，不必逐条翻看 Git 历史。

建议从一个非核心模块开始尝试：部署 CodeCompass，连接测试仓库，提几个具体问题（例如“用户权限是怎么校验的？”），观察返回结果是否覆盖了多文件逻辑。如果响应准确且节省了解读时间，再推广到主干项目。