locus (Dpopsuev)

轨迹

Graph Walker for AI代理。将其指向任何存储库并遍历符号图——探测符号、跟踪场景、查询架构师手册、渲染图表。通过CLI或MCP服务器。

快速开始

go install github.com/dpopsuev/locus/cmd/locus@latest

MCP配置（光标/克劳德桌面）

{
  "mcpServers": {
    "locus": {
      "command": "locus",
      "args": ["serve"]
    }
  }
}

Locus作为本地stdio进程运行，具有完全的文件系统访问权限和本机Go工具链。

问题

LLM代理需要结构上下文来做出正确的决策。没有它，他们会盲目地抓取，一次读取一个文件，错过耦合、搅动、分层和信任边界。Locus扫描任何存储库并生成一个符号图，代理可以遍历MCP工具。

Graph Walker工作流程

scan → probe → scenario → book → diagnose

1. 扫描 (codograph scan_local)--构建符号图，得到 cache_key
2. 探测 (analysis probe)--一个符号的所有生命体征（扇入、扇出、不稳定、电路）
3. 场景 (analysis scenario)--从上游追踪到入口点，从下游追踪到树叶
4. 书 (book)--查询建筑师手册以获取诊断知识
5. 诊断 (analysis diagnose)--一个调用组合：探测+图书查找

代理开始广泛（扫描），放大到符号（探测），跟踪其上下文（场景），然后用知识解释信号（书籍/诊断）。

MCP工具

分析行动

符号图元

诊断

调用图

建筑

支持的语言

Locus使用LSP服务器作为主要分析后端（Strangler图——调用图拒绝使用非LSP后端）。快速失败：如果LSP不可用，则返回命名所需服务器的错误。

通过树状图、ctags或正则表达式扫描器支持的其他语言：Lua、Proto/gRPC、Shell。

建筑师手册

图中有28个知识条目，有43条键入的边。通过以下方式嵌入Oculus二进制文件 embed.FS.使用关键字+跳数进行查询，以获得具有类型化关系的知识子图。

类别： 度量（扇入、扇出、不稳定性、LOC、流失、LCOM、与主序列的距离）、气味（9 Fowler）、原则（SOLID+六边形+耦合+内聚）、模式（外观、策略、中介、工厂）。

边缘类型： 违反、衡量、混淆、补救、提要、部分、区分。

容器

Locus容器捆绑了5个核心LSP服务器，用于即时多语言分析：

podman run --rm -i -v /path/to/repo:/path/to/repo:rbind \
  locus:latest serve --transport http --addr :8081

可以手动安装其他LSP服务器（jdtls、kotlin语言服务器、omnisharp、sourcekit-LSP、zls）以扩展语言支持。

图表类型

16种图表类型，全部渲染为美人鱼：

选项： theme （亮/暗/自然）， enrich （loc、fan_in、节点标签上的搅拌）， format （美人鱼/事实/两者）， exported_only, scope, entry.

配置

许可证

麻省理工学院