file · Referensi perintah
qzx repairWorkspace
Apa fungsinya
Memvalidasi rencana tersimpan dari auditWorkspace dan hanya menerapkan tindakan pembersihan terpilih yang belum berubah.
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
Pratinjau tersedia
Berfungsi tanpa memanggil program native
Berfungsi tanpa menggunakan jaringan
Menggunakan izin Anda saat ini; hasil dapat bervariasi
Pratinjau adalah perilaku default. Perbaikan nyata memerlukan rencana lengkap yang disimpan oleh auditWorkspace, identifier eksplisit tindakan executable, fingerprint konten yang tidak berubah, dry_run=false, apply=true, serta cadangan workspace dengan perlindungan kegagalan. Entri terpilih diisolasi dalam staging di workspace yang sama sebelum dibersihkan; temuan yang hanya untuk ditinjau tidak pernah dapat diterapkan.
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 Sol terhadap digest implementasi sha256:dd5295cd267097ab0e54e7cb7e02105099db87446652192be1d31fad5da527e5 pada 2026-09-05.
Sintaks persis
qzx repairWorkspace [path] [plan_file] [action_ids] [dry_run] [apply] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| path | str | Tidak | "." | Direktori workspace yang sesuai dengan rencana tersimpan |
| plan_file | str | Tidak | Tidak dideklarasikan | Rencana JSON yang dibuat oleh auditWorkspace |
| action_ids | str | Tidak | Tidak dideklarasikan | Identifier dipisahkan koma untuk tindakan executable yang telah ditinjau operator |
| dry_run | bool | Tidak | true | Validasi dan pratinjau tanpa mengubah workspace |
| apply | bool | Tidak | false | Mengotorisasi tindakan terpilih secara eksplisit; memerlukan dry_run=false |
Contoh input
qzx repairWorkspace . --plan-file qzx-repair-plan.jsonValidasi rencana tersimpan dan cantumkan tindakan executable-nya
qzx repairWorkspace . --plan-file qzx-repair-plan.json --action-ids act-123,act-456 --dry-run false --applyCadangkan workspace, validasi ulang dua tindakan, lalu terapkan
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx repairWorkspace [path] [plan_file] [action_ids] [dry_run] [apply] --json
Contoh output yang diamati
Ditangkap dengan QZX 0.2.2.0.9 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.
Perintah contoh: qzx repairWorkspace ../artifacts/qzx-evidence/repair-workspace/workspace --plan-file ../artifacts/qzx-evidence/repair-workspace/plan.json --json
{
"success": true,
"status": "preview",
"message": "Repair plan 'plan-70b0f1e9ef689794bc9423b4e17812fad340a3316bb5ddf912c29483aa6d05b5' is valid and unchanged. 1 executable action(s) are available; 0 selected. Nothing was changed.",
"details": {
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\workspace",
"plan_file": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\repair-workspace\\plan.json",
"plan_id": "plan-70b0f1e9ef689794bc9423b4e17812fad340a3316bb5ddf912c29483aa6d05b5",
"dry_run_mode": true,
"apply_requested": false,
"workspace_unchanged": true,
"selected_actions": [],
"executable_actions": [
{
"category": "temp",
"executable": true,
"fingerprint": {
"sha256": "a4be5b5eeff332365000a7d71223443e63df5d51a58fdb60aa682b8b01d22266",
"size_bytes": 28,
"type": "file"
},
"id": "act-76685ad35f1fd085e962",
"kind": "delete_file",
"path": "debug.tmp",
"reason": "Temporary editor or tool output selected for explicit cleanup.",
"size_bytes": 28
}
],
"review_only_actions": []
},
"meta": {
"command": "repairWorkspace",
"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": 8.58,
"schema_version": 1
}
}Lihat kontrak hasil JSON
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"preview",
"applied",
"rolled_back",
"recovery_required",
"cleanup_incomplete"
]
},
"error_code": {
"type": "string"
},
"error": {
"type": "string"
},
"details": {
"type": "object",
"additionalProperties": true
},
"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
}
},
"additionalProperties": true,
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message",
"meta",
"success"
]
}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: ditangkap dan divalidasi dengan digest.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/file/repair_workspace.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 terkait
Perintah ini juga termasuk kategori file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx readFileMembaca dan menampilkan isi file.qzx touchFileMembuat file kosong atau memperbarui timestamp file yang sudah ada.qzx movePathMemindahkan atau mengganti nama file, symbolic link, atau seluruh direktori; menolak pemindahan direktori secara parsial.qzx auditWorkspaceMembuat rencana deterministik dengan fingerprint konten untuk meninjau kemungkinan pembersihan tanpa mengubah workspace.