# Changelog

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

---

## [1.3.32] - 2026-04-02

### 新增
- ✨ **个人卡片emoji头像点击切换功能**
  - 点击头像可自动切换不同的emoji表情
  - 内置20个精选emoji头像：👤😊🎨🌟🦋🌺🍀🎯🚀💎🌈🎭🦊🐼🦁🐨🦄🐉🔥⚡
  - 添加触觉反馈，提升交互体验
  - 切换时显示SnackBar提示，告知用户新头像
  - 支持收起和展开状态下的头像切换
  - 涉及文件：
    - `lib/views/profile/per_card.dart` - 添加头像切换功能

---

## [1.3.31] - 2026-04-02

### 优化
- 🎨 **统一气泡提示样式为 Get.snackbar**
  - 将 `home_components.dart` 中的所有 `PoetryStateManager.showSnackBar` 改为 `Get.snackbar`
  - 使用透明毛玻璃样式，与调试信息气泡保持一致
  - 包括分享、复制等操作的提示
  - 涉及文件：
    - `lib/views/home/home_components.dart` - 统一气泡样式

---

## [1.3.30] - 2026-04-02

### 新增
- ⭐ **添加全局 Tips 开关管理器**
  - 创建 `GlobalTipsManager` 单例类，支持 ValueNotifier 状态监听
  - 修改设置页面，全局 Tips 开关使用 GlobalTipsManager 管理
  - 修改发现页面，使用 ValueListenableBuilder 监听状态变化
  - 开关关闭后，发现页面的 Tips 提示会立即隐藏，下方布局自动向上占位
  - 涉及文件：
    - `lib/views/home/home-load.dart` - 添加 GlobalTipsManager
    - `lib/views/profile/settings/app_fun.dart` - 使用 GlobalTipsManager
    - `lib/views/discover_page.dart` - 使用 ValueListenableBuilder 监听状态

### 优化
- 🎨 **给诗词原文添加轻微背景色**
  - 给诗词原文区域添加主题色 20% 透明度的背景
  - 添加"诗词原文"标题，使区域更清晰
  - 涉及文件：
    - `lib/views/home/home_part.dart` - 添加背景色和标题

---

## [1.3.29] - 2026-04-02

### 修复
- 🐛 **修复调试信息开关关闭后仍显示调试信息的问题**
  - 修改 `home_controller.dart`，将所有 `Get.snackbar` 调用改为通过 `DebugInfoManager` 显示
  - 调试信息现在完全受设置页面中的"调试信息"开关控制
  - 开关关闭后，所有调试提示（刷新、下一条、上一条、点赞、复制等）都不会显示
  - 涉及文件：
    - `lib/services/get/home_controller.dart` - 统一通过 DebugInfoManager 显示调试信息

---

## [1.3.28] - 2026-04-02

### 优化
- 🚀 **优化设置页面，内外实时生效**
  - 修改 `DebugInfoManager`，添加 `ValueNotifier` 支持实时状态监听
  - 修改 `AutoRefreshManager`，添加 `ValueNotifier` 支持实时状态监听，init 时自动启动定时器
  - 修改 `home_page.dart`，从 `StatelessWidget` 改为 `StatefulWidget`，添加 `ValueListenableBuilder` 监听次要按钮状态
  - 次要按钮（上一条、分享）的显示/隐藏现在可以实时响应设置变化
  - 涉及文件：
    - `lib/views/home/home-load.dart` - 添加 ValueNotifier 支持
    - `lib/views/home/home_page.dart` - 添加实时监听次要按钮状态
    - `lib/views/profile/settings/app_fun.dart` - 已优化设置逻辑

---

## [1.3.26] - 2026-04-02

### 优化
- 🎨 **优化主页悬浮按钮位置，紧贴底部导航栏**
  - 修改悬浮按钮 bottom 定位值，从使用 liquidGlassTotalHeight 改为使用 liquidGlassHeight + liquidGlassBottomMargin
  - 调整按钮间距，使布局更紧凑美观
  - 确保按钮固定位置，不随诗词卡片上下滚动
  - 涉及文件：
    - `lib/views/home/home_page.dart` - 修改悬浮按钮定位

