逻瞳 · 代码智能分析平台
TypeScript · Node.js / Fastify · Vue3 / Vite · AntV G6 · tree-sitter · MCP · ReAct Agent · RAG个人独立开发的「代码知识图谱 + 智能问答」平台(逻瞳 / Logipulse):以多语言 AST 构建符号级知识图谱,以 RAG 与 ReAct Agent 提供中文代码问答,并通过 MCP 将同一份可追溯的结构化代码事实开放给 Claude Code 等 AI 编程助手。
- 代码知识图谱与事实底座:基于 TypeScript Compiler API、@vue/compiler-sfc 与 tree-sitter 解析 TypeScript / Vue / Java,抽取函数、组件、接口、路由及 calls / imports / injects 等关系;通过 endpoint 归一建立跨语言桥,在同一张图中打通「前端请求 → 后端 handler → 下游依赖」。
- RAG 与语义召回:设计结构化检索与 Embedding 语义召回相结合的问答管线,使用本地 Ollama / bge-m3 构建文件语义索引,桥接中文业务问题与英文代码标识符;向量服务超时或不可用时自动降级为关键词检索。
- ReAct Agent 与工具编排:实现「模型推理 → 并行工具调用 → 结果回灌 → 继续推理」的 Agent Loop,支持代码搜索、文件读取、符号定位和调用链追踪;复杂任务先生成执行计划,简单问题直接进入分析,规划失败可自动降级。
- 循环防护与上下文工程:对「工具 + 参数」进行请求级缓存和重复计数,重复调用时注入纠偏提示,连续无新进展则强制收尾;通过渐进式上下文压缩保留文件路径和读取范围,并以最大轮次、单次调用及总时长进行多级超时控制。
- 对话记忆与多模型适配:使用 SQLite 持久化多轮对话和跨会话项目记忆,结合关键词与向量召回注入相关事实;统一适配 DeepSeek、OpenAI 兼容模型、Ollama 与阿里百炼,并通过 SSE / WebSocket 展示 Agent 过程和索引进度。
- MCP 与 AI 编码集成:自研 @aiops/mcp stdio 服务,向 Claude Code 暴露 9 个只读分析工具;在原子工具之上提供 prepare_fix_context 与 get_impact_scope,输出修改入口、关键流程、验证建议及上下游影响面,并通过 ANALYZER_REPO 锁库避免跨仓查询错误。
- 评测驱动开发(L1–L4 可回归):搭建检索 / 引用 / 答案 / 观测四层评测——引用准确率经确定性核对源码从 25% 提升至 92%(据此定位并修复 Vue SFC 行号偏移的真实 parser bug),检索改用 RRF 融合使 Recall@10 从 0.556 提升至 0.778,并接入 Langfuse 自托管观测 + 抽样 LLM-judge 打分回写告警。