ModLens 代码智能与 AST 语义切片分析仪

ModLens 代码智能与 AST 语义切片分析仪

@liustack/modlens·v1.4.2·tools

专为超大规模代码库设计的抽象语法树(AST)智能分析套件。支持跨语言符号定义寻址、调用链深度追踪、代码坏味道静态排查以及结构化代码补丁精准合成。

代码分析 · Tree-sitter · 语义切片 · 重构工具

GitHubNPM
快速安装与集成
bash
manager:
$ pnpm add @liustack/modlens

架构解析

「ModLens」是智能体理解海量代码的超级放大镜。在大规模工程中,简单的字符 Grep 往往会检索出成千上万个无意义的命名注释或字符串匹配,造成严峻的上下文污染。 本插件通过植入 Tree-sitter 与语言服务器协议(LSP)分析器,使智能体能够像资深 IDE 一样洞悉源码。无论是快速跳转至复杂泛型的具体实现、追踪特定全局变量的全部写入链路,还是在函数级别执行精准语义切片,都能在毫秒级完成,大幅提升编程智能体的任务成功率。

核心特性

01

Tree-sitter 原生多语言解析:秒级解析 TS、Go、Rust、Python、Java 等主流语言

02

符号级跳转而非文本正则:杜绝将注释、日志字符串误当做有效业务调用的假阳性

03

精简语义切片提纯:仅提取目标函数上下游依赖,节省 80% 代码阅读 Token 开销

04

重构语法完整性校验:自动验证修改后补丁的语法正确性,防止破坏现有工程

核心机制

01

代码库 AST 预索引

基于 Tree-sitter 极速解析多语言文件,生成轻量符号关系索引。

02

语义符号精准寻址

通过函数签名或类型定义执行跨文件跳转,捕获上游与下游依赖栈。

03

局部语义切片提纯

剥离无关函数实现,仅将目标逻辑及其直接依赖声明提纯为紧凑上下文。

04

结构化补丁交付

以统一 Diff 格式或精确行号替换模式交付重构代码,杜绝语法截断。

配置参数参考 (YAML / JSON)

参数名类型默认值说明
maxSliceTokensnumber4096单个语义代码切片允许注入的最大 Token 限制
resolveExternalLibsbooleanfalse是否深入解析 node_modules 等第三方依赖包定义
enableLSPbooleantrue是否开启轻量语言服务协议(LSP)辅助类型推断