---

## [1.3.25] - 2026-04-02

### 新增
- ✨ **新增液态玻璃导航栏透明度级别控制**
  - 在 TapLiquidGlassController 中添加 TransparencyLevel 枚举
  - 支持三个透明度级别：弱、中、强
  - 弱：当前效果（白色 0.35/0.2，灰色 0.35/0.2）
  - 中：中等透明度（白色 0.22/0.12，灰色 0.22/0.12）
  - 强：几乎透明（白色 0.1/0.05，灰色 0.1/0.05）
  - 在功能设置页面添加 3 级开关，开启 Tap 沉浸光感后显示
  - 透明度设置持久化到 SharedPreferences
  - 涉及文件：
    - `lib/services/get/tap_liquid_glass_controller.dart` - 新增透明度级别控制
    - `lib/views/profile/settings/app_fun.dart` - 添加透明度级别开关
    - `lib/widgets/tap-liquid-glass.dart` - 应用透明度级别

---

## [1.3.24] - 2026-04-02

### 修复
- 🔧 **修复发现页 Tips 显示和关闭功能**
  - 在 DiscoverController 中添加全局 tips 开关设置加载逻辑
  - 修改 discover_page.dart 显示条件，根据全局开关和本地关闭状态控制显示
  - 全局Tips关闭时，发现页不显示提示
  - 全局Tips开启时，点击X可关闭提示（仅当前会话，不写入SharedPreferences）
  - 涉及文件：
    - `lib/services/get/discover_controller.dart` - 添加全局tips开关加载
    - `lib/views/discover_page.dart` - 修改tips显示逻辑

---

## [1.3.23] - 2026-04-02

### 优化
- 🎨 **优化 Tap 沉浸光感液态玻璃导航栏视觉效果**
  - 增强透明效果，降低背景透明度约 30-40%
  - 移除选中项胶囊形背景，消除两层包裹效果
  - 移除点击水波纹和高亮效果，保持纯净玻璃质感
  - 添加灰度渐变底层，提升玻璃逼真度
  - 优化图标缩放效果（从 1.12 调整为 1.1）
  - 增加模糊强度（从 20 提升至 35）
  - 增强阴影效果，提升悬浮感
  - 涉及文件：
    - `lib/widgets/tap-liquid-glass.dart` - 优化视觉效果
    - `lib/config/app_config.dart` - 增加模糊强度

---

## [1.3.22] - 2026-04-02

### 重新设计
- 🎨 **重新设计 Tap 沉浸光感液态玻璃导航栏**
  - 实现 iOS 26 风格的液态玻璃效果
  - 使用 BackdropFilter 实现真正的毛玻璃模糊
  - 下层页面滑动时，能透过底栏模糊看到底部大概轮廓
  - 添加双层阴影效果，增强悬浮感
  - 使用渐变背景替代纯色，提升玻璃质感
  - 选中项添加胶囊形背景指示器
  - 优化图标动画效果，选中时放大 1.12 倍
  - 支持动画开关控制，响应主题控制器设置
  - 添加详细的使用示例和注意事项注释
  - 涉及文件：
    - `lib/widgets/tap-liquid-glass.dart` - 重新设计液态玻璃导航栏

### 修复
- 🔧 **修复液态玻璃导航栏布局遮挡问题**
  - 使用 Stack 布局替代 Scaffold.bottomNavigationBar
  - 导航栏悬浮在页面内容上方，不再遮挡下方布局
  - 页面内容延伸到屏幕底部，透过玻璃可见
  - 添加 `liquidGlassTotalHeight` 配置计算导航栏总高度
  - 修改所有子页面 ListView/ScrollView 底部内边距
  - 涉及文件：
    - `lib/widgets/main_navigation.dart` - 使用 Stack 布局实现悬浮效果
    - `lib/config/app_config.dart` - 添加导航栏高度计算
    - `lib/views/home/home_page.dart` - 添加底部内边距
    - `lib/views/discover_page.dart` - 添加底部内边距
    - `lib/views/active/popular_page.dart` - 添加底部内边距
    - `lib/views/footprint/all_list.dart` - 添加底部内边距
    - `lib/views/footprint/liked_poetry_manager.dart` - 添加底部内边距
    - `lib/views/footprint/local_jilu.dart` - 添加底部内边距
    - `lib/views/profile/profile_page.dart` - 添加底部内边距

