# AIVoice

**Repository Path**: wilsondebug/aivoice

## Basic Information

- **Project Name**: AIVoice
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-20
- **Last Updated**: 2026-02-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI语音助手 (AIVoiceApp)

基于uni-app框架开发的智能语音识别与播报应用，集成Moxin语音模型，支持iOS和Android双平台。

## 🎯 项目概述

AI语音助手是一款功能强大的语音处理应用，提供语音识别（语音转文字）和语音播报（文字转语音）两大核心功能，支持多种音色选择，具备历史记录管理和个性化设置功能。

### 核心功能
- 🎤 **语音识别**：实时语音转文字，支持中文普通话，识别准确率≥85%
- 🔊 **语音播报**：文字转语音，支持男声、女声、童声三种音色
- 📜 **历史记录**：保存、搜索、管理识别记录，支持数据导出
- ⚙️ **个性化设置**：自定义音色、语速、音调等参数

## 🛠️ 技术栈

- **前端框架**: uni-app (Vue 3)
- **语音引擎**: Moxin模型 + Whisper语音识别
- **开发语言**: JavaScript
- **构建工具**: Vite
- **测试框架**: Jest
- **目标平台**: iOS, Android

## 📁 项目结构

```
AIVoice/
├── pages/                  # 页面文件
│   ├── index/             # 首页
│   ├── history/           # 历史记录页
│   └── settings/          # 设置页
├── utils/                 # 工具模块
│   ├── speechRecognition.js  # 语音识别模块
│   ├── speechSynthesis.js    # 语音播报模块
│   └── storage.js            # 本地存储模块
├── tests/                 # 测试文件
│   ├── unit/             # 单元测试
│   └── e2e/              # 端到端测试
├── docs/                  # 文档
│   ├── requirements.md   # 需求规格说明书
│   ├── test_report.md    # 测试报告
│   └── user_manual.md    # 用户操作手册
├── static/               # 静态资源
├── manifest.json         # 应用配置
├── pages.json           # 页面配置
├── package.json         # 项目依赖
└── vite.config.js       # Vite配置
```

## 🚀 快速开始

### 环境要求
- Node.js 16.0+
- npm 8.0+ 或 yarn 1.22+
- HBuilderX 3.6+ (推荐)

### 安装依赖

```bash
# 克隆项目
git clone https://github.com/your-org/AIVoiceApp.git
cd AIVoiceApp

# 安装依赖
npm install

# 或使用 yarn
yarn install
```

### 开发运行

```bash
# H5端
npm run dev:h5

# 微信小程序
npm run dev:mp-weixin

# App端
npm run dev:app
```

### 构建发布

```bash
# H5端
npm run build:h5

# 微信小程序
npm run build:mp-weixin

# App端（生成安装包）
npm run build:app
```

## 🧪 测试

### 运行单元测试
```bash
npm run test:unit
```

### 运行端到端测试
```bash
npm run test:e2e
```

### 代码检查
```bash
npm run lint
```

## 📱 功能模块

### 1. 语音识别模块
- 实时语音采集
- 基于Moxin模型的语音转文字
- 支持中文普通话识别
- 识别准确率≥85%
- 响应时间≤3秒

### 2. 语音播报模块
- 文字转语音
- 3种音色选择（男声、女声、童声）
- 语速调节（0.5x-2.0x）
- 音调调节（0.5-2.0）
- 播放控制（播放/暂停/停止）

### 3. 历史记录模块
- 自动保存识别记录
- 支持搜索功能
- 单条/批量删除
- 数据导出（JSON格式）
- 最多保存100条记录

### 4. 设置模块
- 音色设置
- 语速/音调调节
- 自动播报开关
- 历史记录开关
- 存储管理
- 恢复默认设置

## 📋 需求管理

本项目采用superpowers skills系统进行需求管理，建立了完整的需求跟踪矩阵。

### 功能需求
- FR-001 ~ FR-010: 核心功能需求
- NFR-001 ~ NFR-006: 非功能需求

详见 [需求规格说明书](./docs/requirements.md)

## 📊 测试报告

测试覆盖：
- ✅ 功能测试：38个用例，通过率100%
- ✅ 性能测试：9个用例，通过率100%
- ✅ 兼容性测试：10个用例，通过率100%
- ✅ 用户体验测试：5个用例，通过率100%

详见 [测试报告](./docs/test_report.md)

## 📖 使用文档

- [用户操作手册](./docs/user_manual.md) - 详细的使用指南
- [需求规格说明书](./docs/requirements.md) - 完整的需求文档
- [测试报告](./docs/test_report.md) - 详细的测试结果

## 🏗️ 架构设计

### 模块化设计
- **utils/speechRecognition.js**: 语音识别服务
- **utils/speechSynthesis.js**: 语音播报服务
- **utils/storage.js**: 本地数据存储

### 数据流
1. 用户录音 → 语音识别服务 → 识别结果
2. 识别结果 → 本地存储 → 历史记录
3. 文本输入 → 语音播报服务 → 语音输出

## 🔧 配置说明

### manifest.json
应用配置文件，包含：
- 应用基本信息
- 权限配置
- 平台特定配置

### pages.json
页面配置文件，包含：
- 页面路由
- 导航栏配置
- TabBar配置

## 📦 交付物

- [x] 完整的源代码
- [x] 需求规格说明书
- [x] 测试用例及测试报告
- [x] 用户操作手册
- [x] iOS IPA安装包
- [x] Android APK安装包

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📝 更新日志

### v1.0.0 (2026-02-20)
- ✨ 初始版本发布
- 🎤 语音识别功能
- 🔊 语音播报功能
- 📜 历史记录管理
- ⚙️ 个性化设置

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 👥 团队

- **产品经理**: AI产品团队
- **开发团队**: AI开发团队
- **测试团队**: AI测试团队

## 📞 联系我们

- **邮箱**: support@aivoice.app
- **官网**: https://www.aivoice.app
- **GitHub**: https://github.com/your-org/AIVoiceApp

---

**AI语音助手 - 让语音交互更简单！**