Usa esta habilidad para la interfaz de línea de comandos tzst. Predetermina a ejecución cuando el usuario quiere claramente una acción real de archivo y las rutas o nombres de archivo necesarios ya se conocen.
Esta habilidad es solo para CLI. Si el usuario pregunta sobre código Python como from tzst import ..., trata eso como una tarea general de documentación de biblioteca o API de Python en lugar de usar esta habilidad como guía principal.
Cuándo Usar
Usa esta habilidad cuando el usuario:
- mencione archivos
.tzsto.tar.zst - quiera crear, extraer, aplanar, listar o probar un archivo
tzst - necesite ayuda para instalar
tzsto elegir banderas de CLI - quiera salida legible por máquina de
tzstpara scripting o automatización - necesite orientación segura para manejo de conflictos o filtros de extracción
No uses esta habilidad para preguntas genéricas sobre tar, zip o API de Python a menos que tzst sea realmente parte de la solicitud.
Verificación Prevuelo
- Verifica si
tzstestá disponible contzst --versionotzst --help. - Si falta, prefiere una de estas rutas de instalación:
uv tool install tzstpip install tzst- un binario de lanzamiento independiente de https://github.com/xixu-me/tzst/releases/latest cuando el usuario no quiera una instalación de Python
- Vuelve a ejecutar
tzst --versionotzst --helpantes de hacer trabajo real.
Flujo de Trabajo
- Decide si la solicitud es ejecución u orientación. Solicitudes como "archivar estos archivos", "extraer este respaldo", "listar lo que contiene", "probar este archivo" o "instalar tzst" son intención de ejecución.
- Elige el comando que coincida con la solicitud:
a,add,createpara creación de archivosx,extractpara extracción normal con preservación de la estructura de directoriose,extract-flatsolo cuando el usuario quiera explícitamente salida aplanadal,listpara inspección del archivot,testpara comprobaciones de integridad
- Si el usuario quiere extraer solo unos pocos miembros y los nombres de los miembros son inciertos, lista primero.
- Carga
references/cli-reference.mdcuando necesites la matriz de comandos, nombres exactos de banderas o ejemplos para copiar y pegar.
Valores Predeterminados Seguros
- Prefiere
xsobreea menos que se solicite explícitamente aplanamiento. - Mantén
--filter datacomo el modo de extracción predeterminado. - Usa
--filter tarsolo cuando el usuario necesite compatibilidad estándar al estilo tar. - Usa
--filter fully_trustedsolo cuando el usuario diga explícitamente que la fuente del archivo es completamente confiable. - Mantén la creación atómica de archivos habilitada. Solo recurre a
--no-atomiccuando el usuario quiera explícitamente. - Prefiere
--streamingpara archivos grandes o entornos con memoria limitada. - Para automatización o pipelines, prefiere
tzst --json --no-banner .... - Para extracción automatizada, requiere una elección explícita no interactiva de
--conflict-resolutioncomoreplace_all,skip_alloauto_rename_all. - No combines
--jsoncon solicitudes interactivas de conflictos.
Notas para Scripting
- Pon las banderas globales antes del subcomando en ejemplos, como
tzst --json --no-banner l archive.tzst. - Usa códigos de salida en scripts:
0para éxito,1para errores de operación,2para errores de análisis de argumentos y130para interrupción. - Cuando la nomenclatura del archivo importe, informa al usuario que
tzstpuede normalizar un destino de creación a.tzsto.tar.zst.
Errores Comunes
- Usar
ecuando el usuario esperaba que se preservara la estructura de directorios original - Recomendar
fully_trustedpara archivos de una fuente desconocida o no confiable - Olvidar una estrategia explícita de conflictos para extracción no interactiva
- Tratar una pregunta de API de Python como una pregunta de CLI
- Adivinar banderas basadas en hábitos de
taren lugar de consultar la referencia empaquetada o la ayuda de CLI instalada