---

## [1.3.21] - 2026-04-02

### 优化
- 🎨 **优化Tap沉浸光感液态玻璃导航栏**
  - 恢复毛玻璃效果，去掉外层纯色背景遮挡
  - 滑动时能模糊看到下层视图的大概轮廓
  - 保持椭圆形悬浮设计和毛玻璃模糊效果
  - 优化点击区域，使用 InkWell 替代 GestureDetector
  - 点击区域扩展到整个 Expanded 区域，包括空白区域
  - 添加水波纹效果，提升点击反馈
  - 涉及文件：
    - `lib/widgets/tap-liquid-glass.dart` - 优化液态玻璃导航栏

---

## [1.3.20] - 2026-04-01

### 新增
- ✨ **深色模式支持全面上线**
  - 创建 ThemeController 管理深色模式状态
  - 使用 SharedPreferences 持久化深色模式设置
  - 全局深色模式适配，涉及 20+ 页面
  - iOS 风格的深色配色方案
  - 统一的暗色背景、卡片、文字颜色
  - 涉及文件：
    - `lib/models/night-mode/theme_model.dart` - 主题数据模型
    - `lib/services/get/theme_controller.dart` - 主题控制器
    - `lib/views/profile/theme/app-diy.dart` - 深色模式开关
    - `lib/views/home/home_page.dart` - 首页深色模式
    - `lib/views/home/home_part.dart` - 首页组件
    - `lib/views/home/home-load.dart` - 首页加载
    - `lib/views/home/home_components.dart` - 首页组件
    - `lib/views/discover_page.dart` - 发现页深色模式
    - `lib/views/active/rate.dart` - 评价页深色模式
    - `lib/views/active/category_page.dart` - 分类页深色模式
    - `lib/views/active/active_search_page.dart` - 搜索页深色模式
    - `lib/views/active/tags/corr_page.dart` - 标签页深色模式
    - `lib/views/favorites_page.dart` - 收藏页深色模式
    - `lib/views/footprint/all_list.dart` - 全部列表深色模式
    - `lib/views/footprint/collect_notes.dart` - 笔记页深色模式
    - `lib/views/footprint/footprint_page.dart` - 足迹页深色模式
    - `lib/views/footprint/local_jilu.dart` - 本地记录深色模式
    - `lib/views/profile/profile_page.dart` - 个人中心深色模式
    - `lib/views/profile/history_page.dart` - 历史页深色模式
    - `lib/views/profile/app-info.dart` - 应用信息深色模式
    - `lib/views/profile/level/distinguish.dart` - 辨别页深色模式
    - `lib/views/profile/level/flow-anim.dart` - 动画页深色模式
    - `lib/views/profile/level/level-jilu.dart` - 级别记录深色模式
    - `lib/views/profile/level/poetry.dart` - 诗词页深色模式
    - `lib/views/profile/guide/beginner_page.dart` - 教程页深色模式
    - `lib/views/profile/guide/sp-guide.dart` - 引导页深色模式
    - `lib/views/profile/guide/tongji.dart` - 统计页深色模式
    - `lib/utils/app_initializer.dart` - 应用初始化
    - `lib/utils/app_theme.dart` - 应用主题

### 修复
- 🔧 **修复诗词卡片加载状态问题**
  - 使用 Obx 包装 PoetryCard 组件
  - 确保 sectionLoadingStates 更新时 UI 响应式刷新
  - 解决"xx加载中..."一直显示的问题
  - 涉及文件：
    - `lib/views/home/home_page.dart` - 修复加载状态

---

## [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 标题显示问题
- ✅ 个人卡片emoji头像切换功能

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

## 开发进度

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