name: environment-triage description: 环境诊断 user-invocable: false
环境诊断
当 uv sync 或 pip install 行为异常时，检查实际解释器。
模式
如果 uv/venv 选择了不同的解释器，系统 Python 可能不是权威的。
操作
# uv 实际使用的解释器
uv run python --version
# 被固定的版本（这控制 uv）
cat .python-version
# 确认包是否已安装
uv pip show <package>
# 在 uv 上下文中确认导入是否正常
uv run python -c "import <package>; print(<package>.__version__)"
常见修复
如果可选依赖需要 Python 3.12+，但 .python-version 是 3.11：
echo "3.13" > .python-version
rm -rf .venv && uv venv && uv sync --all-extras
不要
- 使用 uv 时信任
python3 --version - 假设安装成功而未验证导入
- 在检查解释器版本前进一步调试
来源会话
- 2243c067: symbolica-agentica 由于
python_version >= 3.12标记被跳过，但 uv 正在使用 3.11 - 4784f390: agentica 导入失败追溯至错误解释器