# schulte-grid

**Repository Path**: dzj8/schulte-grid

## Basic Information

- **Project Name**: schulte-grid
- **Description**: 舒尔特方格
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 舒尔特方格 - 古诗词专注力训练

一款融合中国古诗词文化的专注力训练应用，基于经典舒尔特方格心理学方法。

## 🎯 核心功能

- **经典模式**: 5×5 数字矩阵，按 1-25 顺序点击
- **倒序挑战**: 按 25-1 倒序点击，增加难度
- **奇偶分离**: 先奇数后偶数，训练分类思维
- **古诗词模式**: 在《静夜思》《春晓》等 20 首诗词中训练，一举两得

## 🎮 技能成长系统

- **鹰眼视觉**: 增大格子尺寸
- **边缘视野**: 显示下一个目标提示
- **听觉反馈**: 数字对应音阶音效
- **触觉反馈**: 点击震动反馈
- **记忆加速**: 缩短目标刷新延迟
- **专注模式**: 隐藏干扰元素

## 🎨 三大主题

- **水墨暗色**: 默认主题，中国风水墨风格
- **宣纸浅色**: 明亮柔和，适合白天使用
- **赛博专注**: 霓虹蓝紫，科技感十足

## 📱 技术特性

- **纯本地存储**: 隐私安全，无需网络
- **Clean Architecture**: 清晰分层，易于维护
- **Riverpod 状态管理**: 响应式数据流
- **SQLite 本地数据库**: 持久化训练记录
- **音频系统**: 25 音阶钢琴音效
- **触觉反馈**: 多级别震动反馈

## 🏗️ 项目结构

```
lib/
├── main.dart                    # 应用入口
├── app.dart                     # 应用配置
├── core/                        # 核心模块
│   ├── constants/               # 常量数据
│   │   └── poems_data.dart      # 20 首古诗词
│   ├── theme/                   # 主题配置
│   │   └── app_theme.dart       # 三大主题
│   ├── utils/                   # 工具函数
│   └── services/                # 服务层
│       └── audio_service.dart   # 音频/震动服务
├── domain/                      # 领域层
│   ├── entities/                # 实体定义
│   │   ├── game_mode.dart       # 游戏模式
│   │   ├── game_state.dart      # 游戏状态
│   │   ├── grid_item.dart       # 格子项
│   │   ├── poem.dart            # 诗词实体
│   │   └── difficulty.dart      # 难度等级
│   ├── repositories/            # Repository 接口
│   └── usecases/                # 业务逻辑
│       └── game_logic.dart      # 游戏核心逻辑
├── data/                        # 数据层
│   ├── models/                  # 数据模型
│   ├── datasources/             # 数据源
│   │   └── local_database.dart  # SQLite 数据库
│   └── repositories_impl/       # Repository 实现
└── presentation/                # 展示层
    ├── pages/                   # 页面
    │   └── home_page.dart       # 首页
    ├── widgets/                 # 组件
    │   ├── mode_card.dart       # 模式卡片
    │   └── stats_summary.dart   # 统计摘要
    └── providers/               # Riverpod Providers
```

## 🚀 开发阶段

| 阶段 | 内容 | 工时 | 状态 |
|------|------|------|------|
| Phase 1 | 项目初始化 | 1 天 | ✅ 完成 |
| Phase 2 | 核心逻辑 | 3 天 | ✅ 完成 |
| Phase 3 | UI 实现 | 3 天 | ✅ 完成 |
| Phase 4 | 音频系统 | 1 天 | ✅ 完成 |
| Phase 5 | 打磨优化 | 2 天 | ✅ 完成 |
| Phase 6 | 发布准备 | 2 天 | 🔄 进行中 |

## 📦 依赖项

```yaml
dependencies:
  flutter_riverpod: ^2.4.9
  sqflite: ^2.3.0
  audioplayers: ^5.2.1
  vibration: ^1.8.4
  fl_chart: ^0.66.0
  freezed_annotation: ^2.4.1
  confetti: ^0.7.0
```

## 🎵 古诗词库

预置 20 首经典诗词，覆盖小学到初中：

- **一年级**: 静夜思、春晓、咏鹅
- **二年级**: 村居、小池、宿新市徐公店
- **三年级**: 山行、赠刘景文、夜书所见
- **四年级**: 暮江吟、题西林壁、雪梅
- **五年级**: 示儿、题临安邸、己亥杂诗
- **六年级**: 浪淘沙、江南春
- **初中**: 望岳、春望、沁园春·雪

## 📊 数据统计

- 游戏记录持久化
- 7 天训练曲线
- 各模式最佳成绩
- 准确率统计
- XP 成长系统
- 连续训练天数

## 🔒 隐私保护

- 所有数据本地存储
- 无需网络连接
- 无权限请求（仅震动）
- 无第三方 SDK

## 🛠️ 开发命令

```bash
# 获取依赖
flutter pub get

# 运行代码生成
flutter pub run build_runner build --delete-conflicting-outputs

# 运行应用
flutter run

# 构建 Release
flutter build ios --release
flutter build appbundle --release

# 运行测试
flutter test
```

## 📄 许可证

MIT License

## 👥 贡献

欢迎提交 Issue 和 Pull Request！

---

*用舒尔特方格训练专注力，在古诗词中感受文化之美* 🦐