# flutter_agent

**Repository Path**: dongweiq/flutter_agent

## Basic Information

- **Project Name**: flutter_agent
- **Description**: 一个基于 Flutter 开发的智能 AI 助手应用，支持多模型对话、语音交互和 Markdown 渲染。
- **Primary Language**: Dart
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2025-02-28
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 助手应用

一个基于 Flutter 开发的智能 AI 助手应用，支持多模型对话、语音交互和 Markdown 渲染。

## 主要功能

### 对话功能
- 支持多轮对话
- Markdown 格式渲染
- 支持代码高亮显示
- 长按消息可复制或语音播报
- 自动保存对话历史
- 支持创建多个会话

### 语音功能
- 语音输入（按住说话）
- 语音播报（AI回复）
- 实时音量显示
- 语音识别结果自动发送

### AI模型
- 支持多个开源模型
- 可配置 API Key
- 实时响应流式输出
- 思考过程实时显示

### 其他功能
- 会话标题自动生成
- 深色/浅色主题适配
- 链接自动识别和跳转
- 权限自动检查和申请

## 开始使用

### 环境要求
- Flutter 3.5.4 或更高版本
- Dart 3.0.0 或更高版本
- Android SDK 24+ / iOS 12.0+

### 安装依赖

```bash
flutter pub get
```

### 配置
1. 在设置页面配置 API Key
2. 选择合适的 AI 模型
3. 确保授予必要的权限（麦克风等）

### 运行

```bash
flutter run
```

## 使用的主要依赖

- flutter_markdown: ^0.6.20
- flutter_tts: ^4.0.2
- ifly_speech_recognition: ^1.0.5
- shared_preferences: ^2.2.2
- url_launcher: ^6.2.5
- permission_handler: ^11.3.0

## 注意事项

1. 语音功能需要麦克风权限
2. 部分功能需要网络连接
3. API Key 请妥善保管，不要泄露
4. 建议在 WiFi 环境下使用语音功能

## 贡献

欢迎提交 Issue 和 Pull Request

## 许可证

MIT License