Initial commit: AI Shell v0.1.0

- 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
2025-07-12 22:06:15 +08:00
commit 644071850a
21 changed files with 3252 additions and 0 deletions
--- a/配置总结.md
+++ b/配置总结.md
@ -0,0 +1,117 @@
+# 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（已配置）
+- ✅ 项目依赖：已同步完成