# Changelog

All notable changes to this project will be documented in this file.

---

## [1.3.19] - 2026-04-01

### 新增
- ✨ **实现应用数据计算功能**
  - 使用原生 dart:io 实现软件包、缓存、数据大小计算
  - 递归计算目录大小，支持多层级文件遍历
  - 字节格式化，自动转换为 B/KB/MB/GB/TB
  - 软件包大小：计算应用数据目录总大小
  - 缓存大小：计算临时目录大小
  - 数据大小：计算文档和支持目录大小
  - 占用空间：显示软件包+缓存+数据+10MB 的总和
  - 实现清空缓存功能，递归删除临时文件
  - 清空后自动刷新缓存大小显示
  - 新增原生清理数据按钮，直接删除文件系统数据
  - 双重确认对话框，防止误操作
  - 原生清理完成后提示关闭应用
  - 涉及文件：
    - `lib/views/profile/guide/app-data.dart` - 实现数据计算功能

### 修复
- 🔧 **统一版本号显示**
  - 修复 learn-us.dart 中版本号引用错误问题
  - 修复 app-info.dart 中硬编码版本号问题
  - 统一使用 AppConfig.appVersion 显示版本号
  - 涉及文件：
    - `lib/views/profile/settings/learn-us.dart` - 修正版本号引用
    - `lib/views/profile/app-info.dart` - 统一版本号显示

### 更新
- 🎨 **多平台应用图标全面更新**
  - 使用用户提供的本地图片作为应用图标
  - 原图尺寸：647x559，自动居中裁剪为正方形
  - 新增 216x216 尺寸图标
  - 支持所有平台图标生成：
    - **HarmonyOS**：完整图标集（9个尺寸）
    - **Android**：启动图标（5个尺寸）
    - **macOS**：应用图标（7个尺寸）
  - 所有平台图标已同步更新
  - 涉及文件：
    - `ohos/entry/src/main/resources/base/media/` - HarmonyOS 图标集（含 icon_216.png）
    - `ohos/AppScope/resources/base/media/app_icon.png` - HarmonyOS AppScope 图标
    - `android/app/src/main/res/mipmap-*/ic_launcher.png` - Android 启动图标
    - `macos/Runner/Assets.xcassets/AppIcon.appiconset/` - macOS 图标
    - `generate_all_icons.py` - 多平台图标生成脚本
    - `assets/XZ4QCHGE][UUYGCV2G(~88J.png` - 用户提供的原始图片

---

## [1.3.18] - 2026-04-01

### 改进
- ✨ **优化诗词投稿检测功能**
  - 在"检测是否存在"按钮左边添加检测状态显示
  - 显示"未检测"、"已检测"、"未通过"三种状态
  - 配套图标：pending、check_circle、close
  - 使用主题色和错误色区分不同状态
  - 提交前要求必须先检测且通过才能提交
  - 未检测时提示"请先检测诗词是否存在"
  - 涉及文件：
    - `lib/views/profile/expand/manu-script.dart` - 优化检测功能

---

## [1.3.17] - 2026-04-01

### 优化
- 🎨 **重新设计使用教程页面**
  - iOS 风格的全新设计，更符合苹果设计理念
  - 增加了四个主要页面的界面预览模块（首页、发现页、足迹页、个人中心）
  - 每个模块使用不同的 emoji 图标和配色方案，图文并茂
  - 保留左侧进度条并优化动画效果
  - 新增页面淡入动画和卡片逐个出现动画
  - 使用主题色 AppConstants.primaryColor 统一配色
  - 圆角卡片设计，柔和阴影，符合 iOS 风格
  - 涉及文件：
    - `lib/views/profile/guide/beginner_page.dart` - 重新设计使用教程页面

### 改进
- 🎨 **优化进度条悬浮效果**
  - 进度条改为悬浮在内容上方，不再单独占位
  - 添加渐变背景遮罩，从左到右透明度渐变
  - 内容区域宽度增加，提升阅读体验
  - 涉及文件：
    - `lib/views/profile/guide/beginner_page.dart` - 优化进度条悬浮效果
- ✨ **优化导航栏设计**
  - 标题文字使用主题色 AppConstants.primaryColor
  - 右上角添加帮助图标按钮
  - 点击按钮跳转到欢迎引导页 SpGuidePage
  - 涉及文件：
    - `lib/views/profile/guide/beginner_page.dart` - 优化导航栏
