# tech_learn

**Repository Path**: hongshu2018/tech_learn

## Basic Information

- **Project Name**: tech_learn
- **Description**: 语音交互学习APP - 通过语音问答进行知识学习
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Voice Learning App

## 项目简介

语音交互学习APP - 通过语音问答进行知识学习

### 核心功能

- 语音输入 - 按住说话，自动识别
- 语音播报 - AI回答自动朗读
- 文字记录 - 问答内容保存为文字
- 历史回顾 - 随时查看历史知识点
- 多AI后端 - 支持配置多种AI服务
- 多平台支持 - Windows、macOS、Android、HarmonyOS

## 技术栈

| 类别 | 技术选型 | 版本 |
|------|----------|------|
| 框架 | Flutter | 3.19+ |
| 状态管理 | flutter_bloc | ^8.1.3 |
| 语音识别 | Whisper | 本地/云端 |
| 语音合成 | flutter_tts | 本地/云端 |
| 本地存储 | sqflite | ^2.3.2 |

## 支持的AI后端

| 提供商 | 状态 | 说明 |
|--------|------|------|
| OpenAI (GPT-4/GPT-3.5) | 支持 | OpenAI API |
| Ollama (本地模型) | 支持 | 本地部署 |
| 硅基流动 | 支持 | 国内可用 |
| MiniMax | 支持 | 国内厂商 |
| 智谱GLM | 支持 | 国内厂商 |
| 阿里通义 | 支持 | 国内厂商 |

## 项目结构

```
voice_learning_app/
├── lib/
│   ├── main.dart                 # 应用入口
│   ├── app.dart                  # 应用配置
│   ├── injection.dart            # 依赖注入
│   ├── core/                     # 核心模块
│   │   ├── constants/            # 常量定义
│   │   ├── router/               # 路由配置
│   │   └── theme/                # 主题配置
│   ├── data/                     # 数据层
│   │   ├── datasources/local/    # 本地数据源
│   │   ├── models/               # 数据模型
│   │   └── repositories/         # 仓储实现
│   ├── domain/                   # 领域层
│   │   └── repositories/         # 仓储接口
│   ├── presentation/             # 表现层
│   │   ├── pages/                # 页面组件
│   │   ├── widgets/              # 通用组件
│   │   └── blocs/                # 状态管理
│   └── services/                 # 服务层
│       ├── ai/adapters/          # AI适配器
│       ├── voice/                # 语音服务
│       ├── tts/                  # TTS服务
│       ├── storage/              # 存储服务
│       └── file/                 # 文件服务
├── k8s/                          # Kubernetes配置
├── .github/workflows/            # CI/CD配置
├── Dockerfile                    # 生产环境Dockerfile
├── Dockerfile.dev                # 开发环境Dockerfile
├── docker-compose.yml            # Docker Compose配置
└── pubspec.yaml                  # 项目依赖
```

## 开发环境

### 环境要求

- Flutter SDK 3.19+
- Android SDK (Android开发)
- Xcode (iOS开发，仅macOS)
- Docker (容器化开发)

### 本地开发

```bash
# 获取依赖
flutter pub get

# 代码分析
flutter analyze --no-fatal-infos

# 运行测试
flutter test

# 启动开发服务器
flutter run
```

### Docker 开发

```bash
# 启动开发容器 (支持热重载)
docker-compose up flutter-dev

# 构建生产镜像
docker build -t voice-learning:latest .
```

## 构建命令

### Android

```bash
# Debug APK
flutter build apk --debug

# Release APK
flutter build apk --release
```

### Windows

```bash
# Debug
flutter build windows --debug

# Release
flutter build windows --release
```

### macOS

```bash
# Debug
flutter build macos --debug

# Release
flutter build macos --release
```

### Linux

```bash
flutter build linux --release
```

## Kubernetes 部署

```bash
# 开发环境
kubectl apply -k k8s/overlays/dev

# 生产环境
kubectl apply -k k8s/overlays/prod
```

## 配置说明

### AI 后端配置

在设置页面添加AI配置，支持以下参数：

- 名称: 配置显示名称
- 提供商: OpenAI/Ollama/硅基流动等
- API地址: 后端服务地址
- API密钥: 访问密钥
- 模型: 模型名称
- 优先级: 数字越小越优先使用

### TTS 配置

支持以下语音合成方案：

- 本地TTS: 使用设备自带语音引擎
- 云端TTS: MiniMax/阿里云/腾讯云

## License

MIT License