environment-triage

检查实际被 uv/venv 使用的 Python 解释器与已装包情况。

用来查清到底是哪个 Python 解释器在被 uv/venv 使用，以及那台解释器里装了哪些包。遇到 uv sync 或 pip install 行为异常、导入失败或版本不对的时候用它来排查。特别之处是区分系统 Python 和 uv/venv 实际选用的解释器，能帮你确定问题源头而不是盲改全局环境。

# Environment Triage

When `uv sync` or `pip install` behaves unexpectedly, check the actual interpreter.

## Pattern

System Python is not authoritative if uv/venv selects a different interpreter.

## DO

```bash
# What uv ACTUALLY uses
uv run python --version

# What's pinned (this controls uv)
cat .python-version

# Confirm package is installed
uv pip show <package>

# Confirm import works in uv context
uv run python -c "import <package>; print(<package>.__version__)"
```

## Common Fix

If optional deps require Python 3.12+ but .python-version is 3.11:

```bash
echo "3.13" > .python-version
rm -rf .venv && uv venv && uv sync --all-extras
```

## DON'T

- Trust `python3 --version` when us