feat: 完成env重新设计

This commit is contained in:
2025-12-14 05:52:59 +08:00
parent e68eeb7e46
commit ca1a5836e1
23 changed files with 1316 additions and 743 deletions

View File

@@ -22,34 +22,82 @@ Aide 是一套命令行工具,用于支持 Aide 工作流体系。所有 aide
## aide env - 环境管理
### aide env list
列出所有可用的环境检测模块。
```bash
aide env list
```
**输出示例**
```
可用模块:
模块 描述 能力 需要配置
────────────────────────────────────────────────────────────
python Python 解释器版本 check 否
uv uv 包管理器 check 否
venv Python 虚拟环境 check, ensure 是 [path]
requirements Python 依赖管理 check, ensure 是 [path]
当前启用: python, uv, venv, requirements
```
### aide env ensure
检测并修复开发环境。
```bash
# 检查项目开发环境
# 检查项目开发环境(按配置启用的模块)
aide env ensure
# 仅检查 aide 运行时环境(不依赖配置文件)
aide env ensure --runtime
# 检测指定模块
aide env ensure --modules python,uv
# 检测所有已启用模块(仅检查不修复)
aide env ensure --all
# 显示详细配置信息(供人工确认)
aide env ensure --verbose
```
**参数**
- `--runtime`:仅检查 aide 程序自身运行所需的环境Python 等),不读取项目配置文件
| 参数 | 说明 |
|------|------|
| `--runtime` | 仅检查 aide 运行时环境python + uv |
| `--modules M1,M2` | 指定要检测的模块(逗号分隔) |
| `--all` | 检测所有已启用模块,仅检查不修复 |
| `-v, --verbose` | 显示详细配置信息 |
**输出示例**
```
✓ 环境就绪 (python:3.12, uv:0.4.0)
# 成功
✓ python: 3.14.2 (>=3.11)
✓ uv: uv 0.9.16
✓ venv: .venv
✓ requirements: requirements.txt
✓ 环境就绪 (python:3.14.2, uv:uv 0.9.16, venv:.venv, requirements:requirements.txt)
```
```
⚠ 已修复: 创建虚拟环境 .venv
环境就绪 (python:3.12)
# 自动修复
✓ python: 3.14.2 (>=3.11)
✓ uv: uv 0.9.16
→ venv: 虚拟环境不存在: .venv尝试修复...
✓ venv: 已创建
✓ 环境就绪 (...)
```
```
✗ Python 版本不满足要求 (需要 >=3.10, 当前 3.8)
建议: 安装 Python 3.10+ 或使用 pyenv 管理版本
# 失败(启用模块缺少配置)
✓ python: 3.14.2 (>=3.11)
✓ uv: uv 0.9.16
✗ venv: 已启用但缺少配置项: path
```
---