SuperAPI AI 工具集

tree-sitter-language-pack-managing-parsers

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

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

预取(离线/CI):ts-pack download python rust typescript 下载指定语言;ts-pack download --all 下载全部语言;ts-pack download --groups all 按组下载;ts-pack download python --fresh 先清空缓存再下载。清单目前只定义一个组 all,组名属于清单数据而非固定列表,应通过 manifest_groups() 枚举。建议在 CI 的 setup 步骤运行 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"]。不带参数时 init 写入带注释的模板;给定 --languages 时同时触发这些语言的下载。init 仅接受 --languages 与 --cache-dir,按组预取请用 ts-pack download --groups <names>。可将 language-pack.toml 提交以在团队或 CI 中固定解析器集合。

典型 CI 流程:ts-pack init --languages python,rust,typescript --cache-dir .ts-pack-cache,之后步骤针对热缓存离线运行 parse/process,再用 ts-pack list --downloaded 断言预期解析器存在。解析器缓存后,可配合解析源码与提取代码结构的相关技能使用。