# aigo

**Repository Path**: liangbigtree/aigo

## Basic Information

- **Project Name**: aigo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-22
- **Last Updated**: 2025-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Chat Assistant

一个基于 Flutter 开发的 AI 聊天助手应用，支持创建和管理多个 AI 智能体，提供流畅的对话体验。

## 项目结构

```
lib/
├── config/               # 配置文件
│   ├── sp_config.dart    # SharedPreferences 配置，负责数据持久化
│   └── theme_config.dart # 主题配置，包括亮色和暗色主题
│
├── models/              # 数据模型
│   ├── agent.dart       # AI 智能体模型，定义智能体的属性和方法
│   └── message.dart     # 消息模型，包括文本、图片等多种消息类型
│
├── pages/              # 页面模块
│   ├── main/          # 主页面
│   │   ├── main_page.dart        # 主页面UI
│   │   ├── main_controller.dart  # 主页面控制器
│   │   └── main_binding.dart     # 主页面依赖注入
│   │
│   ├── home/          # 首页模块
│   │   ├── home_page.dart        # 首页UI，展示AI智能体列表
│   │   ├── home_controller.dart  # 首页控制器
│   │   └── home_binding.dart     # 首页依赖注入
│   │
│   ├── chat/          # 聊天模块
│   │   ├── chat_page.dart        # 聊天页面UI
│   │   ├── chat_controller.dart  # 聊天控制器
│   │   └── chat_binding.dart     # 聊天页面依赖注入
│   │
│   ├── create/        # 创建AI模块
│   │   ├── create_page.dart      # 创建页面UI
│   │   ├── create_controller.dart # 创建页面控制器
│   │   └── create_binding.dart   # 创建页面依赖注入
│   │
│   └── settings/      # 设置模块
│       ├── settings_page.dart     # 设置页面UI
│       ├── settings_controller.dart# 设置控制器
│       └── settings_binding.dart  # 设置页面依赖注入
│
└── routes.dart        # 路由配置，管理所有页面路由

```

## 技术特点

1. **状态管理**
   - 使用 GetX 进行状态管理
   - 响应式编程，自动更新UI
   - 依赖注入，方便测试和维护

2. **UI/UX**
   - 遵循 Material Design 3 设计规范
   - 使用 flutter_screenutil 实现屏幕适配
   - 支持亮色/暗色主题切换

3. **数据持久化**
   - 使用 SharedPreferences 存储本地数据
   - 支持AI智能体数据的增删改查
   - 保存聊天历史记录

4. **功能特性**
   - AI智能体创建和管理
   - 实时对话功能
   - 消息历史记录
   - 个性化设置

## 开发规范

1. **命名规范**
   - 文件名使用小写下划线：`home_page.dart`
   - 类名使用大驼峰：`HomePage`
   - 变量和方法使用小驼峰：`userName`

2. **代码组织**
   - 每个页面模块包含 page、controller 和 binding
   - 使用 GetX 的依赖注入管理依赖
   - 控制器负责业务逻辑，页面只负责UI展示

3. **注释规范**
   - 每个文件顶部添加文件说明注释
   - 重要方法添加方法说明注释
   - 复杂逻辑添加行内注释

4. **UI开发规范**
   - 使用 flutter_screenutil 进行屏幕适配
   - 颜色和主题统一在 theme_config 中配置
   - 常用组件封装为独立的 widget

## 运行环境

- Flutter SDK: >=3.2.3 <4.0.0
- Dart SDK: >=3.2.3 <4.0.0

## 依赖包

- get: ^4.6.6 (状态管理)
- shared_preferences: ^2.2.2 (数据持久化)
- flutter_screenutil: ^5.9.0 (屏幕适配)
- cupertino_icons: ^1.0.6 (图标库)

## 开发流程

1. **环境配置**
   ```bash
   flutter pub get
   ```

2. **运行项目**
   ```bash
   flutter run
   ```

3. **打包发布**
   ```bash
   flutter build apk  # Android
   flutter build ios  # iOS
   ```

## 注意事项

1. 修改代码后确保运行 flutter analyze 检查代码质量
2. 提交代码前进行充分的测试
3. 保持代码风格统一，遵循项目规范
4. 及时更新依赖包版本，注意兼容性问题