用途:管理 tree-sitter 解析器缓存。解析器库在首次使用某语言时按需下载并缓存到磁盘,本技能用于离线工作、CI 预取、可复现构建或回收空间时显式管理该缓存。
主要能力与用法:解析器缓存管理(下载、清理、初始化)需直接使用 ts-pack CLI;OpenCode 工具仅暴露 parse/process/info。
预取:ts-pack download python rust typescript(指定语言)、ts-pack download --all(全部可用语言)、ts-pack download --groups all(按组)、ts-pack download python --fresh(先清空缓存再下载)。清单当前只定义了一个组 all;组名来自清单数据而非固定列表,应通过 manifest_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 会移除所有已缓存解析器库,下次使用时重新下载。
配置文件:ts-pack init 在当前目录写入 language-pack.toml,固定缓存位置和/或语言集合,例如 ts-pack init --languages python,rust --cache-dir .ts-pack-cache,生成 cache_dir 与 languages 字段。无参数时写入带注释的模板;给出 --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 断言预期解析器存在。
限制:解析器缓存管理不在 OpenCode 工具内,必须用 ts-pack CLI;组名需动态枚举。解析器缓存就绪后,获取语法树用 parsing-source,提取元数据用 extracting-code-structure,语言支持检查见 detecting-languages。