tzst 명령줄 인터페이스용 스킬입니다. 사용자가 실제 아카이브 작업을 원하고 필요한 경로나 아카이브 이름이 이미 알려진 경우 기본적으로 실행합니다.
이 스킬은 CLI 전용입니다. 사용자가 from tzst import ...와 같은 Python 코드를 묻는 경우, 이 스킬을 주요 가이드로 사용하지 말고 일반 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를 참조하십시오.
안전 기본값
- 플래트닝이 명시적으로 요청되지 않는 한
e보다x를 선호하십시오. - 기본 추출 모드로
--filter data를 유지하십시오. - 사용자가 표준 tar 스타일 호환성이 필요할 때만
--filter tar를 사용하십시오. - 사용자가 아카이브 소스를 완전히 신뢰한다고 명시적으로 말할 때만
--filter fully_trusted를 사용하십시오. - 원자적 아카이브 생성을 활성화된 상태로 유지하십시오. 사용자가 명시적으로 원할 때만
--no-atomic을 사용하십시오. - 대용량 아카이브 또는 메모리 제한 환경에서는
--streaming을 선호하십시오. - 자동화 또는 파이프라인에서는
tzst --json --no-banner ...를 선호하십시오. - 자동화된 추출의 경우
replace_all,skip_all, 또는auto_rename_all과 같은 명시적인 비대화형--conflict-resolution선택이 필요합니다. --json을 대화형 충돌 프롬프트와 결합하지 마십시오.
스크립팅 참고 사항
- 예제에서는
tzst --json --no-banner l archive.tzst와 같이 전역 플래그를 하위 명령 앞에 두십시오. - 스크립트에서 종료 코드를 사용하십시오:
0은 성공,1은 작업 오류,2는 인수 구문 분석 오류,130은 중단입니다. - 아카이브 이름 지정이 중요한 경우,
tzst가 생성 대상을.tzst또는.tar.zst로 정규화할 수 있다고 사용자에게 알리십시오.
일반적인 실수
- 사용자가 원래 디렉터리 구조가 보존되기를 기대할 때
e를 사용하는 경우 - 알 수 없거나 신뢰할 수 없는 소스의 아카이브에
fully_trusted를 권장하는 경우 - 비대화형 추출에 명시적인 충돌 전략을 잊어버리는 경우
- Python API 질문을 CLI 질문으로 처리하는 경우
- 번들된 참조 또는 설치된 CLI 도움말을 확인하지 않고
tar습관에서 플래그를 추측하는 경우