SuperAPI AI 工具集

parsing-source

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:当用户需要某个源文件的 tree-sitter 语法树(s-expression 转储或 JSON 树)时使用,例如查看节点结构、调试语法或把 s-expression 交给其他工具。

主要能力:ts-pack parse <file> 用一个文件对应的 tree-sitter 语法进行解析并打印具体语法树。默认输出 s-expression;加 --format json 输出 JSON,结构为 { "language", "sexp", "has_errors" },读取 has_errors 可快速判断是否产生错误节点。

必要用法:语言默认由文件扩展名自动检测。可加 --language/-l 覆盖(扩展名缺失、误导或从 stdin 读取时)。格式用 --format/-f 指定,取值 sexp(默认)或 json。

命令示例: ts-pack parse src/main.rs ts-pack parse src/main.rs --format json ts-pack parse script --language bash cat snippet.py | ts-pack parse - --language python

限制:stdin(用 - 作为文件名)不能按路径自动检测,必须传 --language。基于内容且无路径的检测需使用 SDK 的 detect_language_from_content。语言解析库首次使用时下载并缓存。parse 只给出原始树;若需要函数、导入、导出、符号、文档字符串等结构化元数据,应改用 ts-pack process 及其诊断功能。其他细节资料未提供。