跳到主要内容

系统 · 命令参考

qzx getDiskHealth

作用

使用 smartctl 检查磁盘 S.M.A.R.T. 健康状况，并区分磁盘警告与命令失败。

命令成熟度：Alpha

可用于真实使用和反馈，但其接口与行为仍可能继续演进。 这是当前开发 checkout 的评估。未来每个不可变发布标签都会保留该版本中包含的准确评估。 可在 PyPI 0.2.2.0.9 使用。文档对应 alpha checkout 0.2.2.0.9。

行为与内置保护

只检查，不改变状态

此操作直接执行

需要时使用原生工具

无需网络即可运行

使用你当前的权限；结果可能有所不同

验证磁盘标识符，解析 smartctl 的精确路径，并在无 shell、15 秒限制下执行。退出码按位掩码解释：语法、打开、SMART 命令或 checksum 失败会中止，而磁盘健康指标会保留为结构化观察结果。

此安全分类由 OpenAI GPT-5.6 Pro 于 2026-08-25 对照实现摘要 sha256:47f465256648751136fa6647d37cd65a70675a7f074f7d0811a3d7466dadc860 审阅。

准确语法

qzx getDiskHealth <disk> [view] --json

参数

滑动或使用横向滚动条查看所有列。

名称类型必填默认值描述
diskstr是未声明不含路径分隔符的标识符（例如 sda、nvme0n1、disk0 或 PhysicalDrive0）
viewstr否"health"详细程度："health" 用于摘要，"full" 用于 smartctl JSON

输入示例

qzx getDiskHealth sda

检查 /dev/sda 的 S.M.A.R.T. 健康状态

qzx getDiskHealth PhysicalDrive0 --view full

读取 Windows 上 PhysicalDrive0 的完整 S.M.A.R.T. JSON

要获得完整结构化载荷，请添加 --json： qzx getDiskHealth <disk> [view] --json

代表性输出示例

此示意 JSON 源自当前实现所支持的结果契约。它展示命令可能返回的内容，并不声称这是录制的实际执行；具体值会随输入、设备、权限和可选工具而变化。

示例命令： qzx getDiskHealth sda --json

{
    "success": true,
    "message": "Inspects one disk's S.M.A.R.T. health with smartctl and reports status flags without treating health warnings as command failures. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "getDiskHealth",
        "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
    },
    "device": "Example value",
    "disk": "Example value",
    "health_status": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "output": "Command completed successfully with structured details.",
    "smart_data": "Example value",
    "stdout": "Command completed successfully.",
    "view": "Example value"
}
查看 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
        },
        "device": [],
        "disk": [],
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "health_status": [],
        "output": [],
        "smart_data": [],
        "stdout": [],
        "view": []
    },
    "additionalProperties": true
}

错误与限制

公开契约要求失败时返回 success=false 和具有描述性的 message。此目录尚未为每个命令声明专门的错误分类；请检查结果，不要推断不存在的错误码。

QZX 仍处于 alpha 阶段。可选依赖、权限和主机能力可能影响结果。

证据流程：需要受控的特权环境。

证据与来源

文档渠道
开发文档 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
可用性
0.2.2.0.9 或更早

实用指南

在实际场景中使用此命令

了解 qzx getDiskHealth 适用于哪些任务、与原生工具相比如何，以及自动化时应关注哪些细节。

继续探索

相关命令

这些命令同样属于 系统 类别。对比它们，选择最适合解决任务的操作。

浏览所有 QZX 命令