# Changelog

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

---

## [1.3.11] - 2026-03-31

### 修复
- 🐛 **修复 Web 平台兼容性问题**
  - 修复了 `wakelock_plus` 库在 Web 平台上不可用的问题（`dart:ffi` 在 Web 平台上不可用）
  - 在 Web 平台上禁用了屏幕常亮功能，并显示相应的提示信息
  - 在 Web 平台上隐藏了屏幕常亮设置项
  - 涉及文件：
    - `lib/views/profile/profile_page.dart` - 添加 Web 平台检查
    - `lib/views/profile/components/pop-menu.dart` - 添加 Web 平台检查

---

### 修复
- 优化了屏幕常亮功能的错误处理
- 增强了平台检测和日志输出
- 为不支持屏幕常亮的设备添加了专门的错误提示
- 🐛 **修复昵称修改不生效问题**
  - 修复了点击确认图标后昵称没有保存的问题
  - 确保在编辑模式下点击确认图标时正确保存昵称到 `widget.userData['nickname']`
  - 涉及文件：
    - `lib/views/profile/per_card.dart` - 修复昵称保存逻辑
- ⚙️ **更新重置设置默认值**
  - 自动刷新：关闭
  - 调试信息：关闭
  - 预加载：开启
  - 隐藏次要按钮：关闭
  - 声音反馈：关闭
  - 震动反馈：开启
  - 全局Tips：开启
  - 涉及文件：
    - `lib/views/profile/settings/app_fun.dart` - 更新重置设置逻辑
- 🎨 **优化离线数据页面温馨提示卡片**
  - 增加了字体大小，使关键信息更明显
  - 调整了间距，使布局更清晰
  - 优化了开启离线状态的方法说明，使其更易理解
  - 涉及文件：
    - `lib/views/profile/settings/offline-data.dart` - 优化温馨提示卡片
- 🎨 **优化屏幕常亮提示弹窗**
  - 增加了圆角边框，提升视觉效果
  - 添加了图标和标题，使弹窗更美观
  - 优化了提示内容的布局和格式，使信息更清晰
  - 调整了按钮样式，增强视觉层次感
  - 涉及文件：
    - `lib/views/profile/profile_page.dart` - 优化屏幕常亮提示弹窗
- 🎨 **优化登录注册对话框**
  - 在标题下方添加了副标题，说明微信号、手机号或邮箱都可以作为投票凭证
  - 涉及文件：
    - `lib/views/profile/components/login_register_dialog.dart` - 添加副标题
- 🎨 **优化个人卡片显示**
  - 删除了等级显示，只保留 UEP 标识（如果用户加入了用户体验计划）
  - 涉及文件：
    - `lib/views/profile/per_card.dart` - 删除等级显示，优化 UEP 标识显示

---

## [1.3.9] - 2026-03-31

### 新增
- 🆔 **UDID 设备信息显示**
  - 在应用信息页面的设备信息列表中添加 UDID 显示
  - 使用 `flutter_udid` 库获取跨平台设备唯一标识
  - 支持点击复制 UDID 功能，带主题色 SnackBar 提示
  - 将 AppInfoPage 从 StatelessWidget 改为 StatefulWidget
  - 添加 `_loadUdid()` 方法异步加载 UDID
  - 在技术栈卡片中添加 flutter_udid 说明
  - 在开源协议对话框中添加 flutter_udid 条目
  - 涉及文件：
    - `lib/views/profile/app-info.dart` - 添加 UDID 获取和显示

### 升级
- 📦 **flutter_udid 库升级至 4.1.2**
  - 升级本地 flutter_udid 包到最新版本 4.1.2
  - Android 平台：更新 Gradle 到 8.5.0，Kotlin 到 2.0.21，使用新的 FlutterPlugin API
  - iOS 平台：替换 SAMKeychain 为 KeychainAccess，支持 iOS 13.0+
  - MacOS 平台：使用 KeychainAccess 和 IOKit 获取硬件 UUID
  - HarmonyOS 平台：保持 3.0.0 版本，使用 OAID 获取设备标识
  - 解决 Gradle 依赖冲突（jcenter 废弃问题）
  - 统一 JVM 目标版本为 17
  - 涉及文件：
    - `packages/flutter_udid/pubspec.yaml` - 更新版本和平台配置
    - `packages/flutter_udid/android/build.gradle` - 更新 Gradle 和 Kotlin 版本
    - `packages/flutter_udid/android/src/main/kotlin/.../FlutterUdidPlugin.kt` - 更新插件 API
    - `packages/flutter_udid/ios/flutter_udid.podspec` - 更新依赖和部署目标
    - `packages/flutter_udid/ios/Classes/SwiftFlutterUdidPlugin.swift` - 更新 KeychainAccess
    - `packages/flutter_udid/macos/Classes/FlutterUdidPlugin.swift` - 更新实现

