QZX_SAFETY高风险使用 YOLO 会全局跳过高风险命令的确认和安全备份。等同于在每次操作中使用 --yolo，应仅用于受控会话。
- 值
YOLO- 默认值
保护已启用
参考文档
89 个命令，一套跨平台词汇
浏览当前 QZX 命令目录。每个命令页面都包含说明、参数、示例，以及适用时的安全注意事项。命令名称在所有语言中保持一致，让自动化更容易移植。
按问题选命令
diagnoseProject、diagnoseStorage 和 diagnoseWebsite 这样的复合诊断通常能减少最多重复工作；更小的命令则适合只需要单一操作的场景。
qzx listCommandsqzx help diagnoseProject已记录 89 个命令
可索引的逐命令参考
每个链接都会打开一个 SSR 页面，其中包含成熟度、语法、参数、可用性、风险、示例和实现证据。
PyPI 0.2.2.0.9 中包含 89 个仅开发 checkout 0.2.2.0.9 中有 0 个89 个 Alpha
显示 89 个命令
没有命令匹配搜索条件。请尝试其他名称、类别或能力。
开发
addPythonDocstringsPyPI 0.2.2.0.9Alpha预览或向 Python 文件中的函数、方法和类添加生成的 docstring。analyzeComplexityPyPI 0.2.2.0.9Alpha分析文件或项目中的代码复杂度指标。auditRepositoryPyPI 0.2.2.0.9Alpha对 Git 仓库执行安全与质量审计：机密信息、大文件、重复项、.gitignore 合规性和许可证。cleanDevelopmentArtifactsPyPI 0.2.2.0.9Alpha查找缓存、已安装依赖和生成的构建产物；默认仅预览。compareFilesPyPI 0.2.2.0.9Alpha逐行比较文本文件，并通过精确字节和 SHA-256 比较二进制文件。deployProjectPyPI 0.2.2.0.9Alpha通过 SSH 预览或部署明确指定的构件，并提供经验证的远程备份、SHA-256 校验、原子提升、健康检查和自动回滚。diagnoseProjectPyPI 0.2.2.0.9Alpha无需执行项目脚本即可检查技术、依赖、验证流程、Git 状态、代码质量和大文件。findUnusedCodePyPI 0.2.2.0.9Alpha查找没有可见引用的函数、类和导出项，以便在移除前进行审查。formatCodePyPI 0.2.2.0.9Alpha检测语言并对源代码文件运行相应的格式化工具。getGitStatusPyPI 0.2.2.0.9Alpha提供结构化的 Git 状态摘要：分支、远程仓库、更改和近期提交。getProjectTreePyPI 0.2.2.0.9Alpha生成有界的 ASCII 和 JSON 项目树，不跟随下级符号链接。planProjectBootstrapPyPI 0.2.2.0.9Alpha构建可选择的项目初始化计划，不写入文件、不安装依赖、不创建机密信息，也不执行迁移。prepareReleasePyPI 0.2.2.0.9Alpha规划版本元数据更新，并可原子修改清单和 CHANGELOG.md；绝不会构建、提交、打标签或发布。projectLanguagesPyPI 0.2.2.0.9Alpha按行数、文件数和字节数百分比分析项目的源代码语言及辅助格式。scaffoldCPyPI 0.2.2.0.9Alpha为 C 程序创建基础结构。scaffoldCppPyPI 0.2.2.0.9Alpha为 C++ 程序创建基础结构。scaffoldCSharpPyPI 0.2.2.0.9Alpha为 C# 程序创建基础结构。scaffoldGoPyPI 0.2.2.0.9Alpha为 Go 程序创建基础结构。scaffoldJavaPyPI 0.2.2.0.9Alpha为 Java 程序创建基础结构。scaffoldJavaScriptPyPI 0.2.2.0.9Alpha为 JavaScript 或 Node.js 程序创建基础结构。scaffoldKotlinPyPI 0.2.2.0.9Alpha为 Kotlin 程序创建基础结构。scaffoldPhpPyPI 0.2.2.0.9Alpha为 PHP 或 Composer 项目创建基础结构。scaffoldPythonPyPI 0.2.2.0.9Alpha为 Python 程序创建基础结构。scaffoldRustPyPI 0.2.2.0.9Alpha为 Rust 程序创建基础结构。scaffoldTypeScriptPyPI 0.2.2.0.9Alpha为 TypeScript 程序创建基础结构。traceCircularImportsPyPI 0.2.2.0.9Alpha跟踪模块导入并识别循环依赖。traceEnvVarPyPI 0.2.2.0.9Alpha跟踪环境变量在代码、.env 和 .env.example 模板中的使用情况。
文件
auditWorkspacePyPI 0.2.2.0.9Alpha创建带内容指纹的确定性计划，用于审查可能的清理操作而不改变工作区。calculateFileHashPyPI 0.2.2.0.9Alpha计算文件的 MD5、SHA-1 和 SHA-256 加密哈希。changePermissionsPyPI 0.2.2.0.9Alpha更改文件或目录的权限。copyPathPyPI 0.2.2.0.9Alpha将文件、符号链接或目录复制到独立目标，并明确指定深度和替换行为。countLinesPyPI 0.2.2.0.9Alpha通过有界内存流式处理和明确的换行证据，统计稳定常规文件中的 Unicode 逻辑行。createDirectoryPyPI 0.2.2.0.9Alpha创建一个或多个真实目录，并提供去重、冲突检测和按目标独立回滚。createZipPyPI 0.2.2.0.9Alpha从文件或目录创建原子 ZIP 文件，并支持可配置的排除规则。deletePathPyPI 0.2.2.0.9Alpha预览或删除文件系统中的文件或目录。detectFileTypePyPI 0.2.2.0.9Alpha通过有界内容签名、可选的 libmagic 细化以及明确的扩展名比较来识别常规文件。downloadFilePyPI 0.2.2.0.9Alpha从互联网下载文件，方式类似 wget 或 curl。extractZipPyPI 0.2.2.0.9Alpha在验证路径、类型、限制和目标冲突后解压 ZIP 文件。findBrokenSymlinksPyPI 0.2.2.0.9Alpha查找指向不存在文件或目录的失效符号链接。findDuplicateFilesPyPI 0.2.2.0.9Alpha通过大小、SHA-256 和逐字节验证查找完全相同的文件。findFilesPyPI 0.2.2.0.9Alpha按名称、深度、大小和修改日期查找文件，并返回结构化元数据。findTextPyPI 0.2.2.0.9Alpha使用高级筛选条件在文件中查找文本模式。getHumanLanguageStatsPyPI 0.2.2.0.9Alpha分析文件以估算自然语言分布；支持通配符和递归搜索。inspectImagePyPI 0.2.2.0.9Alpha从 PNG、JPEG、GIF 和 BMP 文件头检查尺寸、格式和大小。isDirectoryEmptyPyPI 0.2.2.0.9Alpha稳定检查目录是否为空，使用流式计数和明确的隐藏项策略，默认不跟随链接。isFileBinaryPyPI 0.2.2.0.9Alpha通过对文件开头、中间和结尾进行有界采样，判断常规文件是二进制还是文本。isFileEmptyPyPI 0.2.2.0.9Alpha通过流式解码检查文件是否为零字节或仅包含 Unicode 空白，默认不跟随链接。listFilesPyPI 0.2.2.0.9Alpha使用通配符和递归搜索列出目录中的文件。movePathPyPI 0.2.2.0.9Alpha移动或重命名文件、符号链接或整个目录；拒绝目录的部分移动。readFilePyPI 0.2.2.0.9Alpha读取并显示文件内容。repairWorkspacePyPI 0.2.2.0.9Alpha验证 auditWorkspace 保存的计划，并仅应用未发生变化的已选清理操作。touchFilePyPI 0.2.2.0.9Alpha创建空文件或更新现有文件的时间戳。
网络
checkDnsPyPI 0.2.2.0.9Alpha查询域名的 DNS A、AAAA、MX、TXT、NS 和 CNAME 记录。checkSslCertificatePyPI 0.2.2.0.9Alpha检查证书日期、主机名覆盖范围和信任链验证。checkUrlStatusPyPI 0.2.2.0.9Alpha请求 HTTP URL 并返回状态码、响应时间和基本响应头。diagnoseWebsitePyPI 0.2.2.0.9Alpha在单一流程中关联 DNS、TLS 证书和 HTTP 可达性，以诊断 HTTPS 站点失败的原因。getNetworkConfigPyPI 0.2.2.0.9Alpha显示网络接口、本地 IP、DNS、公网 IP 和 VPN 检测结果。testInternetSpeedPyPI 0.2.2.0.9Alpha以毫秒测量 HTTP 延迟，并以 Mbps 和 MiB/s 测量有界下载速度。
系统
aboutPyPI 0.2.2.0.9Alpha显示 QZX 产品信息、创建者、维护者和许可证。checkExecutablePyPI 0.2.2.0.9Alpha在 PATH 中定位可执行文件，并且仅在明确请求时读取其常规 --version 输出。checkSystemPathPyPI 0.2.2.0.9Alpha诊断 PATH 变量，列出失效或重复目录，并定位某个二进制程序的所有实例。clearScreenPyPI 0.2.2.0.9Alpha直接清理交互式终端，不启动 cls、clear 或命令 shell。diagnoseStoragePyPI 0.2.2.0.9Alpha结合容量、大文件和已验证重复项诊断存储压力，不删除或修改任何文件。explainFileWithGeminiPyPI 0.2.2.0.9Alpha先预览，并在明确授权后将文件的有限样本发送给 Google Gemini 以获取说明。getCpuLoadPyPI 0.2.2.0.9Alpha获取当前 CPU 使用情况。getCurrentDateTimePyPI 0.2.2.0.9Alpha显示当前本地日期和时间，并包含时区、日历、ISO 周和时间戳。getCurrentDirectoryPyPI 0.2.2.0.9Alpha显示当前工作目录及其内容的实用清单。getCurrentUserPyPI 0.2.2.0.9Alpha获取当前登录用户的信息。getDiskHealthPyPI 0.2.2.0.9Alpha使用 smartctl 检查磁盘 S.M.A.R.T. 健康状况，并区分磁盘警告与命令失败。getDiskSpacePyPI 0.2.2.0.9Alpha获取磁盘空间使用情况。getGpuInfoPyPI 0.2.2.0.9Alpha检查已安装 GPU，并报告供应商、驱动、显存和可用使用指标。getRamInfoPyPI 0.2.2.0.9Alpha获取 RAM 使用情况的详细信息。getSystemInfoPyPI 0.2.2.0.9Alpha获取可移植的操作系统、Python、用户和环境信息，并可选择包含 RAM 和存储详情。helpPyPI 0.2.2.0.9Alpha显示命令帮助。inspectPortPyPI 0.2.2.0.9Alpha检查本地端口是否被占用，并报告占用它的进程而不终止进程。isAdminPyPI 0.2.2.0.9Alpha检查当前用户是否具有管理员权限。killProcessPyPI 0.2.2.0.9Alpha终止明确指定的进程并确认其已经结束。listCommandsPyPI 0.2.2.0.9Alpha按类别列出可用命令。listDiskDevicesPyPI 0.2.2.0.9Alpha获取某个磁盘或所有磁盘的名称或型号。listProcessesPyPI 0.2.2.0.9Alpha列出正在运行的进程。listStartupProgramsPyPI 0.2.2.0.9Alpha列出配置为在系统或会话启动时运行的程序。listSystemServicesPyPI 0.2.2.0.9Alpha列出操作系统服务及其运行状态。runDiagnosticCommandPyPI 0.2.2.0.9Alpha从平台专用允许列表中执行严格只读的原生诊断。runScriptPyPI 0.2.2.0.9Alpha执行明确指定的本地 Python、Bash 或 Windows Batch 脚本，并设置超时和有界输出保留。systemDoctorPyPI 0.2.2.0.9Alpha执行 CPU、RAM、磁盘、网络、PATH、服务、端口和系统错误诊断。terminalPyPI 0.2.2.0.9Alpha启动用于 QZX 命令的交互式终端。testDiskSpeedPyPI 0.2.2.0.9Alpha使用唯一命名的临时文件，以 MiB/s 测量持久顺序写入和缓冲读取速度。versionPyPI 0.2.2.0.9Alpha显示已安装的 QZX 版本及其稳定产品标识。welcomePyPI 0.2.2.0.9Alpha立即显示 QZX 欢迎信息，并可选择显示系统信息。
CLI 配置
环境变量
QZX 从进程环境读取这些变量。在终端中设置的值会影响从该会话启动的命令；删除后，QZX 会恢复默认行为。
注意： QZX_SAFETY=YOLO 会为当前会话中的所有高风险命令关闭一道恢复屏障。不要将其设为永久配置。
安全与备份
控制高风险操作前的保护措施，以及 QZX 在修改数据前创建的备份文件。
QZX_BACKUPS_PATH更改 QZX 保存自动备份的目录。包含 ~ 和系统变量的路径会在创建文件前展开。
- 值
目录路径- 默认值
~/QZX-Backups
QZX_BACKUPS_FORMAT选择备份容器格式。ZIP 和 TAR.GZ 支持压缩；TAR 以未压缩方式保存数据。
- 值
ZIP · TAR.GZ · TAR- 默认值
ZIP
QZX_BACKUPS_COMPRESSION调整压缩级别。0 表示不压缩，9 优先获得最小体积；使用 TAR 格式时，实际值始终为 store。
- 值
store · fastest · fast · normal · maximum · 0–9- 默认值
fastest
隐私、诊断与集成
配置 CLI 的假名化遥测、本地状态和可选服务。
QZX_TELEMETRY使用 0 关闭激活遥测，或使用 1 明确启用。QZX_TELEMETRY=1 的优先级高于 DO_NOT_TRACK=1。
- 值
0 · 1- 默认值
1（已启用）
DO_NOT_TRACK当值为 1 时关闭遥测，除非 QZX_TELEMETRY 明确将其启用或关闭。
- 值
1- 默认值
未定义
QZX_TELEMETRY_STATE_DIR更改假名化遥测本地状态的存储位置；适用于便携式安装和测试。
- 值
目录路径- 默认值
系统数据目录
QZX_TELEMETRY_DEBUG将遥测传输诊断写入 stderr。不会改变命令结果。
- 值
1 · true · yes · on · enabled- 默认值
已禁用
GEMINI_API_KEY机密explainFileWithGemini 的首选凭据。QZX 会从进程环境或当前目录的 .env 文件中读取；请将其视为机密信息，切勿公开或提交到版本控制中。
- 值
API 密钥- 默认值
未定义
GEMINI_API_TOKEN机密当未定义 GEMINI_API_KEY 时，explainFileWithGemini 接受的兼容凭据。QZX 也可以从当前目录的 .env 文件中读取；请将其视为机密信息，切勿公开或提交到版本控制中。
- 值
API 令牌- 默认值
未定义
各终端示例
导出的赋值会持续到你关闭会话或删除变量为止。请按你的策略替换具体值。
Linux / macOS / POSIX
QZX_TELEMETRY=0 qzx welcome
export QZX_BACKUPS_FORMAT=TAR.GZ
export QZX_BACKUPS_COMPRESSION=fastestWindows PowerShell
$env:QZX_TELEMETRY = "0"
$env:QZX_BACKUPS_FORMAT = "TAR.GZ"
$env:QZX_BACKUPS_COMPRESSION = "fastest"