Python 3.14 装 agent-framework 全量卡死：resolution-too-deep（依赖图过深）

症状

Python 3.14 环境安装报错或长时间卡在构建阶段；部分包（如带 Rust/C 扩展的）无 cp314 轮子，进入源码编译。

原因

官方支持范围 Python 3.10-3.13；3.14 较新，部分依赖没有预编译轮子（2026-08-28 本环境实测信号），编译耗时且可能失败。

解法

1. 官方支持环境：用 Python 3.10-3.13 的 venv/conda 装（最稳）。

2. 3.14 用户：装 `agent-framework-core` 最小集（不加 [all]）先验证核心可用；带扩展依赖按报错逐个处理。

3. 编译失败时检查缺失构建工具：`build-essential`、Rust 工具链（如适用）。

验证证据

- 2026-08-29 实测复现（Python 3.14.4 venv + 清华镜像，实测复现日志（2026-08-29））：全量 meta 包解析约 20 分钟未收敛，pip 报 `resolution-too-deep`（Dependency resolution exceeded maximum depth）——依赖图过深而非轮子缺失：核心依赖 pydantic-core 2.46.5 有 cp314 轮子。规避：装 `agent-framework-core` 最小核心（实测成功，31MB，9 依赖）。

- 2026-08-28 本环境实测：Python 3.14.4 全量安装失败/卡编译（部分依赖无预编译轮子信号）。