# Changelog

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

---

## [1.6.0] - 2026-04-18

### 优化
- 🧹 **代码质量全面清理**
  - 清理所有未使用的导入（app_constants.dart、theme_controller.dart等）
  - 清理所有未使用的字段（_readAloudEnabled、_firstLaunch、_showGuideOnStartup、_isLoadingCategories等）
  - 清理所有未使用的方法（_buildActionButton、_copyQQGroupNumber、_buildDesignStyleCard、_showGuideStatusPopup、_toggleShowGuide等）
  - 清理未使用的局部变量（themeController等）
  - 修复废弃API引用（withOpacity → withValues）
  - 修复登录弹窗、服务器信息弹窗等组件的冗余依赖
  - 分析结果：0错误、0警告、164提示（均为info级别）
  - 优先级：3

### 新增
- 📋 **项目分析文档**
  - 创建 `lib/PROJECT_ANALYSIS.md` 项目分析报告
  - 包含代码质量概览、需加强功能、现有问题分析、新增功能建议
  - 包含代码规范待改进项、开发进度追踪
  - 优先级：2
- 🏷️ **主页标签点击跳转**
  - 关键词标签（如"围炉夜话"）点击后跳转到对应标签诗词列表页
  - 朝代标签（如"暂无朝代"）点击后跳转到对应朝代诗词列表页
  - 长按仍保留复制功能
  - 涉及文件：`lib/views/home/home_part.dart` - _buildKeywordSection 方法
  - 优先级：3

---

## [1.4.8] - 2026-04-18

### 新增
- ✨ **跟随系统深色模式开关**
  - ThemeController 新增 `_followSystem` 响应式状态（默认开启）
  - 实现 `WidgetsBindingObserver` 监听系统亮度变化（`didChangePlatformBrightness`）
  - 跟随系统开启时，应用自动跟随 OS 深色/浅色模式切换
  - 跟随系统开启时，隐藏"深色模式"手动开关，界面更简洁
  - 跟随系统关闭时，显示"深色模式"手动开关，由用户手动控制
  - 状态持久化到 SharedPreferences
  - 涉及文件：
    - `lib/services/get/theme_controller.dart` - 新增 followSystem 状态、系统亮度监听、toggleFollowSystem 方法
    - `lib/views/profile/theme/app-diy.dart` - 新增跟随系统开关 UI
  - 优先级：4

---

## [1.4.7] - 2026-04-09

### 新增
- ✨ **列表/网格布局切换功能**
  - 扩展 `FavoritesController` 添加布局切换持久化功能
  - 支持在列表模式（一行一个）和网格模式（一行两个）之间切换
  - 布局设置自动保存到 SharedPreferences
  - 涉及页面：
    - 全部列表页面 - 支持网格布局
    - 笔记列表页面 - 支持网格布局
  - 涉及文件：
    - `lib/services/get/favorites_controller.dart` - 添加布局持久化
    - `lib/views/footprint/all_list.dart` - 支持网格布局
    - `lib/views/footprint/local_jilu.dart` - 支持网格布局

### 优化
- 🔧 **网格布局卡片优化**
  - 全部列表页面网格布局：2列，适配点赞诗词和笔记
  - 笔记列表页面网格布局：2列，完整功能支持
  - 支持锁定、置顶、删除等所有操作
  - 深色模式完整支持

### 新增
- ✨ **诗词答题页面骨架屏**
  - 在 `poetry-page.dart` 中新增 `PoetryLevelSkeleton` 骨架屏组件
  - 冷启动加载时显示骨架屏，避免页面闪白
  - 包含分数显示、题目卡片、选项等完整骨架
  - 支持深色/浅色模式和动态主题色
  - 涉及文件：
    - `lib/views/profile/level/poetry-page.dart` - 新增 PoetryLevelSkeleton 组件
    - `lib/views/profile/level/poetry.dart` - 使用骨架屏替换加载指示器

### 修复
- 🐛 **修复笔记网格布局报错**
  - 修复 `_buildGridNoteCard` 方法中缺少 `hasCategory` 变量定义的问题
  - 涉及文件：
    - `lib/views/footprint/local_jilu.dart` - 添加 `hasCategory` 变量定义
- 🐛 **修复个人页面统计数据隐藏功能**
  - 修复点击隐藏按钮后统计数据依旧显示的问题
  - 使用 `Obx` 包裹统计部分的 Column，使其能够响应 `isStatsHidden` 的变化
  - 现在点击隐藏按钮会同时隐藏诗词挑战和统计数据
  - 涉及文件：
    - `lib/views/profile/profile_page.dart` - 使用 Obx 包裹统计部分

