SuperAPI AI 工具集

detecting-languages

编程与开发

查看项目

更新于 10-16 07:18

技能介绍

用途:判断某个文件或代码片段属于哪种编程语言,供后续解析或结构提取使用。

主要能力:tree-sitter-language-pack 可将文件映射到其支持的 306 种语言之一。识别来源有三类:文件路径(依据扩展名)、单独的扩展名、以及通过 SDK 传入的源码内容(例如根据 shebang 行判断)。检测函数在无匹配语法时返回 null/None。

使用方式:CLI 没有独立的检测命令,检测在 parse 和 process 中隐式进行,例如 ts-pack parse src/app.ts 会识别为 typescript 并解析,ts-pack process app.py 会识别为 python 并提取。识别失败时(无扩展名、有歧义或来自 stdin),可显式传入 --language,例如 cat snippet | ts-pack parse - --language go。用 ts-pack list --filter type、ts-pack list --manifest 可查看语言是否受支持,用 ts-pack info typescript 可查看语言是否已知、是否已下载及缓存路径。SDK 暴露三个显式函数:detect_language_from_path(path)、detect_language_from_extension(ext)、detect_language_from_content(content),分别从完整路径、裸扩展名和原始源码文本检测;其中基于内容的检测是 CLI 未提供的。Python 从 tree_sitter_language_pack 导入,Node.js/TypeScript 从 @xberg-io/tree-sitter-language-pack 导入。

适用场景:已知路径或扩展名且只需一次性处理时,直接运行 ts-pack parse/process 自动识别;只有原始内容(粘贴的片段、流、无扩展名文件)时,先用 SDK 的内容检测,再把结果作为 --language 传给 CLI。语言确定后可交由解析源码或提取代码结构的技能继续处理;查看或预取解析器可参考管理解析器的技能。

限制:CLI 不提供独立检测命令,内容检测仅在 SDK 中可用;无扩展名、有歧义或 stdin 输入需手动指定语言。其余如安装方式、平台与收费信息暂未提供。