用途：系统化排查 uv（Python 包与项目管理工具）的常见故障，从依赖解析失败到环境配置问题，帮助项目恢复可用。
主要能力：区分错误类别（解析、环境、缓存、网络、锁文件）；用冗余日志定位问题；修复版本冲突与预发布版本问题；清理和恢复缓存；安装与固定 Python 版本；处理虚拟环境损坏；优化解析性能；排查 Windows PATH、macOS/Linux 权限和 Docker 构建问题。
常用命令：uv sync --verbose 查看过程；uv cache clean 清理缓存；uv lock --upgrade 强制重新解析；uv python list 检查 Python；uv python install 3.12 安装版本；uv python pin 3.12 固定版本；uv add --dry-run 检验兼容性；uv tree 查看依赖树；uv sync --frozen 使用现有锁文件加速；uv sync --reinstall 重建环境。
适用场景：依赖装不上或版本冲突、锁文件与 pyproject.toml 不同步、缓存异常导致操作反复失败、找不到或选错 Python 版本、CI/Docker 构建失败、解析过慢。
限制：需安装 uv 并提供 Python 3.8+ 与网络；部分修复需手动删缓存或改 PATH；资料未提供具体版本兼容范围、收费信息；自定义索引的具体可用性需自行验证。