Hybrid RAG

Hybrid RAG 是一款专为代码仓库设计的 AI 助手，它采用混合检索增强生成技术，将 Okapi BM25 稀疏检索与稠密语义向量搜索相结合，并通过 Reciprocal Rank Fusion（k=60）算法融合结果，从而提供精准、上下文相关的回答。该工具以零云依赖为核心理念，所有检索和生成过程均在本地 SQLite FTS5 中完成，确保数据隐私和低延迟。

核心功能

• 混合检索：结合 BM25 关键词匹配与语义向量搜索，兼顾精确性和语义理解，显著提升答案相关性。
• Markdown 感知分块：智能识别 Markdown 结构，生成语义完整的文本块，并支持确定性行号引用（如 [file#L-L]），方便用户追溯答案来源。
• 零云执行：完全本地运行，无需外部云服务，数据不出库，适合敏感代码库。
• GitHub Action 集成：可轻松嵌入 CI/CD 流程，自动为仓库生成文档或回答问题。

主要特性

• 高精度引用：每个回答都附带精确的代码行号，便于快速定位。
• 零依赖打包：使用 @vercel/ncc 打包，无外部运行时依赖，部署简单。
• 可定制分块：支持自定义分块大小和重叠，适应不同文档结构。
• 快速部署：通过 GitHub Action 一键配置，无需服务器。

适用场景

• 代码文档生成：自动为大型仓库生成结构化的文档摘要。
• 智能代码问答：开发者可针对特定代码段提问，获得带引用的解答。
• 私有仓库分析：适合企业内网或敏感项目，确保代码不泄露。

Hybrid RAG 为开发团队提供了一种高效、安全、可追溯的 AI 辅助工具，让代码理解和文档维护变得前所未有的简单。