sistem · Referensi perintah

`qzx testDiskSpeed`

Apa fungsinya

Mengukur penulisan sekuensial yang durable dan pembacaan ber-buffer dalam MiB/s menggunakan file sementara bernama unik.

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

Dirancang untuk bekerja tanpa elevasi hak akses

Membuat file sementara bernama unik agar tidak menimpa data yang ada, membatasi ukurannya antara 1 dan 1024 MiB, memverifikasi byte yang dibaca, dan menghapus file pada semua jalur keluar. Jika pembersihan gagal, jalur persis dilaporkan untuk pemulihan manual.

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

Sintaks persis

qzx testDiskSpeed [test_path] [size_mib] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

Nama	Tipe	Wajib	Default	Deskripsi
test_path	str	Tidak	"."	Direktori yang ada, yang filesystem-nya akan diukur
size_mib	int	Tidak	50	Ukuran file sementara dalam MiB, dari 1 hingga 1024

Contoh input

qzx testDiskSpeed

Ukur filesystem saat ini dengan file sementara 50 MiB

qzx testDiskSpeed C:/temp --size-mib 100

Ukur C:/temp dengan file sementara unik 100 MiB

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx testDiskSpeed [test_path] [size_mib] --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 testDiskSpeed --json

{
    "success": true,
    "message": "Measures sequential durable-write and buffered-read throughput in MiB/s using a uniquely named temporary file. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "testDiskSpeed",
        "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": {
        "temporary_fixture": "Example value",
        "chunk_size_bytes": 4096
    },
    "fixture_size": {
        "mebibytes": [
            {
                "name": "example",
                "status": "ok"
            }
        ],
        "bytes": [
            {
                "name": "example",
                "status": "ok"
            }
        ]
    },
    "read": {
        "mebibytes_per_second": "Example value",
        "duration_seconds": 42.7,
        "bytes_verified": "Example value"
    },
    "test_directory": "C:\\project\\example.txt",
    "write": {
        "mebibytes_per_second": "Example value",
        "duration_seconds": 42.7,
        "durability": "Example value"
    }
}

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": {
            "oneOf": [
                {
                    "type": "object",
                    "properties": {
                        "temporary_fixture": {
                            "type": "string"
                        },
                        "chunk_size_bytes": []
                    },
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "test_directory": [],
                        "received_size_mib": [],
                        "allowed_size_mib": {
                            "type": "object",
                            "properties": {
                                "minimum": {
                                    "type": "integer"
                                },
                                "maximum": {
                                    "type": "integer"
                                }
                            },
                            "additionalProperties": true
                        }
                    },
                    "additionalProperties": true
                }
            ]
        },
        "error": [],
        "error_code": [],
        "fixture_size": {
            "type": "object",
            "properties": {
                "mebibytes": [],
                "bytes": []
            },
            "additionalProperties": true
        },
        "read": {
            "type": "object",
            "properties": {
                "mebibytes_per_second": [],
                "duration_seconds": [],
                "bytes_verified": []
            },
            "additionalProperties": true
        },
        "test_directory": [],
        "write": {
            "type": "object",
            "properties": {
                "mebibytes_per_second": [],
                "duration_seconds": [],
                "durability": {
                    "type": "string"
                }
            },
            "additionalProperties": true
        }
    },
    "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 target terisolasi yang dapat dibuang.

Bukti dan asal-usul

Implementasi: src/qzx/commands/system/test_disk_speed.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 sistem. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX