欢迎加入开源鸿蒙跨平台社区：
https://openharmonycrossplatform.csdn.net

一、项目概述

运行效果图

1.1 应用简介

古诗词学习是一款传统文化学习应用，收录了唐诗、宋词、元曲等经典古诗词作品。应用提供原文、注释、赏析、作者介绍等丰富内容，支持分类浏览、搜索查询、收藏管理、学习记录等功能，帮助用户深入了解古诗词文化，传承中华优秀传统文化。

应用以典雅的墨绿色为主色调，象征传统文化的深厚底蕴与文人雅士的气质。涵盖诗词浏览、分类学习、收藏管理、学习记录四大模块。用户可以浏览经典诗词、查看详细注释、学习赏析内容、收藏喜欢的作品，系统地学习古诗词知识。

1.2 核心功能

1.3 朝代分类定义

1.4 题材分类定义

1.5 学习等级定义

1.6 技术栈

1.7 项目结构

lib/
└── main_poetry_learning.dart
    ├── PoetryLearningApp               # 应用入口
    ├── Dynasty                         # 朝代枚举
    ├── Theme                           # 题材枚举
    ├── LearningLevel                   # 学习等级枚举
    ├── Poem                            # 诗词模型
    ├── Author                          # 作者模型
    ├── LearningRecord                  # 学习记录模型
    ├── PoetryLearningHomePage          # 主页面（底部导航）
    ├── _buildBrowsePage                # 浏览页面
    ├── _buildCategoryPage              # 分类页面
    ├── _buildFavoritesPage             # 收藏页面
    ├── _buildProfilePage               # 个人页面
    └── PoemDetailPage                  # 诗词详情页

二、系统架构

2.1 整体架构图

2.2 类图设计

2.3 页面导航流程

2.4 学习流程

三、核心模块设计

3.1 数据模型设计

3.1.1 朝代枚举

enum Dynasty {
  tang(label: '唐代', emoji: '📜', description: '诗歌鼎盛时期', workCount: 120),
  song(label: '宋代', emoji: '📖', description: '词作辉煌时代', workCount: 80),
  yuan(label: '元代', emoji: '🎭', description: '曲作兴起时期', workCount: 40),
  ming(label: '明代', emoji: '📚', description: '诗词复兴时期', workCount: 30),
  qing(label: '清代', emoji: '📝', description: '古典诗词总结', workCount: 25),
  preQin(label: '先秦', emoji: '🏛️', description: '诗歌起源时期', workCount: 15);

  final String label;
  final String emoji;
  final String description;
  final int workCount;
  const Dynasty({
    required this.label,
    required this.emoji,
    required this.description,
    required this.workCount,
  });
}

3.1.2 题材枚举

enum Theme {
  landscape(label: '山水田园', emoji: '🏔️', description: '描写自然风光'),
  border(label: '边塞军旅', emoji: '⚔️', description: '描写边塞生活'),
  history(label: '咏史怀古', emoji: '🏛️', description: '借古讽今'),
  farewell(label: '送别离别', emoji: '👋', description: '离别之情'),
  homesick(label: '思乡怀人', emoji: '🌙', description: '思念之情'),
  love(label: '爱情婚姻', emoji: '💕', description: '爱情主题'),
  philosophy(label: '哲理人生', emoji: '💭', description: '人生感悟'),
  object(label: '咏物抒怀', emoji: '🌸', description: '借物抒情');

  final String label;
  final String emoji;
  final String description;
  const Theme({
    required this.label,
    required this.emoji,
    required this.description,
  });
}

3.1.3 诗词模型

class Poem {
  final String id;              // 诗词ID
  final String title;           // 标题
  final String author;          // 作者
  final Dynasty dynasty;        // 朝代
  final Theme theme;            // 题材
  final String content;         // 原文
  final String annotation;      // 注释
  final String appreciation;    // 赏析
  final String translation;     // 译文
  final int viewCount;          // 浏览次数
  final bool isFavorite;        // 是否收藏

  const Poem({
    required this.id,
    required this.title,
    required this.author,
    required this.dynasty,
    required this.theme,
    required this.content,
    required this.annotation,
    required this.appreciation,
    required this.translation,
    this.viewCount = 0,
    this.isFavorite = false,
  });

  Poem copyWith({
    int? viewCount,
    bool? isFavorite,
  }) {
    return Poem(
      id: id,
      title: title,
      author: author,
      dynasty: dynasty,
      theme: theme,
      content: content,
      annotation: annotation,
      appreciation: appreciation,
      translation: translation,
      viewCount: viewCount ?? this.viewCount,
      isFavorite: isFavorite ?? this.isFavorite,
    );
  }
}

