# Changelog

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

---

## [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条记录，超出时自动删除最早的记录

---



## [1.3.2] - 2026-03-30

### 新增
- 📝 **诗词投稿功能**
  - 新增投稿页面 `lib/views/profile/expand/manu-script.dart`
  - 支持诗词收录申请，包含完整表单（参考语句、分类选择、诗人和标题、关键词、诗词介绍、人机验证）
  - 实现相似度检测功能，防止重复提交
  - 平台字段自动获取设备类型并发送"设备类型 + Flutter"格式数据
  - 修改"去投稿"按钮跳转逻辑，文件：`lib/views/profile/profile_page.dart`




---

## [1.3.0] - 2026-03-29

### 新增
- ⚡ **离线数据下载优化**
  - 添加取消下载功能，支持中断下载过程
  - 下载过程中显示取消按钮，点击可立即停止
  - 优化下载状态显示，避免页面卡死
  - 取消下载时显示相应提示
  - 文件：`lib/views/profile/settings/offline-data.dart`

### 优化
- 🌐 **网络状态自动检测**
  - 个人卡片加载时自动检测网络状态
  - 无网络时自动调整为离线状态
  - 避免网络异常导致的错误
  - 文件：`lib/views/profile/per_card.dart`

### 修复
- 🐛 **网络状态检测错误修复**
  - 修复 `currentNetworkStatus` 不存在的错误
  - 修复 `NetworkStatus.offline` 不存在的错误
  - 使用正确的 `currentStatus` 和 `NetworkStatus.error`
  - 文件：`lib/views/profile/per_card.dart`

### 新增
- 📊 **服务器信息显示**
  - 在离线数据页面添加服务器信息卡片
  - 显示 API 地址、版本、频率限制等信息
  - 文件：`lib/views/profile/settings/offline-data.dart`

### 优化
- 📱 **离线数据下载功能增强**
  - 新增下载类型选择：诗句和答题
  - 诗句数量选项：20、30、60、100条
  - 答题数量选项：20、50、80、100条
  - 100条下载需要加入用户体验计划
  - 实现下载一条写入一条的功能
  - 取消下载时保存已下载的数据
  - 实时更新缓存状态显示
  - 返回上一页时继续后台下载，不中断
  - 清空缓存时弹窗选择清空内容（诗句/答题/全部）
  - 缓存状态同时显示诗句和答题数量
  - 文件：`lib/views/profile/settings/offline-data.dart`



---

## 软件特性功能

### 已开发完成
- 🐛 **已知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