# lexiflow

**Repository Path**: wtm/lexiflow

## Basic Information

- **Project Name**: lexiflow
- **Description**: lexiflow
- **Primary Language**: Dart
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LexiFlow

> 完全离线的单词学习 APP — 基于 Flutter 构建

## 概述

LexiFlow 是一个 100% 离线的单词学习应用，无需网络连接、无需账号即可使用。内置 11 个官方词库（小学/初中/高中/四六/考研/雅思/托福/GRE/SAT/BEC），支持自定义词库导入、艾宾浩斯遗忘曲线复习、5 种学习模式、生词本/熟词表管理、数据统计与导出。

## 技术栈

| 类别 | 技术选型 |
|------|---------|
| 框架 | Flutter 3.32+ / Dart 3.8+ |
| 状态管理 | Riverpod 2.5+ |
| 路由 | GoRouter 14 |
| 数据库 | Isar 3.1（嵌入式 NoSQL） |
| 发音 | flutter_tts（系统 TTS 引擎） |
| 图表 | fl_chart 0.69 |
| 备份 | ZIP 归档 + SHA-256 校验 |

## 功能特性

- **11 个官方词库**：覆盖 K12 到 GRE 全阶段
- **5 种学习模式**：卡片、拼写、听写、英英、滚动
- **艾宾浩斯复习**：间隔 [0, 1, 2, 4, 7, 15] 天，动态调整 easeFactor
- **导入格式**：TXT / CSV / XLSX / JSON / Markdown / PDF
- **导出格式**：PDF / CSV / Excel / JSON
- **本地备份**：.lexi 格式（ZIP + SHA-256 校验）
- **5 种主题**：跟随系统 / 浅色 / 深色 / 纯黑 / 纸张白
- **跨平台**：Android / iOS / Windows / macOS

## 快速开始

### 环境要求

- Flutter SDK >= 3.32.0
- Dart SDK >= 3.8.0
- Android Studio / Xcode（用于移动端构建）
- Visual Studio with C++ build tools（用于 Windows 构建）

### 安装与运行

```bash
# 1. 安装依赖
flutter pub get

# 2. 运行（开发模式）
flutter run

# 3. 运行测试
flutter test

# 4. 静态分析
flutter analyze

# 5. 构建发布包
flutter build apk --release    # Android
flutter build exe --release     # Windows
flutter build macos --release   # macOS
```

## 项目结构

```
lexiflow/
├── lib/
│   ├── app/                    # 应用入口与路由配置
│   ├── core/                   # 核心层（常量、异常、扩展、工具、主题、国际化）
│   │   ├── constants/
│   │   ├── exceptions/
│   │   ├── extensions/
│   │   ├── localization/
│   │   ├── theme/
│   │   └── utils/
│   ├── database/               # Isar 数据库服务
│   ├── models/                 # 数据模型（8 个 Isar Collection）
│   ├── repository/             # Repository 层（5 个 Repository）
│   ├── services/               # 业务服务层（7 个 Service）
│   ├── providers/              # Riverpod 状态管理（5 个 Provider 文件）
│   ├── pages/                  # 页面（onboarding / home / study / stats / vocabulary / settings / profile）
│   ├── routes/                 # GoRouter 路由配置
│   └── widgets/                # 通用 Widget
├── assets/
│   ├── dictionaries/           # 11 个官方词库 JSON
│   └── images/
├── test/
│   ├── unit/                   # 单元测试（29 个文件）
│   ├── widget/                 # Widget 测试（2 个文件）
│   └── integration/            # 集成测试（3 个文件）
├── docs/                       # 技术文档
├── scripts/                    # 构建与生成脚本
└── pubspec.yaml
```

## 性能指标

| 指标 | 目标 | 实现方式 |
|------|------|---------|
| 启动时间 | < 2s | 异步初始化 + Splash 页 |
| 搜索响应 | < 100ms | Isar 索引 + Debouncer 防抖 |
| PDF 导出 10000 词 | < 5s | pdf 包 + 流式写入 |
| 内存占用 | < 250MB | 分页加载 + 按需查询 |

## 测试覆盖率

- 单元测试：29 个文件，覆盖所有模型、服务、工具类
- Widget 测试：StudyCard、WelcomePage
- 集成测试：用户流程、批量导入、30 天复习周期
- 目标覆盖率：≥ 85%

## 文档

- [架构设计](docs/architecture.md)
- [数据库设计](docs/database.md)
- [复习引擎](docs/review_engine.md)
- [导入导出](docs/import_export.md)
- [测试策略](docs/testing.md)
- [构建指南](docs/build.md)
- [发布流程](docs/release.md)

## 许可证

MIT License