✨ feat: 实现扩展模块和设置命令
This commit is contained in:
@@ -22,46 +22,16 @@ 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 运行时环境（init 流程使用）
|
||||
aide env ensure --runtime
|
||||
|
||||
# 检测指定模块
|
||||
aide env ensure --modules python,uv
|
||||
|
||||
# 检测所有已启用模块（仅检查不修复）
|
||||
aide env ensure --all
|
||||
|
||||
# 显示详细配置信息（供人工确认）
|
||||
aide env ensure --verbose
|
||||
# 检查项目开发环境（按配置启用的模块）
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
**参数**：
|
||||
@@ -79,27 +49,33 @@ aide env ensure --verbose
|
||||
# 成功
|
||||
✓ 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)
|
||||
✓ 环境就绪 (python:3.14.2, uv:uv 0.9.16)
|
||||
```
|
||||
|
||||
```
|
||||
# 自动修复
|
||||
✓ python: 3.14.2 (>=3.11)
|
||||
✓ uv: uv 0.9.16
|
||||
→ venv: 虚拟环境不存在: .venv，尝试修复...
|
||||
✓ venv: 已创建
|
||||
✓ 环境就绪 (...)
|
||||
```
|
||||
|
||||
```
|
||||
# 失败（启用模块缺少配置）
|
||||
✓ python: 3.14.2 (>=3.11)
|
||||
✓ uv: uv 0.9.16
|
||||
# 失败
|
||||
✗ venv: 已启用但缺少配置项: path
|
||||
```
|
||||
|
||||
**失败处理**：当 `aide env ensure` 输出 `✗` 时，触发 `env-config` skill 获取详细配置指导。
|
||||
|
||||
### aide env list
|
||||
|
||||
列出所有可用的环境检测模块。
|
||||
|
||||
```bash
|
||||
aide env list
|
||||
```
|
||||
|
||||
### aide env set
|
||||
|
||||
设置环境配置（详细用法见 `env-config` skill）。
|
||||
|
||||
```bash
|
||||
aide env set modules <模块列表>
|
||||
aide env set <模块名>.<配置项> <值>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## aide flow - 进度追踪
|
||||
|
||||
256
aide-marketplace/aide-plugin/skills/env-config/SKILL.md
Normal file
256
aide-marketplace/aide-plugin/skills/env-config/SKILL.md
Normal file
@@ -0,0 +1,256 @@
|
||||
---
|
||||
name: env-config
|
||||
description: 环境配置详细指南。当 aide env ensure 检测失败需要配置环境时使用。提供模块选择、配置设置、多项目场景处理等详细指导。
|
||||
---
|
||||
|
||||
# 环境配置指南
|
||||
|
||||
当 `aide env ensure` 检测失败（输出 `✗`）时，使用本指南分析项目所需环境并完成配置。
|
||||
|
||||
---
|
||||
|
||||
## 一、问题诊断
|
||||
|
||||
### 1.1 常见失败原因
|
||||
|
||||
| 错误信息 | 原因 | 解决方案 |
|
||||
|----------|------|----------|
|
||||
| `已启用但缺少配置项: path` | 类型B模块未配置路径 | 使用 `aide env set` 配置 |
|
||||
| `未知模块: xxx` | 启用了不存在的模块 | 检查模块名拼写 |
|
||||
| `xxx 未安装` | 工具未安装 | 安装对应工具或移除该模块 |
|
||||
| `node_modules 不存在` | Node.js 依赖未安装 | 配置 node_deps 模块 |
|
||||
|
||||
### 1.2 查看可用模块
|
||||
|
||||
```bash
|
||||
aide env list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、模块分类
|
||||
|
||||
### 2.1 类型A：全局工具检测（无需配置）
|
||||
|
||||
| 模块 | 检测内容 |
|
||||
|------|----------|
|
||||
| `python` | Python 解释器版本 |
|
||||
| `uv` | uv 包管理器 |
|
||||
| `rust` | Rust 工具链（rustc + cargo） |
|
||||
| `node` | Node.js 运行时 |
|
||||
| `flutter` | Flutter SDK |
|
||||
| `android` | Android SDK（ANDROID_HOME） |
|
||||
|
||||
### 2.2 类型B：项目级检测（需要配置）
|
||||
|
||||
| 模块 | 配置项 | 说明 |
|
||||
|------|--------|------|
|
||||
| `venv` | `path` | Python 虚拟环境目录 |
|
||||
| `requirements` | `path` | Python 依赖文件路径 |
|
||||
| `node_deps` | `path`, `manager`(可选) | Node.js 项目依赖 |
|
||||
|
||||
---
|
||||
|
||||
## 三、配置命令
|
||||
|
||||
### 3.1 aide env set
|
||||
|
||||
```bash
|
||||
# 设置启用的模块列表
|
||||
aide env set modules <模块列表>
|
||||
|
||||
# 设置模块配置
|
||||
aide env set <模块名>.<配置项> <值>
|
||||
```
|
||||
|
||||
### 3.2 验证规则
|
||||
|
||||
- 设置 `modules` 时，验证每个模块类型是否存在
|
||||
- 无效模块名会报错并显示可用模块列表
|
||||
|
||||
```bash
|
||||
# 验证失败示例
|
||||
$ aide env set modules python,fortran
|
||||
✗ 未知模块: fortran
|
||||
→ 可用模块: python, uv, venv, requirements, rust, node, flutter, node_deps, android
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、项目类型配置
|
||||
|
||||
### 4.1 项目特征与模块映射
|
||||
|
||||
| 项目特征 | 推荐模块 |
|
||||
|----------|----------|
|
||||
| 存在 `Cargo.toml` | `rust` |
|
||||
| 存在 `package.json` | `node`, `node_deps` |
|
||||
| 存在 `pubspec.yaml` | `flutter` |
|
||||
| 存在 `build.gradle` 或 `android/` | `android` |
|
||||
| 存在 `requirements.txt` 或 `.venv` | `python`, `uv`, `venv`, `requirements` |
|
||||
|
||||
### 4.2 配置示例
|
||||
|
||||
**Rust 项目**：
|
||||
```bash
|
||||
aide env set modules rust
|
||||
```
|
||||
|
||||
**Node.js 项目**：
|
||||
```bash
|
||||
aide env set modules node,node_deps
|
||||
aide env set node_deps.path .
|
||||
```
|
||||
|
||||
**Flutter 项目**：
|
||||
```bash
|
||||
aide env set modules flutter
|
||||
# 如果需要构建 Android APK
|
||||
aide env set modules flutter,android
|
||||
```
|
||||
|
||||
**Python 项目**：
|
||||
```bash
|
||||
aide env set modules python,uv,venv,requirements
|
||||
aide env set venv.path .venv
|
||||
aide env set requirements.path requirements.txt
|
||||
```
|
||||
|
||||
**混合项目**（多种技术栈）：
|
||||
```bash
|
||||
aide env set modules rust,node,flutter,android
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、多项目场景
|
||||
|
||||
### 5.1 模块实例化命名
|
||||
|
||||
当工作目录下有多个同类型子项目时，使用 `模块类型:实例名` 格式：
|
||||
|
||||
```bash
|
||||
# 多个 Node.js 项目
|
||||
aide env set modules node,node_deps:frontend,node_deps:admin
|
||||
aide env set node_deps:frontend.path frontend
|
||||
aide env set node_deps:admin.path admin
|
||||
```
|
||||
|
||||
### 5.2 配置文件格式
|
||||
|
||||
```toml
|
||||
[env]
|
||||
modules = ["node", "node_deps:frontend", "node_deps:admin"]
|
||||
|
||||
[env."node_deps:frontend"]
|
||||
path = "frontend"
|
||||
|
||||
[env."node_deps:admin"]
|
||||
path = "admin"
|
||||
manager = "pnpm"
|
||||
```
|
||||
|
||||
### 5.3 输出示例
|
||||
|
||||
```
|
||||
✓ node: 24.11.1 (npm 11.6.2)
|
||||
✓ node_deps:frontend: frontend (npm)
|
||||
✓ node_deps:admin: admin (pnpm)
|
||||
✓ 环境就绪 (...)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、node_deps 模块详解
|
||||
|
||||
### 6.1 配置项
|
||||
|
||||
| 配置项 | 必需 | 说明 |
|
||||
|--------|------|------|
|
||||
| `path` | 是 | package.json 所在目录 |
|
||||
| `manager` | 否 | 包管理器，默认自动检测 |
|
||||
|
||||
### 6.2 包管理器自动检测
|
||||
|
||||
根据锁文件自动判断：
|
||||
|
||||
| 锁文件 | 包管理器 |
|
||||
|--------|----------|
|
||||
| `pnpm-lock.yaml` | pnpm |
|
||||
| `yarn.lock` | yarn |
|
||||
| `bun.lockb` | bun |
|
||||
| `package-lock.json` 或无 | npm |
|
||||
|
||||
### 6.3 ensure 行为
|
||||
|
||||
检测失败时自动运行对应的安装命令：
|
||||
- npm: `npm install`
|
||||
- pnpm: `pnpm install`
|
||||
- yarn: `yarn install`
|
||||
- bun: `bun install`
|
||||
|
||||
---
|
||||
|
||||
## 七、配置流程
|
||||
|
||||
### 7.1 标准流程
|
||||
|
||||
```bash
|
||||
# 1. 查看可用模块
|
||||
aide env list
|
||||
|
||||
# 2. 分析项目类型，设置模块
|
||||
aide env set modules <根据项目选择>
|
||||
|
||||
# 3. 配置类型B模块（如有）
|
||||
aide env set <模块>.<配置项> <值>
|
||||
|
||||
# 4. 验证配置
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
### 7.2 快速配置模板
|
||||
|
||||
**前端项目**：
|
||||
```bash
|
||||
aide env set modules node,node_deps
|
||||
aide env set node_deps.path .
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
**全栈项目**：
|
||||
```bash
|
||||
aide env set modules node,node_deps:frontend,node_deps:backend
|
||||
aide env set node_deps:frontend.path frontend
|
||||
aide env set node_deps:backend.path backend
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
**移动端项目**：
|
||||
```bash
|
||||
aide env set modules flutter,android
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 八、故障排除
|
||||
|
||||
### 8.1 模块检测失败
|
||||
|
||||
```bash
|
||||
# 查看详细信息
|
||||
aide env ensure --verbose
|
||||
```
|
||||
|
||||
### 8.2 重置配置
|
||||
|
||||
直接修改 `.aide/config.toml` 或重新运行：
|
||||
|
||||
```bash
|
||||
aide env set modules <新的模块列表>
|
||||
```
|
||||
|
||||
### 8.3 跳过某个模块
|
||||
|
||||
从 modules 列表中移除该模块即可。
|
||||
Reference in New Issue
Block a user