CodeSense

中文 | English

面向 Vue 项目的配置驱动代码知识图谱引擎。基于 tree-sitter AST 解析、LadybugDB 图数据库、MCP 协议与 Sigma.js 可视化。

灵感来自 GitNexus，并针对 Vue/Electron 语义做了增强。

快速开始

# 一站式接入：初始化 → 索引 → 医生检查 → Wiki → 总结
npx @code-sense/core analyze

# 或者分步操作
npx @code-sense/core init --interactive
npx @code-sense/core index
npx @code-sense/core view
npx @code-sense/core serve

全局安装：

npm install -g @code-sense/core
code-sense analyze

核心能力

• 将 .vue 组件、store、路由、Electron IPC 等实体构建为图节点
• 将 import、store 调用、路由映射、IPC 通道等关系构建为图边
• 识别 Vue API 调用（如 ref、computed、watch）和 Electron 通信链路
• Living Wiki：从图谱自动生成 Markdown 项目知识库，含源码证据链接
• 增量刷新：--stale-only 仅刷新因源文件变更而过期的 Wiki 页面
• Flow Map：追踪路由→组件→store→composable→IPC 的完整业务链路
• One-Step Analyze：一站式项目入门（配置检测→索引→健康检查→Wiki）
• 提供 MCP 工具支持影响分析、调用追踪、语义检索等
• 提供浏览器图谱视图（Sigma.js）用于交互探索

命令

| 命令 | 说明 | | --- | --- | | analyze | 一站式：自动初始化、索引、医生检查、生成 Wiki、输出总结 | | index | 构建知识图谱 | | view | 启动可视化服务（默认端口 3456） | | serve | 启动 MCP 服务供 AI Agent 调用 | | wiki | 生成 Living Wiki（--stale-only 增量刷新） | | init | 生成默认 codesense.yaml | | init --interactive | 生成更完整的项目配置 |

MCP 工具（11 个）

| 工具 | 用途 | | --- | --- | | entity_context | 获取文件/实体的完整上下文 | | function_context | 查看函数调用方、被调用方与同级函数 | | impact_analysis | 分析改动影响范围 | | diff_impact | 基于 Git diff 的影响追踪 | | route_map | 路由与组件映射 | | trace_usage | 符号使用位置与证据 | | find_entrypoints | 识别入口点（路由、页面等） | | semantic_search | 语义检索函数/代码片段 | | flow_map | 追踪实体的分层业务链路（路由/组件/store/IPC） | | project_overview | 项目图谱统计总览 | | cypher | 执行原生 Cypher 调试查询 |

MCP 配置示例（Claude Code / Codex）

{
  "mcpServers": {
    "code-sense": {
      "command": "npx",
      "args": ["@code-sense/core", "serve"]
    }
  }
}

不要在 MCP 配置中写死绝对路径，避免多个项目误连到同一个图谱数据目录。

许可证

MIT