### 新增
- 👥 **QQ 交流群卡片**
  - 在了解我们页面的"官方网站"卡片下方添加 QQ 群卡片
  - 群号显示：271129018
  - 点击群号可复制到剪贴板
  - 蓝色主题色（Icons.group）
  - 提示"💡 点击群号可复制"
  - 涉及文件：
    - `lib/views/profile/settings/learn-us.dart` - 添加 QQ 群卡片

---

## [1.3.8] - 2026-03-31

### 新增
- 🎛️ **隐藏次要按钮功能**
  - 在功能设置页面添加"隐藏次要按钮"开关
  - 开启后隐藏主页的"上一条"和"分享"悬浮按钮
  - 默认关闭，状态保存到 SharedPreferences
  - 使用 `SecondaryButtonsManager` 单例管理状态
  - 实时响应开关状态变化，无需重启应用
  - 涉及文件：
    - `lib/views/profile/settings/app_fun.dart` - 添加开关和状态管理
    - `lib/views/home/home-load.dart` - 添加 SecondaryButtonsManager 管理类
    - `lib/views/home/home_page.dart` - 使用 ValueListenableBuilder 监听状态变化

---

## [1.3.7] - 2026-03-31

### 新增
- 📸 **诗词卡片截图分享功能**
  - 在主页点赞按钮上方添加悬浮分享按钮，使用 📤 icon
  - 点击按钮可将当前诗词卡片生成高清图片并分享
  - 使用 `RepaintBoundary` 和 `GlobalKey` 实现 Widget 截图
  - 集成 `share_plus` 库实现跨平台图片分享
  - 包含生成中、成功、失败的用户提示
  - 涉及文件：
    - `lib/views/home/home_components.dart` - 添加 ShareImageUtils 工具类和 FloatingShareButton 组件
    - `lib/views/home/home_page.dart` - 添加截图 Key 和分享按钮布局
    - `lib/views/home/home_part.dart` - 添加 RepaintBoundary 支持截图

---

## [1.3.6] - 2026-03-31

### 优化
- 🏷️ **文件重命名与统一**
  - 将 `sqlite_storage_controller.dart` 重命名为 `shared_preferences_storage_controller.dart`
  - 将类名 `SQLiteStorageController` 重命名为 `SharedPreferencesStorageController`
  - 更新所有引用该文件的导入语句和类名调用
  - 涉及文件：
    - `lib/main.dart`
    - `lib/controllers/history_controller.dart`
    - `lib/views/profile/profile_page.dart`
    - `lib/views/profile/level/poetry.dart`
    - `lib/views/profile/level/distinguish.dart`
  - 保持功能不变，仅统一命名规范

---

## [1.3.5] - 2026-03-30

### 新增
- 📜 **投稿记录功能**
  - 新增投稿记录页面 `lib/views/profile/expand/tougao.dart`
  - 显示历史投稿记录列表，按时间倒序排列
  - 支持展开查看详细信息（分类、诗人和标题、关键词、平台、介绍）
  - 提供清空所有记录功能（带确认提示）
  - 修改 `lib/views/profile/expand/manu-script.dart`
  - 在AppBar添加历史记录图标按钮，点击跳转至记录页面
  - 投稿成功后自动保存记录到SharedPreferences
  - 最多保存50条记录，超出时自动删除最早的记录

---

## 软件特性功能

### 已开发完成
- 🎛️ **隐藏次要按钮功能** - 在功能设置页面添加开关、开启后隐藏主页的"上一条"和"分享"悬浮按钮、默认关闭、状态保存到SharedPreferences、使用SecondaryButtonsManager单例管理、实时响应开关状态变化无需重启
  - 优先级：3
- 📸 **诗词卡片截图分享功能** - 主页点赞按钮上方添加悬浮分享按钮、点击生成诗词卡片高清图片并分享、使用RepaintBoundary和GlobalKey实现Widget截图、集成share_plus库实现跨平台分享、包含生成中/成功/失败提示
  - 优先级：4
- 📜 **诗词投稿功能** - 新增投稿页面、支持诗词收录申请表单、包含参考语句/分类选择/诗人和标题/关键词/诗词介绍/人机验证、实现相似度检测防止重复提交、平台字段自动获取设备类型
  - 优先级：3
