# 🚀 BMAD Research Framework 安装指南

## 环境要求

- **Node.js**: >= 20.10.0
- **BMAD-METHOD**: ^4.0.0 (必需的核心框架)

## 安装方式

### 方式1: NPM安装 (推荐)

```bash
# 1. 首先确保安装了BMAD-METHOD核心框架
npm install -g bmad-method
# 或在项目中本地安装
npm install bmad-method

# 2. 安装研究框架扩展
npm install bmad-research-framework
```

### 方式2: 项目集成

```bash
# 在您的研究项目中
npm init -y
npm install bmad-method bmad-research-framework

# 创建项目结构
mkdir .bmad-research-framework
cp -r node_modules/bmad-research-framework/bmad-research-framework/* .bmad-research-framework/
```

### 方式3: 全局安装

```bash
# 全局安装用于多个项目
npm install -g bmad-method bmad-research-framework

# 在项目中初始化
mkdir my-research-project
cd my-research-project
# 然后在支持BMAD的环境中激活智能体
```

## 验证安装

```javascript
// 测试安装是否成功
const framework = require('bmad-research-framework');
console.log('框架版本:', framework.version);
console.log('可用智能体:', framework.agents.length, '个');
```

## 开始使用

在Claude Code、Cursor或其他支持BMAD的环境中：

```markdown
我想开始一个科研项目，请帮我制定研究策略。

@research-strategy-planner
```

## 故障排除

### 问题1: "找不到bmad-method"
**解决方案**: 确保先安装BMAD-METHOD核心框架
```bash
npm install bmad-method
```

### 问题2: 智能体无法激活
**解决方案**: 检查.bmad-research-framework目录是否存在
```bash
ls -la | grep bmad
# 应该看到 .bmad-research-framework/ 目录
```

### 问题3: Node.js版本过低
**解决方案**: 升级Node.js到20.10.0或更高版本
```bash
node --version  # 检查当前版本
# 访问 https://nodejs.org/ 下载最新LTS版本
```

## 高级配置

### 自定义安装路径
```bash
# 指定自定义目录
mkdir custom-research-dir
cp -r node_modules/bmad-research-framework/bmad-research-framework custom-research-dir/
```

### 项目特定配置
在项目根目录创建 `.bmad-research-config.yaml`:

```yaml
framework:
  name: "bmad-research-framework"
  path: "./custom-research-dir"
  enabled: true

shortcuts:
  start: "research-strategy-planner"
  config: "project-auto-configurator"
```

## 支持

如需帮助，请：
1. 查看 [GitHub Issues](https://github.com/The-D66/bmad-research-framework/issues)
2. 阅读 [BMAD-METHOD文档](https://github.com/bmadcode/BMAD-METHOD)
3. 在智能体中使用 `*help` 命令获取帮助