使用此技能處理 tzst 命令列介面。當使用者明確想要執行歸檔動作，且所需的路徑或歸檔名稱已知時，預設執行指令。
此技能僅適用於 CLI。如果使用者詢問 Python 程式碼，例如 from tzst import ...，請將其視為一般的 Python 函式庫或 API 文件查詢，不要以此技能作為主要指南。
使用時機
當使用者：
- 提及
.tzst或.tar.zst歸檔 - 想要建立、解壓縮、扁平化、列出或測試
tzst歸檔 - 需要安裝
tzst或選擇 CLI 旗標的協助 - 想要機器可讀的
tzst輸出，以便編寫腳本或自動化 - 需要安全的衝突處理或解壓縮過濾器指引
除非請求中確實包含 tzst，否則不要將此技能用於一般的 tar、zip 或 Python API 問題。
前置檢查
- 使用
tzst --version或tzst --help檢查tzst是否可用。 - 如果找不到，建議使用以下任一安裝方式：
uv tool install tzstpip install tzst- 當使用者不希望使用 Python 安裝時，可使用來自 https://github.com/xixu-me/tzst/releases/latest 的獨立發行版二進位檔
- 在執行實際工作之前，再次執行
tzst --version或tzst --help。
工作流程
- 判斷請求是執行還是指引。 諸如「歸檔這些檔案」、「解壓縮這個備份」、「列出裡面的內容」、「測試這個歸檔」或「安裝 tzst」等請求屬於執行意圖。
- 選擇與請求匹配的指令：
a、add、create用於建立歸檔x、extract用於一般解壓縮（保留目錄結構）e、extract-flat僅在使用者明確要求扁平化輸出時使用l、list用於檢視歸檔內容t、test用於完整性檢查
- 如果使用者只想解壓縮少數成員，且成員名稱不確定，請先列出內容。
- 當需要指令矩陣、精確旗標名稱或可直接複製貼上的範例時，請載入
references/cli-reference.md。
安全預設值
- 除非明確要求扁平化，否則優先使用
x而非e。 - 保留
--filter data作為預設解壓縮模式。 - 僅在使用者需要標準 tar 風格相容性時才使用
--filter tar。 - 僅在使用者明確表示歸檔來源完全可信時，才使用
--filter fully_trusted。 - 保留原子歸檔建立功能啟用。僅在使用者明確要求時才使用
--no-atomic。 - 對於大型歸檔或記憶體受限環境，優先使用
--streaming。 - 對於自動化或管線處理，優先使用
tzst --json --no-banner ...。 - 對於自動化解壓縮，需要明確的非互動式
--conflict-resolution選擇，例如replace_all、skip_all或auto_rename_all。 - 不要將
--json與互動式衝突提示結合使用。
腳本化注意事項
- 在範例中，將全域旗標放在子指令之前，例如
tzst --json --no-banner l archive.tzst。 - 在腳本中使用退出碼：
0表示成功，1表示操作錯誤，2表示參數解析錯誤，130表示中斷。 - 當歸檔命名很重要時，請告知使用者
tzst可能會將建立目標標準化為.tzst或.tar.zst。
常見錯誤
- 在使用者期望保留原始目錄結構時使用了
e - 對來源不明或不可信的歸檔建議
fully_trusted - 忘記為非互動式解壓縮指定明確的衝突策略
- 將 Python API 問題當作 CLI 問題處理
- 根據使用
tar的習慣猜測旗標，而非查閱捆綁的參考文件或已安裝的 CLI 說明