SuperAPI AI 工具集

managing-parsers

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:tree-sitter 解析器库在首次使用某语言时按需下载并缓存到磁盘。本技能用于显式管理该缓存,适用于离线工作、CI 预取、可复现构建或回收空间。注意:解析器缓存的下载、清理、初始化需直接使用 ts-pack CLI;OpenCode 工具仅提供 parse/process/info。

预取(离线/CI): ts-pack download python rust typescript(指定语言)、ts-pack download --all(全部语言)、ts-pack download --groups web,systems(按组)、ts-pack download python --fresh(先清缓存再下载)。可用组:web、systems、scripting、data、jvm、functional(--groups 用逗号分隔)。在 CI 设置步骤中运行 download,后续 parse/process 调用即可命中缓存而不走网络。

查看:ts-pack list(全部可用语言)、ts-pack list --downloaded(仅已缓存)、ts-pack list --manifest(远程清单全部)、ts-pack list --filter script(按名称子串过滤);ts-pack info python(是否已知、是否已下载、缓存路径);ts-pack cache-dir(打印有效缓存目录)。

清理:ts-pack clean(需确认)、ts-pack clean --force(跳过确认,用于脚本/CI)。clean 会删除所有已缓存解析器库,下次使用时重新下载。

配置文件(init):ts-pack init 在当前目录写入 language-pack.toml,固定缓存位置和/或语言集。示例:ts-pack init --languages python,rust --cache-dir .ts-pack-cache,生成的文件含 cache_dir = ".ts-pack-cache" 与 languages = ["python", "rust"]。不带参数时写入注释模板;带 --languages(或组)时同时触发这些语言的下载。可将 language-pack.toml 提交以在团队或 CI 中固定解析器集。

典型 CI 流程:先 init 固定语言与缓存目录,随后步骤离线对已预热缓存运行 parse/process,再用 ts-pack list --downloaded 断言预期解析器存在。

与其他技能配合:解析器缓存后,可用 parsing-source 获取语法树、extracting-code-structure 提取元数据;此处的 info/list 也服务于 detecting-languages 中的语言支持检查。