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

@@ -71,42 +71,88 @@ LLM 在执行任务时需要调用各种工具,但:
## 五、子命令接口规格
### 5.1 aide env ensure
### 5.1 aide env list
**用途**:列出所有可用的环境检测模块
**语法**
```
aide env list
```
**输出**
```
可用模块:
模块 描述 能力 需要配置
────────────────────────────────────────────────────────────
python Python 解释器版本 check 否
uv uv 包管理器 check 否
venv Python 虚拟环境 check, ensure 是 [path]
requirements Python 依赖管理 check, ensure 是 [path]
当前启用: python, uv, venv, requirements
```
### 5.2 aide env ensure
**用途**:检测并修复开发环境
**语法**
```
aide env ensure [--runtime]
aide env ensure [--runtime] [--modules M1,M2] [--all] [-v]
```
**参数**
| 参数 | 说明 |
|------|------|
| `--runtime` | 仅检查 aide 运行时环境,不依赖配置文件 |
| `--runtime` | 仅检查 aide 运行时环境python + uv,不依赖配置文件 |
| `--modules M1,M2` | 指定要检测的模块(逗号分隔) |
| `--all` | 检测所有已启用模块,仅检查不修复 |
| `-v, --verbose` | 显示详细配置信息(工作目录、配置路径、模块配置等) |
**输出**
```
# 成功
环境就绪 (python:3.12, uv:0.4.0)
# 成功(完整检查)
→ 任务原文档: task-now.md
→ 任务细则文档: task-spec.md
✓ 环境就绪 (python:3.12, uv:0.4.0, venv:.venv)
✓ 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
# --verbose 输出(供人工确认)
============================================================
环境检测详细信息
============================================================
工作目录: /home/user/myproject
配置文件: /home/user/myproject/.aide/config.toml
配置存在: 是
启用模块: python, uv, venv, requirements
目标模块: python, uv, venv, requirements
[venv] 配置:
path: .venv
path (绝对): /home/user/myproject/.venv
path (存在): 是
...
```
### 5.2 aide init
### 5.3 aide init
**用途**:初始化 .aide 目录和默认配置
@@ -126,7 +172,7 @@ aide init
✓ 初始化完成,.aide/ 与默认配置已准备就绪
```
### 5.3 aide flow
### 5.4 aide flow
**用途**:进度追踪 + Git 自动提交 + 流程校验
@@ -248,7 +294,7 @@ aide flow 会自动校验环节跳转是否合理:
- `impl``flow-design` ✓(回退)
- `flow-design``finish` ✗(跳过环节)
### 5.4 aide decide
### 5.5 aide decide
**用途**:通过 Web 界面处理待定项确认
@@ -287,7 +333,7 @@ aide decide result
> 注:`note` 字段仅在用户添加备注时出现
### 5.5 aide config
### 5.6 aide config
**用途**:配置读写

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
```
---