# study-chinese

**Repository Path**: liuchangng/study-chinese

## Basic Information

- **Project Name**: study-chinese
- **Description**: 一站式中文智能学习平台 · 覆盖汉字、成语、谜语、诗词、对联、思维题、文化常识、阅读、课本、英语十大核心模块
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: feature-english-tts
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-21
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学中文 (Study Chinese)

> 跨平台中文学习与阅读应用，采用 Flutter + 预填充数据库架构，支持 Android / Windows / Web 三端。

**仓库地址**：
- GitHub: https://github.com/liuchangng/study-chinese
- Gitee: https://gitee.com/liuchangng/study-chinese

## 项目结构

```
study-chinese/
├── client/                  # Flutter 客户端
│   ├── lib/                 # Dart 源码（core / features / shared）
│   ├── android/             # Android 平台
│   ├── windows/             # Windows 平台
│   ├── web/                 # Web 平台
│   ├── assets/              # 静态资源（预填充DB + JSON数据）
│   ├── test/                # 单元测试
│   ├── pubspec.yaml         # Flutter 依赖
│   └── README.md            # 客户端详细文档
│
├── docs/                    # 项目文档与截图
│   ├── README.md            # 完整项目文档（含截图）
│   └── images/              # 应用截图
│
├── tools/                   # 数据处理工具
│   ├── content_checker/     # 内容检查脚本
│   └── textbook_editor/     # 课本编辑器
│
├── english/                 # 英语课本数据处理
├── math/                    # 数学课本数据处理
├── build_all.bat            # 一键构建脚本（Android + Windows）
└── README.md                # 本文件
```

## 功能概览

| 模块 | 功能 | 数据量 |
|------|------|--------|
| 汉字学习 | 笔画动画、笔顺演示、笔画名称、叠字查询 | 20,904 字 + 9,440 笔顺 |
| 成语词典 | 成语查询与学习 | 30,895 条 |
| 古诗词 | 诗词浏览与背诵 | 8,472 首 |
| 对联 | 传统对联欣赏 | 20,000 副 |
| 谜语 | 字谜与猜谜 | 30,028 则 |
| 思维题 | 数学思维训练 | 12,626 道 |
| 文化常识 | 中华文化知识库 | — |
| 语文课本 | 小学语文同步学习 | 四年级上下册 |
| 英语学习 | 课程/单词/练习 | 四年级上册 |
| 阅读器 | EPUB/PDF/TXT/MOBI，微信读书风格 + TTS | — |
| 打卡系统 | 学习打卡、积分奖励、积分商城 | — |
| 设置 | 主题切换、数据管理、阅读统计 | — |

## 技术栈

| 层 | 技术 |
|----|------|
| 前端 | Flutter 3.x + Dart 3.12+ + Riverpod + GoRouter |
| 存储 | SQLite（sqflite 全平台）+ Hive（设置/阅读状态） |
| 数据 | 预填充数据库（69MB）+ JSON（Web 端导入） |

## 快速开始

```bash
# 前端开发
cd client
flutter pub get
flutter run

# 一键构建（Android + Windows）
# 双击 build_all.bat

# Web
cd client
flutter run -d web-server --web-port=8080
```

详见 [client/README.md](client/README.md) 和 [docs/README.md](docs/README.md)。

## 构建产物

| 平台 | 产物 | 大小 |
|------|------|------|
| Android | `client/build/app/outputs/flutter-apk/app-release.apk` | ~119MB |
| Windows | `client/build/windows/x64/runner/Release/` | ~211MB |
| Web | `client/build/web/` | — |

## 附件下载

APK / EXE 安装包通过 Release 分发：

| 平台 | 下载地址 |
|------|----------|
| Android APK | [GitHub Releases](https://github.com/liuchangng/study-chinese/releases) / [Gitee Releases](https://gitee.com/liuchangng/study-chinese/releases) |
| Windows EXE | [GitHub Releases](https://github.com/liuchangng/study-chinese/releases) / [Gitee Releases](https://gitee.com/liuchangng/study-chinese/releases) |