# ai_example_claude

**Repository Path**: bulogo/ai_example_claude

## Basic Information

- **Project Name**: ai_example_claude
- **Description**: claude模型搭建的大型flutter项目框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter大型项目框架

基于Clean Architecture的生产级Flutter项目框架。

---

## 🚀 快速开始

### 安装依赖

```bash
flutter pub get
```

### 运行应用

```bash
flutter run
```

---

## 📚 核心功能

### 1. 国际化（i18n）

**使用JSON方案** - 易于维护和扩展

#### 使用方法

```dart
import 'package:ai_example_2/core/l10n/app_localizations_v2.dart';

final l10n = AppLocalizationsV2.of(context);
Text(l10n.appName)
```

#### 添加翻译

编辑JSON文件：
- `assets/translations/zh_CN.json` - 中文
- `assets/translations/en_US.json` - 英文

**详细文档**: `docs/I18N_README.md`

---

### 2. 页面可见性监听

**使用VisibilityDetector** - 监听路由跳转和前后台切换

#### 使用方法（3步）

```dart
import 'package:ai_example_2/core/mixins/page_visibility_mixin.dart';

class _MyPageState extends State<MyPage> with PageVisibilityMixin {
  
  @override
  String get pageName => 'MyPage';

  @override
  void onPageVisible() {
    debugPrint('页面可见');
  }

  @override
  void onPageInvisible() {
    debugPrint('页面不可见');
  }

  @override
  Widget build(BuildContext context) {
    return wrapWithVisibilityDetector(
      Scaffold(
        // 你的UI
      ),
    );
  }
}
```

**详细文档**: `VISIBILITY_FINAL_SOLUTION.md`

---

### 3. 主题切换

支持浅色、深色、跟随系统三种模式。

```dart
final themeNotifier = ref.read(themeModeProvider.notifier);
themeNotifier.setThemeMode(ThemeMode.dark);
```

---

### 4. 语言设置

**支持简体中文和英文** - 动态切换，持久化保存

#### 使用方法

在设置页面点击"语言"选项，选择目标语言即可。

#### 代码中切换语言

```dart
// 切换到中文
ref.read(localeProvider.notifier).setLocale(const Locale('zh', 'CN'));

// 切换到英文
ref.read(localeProvider.notifier).setLocale(const Locale('en', 'US'));

// 获取当前语言
final currentLocale = ref.watch(localeProvider);
```

**详细文档**: `docs/LANGUAGE_SETTINGS_GUIDE.md`

---

### 5. 状态管理

使用Riverpod进行状态管理。

---

## 📁 项目结构

```
lib/
├── core/                    # 核心功能
│   ├── l10n/               # 国际化
│   ├── mixins/             # Mixin
│   ├── router/             # 路由
│   └── theme/              # 主题
├── features/               # 功能模块
│   ├── auth/              # 认证
│   ├── home/              # 首页
│   ├── profile/           # 个人资料
│   └── settings/          # 设置
└── main.dart              # 入口文件
```

**详细文档**: `PROJECT_STRUCTURE.md`

---

## 🛠️ 技术栈

- **状态管理**: Riverpod
- **路由**: GoRouter
- **国际化**: 自定义JSON方案
- **网络**: Dio + Retrofit
- **本地存储**: SharedPreferences, Hive
- **UI**: ScreenUtil, CachedNetworkImage

**详细文档**: `docs/TECH_STACK.md`

---

## 📖 文档

### 核心文档
- [快速开始](QUICK_START.md)
- [项目架构](ARCHITECTURE.md)
- [开发指南](DEVELOPMENT_GUIDE.md)

### 功能文档
- [国际化指南](docs/I18N_README.md)
- [语言设置指南](docs/LANGUAGE_SETTINGS_GUIDE.md)
- [页面可见性](VISIBILITY_FINAL_SOLUTION.md)
- [设置功能](docs/SETTINGS_FEATURE.md)

---

## 🎯 主要特性

- ✅ Clean Architecture架构
- ✅ 完整的国际化支持（中英文）
- ✅ 语言动态切换（简体中文/English）
- ✅ 主题切换（浅色/深色/跟随系统）
- ✅ 页面可见性监听
- ✅ 状态管理（Riverpod）
- ✅ 路由管理（GoRouter）
- ✅ 依赖注入（GetIt）

---

## 📝 License

MIT License

---

**开始构建你的Flutter应用吧！** 🚀