用途:该技能在用户需要源代码的结构化元数据(函数、类、导入、导出、符号、docstrings、注释或语法诊断)而非原始语法树时使用,通过 ts-pack process <file> 运行代码智能流水线并打印 JSON。
主要能力与用法:默认执行 --structure --imports --exports;可显式指定 --structure、--imports、--exports、--comments、--docstrings、--symbols、--diagnostics 或 --all。注意:一旦传入任一提取标志,默认集合即被关闭,需列出全部所需特性;而 --chunk-size 与 --language 属于修饰符,不会关闭默认项。
结果结构:始终输出 JSON,顶层含 language、metrics、structure 等键;metrics 在任意处理时填充,chunks 仅在设置 --chunk-size 时出现。空集合按 wire contract 省略,缺键表示未找到而非报错。structure 条目含 kind、name、visibility 及嵌套 span(含 start_byte/end_byte 与零基行、列),嵌套通过 children 表达。
SDK:Python 端可用 process、ProcessConfig(冻结 dataclass,structure/imports/exports 默认 True)与 ProcessResult;还暴露 get_parser 及 data_extraction 配置标志从 JSON、YAML、TOML 拉取层次键值树,二者 CLI 未暴露。若需原始语法树,改用 ts-pack parse。语言缺省按扩展名自动检测。具体支持语言范围、性能与平台限制资料未提供。