跳到主要内容

为什么选择 QZX

为你的智能体
提供清晰的起点。

QZX 将常见诊断整合为有文档说明的命令,并提供清晰的结果。你和与你协作的自动化程序都能使用同一份报告。

免费且开源Windows、Linux 和 macOS 的支持情况因命令而异易读输出和 JSON

当任务反复出现

复用检查过程,保留上下文。

这张示意图展示:当 QZX 的某项操作能够完成任务时,工作方式会如何变化。这是对工作流程的概念性比较。

原先

重新组织检查过程

  1. 选择命令

    确定环境中的工具及其参数。

  2. 解读输出

    收集每项检查返回的数据。

  3. 准备上下文

    整理观察结果,以便决定下一步。

使用 QZX

从有文档说明的操作开始

qzx diagnoseProject . --json
  1. 请求诊断

    使用支持该任务的命令。

  2. 查看依据

    检查技术栈、依赖项、发现项和未执行的检查。

  3. 决定下一步

    与人或智能体共享同一个结果。

测试项目中记录的示例

技术栈
Python
软件包(去重计数)
1
发现项
1
查看 JSON 摘录
{
    "success": true,
    "details": {
        "technologies": [
            "Python"
        ],
        "dependencies": {
            "unique_declared_package_count": 1,
            "unique_packages": [
                "httpx"
            ]
        },
        "version_control": {
            "status": "not_repository"
        },
        "file_scan": {
            "scanned_file_count": 3,
            "scan_complete": true
        },
        "summary": {
            "issue_count": 1,
            "verification": {
                "release_readiness": "not_assessed"
            }
        },
        "validation": {
            "tests": {
                "status": "configured_not_run"
            },
            "lint": {
                "status": "configured_not_run"
            }
        }
    }
}

这个接口带来什么

减少每项任务中的重复工作。

共用一套术语,结果可直接检查。

一项有文档说明的操作

在受支持的系统上,复用相同的命令名和参数模型。命令目录详细说明了每项操作的参数与要求。

探索命令

给人易读输出,给智能体结构化数据。

默认输出便于人阅读。当程序或智能体需要同一结果的结构化数据时,添加 --json。

阅读结果规范

为决策提供依据

执行状态和检查发现分别存放在不同字段中。你可以分清:检查虽然已完成,结果中仍可能有需要关注的内容。

查看实录示例

适用场景

根据任务选择工具。

QZX 可与 API 和原生命令配合使用。当它支持所需操作,且统一接口能让工作更清晰时,就适合使用它。

何时有帮助

  • 你需要有文档说明的诊断,并且它支持你使用的系统。
  • 你想向智能体提供结构化结果,并附上有用的上下文。
  • 你希望先查看依据,再执行脚本或修改文件。

仍需核实的事项

  • 命令参考文档中的可用性、依赖项和平台差异。
  • 哪些检查实际执行过:检测到测试,并不代表测试已经通过。
  • 会改变状态的操作所需的权限、备份和预览。QZX 使用你的权限运行;统一接口不会隔离执行。

如果需要平台专有能力、流式处理,或类型约束更严格的集成,请选择合适的原生 API 或工具。

从一项具体任务开始

纳入工作流程前,先看看结果。

查看已记录的示例,并在自己的环境中试用一条只读命令。

这些结果来自哪里

记录于 2026-10-08,使用 QZX 0.2.2.0.15、CPython 3.13.13 和 Windows 11 10.0.26200。

这些数值来自已记录的示例。可复制的命令会在你的终端中运行,结果取决于运行环境。