zackeryyy wang
644071850a
- AI-powered shell command generator using DeepSeek V3 - Support for natural language to shell command conversion - Secure configuration management with .env files - Package structure with uv tool installation support - Chinese and English language support - Configuration validation and error handling
118 lines
3.6 KiB
Markdown
118 lines
3.6 KiB
Markdown
# UV 国内源加速配置总结
|
||
|
||
## ✅ 配置完成状态
|
||
|
||
### 核心配置文件
|
||
|
||
- **uv.toml** - 主要配置文件 ⭐
|
||
- 清华大学镜像（主源）+ 阿里云、腾讯云（备源）
|
||
- 10个并发下载，智能版本选择策略
|
||
- 已优化缓存配置
|
||
|
||
- **pyproject.toml** - 项目配置文件
|
||
- Python 版本：>=3.12（当前使用 3.12.11）
|
||
- 核心依赖：pydantic-ai, google-genai, requests
|
||
|
||
### 2. 配置的镜像源
|
||
|
||
| 镜像源 | URL | 状态 |
|
||
|--------|-----|------|
|
||
| 清华大学 | https://pypi.tuna.tsinghua.edu.cn/simple | 主源 ✅ |
|
||
| 阿里云 | https://mirrors.aliyun.com/pypi/simple/ | 备用 ✅ |
|
||
| 腾讯云 | https://mirrors.cloud.tencent.com/pypi/simple/ | 备用 ✅ |
|
||
|
||
### 3. 性能测试结果
|
||
|
||
- ✅ PyPI 包解析速度：0.02秒（极快）
|
||
- ✅ 包安装速度：显著提升（使用国内镜像源）
|
||
- ✅ 配置文件检测：全部通过
|
||
- ✅ Python 版本：3.12.11（已正确配置）
|
||
- ⚠️ Python 解释器下载：仍需要优化（建议使用系统包管理器）
|
||
|
||
## 🚀 使用方法
|
||
|
||
### 基本命令
|
||
|
||
```bash
|
||
# 安装依赖
|
||
uv sync
|
||
|
||
# 添加新包
|
||
uv add package-name
|
||
|
||
# 运行脚本
|
||
uv run python script.py
|
||
|
||
# 激活虚拟环境
|
||
uv shell
|
||
```
|
||
|
||
### 验证配置
|
||
|
||
```bash
|
||
# 运行测试脚本
|
||
uv run python test_uv_config.py
|
||
```
|
||
|
||
## 📁 当前项目结构
|
||
|
||
```
|
||
ai-shell/
|
||
├── ai.py # 主程序（AI shell 命令生成器）
|
||
├── pyproject.toml # 项目配置文件
|
||
├── uv.toml # UV 配置文件（核心）
|
||
├── uv.lock # 依赖锁定文件（自动生成）
|
||
├── .python-version # Python 版本文件（自动生成）
|
||
├── .venv/ # 虚拟环境（自动生成）
|
||
├── README.md # 项目说明
|
||
├── 配置总结.md # 本文件
|
||
└── 项目配置说明.md # 详细配置说明
|
||
```
|
||
|
||
## 🎯 配置优势
|
||
|
||
1. **PyPI 包速度提升**：使用国内镜像源，包下载速度显著提升
|
||
2. **稳定性**：多个备用镜像源，确保可用性
|
||
3. **兼容性**：支持所有 uv 功能
|
||
4. **易维护**：配置文件清晰，易于修改
|
||
5. **版本管理**：正确配置 Python 版本要求，避免兼容性问题
|
||
|
||
## 🔧 故障排除
|
||
|
||
如果遇到问题：
|
||
|
||
1. **网络问题**：检查网络连接，尝试切换镜像源
|
||
2. **缓存问题**：运行 `uv cache clean` 清除缓存
|
||
3. **配置冲突**：确保 uv.toml 配置正确
|
||
|
||
## 📝 注意事项
|
||
|
||
- uv.toml 文件优先级高于 pyproject.toml 中的 [tool.uv] 配置
|
||
- 使用 unsafe-best-match 策略可能有安全风险，但提供更好的包版本选择
|
||
- 定期更新镜像源地址以确保最佳性能
|
||
|
||
## 🐍 关于 Python 解释器下载
|
||
|
||
**重要说明**：
|
||
- ✅ **PyPI 包下载**：已成功配置国内镜像源，速度很快
|
||
- ⚠️ **Python 解释器下载**：镜像源配置复杂，建议使用以下替代方案：
|
||
|
||
### 推荐的 Python 版本管理方案：
|
||
1. **使用系统包管理器**：`brew install python@3.12` (macOS)
|
||
2. **使用 pyenv**：`pyenv install 3.12.0`
|
||
3. **使用 conda**：`conda install python=3.12`
|
||
4. **使用现有版本**：您已有 Python 3.12.11，完全可用
|
||
|
||
### 如果必须用 uv 下载 Python：
|
||
- 考虑使用代理：`export HTTPS_PROXY=your_proxy`
|
||
- 或者耐心等待：Python 解释器文件较大，首次下载需要时间
|
||
|
||
---
|
||
|
||
🎉 **配置完成！现在您可以享受快速的 Python 包管理体验了！**
|
||
|
||
📋 **当前状态**：
|
||
- ✅ PyPI 包下载：极快（国内镜像源）
|
||
- ✅ Python 版本：3.12.11（已配置）
|
||
- ✅ 项目依赖：已同步完成
|