网络 · 命令参考
qzx diagnoseWebsite
作用
在单一流程中关联 DNS、TLS 证书和 HTTP 可达性，以诊断 HTTPS 站点失败的原因。
命令成熟度：Alpha
可用于真实使用和反馈，但其接口与行为仍可能继续演进。 这是当前开发 checkout 的评估。未来每个不可变发布标签都会保留该版本中包含的准确评估。 可在 PyPI 0.2.2.0.9 使用。文档对应 alpha checkout 0.2.2.0.9。
行为与内置保护
只检查，不改变状态
此操作直接执行
需要时使用原生工具
为文档所述任务使用网络
设计为无需提权即可运行
仅执行诊断检查：DNS 解析、TLS 证书检查以及用于可达性判断的 HTTPS 请求。无 scheme 的域名默认使用 HTTPS。在任何网络访问前，会拒绝非 HTTPS scheme、数字 IP 地址、嵌入式凭据、query string、fragment，以及包含 shell 敏感字符的目标。权威 DNS 返回名称不存在时会避免不必要的 TLS/HTTP 查询；探针内部失败会标记为部分诊断，不会错误呈现为网站宕机。
此安全分类由 OpenAI GPT-5.6 Sol 于 2026-09-10 对照实现摘要 sha256:7da1246f5eb89d528f235dfc19e325e3e697c7b7b902cbb26078d0955e4c4452 审阅。
准确语法
qzx diagnoseWebsite <target> [timeout] --json参数
滑动或使用横向滚动条查看所有列。
| 名称 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| target | str | 是 | 未声明 | 要诊断的域名或 HTTPS URL；可包含端口或路径 |
| timeout | float | 否 | 10 | HTTP 请求最大等待时间（秒，0.1-60；默认：10） |
输入示例
qzx diagnoseWebsite example.com使用单个命令诊断网站的 DNS、TLS 和 HTTP
qzx diagnoseWebsite https://example.com/docs --json获取特定 HTTPS 路径的结构化诊断
qzx diagnoseWebsite example.com:8443/status --timeout 15 --json使用更长 HTTP 超时诊断自定义端口上的 HTTPS 服务
要获得完整结构化载荷，请添加 --json： qzx diagnoseWebsite <target> [timeout] --json
代表性输出示例
此示意 JSON 源自当前实现所支持的结果契约。它展示命令可能返回的内容，并不声称这是录制的实际执行；具体值会随输入、设备、权限和可选工具而变化。
示例命令： qzx diagnoseWebsite example.com --json
{
"success": true,
"message": "Diagnoses why an HTTPS website may be failing by correlating DNS, TLS certificate, and HTTP reachability evidence. In this illustrative example, the command completed successfully.",
"meta": {
"command": "diagnoseWebsite",
"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": {
"summary": "Additional structured context is included here."
},
"dns": [
{
"name": "example",
"status": "ok"
}
],
"findings": [
{
"name": "example",
"status": "ok"
}
],
"healthy": true,
"host": "example.com",
"http": "Example value",
"network_requests": true,
"overall_status": [
{
"name": "example",
"status": "ok"
}
],
"partial": "Example value",
"path": "C:\\project\\example.txt",
"port": 443,
"primary_issue_layer": "Example value",
"probe_status": [
{
"name": "example",
"status": "ok"
}
],
"read_only": true,
"recommendations": [
{
"name": "example",
"status": "ok"
}
],
"related_commands": [
{
"name": "example",
"status": "ok"
}
],
"remediation": "Example value",
"report": "Analysis complete.\nNo blocking issues were found.",
"target": "Example value",
"timeout_seconds": [
{
"name": "example",
"status": "ok"
}
],
"tls": [
{
"name": "example",
"status": "ok"
}
],
"url": "https://example.com"
}查看 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": [],
"dns": [],
"error": [],
"error_code": [],
"findings": [],
"healthy": {
"type": "boolean"
},
"host": [],
"http": [],
"network_requests": {
"type": "boolean"
},
"overall_status": [],
"partial": [],
"path": [],
"port": [],
"primary_issue_layer": [],
"probe_status": [],
"read_only": {
"type": "boolean"
},
"recommendations": [],
"related_commands": {
"type": "array"
},
"remediation": {
"type": "string"
},
"report": [],
"target": [],
"timeout_seconds": [],
"tls": [],
"url": []
},
"additionalProperties": true
}错误与限制
公开契约要求失败时返回 success=false 和具有描述性的 message。此目录尚未为每个命令声明专门的错误分类；请检查结果，不要推断不存在的错误码。
QZX 仍处于 alpha 阶段。可选依赖、权限和主机能力可能影响结果。
证据流程：需要获授权的端点或经审阅的 fixture。
证据与来源
- 文档渠道
- 开发文档 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- 可用性
- 0.2.2.0.9 或更早
继续探索
相关命令
这些命令同样属于 网络 类别。对比它们，选择最适合解决任务的操作。