不熟悉的项目
修改前先识别技术栈、依赖项和检查发现。
探索项目01 / 项目
先了解项目，再动手修改。
在一份报告中查看技术栈、依赖项和检查发现。检测到的测试和代码检查工具仍按实际状态标记为“已配置、未执行”。
在项目根目录中试用qzx diagnoseProject . --json
QZX 的检查发现
- 技术栈
- Python
- 软件包（去重计数）
- 1
- 发现项
- 1
已声明的依赖项 httpx
这是在一个小型测试项目中记录的结果。此次检查没有运行项目中的测试或代码检查工具。
查看 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"
}
}
}
}02 / 存储
看看空间被什么占用了。
查看卷容量，并汇总大文件与已验证重复文件的信息。诊断过程会保留文件，方便你决定如何处理。
在要检查的文件夹中试用qzx diagnoseStorage . --min-file-size 1KB --max-files 10 --duplicate-min-size-kb 1 --max-depth 2 --json
待查看的存储空间
- 已用
- 99.4%
- 可用
- 19.85 GB
- 重复文件组
- 1
这是在一个限定范围的测试文件夹中记录的结果；容量属于该文件夹所在的卷。未删除任何文件。
查看 JSON 摘录
{
"success": true,
"read_only": true,
"partial": false,
"scan_scope": {
"max_depth": 2,
"large_file_min_size": "1KB"
},
"assessment": {
"capacity_status": "critical",
"percent_used": 99.4,
"free_readable": "19.85 GB",
"duplicate_groups": 1,
"confirmed_reclaimable_bytes": 9984,
"reclaimable_space_basis": "logical_content_bytes",
"physical_reclaimable_bytes": null
}
}03 / HTTP
弄清 URL 返回了什么。
区分命令的执行状态和 HTTP 结果。在这份记录中，请求已完成，服务器返回了 404。
用公开 URL 试一试qzx checkUrlStatus https://example.com 10 --json
结合上下文看 404 响应
- HTTP 状态
- 404
- 检查
- 已完成
- 请求的资源
- 未找到
这个 404 来自本地测试 HTTP 服务器的记录。可复制的命令会访问 example.com，并获得该请求实际返回的响应。
查看 JSON 摘录
{
"success": true,
"is_online": false,
"status_code": 404
}在终端中试用
选一个问题，从一条命令开始。
安装已发布的 QZX 版本，在自己的环境中执行只读检查。
python -m pip install --upgrade qzx