file · Referensi perintah

`qzx createZip`

Apa fungsinya

Membuat arsip ZIP atomik dari file atau direktori dengan aturan pengecualian yang dapat dikonfigurasi.

Kematangan perintah: Alpha

Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.

Perilaku dan perlindungan bawaan

Mode nyata menerapkan perubahan yang Anda minta

Eksekusi langsung untuk operasi ini

Berfungsi tanpa memanggil program native

Berfungsi tanpa menggunakan jaringan

Menggunakan izin Anda saat ini; hasil dapat bervariasi

QZX membangun ZIP dalam file sementara yang berdekatan dan baru memublikasikannya setelah lengkap. Secara default mempertahankan target yang ada, mengabaikan symbolic link, dan menolak penggunaan objek yang sama sebagai sumber dan target. --overwrite terlebih dahulu memerlukan cadangan ZIP lama yang dapat dipulihkan.

QZX membuat arsip pemulihan sebelum perubahan nyata; gunakan --dangerously-bypass-approvals-and-sandbox/--yolo hanya jika Anda sengaja memilih untuk melewatinya.

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:ee0976439603ebc86ae05188b804c51c0f0e159b474900af8d2e22b1852dbbc9 pada 2026-08-25.

Sintaks persis

qzx createZip <zip_path> <source_path> [exclude_patterns] [overwrite] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

Nama	Tipe	Wajib	Default	Deskripsi
zip_path	str	Ya	Tidak dideklarasikan	Jalur target arsip ZIP yang akan dibuat (misalnya project.zip)
source_path	str	Ya	Tidak dideklarasikan	File atau direktori lokal yang akan dikompresi
exclude_patterns	str	Tidak	".git,node_modules,__pycache__,.venv,env,dist,build"	Folder, file, atau wildcard yang dikecualikan, dipisahkan koma (default: cache umum)
overwrite	bool	Tidak	false	Mengganti ZIP yang ada setelah membuat cadangan pengaman

Contoh input

qzx createZip project.zip .

Kompres direktori saat ini menjadi project.zip baru

qzx createZip src.zip src

Kompres folder src menjadi src.zip baru

qzx createZip project.zip . --overwrite

Ganti project.zip setelah membuat cadangan pengaman

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx createZip <zip_path> <source_path> [exclude_patterns] [overwrite] --json

Contoh output representatif

JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.

Perintah contoh: qzx createZip project.zip . --json

{
    "success": true,
    "message": "Compresses a file or directory into an atomic ZIP archive with custom exclusion rules. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "createZip",
        "command_maturity": {
            "stage": "alpha",
            "label": "Alpha",
            "sequence": 2,
            "public_executable": true,
            "stability": "interface_may_change",
            "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
            "promotion_review_required": false,
            "assessment_scope": "development_checkout"
        },
        "duration_ms": 0,
        "schema_version": 1
    },
    "compressed_bytes": 4096,
    "compression_ratio_percent": 42.7,
    "details": {
        "summary": "Additional structured context is included here."
    },
    "files_archived": "C:\\project\\example.txt",
    "original_bytes": 4096,
    "overwrite": true,
    "sha256": "Example value",
    "skipped_symlinks": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "source_path": "C:\\project\\example.txt",
    "zip_path": "C:\\project\\example.txt"
}

Lihat kontrak hasil JSON

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message",
        "meta"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "meta": {
            "type": "object",
            "required": [
                "command",
                "command_maturity",
                "duration_ms",
                "schema_version"
            ],
            "properties": {
                "command": {
                    "type": "string"
                },
                "command_maturity": {
                    "type": "object",
                    "required": [
                        "stage",
                        "label",
                        "sequence",
                        "public_executable",
                        "stability",
                        "summary",
                        "promotion_review_required",
                        "assessment_scope"
                    ],
                    "properties": {
                        "stage": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "sequence": {
                            "type": "integer"
                        },
                        "public_executable": {
                            "type": "boolean"
                        },
                        "stability": {
                            "type": "string"
                        },
                        "summary": {
                            "type": "string"
                        },
                        "promotion_review_required": {
                            "type": "boolean"
                        },
                        "assessment_scope": {
                            "type": "string"
                        },
                        "note": {
                            "type": "string"
                        },
                        "review": {
                            "type": "object",
                            "required": [
                                "reviewed_on",
                                "rationale",
                                "evidence"
                            ],
                            "properties": {
                                "reviewed_on": {
                                    "type": "string",
                                    "format": "date"
                                },
                                "rationale": {
                                    "type": "string"
                                },
                                "evidence": {
                                    "type": "array",
                                    "minItems": 1,
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "replacement": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": true
                },
                "duration_ms": {
                    "type": "number"
                },
                "schema_version": {
                    "type": "integer"
                }
            },
            "additionalProperties": true
        },
        "compressed_bytes": [],
        "compression_ratio_percent": [],
        "details": [],
        "error": [],
        "error_code": [],
        "files_archived": [],
        "original_bytes": [],
        "overwrite": [],
        "sha256": [],
        "skipped_symlinks": [],
        "source_path": [],
        "zip_path": []
    },
    "additionalProperties": true
}

Kesalahan dan batasan

Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.

QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.

Alur bukti: memerlukan lingkungan privileged yang terkontrol.

Bukti dan asal-usul

Implementasi: src/qzx/commands/file/create_zip.py
Pengujian: tests/test_file_commands/test_create_zip.py
Kanal dokumentasi: Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Ketersediaan: 0.2.2.0.9 atau lebih lama

Lanjut jelajahi

Perintah ini juga termasuk kategori file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX