Agent Skills
返回列表
💻

TZST 归档命令行

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/xixu-me-skills-tzst。

技能介绍

要解决什么问题

.tzst / .tar.zst 把 tar 目录结构与 Zstandard 压缩合在一起,在备份和产物分发里越来越常见;但很多人仍按 tar 习惯瞎猜子命令和过滤模式,解压时目录结构被 flatten 掉,或在 CI 里因为没指定 --conflict-resolution 而卡在交互提示上。这个技能只管 tzst 命令行,不替你读 Python 里的 from tzst import ...。

技能如何工作

执行前会先确认本机是否有 tzst(tzst --version / --help),缺失时再走 uv tool install、pip 或独立二进制等路径。接到明确要「真动手」的请求时,按意图选子命令:a/add/create 打包,x/extract 保留目录结构解压,仅在明确要求时才用 e/extract-flat,l/list 看成员,t/test 做完整性检查;成员名不确定时先 list 再解压。

默认策略偏向安全:优先 x 而非 e,提取默认 --filter data,只在需要 tar 兼容时用 --filter tar,只在用户明确声明完全可信源时才用 fully_trusted;大归档倾向 --streaming,流水线里用 tzst --json --no-banner ...,非交互解压必须显式给出 replace_all / skip_all / auto_rename_all 之一,且不与 --json 混用交互式冲突处理。需要完整参数矩阵时可对照技能内的 references/cli-reference.md 或本机 --help。

适用边界

  • 适用:提到 .tzst、安装 tzst、选 CLI 标志、脚本化机器可读输出、提取过滤与安全冲突处理。
  • 不适用:纯 tar/zip 问题、把库 API 当 CLI 问、在未核对参考文档的情况下凭 tar 经验猜标志。
  • 常见坑:用 e 却期望原目录树;对不可信归档推荐 fully_trusted;自动化解压忘记冲突策略。

使用场景

  • CI 产物是 `.tar.zst`,流水线里要用 `tzst --json --no-banner` 列出成员再决定解压路径
  • 本地备份拆成多个 `.tzst`,需要 `x` 保留目录树解压到指定目录并处理同名文件冲突
  • 收到同事发来的归档要先 `t` 测完整性,通过后再按 `--filter data` 默认模式解压
  • 要把若干目录打成单一 `.tzst` 发布物,且需要保持原子写入避免半截归档

适合人员

  • 负责 nightly 备份落地的 SRE,要把日志目录打成 `.tzst` 并在故障时按成员列表选择性恢复
  • 维护发布工件的 DevOps,需要在无人值守脚本里解压 `.tar.zst` 并固定 `replace_all` 或 `skip_all` 策略
  • 写数据迁移脚本的工程师,要区分 `x` 与 `e`,避免把多层目录压平导致路径对不上
  • 偶尔接触 RealQ 生态工具链的开发者,不熟悉 tzst 子命令与 `--filter` 含义时需要对照 CLI 参考