---

## [1.4.6] - 2026-04-09

### 新增
- ✨ **搜索历史功能**
  - 新建搜索历史管理器 `SearchHistoryManager`
  - 新建搜索历史页面 `SearchHistoryPage`
  - 自动保存用户搜索记录，最多保存 20 条
  - 支持点击搜索历史快速搜索
  - 支持删除单条搜索记录
  - 支持清空所有搜索历史
  - 使用 iOS 风格 Cupertino 组件
  - 涉及文件：
    - `lib/views/active/search/search_history_manager.dart` - 搜索历史管理器
    - `lib/views/active/search/search_history_page.dart` - 搜索历史页面
    - `lib/views/active/active_search_page.dart` - 搜索页面

### 优化
- 🔧 **统一消息气泡样式为 GetX 风格**
  - 将所有页面的 ScaffoldMessenger 改为 GetX 的 Get.snackbar
  - 背景使用 GetX 默认样式
  - 字体色使用动态主题色
  - 根据操作逻辑判断显示位置：
    - 成功操作（保存、删除、更新等）显示在底部
    - 错误提示（密码错误、输入为空等）显示在顶部
  - 涉及文件：
    - `lib/views/footprint/local_jilu.dart` - 笔记列表页面
    - `lib/views/footprint/collect_notes.dart` - 笔记编辑页面
    - `lib/views/footprint/footprint_page.dart` - 足迹页面
    - `lib/views/footprint/all_list.dart` - 全部列表页面
    - `lib/views/profile/settings/app_fun.dart` - 设置页面
- 🔧 **公告页面优化**
  - 添加底部"到底了"提示
  - 增加底部 padding 防止被底部 tabs 遮住
  - 涉及文件：
    - `lib/views/footprint/load/notice-page.dart` - 公告页面
- 🔧 **全局Tips开关优化**
  - 添加开关状态提示消息
  - 使用 GetX 消息气泡样式

---

## [1.4.5] - 2026-04-09

### 新增
- ✨ **添加密码提示和找回密码功能**
  - 笔记数据结构新增 `passwordHint` 字段
  - 在设置/修改密码对话框中新增密码提示输入框
  - 密码提示可作为找回密码的凭证
  - 在笔记列表密码输入对话框中新增"忘记密码？"选项
  - 输入正确的密码提示可重置密码并解锁笔记
  - 涉及文件：
    - `lib/controllers/history_controller.dart` - 添加密码提示相关方法
    - `lib/views/footprint/collect_notes.dart` - 添加密码提示输入框
    - `lib/views/footprint/local_jilu.dart` - 添加忘记密码功能

### 优化
- 🔧 **HistoryController 新增方法**
  - `verifyNotePasswordHint()` - 验证密码提示
  - `resetNotePasswordByHint()` - 通过密码提示重置密码
- 🔧 **确保密码提示正确保存到 SharedPreferences**
  - `saveNote()` 方法正确处理和保存 `passwordHint` 字段
  - 读取和更新笔记时正确保留密码提示
- 🔧 **修复忘记密码按钮功能**
  - 重构密码输入对话框，使用 Map 返回不同类型的结果
  - 确保"忘记密码？"按钮正常工作并切换到密码提示输入模式
  - 验证成功后直接进入笔记页面

---

---

## 软件特性功能

### 已开发完成
- ✅ iOS 风格界面设计
- ✅ 诗词浏览与收藏
- ✅ 搜索与分类
- ✅ 答题挑战功能
- ✅ 离线模式
- ✅ 个性化设置
- ✅ 投稿功能
- ✅ 投票功能
- ✅ 天气与十二时辰
- ✅ 图片分享
- ✅ 数据管理
- ✅ 使用教程页面
- ✅ 全站统计页面
- ✅ 修复 AppBar 标题显示问题
- ✅ 个人卡片emoji头像切换功能
- ✅ 深色模式支持
- ✅ 液态玻璃导航栏
- ✅ 多页面主题色支持
- ✅ WiFi设备安装优化 (v1.4.3)
- ✅ 统一平台判断工具类 PlatformUtils (v1.4.2)
- ✅ 三星平板启动页修复 (v1.4.2)
- ✅ 动态版本号获取 (v1.4.1)
- ✅ Web图标替换 (v1.4.1)
- ✅ 出处字段遮挡修复 (v1.3.59)
- ✅ 公告信息页面 (v1.4.4)
- ✅ 收藏页面推送标签 (v1.4.4)

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

## 开发进度

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