3.1.4 作者模型

class Author {
  final String id;              // 作者ID
  final String name;            // 姓名
  final Dynasty dynasty;        // 朝代
  final String introduction;    // 简介
  final List<String> works;     // 代表作品
  final int poemCount;          // 作品数量

  const Author({
    required this.id,
    required this.name,
    required this.dynasty,
    required this.introduction,
    required this.works,
    required this.poemCount,
  });
}

3.1.5 学习记录模型

class LearningRecord {
  final String id;              // 记录ID
  final String poemId;          // 诗词ID
  final DateTime learnTime;     // 学习时间
  final int duration;           // 学习时长（秒）
  final bool completed;         // 是否完成

  const LearningRecord({
    required this.id,
    required this.poemId,
    required this.learnTime,
    required this.duration,
    required this.completed,
  });
}

3.1.6 朝代作品分布

3.2 页面结构设计

3.2.1 主页面布局

3.2.2 浏览页结构

3.2.3 诗词详情页结构

3.2.4 分类页结构

3.3 诗词浏览逻辑

3.4 学习记录逻辑

四、UI设计规范

4.1 配色方案

应用以典雅的墨绿色为主色调，象征传统文化的深厚底蕴：

4.2 朝代配色

4.3 字体规范

4.4 组件规范

4.4.1 诗词卡片

┌─────────────────────────────────────┐
│  📜 静夜思                           │
│  李白 · 唐代 · 山水田园               │
│                                     │
│  床前明月光，疑是地上霜。              │
│  举头望明月，低头思故乡。              │
│                                     │
│  浏览 1234次                ❤️ 收藏   │
└─────────────────────────────────────┘

4.4.2 分类卡片

┌─────────────────────────────────────┐
│  📜 唐代诗词                          │
│                                     │
│  诗歌鼎盛时期                         │
│  作品数：120首                        │
│                                     │
│  代表：李白、杜甫、白居易              │
└─────────────────────────────────────┘

4.4.3 详情页标题区

┌─────────────────────────────────────┐
│  静夜思                               │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│  李白 · 唐代                          │
│  📜 山水田园 · 💭 思乡怀人             │
└─────────────────────────────────────┘

4.4.4 注释卡片

┌─────────────────────────────────────┐
│  📝 注释                              │
│                                     │
│  • 床：此处指井栏或井边的床            │
│  • 疑：怀疑，以为                     │
│  • 举头：抬头                         │
│  • 低头：形容沉思的样子                │
└─────────────────────────────────────┘

4.4.5 赏析卡片

┌─────────────────────────────────────┐
│  💡 赏析                              │
│                                     │
│  这首诗写的是在寂静的月夜思念家乡       │
│  的感受。诗的前两句，是写诗人在作客     │
│  他乡的特定环境中一刹那间所产生的       │
│  错觉......                          │
└─────────────────────────────────────┘

4.4.6 学习统计卡片

┌─────────────────────────────────────┐
│  📊 学习统计                          │
│                                     │
│  已学习诗词：45首                     │
│  学习时长：3小时20分                   │
│  当前等级：📖 进阶者                   │
│  连续学习：7天                         │
└─────────────────────────────────────┘

五、核心功能实现

5.1 诗词数据初始化

final List<Poem> _poems = [
  Poem(
    id: '1',
    title: '静夜思',
    author: '李白',
    dynasty: Dynasty.tang,
    theme: Theme.homesick,
    content: '床前明月光，疑是地上霜。\n举头望明月，低头思故乡。',
    annotation: '• 床：此处指井栏或井边的床\n• 疑：怀疑，以为\n• 举头：抬头\n• 低头：形容沉思的样子',
    appreciation: '这首诗写的是在寂静的月夜思念家乡的感受。诗的前两句，是写诗人在作客他乡的特定环境中一刹那间所产生的错觉。一个独处他乡的人，白天奔波忙碌，倒还能冲淡离愁，然而一到夜深人静的时候，心头就难免泛起阵阵思念故乡的波澜。何况是在月明之夜，更何况是月色如霜的秋夜。',
    translation: '明亮的月光洒在床前的窗户纸上，好像地上泛起了一层霜。我禁不住抬起头来，看那天窗外空中的一轮明月，不由得低头沉思，想起远方的家乡。',
    viewCount: 1234,
    isFavorite: false,
  ),
  // ... 更多诗词
];

5.2 搜索功能实现

void _searchPoems(String query) {
  setState(() {
    if (query.isEmpty) {
      _filteredPoems = _poems;
    } else {
      _filteredPoems = _poems.where((poem) {
        return poem.title.contains(query) ||
               poem.author.contains(query) ||
               poem.content.contains(query);
      }).toList();
    }
  });
}

