安装
把 QZX 安装到你能控制的 Python 环境中
可以在虚拟环境中使用 pip，也可以使用 pipx 隔离 CLI。安装后确认版本，再运行一个不会修改系统的只读诊断。
60 秒试用 QZX
通过快速获取只读 ISO 时间戳来确认 QZX 可以运行。
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json请在终端中执行这两条命令。JSON 包含 success: true 和非空 message 表示首次检查成功；仅复制不会安装或运行任何内容。
QZX — Quick Zap Exchange 由 Alejandro Sánchez 创建并维护。
用于 Codex、Claude Code 和 Gemini CLI 的 QZX — 快速入门使用 pip
在合适的 Python 环境中安装 PyPI 上的公开包。
python -m pip install --upgrade qzx
qzx version使用 pipx 隔离 CLI
pipx 为 QZX 创建独立环境，并让可执行文件通过 PATH 使用。
pipx install qzx
qzx version第一个有用的检查
先运行不会改变状态的命令。如果你正在使用编程代理，diagnoseProject 往往比临时编写环境识别脚本更适合作为起点。
qzx getCurrentDateTimeqzx diagnoseProject .已安装 QZX，但终端找不到 qzx？
请选择与你的安装方式对应的恢复步骤。找不到启动命令，不一定意味着没有安装软件包。
通过 pip 安装：使用同一个 Python 运行
使用安装时的同一个 Python：python、python3 或 py -3.13。
python -m qzx version --json
python -m qzx getCurrentDateTime --output-format iso --json请使用执行 python -m pip install --upgrade qzx 时的同一个解释器。通过模块运行时，不需要 PATH 中存在 qzx 启动命令。
如果安装时使用的是 python3 或 py -3.13，请将下面所有命令中的 python 替换为同一个前缀。不要中途切换解释器。
出现 No module named qzx 或版本不符合预期？
重新安装前，先确认当前解释器。激活安装 QZX 的环境，再查看 pip 和软件包的位置：
python -m pip --version
python -m pip show qzx如果 pip 在这里找不到 QZX，说明这个解释器中没有该软件包。如果 qzx version --json 与模块命令显示的版本不同，它们指向不同的安装。只更新你打算使用的那一个。遇到 externally-managed-environment 时，仍应使用自己管理的环境或 pipx，而不是强行修改受管理的 Python。
通过 pipx 安装：恢复启动命令
先运行 pipx list。如果列表中有 QZX，运行 pipx ensurepath，按提示重新打开或刷新终端，再试 qzx version --json。如果列表中没有 QZX，请使用上面的 pipx 安装方式。
系统 Python 通常无法导入 pipx 隔离环境中的软件包，因此 python -m qzx 不是修复 pipx 的方法。pipx run 测试的是临时环境，而不是现有安装。
验证成功后，打开你自己的项目文件夹：使用 pip 安装时的解释器运行 python -m qzx diagnoseProject .，或使用 pipx 的启动命令运行 qzx diagnoseProject .。QZX 会检查项目，但不会执行项目的测试或构建脚本。
分享诊断结果前，请删除个人路径、凭据和私有项目详情。