- ✨ **添加滚动隐藏 AppBar 功能**
  - 使用 SliverAppBar 实现滚动时自动隐藏效果
  - floating: true 和 snap: true 配合，实现自然收起动画
  - 向下滚动时 AppBar 自动隐藏，向上滚动时自动显示
  - 所有图标颜色统一使用主题色 AppConstants.primaryColor
  - 涉及文件：
    - `lib/views/profile/guide/beginner_page.dart` - 添加滚动隐藏功能
- 🎨 **美化开发者卡片**
  - 新增微信公众号信息展示
  - 公众号名称：微风暴
  - 使用微信绿色主题色 (0xFF07C160)
  - 添加搜索图标和标签样式设计
  - 渐变色背景卡片，圆角设计
  - 涉及文件：
    - `lib/views/profile/settings/learn-us.dart` - 美化开发者卡片
- 🎨 **优化卡片布局**
  - 去掉开发者卡片和团队信息卡片中的分割线
  - 调整内边距，使布局更紧凑美观
  - 内容区块之间使用自然间距代替分割线
  - 涉及文件：
    - `lib/views/profile/settings/learn-us.dart` - 优化卡片布局
- ✨ **增强开发者卡片功能**
  - 邮箱地址字体加大，从 13 改为 15
  - 公众号"微风暴"右边添加复制图标
  - 点击复制图标可复制公众号名称到剪贴板
  - 复制成功后显示 SnackBar 提示
  - 涉及文件：
    - `lib/views/profile/settings/learn-us.dart` - 增强开发者卡片
- 🎨 **优化设备信息卡片布局**
  - 设备信息从 1×6 列表布局改为 2×3 网格布局
  - 新增网格布局信息项 widget，带卡片样式
  - 使用主题色 AppConstants.primaryColor 统一图标颜色
  - 可复制项带复制图标，点击可复制
  - 卡片样式：灰色背景，圆角边框，更美观
  - 去掉设备信息和设备详细信息之间的空白区域
  - 涉及文件：
    - `lib/views/profile/app-info.dart` - 优化设备信息布局

---

## [1.3.16] - 2026-04-01

### 新增
- ✨ **新增使用教程页面**
  - 创建 iOS 风格的使用教程页面 `BeginnerPage`
  - 超长列表布局，包含 16 个功能模块
  - 左侧悬浮进度指示器，带平滑动画
  - 显示当前阅读进度百分比
  - 主题色设计，圆角卡片，阴影效果
  - 功能模块：首页功能、发现页面、足迹页面、个人中心、诗词阅读、收藏功能、搜索功能、答题挑战、离线模式、个性化设置、投稿功能、投票功能、天气与十二时辰、图片分享、数据管理、帮助与反馈
  - 涉及文件：
    - `lib/views/profile/guide/beginner_page.dart` - 新建使用教程页面
    - `lib/views/profile/components/pop-menu.dart` - 修改按钮跳转

---

## [1.3.15] - 2026-04-01

### 修改
- 🎨 **修改收藏页面标题**
  - 将收藏页面 AppBar 标题从"收藏"改为"足迹"
  - 底部导航栏标签保持"收藏"不变
  - 涉及文件：
    - `lib/views/favorites_page.dart` - 修改页面标题

---

## 软件特性功能

### 已开发完成
- ✅ iOS 风格界面设计
- ✅ 诗词浏览与收藏
- ✅ 搜索与分类
- ✅ 答题挑战功能
- ✅ 离线模式
- ✅ 个性化设置
- ✅ 投稿功能
- ✅ 投票功能
- ✅ 天气与十二时辰
- ✅ 图片分享
- ✅ 数据管理
- ✅ 使用教程页面
- ✅ 全站统计页面
- ✅ 修复 AppBar 标题显示问题

### 开发中
- 🚧 更多功能优化

## 开发进度

| 功能 | 优先级 | 状态 |
|------|--------|------|
| 使用教程 | 1 | ✅ 已完成 |
| 投稿功能优化 | 2 | ✅ 已完成 |
| 界面美化 | 3 | ✅ 已完成 |
| 数据管理功能 | 1 | ✅ 已完成 |
| 性能优化 | 4 | 🔄 进行中 |
| 新功能开发 | 5 | 📋 计划中 |