5.3 筛选功能实现

void _filterPoems() {
  setState(() {
    _filteredPoems = _poems.where((poem) {
      bool matchDynasty = _selectedDynasty == null || poem.dynasty == _selectedDynasty;
      bool matchTheme = _selectedTheme == null || poem.theme == _selectedTheme;
      return matchDynasty && matchTheme;
    }).toList();
  });
}

5.4 收藏功能实现

void _toggleFavorite(String poemId) {
  setState(() {
    final index = _poems.indexWhere((p) => p.id == poemId);
    if (index != -1) {
      _poems[index] = _poems[index].copyWith(
        isFavorite: !_poems[index].isFavorite,
      );
      
      if (_poems[index].isFavorite) {
        _favoritePoems.add(_poems[index]);
      } else {
        _favoritePoems.removeWhere((p) => p.id == poemId);
      }
    }
  });
}

5.5 学习记录实现

void _recordLearning(String poemId, int duration) {
  final record = LearningRecord(
    id: 'record_${DateTime.now().millisecondsSinceEpoch}',
    poemId: poemId,
    learnTime: DateTime.now(),
    duration: duration,
    completed: true,
  );

  setState(() {
    _learningRecords.add(record);
    _totalLearnedPoems++;
    _totalLearningTime += duration;
    _currentLevel = _calculateLevel(_totalLearnedPoems);
  });
}

5.6 等级计算实现

LearningLevel _calculateLevel(int learnedPoems) {
  if (learnedPoems >= 300) return LearningLevel.master;
  if (learnedPoems >= 200) return LearningLevel.scholar;
  if (learnedPoems >= 100) return LearningLevel.enthusiast;
  if (learnedPoems >= 50) return LearningLevel.intermediate;
  return LearningLevel.beginner;
}

六、交互设计

6.1 浏览流程

6.2 学习流程

6.3 收藏管理流程

七、扩展功能规划

7.1 后续版本规划

7.2 功能扩展建议

7.2.1 朗读功能

朗读功能：

• 专业朗诵音频
• 拼音标注显示
• 语速调节
• 跟读练习

7.2.2 AI智能推荐

AI功能：

• 个性化推荐
• 学习路径规划
• 薄弱点分析
• 智能复习提醒

7.2.3 社区交流

社交功能：

• 学习心得分享
• 诗词创作
• 评论互动
• 学习小组

八、注意事项

8.1 开发注意事项

1. 数据准确性：确保诗词内容、注释、赏析的准确性

2. 版权问题：注意诗词内容的版权和引用规范

3. 性能优化：大量诗词数据需优化加载和搜索性能

4. 用户体验：提供良好的阅读体验和交互反馈

5. 数据持久化：学习记录和收藏数据需持久化存储

8.2 常见问题

8.3 使用技巧

📚 古诗词学习技巧 📚

学习方法

• 先读原文，理解大意
• 再看注释，了解典故
• 后读赏析，深入理解
• 最后背诵，巩固记忆

分类学习

• 按朝代学习：了解时代背景
• 按题材学习：掌握写作手法
• 按作者学习：理解诗人风格

记忆技巧

• 理解记忆：先理解后背诵
• 联想记忆：联系生活实际
• 反复复习：定期回顾巩固
• 朗读背诵：加深印象

九、运行说明

9.1 环境要求

9.2 运行命令

# 查看可用设备
flutter devices

# 运行到Web服务器
flutter run -d web-server -t lib/main_poetry_learning.dart --web-port 8152

# 运行到鸿蒙设备
flutter run -d 127.0.0.1:5555 lib/main_poetry_learning.dart

# 代码分析
flutter analyze lib/main_poetry_learning.dart

十、总结

古诗词学习应用通过诗词浏览、分类学习、收藏管理、学习记录四大模块，为用户提供了一个便捷的古诗词学习平台。应用收录了唐诗、宋词、元曲等经典古诗词作品，提供原文、注释、赏析、译文等丰富内容，支持分类浏览、搜索查询、收藏管理、学习记录等功能。

核心功能涵盖诗词浏览、分类学习、收藏管理、学习记录四大模块。诗词浏览支持搜索和筛选功能；分类学习按朝代、题材、作者分类；收藏管理方便用户收藏喜欢的诗词；学习记录记录学习进度和统计数据。

应用采用 Material Design 3 设计规范，以典雅的墨绿色为主色调，象征传统文化的深厚底蕴与文人雅士的气质。通过本应用，希望能够帮助用户深入了解古诗词文化，传承中华优秀传统文化，提升文学素养和审美能力。

古诗词学习——传承经典，品味文化