文档摘要

附录 C 常见报错与排查 按现象 → 原因 → 处理 组织，便于生产值班快速定位。 C.1 安装与环境 现象 | 可能原因 | 处理 不满足 | 版本 < 3.13 | 升级 Python；用 pyenv / conda | 包名错误 | 导入失败 | 未装可选依赖 | 工具不可用 | 未装 extra | C.2 API Key 与 LLM 调用 现象 | 可能原因 | 处理 HTTP 401 / Invalid API Key | 密钥错误或过期 | 检查环境变量与 Profile 中的 apikey 连接失败 | 端点 URL 错误 | 核对兼容 API 地址（含 后缀） Model not found | 模型名拼写错误 | 对照 Provider 模型列表 Rate limit

---