file · Referensi perintah

`qzx movePath`

Apa fungsinya

Memindahkan atau mengganti nama file, symbolic link, atau seluruh direktori; menolak pemindahan direktori secara parsial.

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 hanya memindahkan direktori secara utuh dan menggunakan rename pada filesystem yang sama; kedalaman terbatas dan pemindahan direktori lintas filesystem ditolak agar tidak meninggalkan tree yang hanya sebagian disalin atau dihapus. File yang berpindah filesystem disiapkan dan diverifikasi berdasarkan ukuran serta SHA-256 sebelum target dipublikasikan dan sumber dihapus. Root, objek khusus, dan hubungan ancestor/descendant juga diblokir. --force mencadangkan target lama sebelum menggantinya.

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:1559276c985be85d9f6083622a44962973695297152550858e4261c992176c23 pada 2026-08-25.

Sintaks persis

qzx movePath <source> <destination> [force] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

Nama	Tipe	Wajib	Default	Deskripsi
source	str	Ya	Tidak dideklarasikan	Jalur file, symbolic link, atau direktori sumber
destination	str	Ya	Tidak dideklarasikan	Jalur lokasi baru di filesystem
force	bool	Tidak	false	Mengganti target yang ada setelah membuat cadangan pengaman

Contoh input

qzx movePath source.txt destination.txt

Pindahkan file atau ganti namanya

qzx movePath myfile.txt archive/myfile.txt

Pindahkan file ke direktori arsip

qzx movePath sourcedir destinationdir

Pindahkan seluruh direktori

qzx movePath sourcedir destinationdir --force

Cadangkan dan ganti target yang ada dengan seluruh direktori

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx movePath <source> <destination> [force] --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 movePath source.txt destination.txt --json

{
    "success": true,
    "message": "Moves or renames one file, symbolic link, or complete directory; partial directory moves are rejected. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "movePath",
        "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
    },
    "details": {
        "status": "ok",
        "source_exists_after": "C:\\project\\example.txt",
        "destination_exists_after": "C:\\project\\example.txt",
        "verification": "Example value",
        "replacement_cleanup": "Example value",
        "retained_previous_path": null
    },
    "warnings": [
        {
            "name": "example",
            "status": "ok"
        }
    ]
}

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
        },
        "details": {
            "type": "object",
            "properties": {
                "status": {
                    "type": "string"
                },
                "source_exists_after": [],
                "destination_exists_after": [],
                "verification": [],
                "replacement_cleanup": [],
                "retained_previous_path": {
                    "type": "null"
                }
            },
            "additionalProperties": true
        },
        "error": [],
        "error_code": [],
        "warnings": []
    },
    "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/move_path.py
Pengujian: Tidak ditemukan file pengujian khusus dengan nama modul yang sama; ini tidak membuktikan bahwa cakupan pengujian sama sekali tidak ada.
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