SuperAPI AI 工具集

tree-sitter-language-pack

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:对源代码做真正的语法树解析与结构化元数据提取,适用于构建代码索引、按语义切块喂给 LLM、跨语言语法检查、语言检测等场景。纯文本文档抽取(PDF、Office、HTML)应使用 Xberg。

主要能力:把 306 种语言解析为具体语法树(s-expression 或 JSON);提取结构(函数、类、方法、模块,含行列与字节区间、子级嵌套、可见性);提取导入与导出;提取全部标识符符号;提取 docstring 与注释;按路径、扩展名或内容检测语言;语法诊断(错误节点与位置);语法感知分块(按语法边界而非字节偏移切分,适配 LLM 上下文窗口);自定义 tree-sitter 查询(仅 SDK);解析器缓存管理(下载、列出、查看、清理,支持离线/CI)。

使用方式:CLI 为 ts-pack,适合一次性解析、缓存管理与 shell/CI 管道;parse 与 process 输出到 stdout(process always emits JSON),语言按扩展名自动识别。SDK 适合嵌入应用、运行自定义查询、从原始内容检测语言或跨多次调用复用解析器,推荐 Rust 内核或 Python/Node 绑定。MCP 服务器(ts-pack mcp)把 parse/process/detect_language 及语言与缓存工具暴露为智能体工具。

CLI 子命令:parse、process、list、info、download、clean、cache-dir、init、completions、mcp。没有独立的 detect 或 validate 命令,语言检测隐含在 parse/process 中,诊断经 process --diagnostics 获取。

安装:brew install xberg-io/tap/ts-pack;npx @xberg-io/ts-pack-cli --help;uvx --from ts-pack-cli ts-pack --help;cargo install ts-pack-cli;pip install tree-sitter-language-pack;npm install @xberg-io/tree-sitter-language-pack;Ruby 用 gem install tree_sitter_language_pack;WebAssembly 用 npm install @xberg-io/tree-sitter-language-pack-wasm。Rust 在 Cargo.toml 依赖中启用 features = ["download"]。

缓存:首次使用某语言时按需下载并本地缓存,离线或 CI 可用 ts-pack download 预取。

限制:自定义 tree-sitter 查询仅 SDK 支持;没有独立 detect/validate 子命令;文档未提供收费、价格与效果类信息。