# BMAD

**Repository Path**: myopencms/BMAD

## Basic Information

- **Project Name**: BMAD
- **Description**: 培训实操项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-23
- **Last Updated**: 2025-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Test Assistant

AI测试助手是一个基于人工智能的智能测试辅助工具，旨在提升软件测试的效率和质量。

## 功能特性

### 🚀 核心功能

- **文档解析**: 支持PDF、Word、Excel等多种格式的文档上传和智能解析
- **AI推荐引擎**: 基于用户行为和历史数据提供个性化测试用例推荐
- **智能问答**: 通过自然语言对话获取测试相关的答案和指导
- **用户行为分析**: 分析用户使用模式，优化推荐算法

### 🛠️ 技术栈

- **前端**: React 19 + TypeScript + Material-UI
- **构建工具**: Vite
- **文档解析**: PDF.js, Mammoth, SheetJS
- **AI集成**: 模拟AI服务接口，支持第三方AI服务接入
- **包管理**: pnpm

## 快速开始

### 安装依赖

```bash
pnpm install
```

### 启动开发服务器

```bash
pnpm run dev
```

### 构建生产版本

```bash
pnpm run build
```

### 类型检查

```bash
pnpm run type-check
```

## 项目结构

```
src/
├── components/          # React组件
│   ├── DocumentUpload.tsx      # 文档上传组件
│   ├── DocumentPreview.tsx     # 文档预览组件
│   ├── RecommendationPanel.tsx # AI推荐面板
│   ├── MainLayout.tsx          # 主布局组件
│   └── ChatInterface.tsx       # 聊天界面组件
├── services/           # 业务逻辑服务
│   ├── documentParser.ts      # 文档解析服务
│   ├── recommendationEngine.ts # AI推荐引擎
│   └── chatService.ts         # 聊天服务
├── types/              # TypeScript类型定义
│   ├── document.ts            # 文档相关类型
│   ├── recommendation.ts       # 推荐相关类型
│   └── conversation.ts        # 对话相关类型
├── hooks/              # React Hooks
│   ├── useRecommendations.ts  # 推荐相关Hook
│   └── useChat.ts             # 聊天相关Hook
├── utils/              # 工具函数
│   └── fileValidation.ts      # 文件验证工具
└── assets/             # 静态资源
```

## 使用说明

### 1. 文档上传

1. 点击"文档上传"标签页
2. 拖拽或点击上传PDF、Word、Excel文档
3. 系统自动解析文档内容
4. 查看解析结果和文档预览

### 2. AI推荐

1. 上传文档后切换到"AI推荐"标签页
2. 系统基于文档内容生成个性化推荐
3. 可以接受、拒绝或收藏推荐
4. 提供反馈以改进推荐质量

### 3. 智能问答

1. 切换到"智能问答"标签页
2. 输入测试相关问题
3. AI助手提供答案和建议
4. 支持多轮对话

## 开发指南

### 添加新的文档格式支持

1. 在 `src/services/documentParser.ts` 中添加新的解析方法
2. 在 `src/utils/fileValidation.ts` 中添加文件类型验证
3. 更新相关的类型定义

### 扩展AI推荐功能

1. 在 `src/services/recommendationEngine.ts` 中添加新的推荐算法
2. 在 `src/types/recommendation.ts` 中扩展推荐类型
3. 更新UI组件以支持新的推荐类型

### 自定义用户界面

1. 在 `src/components/` 目录下创建新组件
2. 使用Material-UI组件库保持一致性
3. 遵循现有的代码结构和命名规范

## 贡献指南

1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 许可证

本项目采用 ISC 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 联系方式

如有问题或建议，请通过以下方式联系：

- 创建 Issue
- 发送邮件
- 提交 Pull Request

---

**AI测试助手** - 让测试更智能，让质量更可靠