- ⚡ **离线数据下载优化** - 添加取消下载功能、下载过程中显示取消按钮、优化下载状态显示避免页面卡死、取消下载时显示相应提示
  - 优先级：4
- 🌐 **网络状态自动检测** - 个人卡片加载时自动检测网络状态、无网络时自动调整为离线状态、避免网络异常导致的错误
  - 优先级：3
- 📊 **服务器信息显示** - 在离线数据页面添加服务器信息卡片、显示API地址/版本/频率限制等信息
  - 优先级：2
- 📱 **离线数据下载功能增强** - 新增下载类型选择（诗句和答题）、诗句数量选项（20/30/60/100条）、答题数量选项（20/50/80/100条）、100条下载需加入用户体验计划、实现下载一条写入一条、取消下载时保存已下载数据、实时更新缓存状态、返回上一页继续后台下载、清空缓存时弹窗选择清空内容、缓存状态同时显示诗句和答题数量
  - 优先级：5
- �� **已知bug列表功能** - 从下到上弹出页面显示已知bug、解决方法和解决时间、支持下拉刷新和滚动查看、显示bug优先级和状态、提供详细解决方案描述、显示影响用户范围和时间信息
- 📜 **投稿记录功能** - 投稿记录页面显示历史投稿列表、按时间倒序排列、支持展开查看详细信息、提供清空记录功能、投稿成功后自动保存到SharedPreferences、最多保存50条记录
- 🗳️ **投票功能完整实现** - 用户登录/注册、获取投票列表、投票详情、提交投票、投票结果展示、API服务基础URL修改、登录注册逻辑简化（只需用户名、默认密码123456、自动注册登录、设备标识）、投票页面调试功能、user_identifier增加Flutter后缀、setState调用安全修复（添加mounted检查）、投票登录状态持久化修复（添加Cookie管理器支持PHP Session认证）
- 🎨 **个人卡片标签栏布局优化** - 将标签栏区域一分为二，左侧区域可以点击展开/收起个人卡片
- 🎲 **题目随机化功能** - 进入答题页面时调用 fetch 接口获取新题，使用 Fisher-Yates 算法打乱题目 ID 顺序
- 💬 **答对答错反馈信息修复** - 当 API 返回的提示信息为空时，自行添加提示内容
- 📚 **App 自行管理题目 ID** - 实现题目 ID 管理逻辑，不再随机生成
- 🔧 **API 接口路径和参数最终修复** - 确认 API 路径，调整随机题目 ID 范围
- 🔧 **API 接口路径和参数修复** - 修复 API 路径和参数，使用正确的新 API 接口
- 🐛 **HttpResponse 处理修复** - 修复 HttpResponse 对象处理方式，使用正确的属性访问
- 🔧 **API 请求参数更新** - 根据新的 API 文档更新所有请求参数
- 📊 **个人页面统计数字动态化** - 从SharedPreferences读取真实的答题统计数据
- 📝 **记录页显示问题修复** - 修复答题记录页面显示未知题目和标签的问题
- 📋 **答题统计弹窗功能** - 显示详细的答题统计数据，支持复制发送给AI评估
- 📝 **诗词答题功能** - 完整的答题页面，支持题目加载、答案提交、提示获取
- 🕐 **中国十二时辰制时间显示** - 时间显示改为十二时辰（子丑寅卯辰巳午未申酉戌亥）
- 🌤️ **天气功能集成** - 集成天气API获取城市、天气状态和温度
- 📚 **朝代信息显示** - 在诗人名称左侧添加朝代信息显示
- 🎨 **卡片样式优化** - 经典和现代样式颜色统一，毛玻璃样式优化
- 🐛 **卡片设置页面重复打开问题修复** - 使用 router.replaceUrl 替换当前页面，避免堆叠
- 📐 **2x2卡片布局优化** - 移除天气按钮组件，保留城市名称显示
- 🌐 **离线模式支持** - 新增 `OfflineDataManager` 类管理离线数据加载、离线状态时从本地缓存加载诗句、在线状态时从网络加载、支持循环加载本地缓存的诗句、离线模式下隐藏点赞按钮、无缓存时显示网络错误提示、优化数据加载逻辑
- 🔄 **个人卡片在线/离线状态切换** - 在个人卡片tips卡片内添加在线状态开关、开关状态保存到SharedPreferences、关闭后切换为离线状态、支持点击tips卡片切换祝福语功能、优化开关布局、状态切换时显示气泡消息提示

### 开发进度
- 🏗️ **HarmonyOS桌面小组件** - 开发中，包含2x2布局、天气显示、诗句展示等功能
  - 优先级：3
getx 加入
二维码能力
HarmonyOS HongMeng Kernel