ui细节优化

This commit is contained in:
Developer
2026-04-01 04:45:33 +08:00
parent 6517a78c7e
commit 79f7269319
23 changed files with 3299 additions and 885 deletions

View File

@@ -1,298 +1,47 @@
# 更新日志
## 软件特性功能
## v1.12.0 - 2026-03-26
### 已开发完成
- 🎛️ **隐藏次要按钮功能** - 在功能设置页面添加开关、开启后隐藏主页的"上一条"和"分享"悬浮按钮、默认关闭、状态保存到SharedPreferences、使用SecondaryButtonsManager单例管理、实时响应开关状态变化无需重启
- 优先级3
- 📸 **诗词卡片截图分享功能** - 主页点赞按钮上方添加悬浮分享按钮、点击生成诗词卡片高清图片并分享、使用RepaintBoundary和GlobalKey实现Widget截图、集成share_plus库实现跨平台分享、包含生成中/成功/失败提示
- 优先级4
- 📜 **诗词投稿功能** - 新增投稿页面、支持诗词收录申请表单、包含参考语句/分类选择/诗人和标题/关键词/诗词介绍/人机验证、实现相似度检测防止重复提交、平台字段自动获取设备类型
- 优先级3
-**离线数据下载优化** - 添加取消下载功能、下载过程中显示取消按钮、优化下载状态显示避免页面卡死、取消下载时显示相应提示
- 优先级4
- 🌐 **网络状态自动检测** - 个人卡片加载时自动检测网络状态、无网络时自动调整为离线状态、避免网络异常导致的错误
- 优先级3
- 📊 **服务器信息显示** - 在离线数据页面添加服务器信息卡片、显示API地址/版本/频率限制等信息
- 优先级2
- 📱 **离线数据下载功能增强** - 新增下载类型选择诗句和答题、诗句数量选项20/30/60/100条、答题数量选项20/50/80/100条、100条下载需加入用户体验计划、实现下载一条写入一条、取消下载时保存已下载数据、实时更新缓存状态、返回上一页继续后台下载、清空缓存时弹窗选择清空内容、缓存状态同时显示诗句和答题数量
- 优先级5
- <20><> **已知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卡片切换祝福语功能、优化开关布局、状态切换时显示气泡消息提示
### 📄 新增隐私政策与用户协议页面
- **新建隐私政策与用户协议页面**
- 创建 `privacy.dart` 页面,包含隐私政策和用户协议两个标签页
- 采用 TabBar 设计,便于在隐私政策和用户协议之间切换
- 关键字段使用 ***** 占位,便于后续修改
- 包含完整的隐私政策内容:信息收集、设备权限、联系方式等
- 包含完整的用户协议内容:协议范围、服务内容、知识产权等
- 地址信息:云南昆明 xx工作室
- 软件名称:情景诗词
### 🔗 在线版本功能
- **AppBar 右侧添加在线版本按钮**
- 添加链接图标按钮,点击显示在线协议弹窗
- 弹窗显示在线协议链接占位符https://*****.github.io/privacy
- 支持一键复制链接到剪贴板
- 复制成功后显示 SnackBar 提示
### 📝 HTML 版协议
- **创建独立的 HTML 版本协议文件**
- 文件位置:`privacy.html`
- 响应式设计,支持手机、平板、桌面端
- 采用现代苹果风格设计,与 App 风格统一
- Tab 切换动画,流畅的用户体验
- 可用于部署到 GitHub Pages 或其他静态网站托管
### 🔗 页面导航优化
- **个人页面添加跳转入口**
- 在 profile_page.dart 中添加隐私政策页面导入
- 修改"软件协议"设置项,点击跳转到隐私政策页面
- 更新图标为 Icons.description更符合页面功能
### 👥 新增"了解我们"页面
- **新建了解我们页面**
- 创建 `learn-us.dart` 页面,展示开发者信息
- 页面头部卡片:显示应用名称、版本号和标语
- 官方网站卡片展示官网链接占位符https://*****.github.io
- 开发者卡片:显示"微风暴工作室"信息
- 团队信息卡片:展示团队成员及个性签名
- 程序设计:***
- UI/UX/Testing****
- 后端:***
- 技术支持:技术
- 备案信息卡片:显示备案号"滇ICP备2022000863号-15A"
- 备案号支持点击复制,复制成功后显示 SnackBar 提示
### 🎨 界面设计
- **统一苹果风格设计**
- 使用与项目一致的设计系统和颜色变量
- 采用卡片式布局,圆角和阴影保持统一
- 关键字使用加粗显示,提升可读性
- 底部添加"到底了"指示器,与其他页面保持一致
---
## v1.11.0 - 2026-03-25
### 🎨 界面优化
- **新增下一条悬浮按钮**
- 在"上一条"按钮下方添加"下一条"悬浮按钮
- 左侧垂直排列:上一条(上)、下一条(下)
- 下一条按钮使用与点击诗词卡片相同的逻辑
- 保留诗词卡片点击加载下一条的功能
- 增加底部预留空间,确保所有按钮都可见
### 🔘 按钮布局优化
- **三悬浮按钮设计**
- 左侧垂直排列:上一条、下一条
- 右侧:点赞按钮
- 所有按钮保持圆形设计和阴影效果
- 左侧两个按钮间距合理,便于操作
---
## v1.10.0 - 2026-03-25
### 🎨 界面重构
- **诗词卡片交互优化**
- 移除"下一条"按钮,改为点击诗词卡片任意区域加载下一条诗词
- 诗词卡片整体可点击,提升用户体验
- 保留原有的长按复制功能
### 🔘 按钮布局调整
- **双悬浮按钮设计**
- 点赞按钮改为悬浮固定按钮,位于右下角
- 上一条按钮改为悬浮固定按钮,位于左下角
- 双按钮采用圆形设计,带阴影效果,左右分布
- 保持加载状态显示和触觉反馈
- 按钮位于上层,诗词卡片在下层,确保按钮始终可见
### 🔄 导航按钮重构
- **双悬浮按钮布局**
- 移除传统导航按钮,改为双悬浮按钮设计
- 左右分布:上一条(左)、点赞(右)
- 简化界面,提升视觉层次感
- 按钮位于上层,确保始终可见和可操作
### ⚡ 动态加载优化
- **分步加载机制**
- 移除全局空白等待,改为固定布局动态加载
- 不同区域显示不同的加载状态文字
- "出处加载中..."、"诗句加载中..."、"原文加载中..."、"关键词加载中..."、"译文加载中..."
- 分步加载顺序:标题→诗句→原文→关键词→译文
- 每个区域200ms间隔提供流畅的视觉体验
### 🌐 网络权限配置
- **Android端网络权限**
- 添加INTERNET权限用于网络访问
- 添加ACCESS_NETWORK_STATE权限检查网络状态
- 添加ACCESS_WIFI_STATE权限检查WiFi状态
- 启用usesCleartextTraffic支持HTTP连接
### 🧹 代码优化
- **组件重构**
- 移除ActionButtons组件替换为FloatingLikeButton
- 移除NavigationButtons组件替换为FloatingPreviousButton
- 移除未使用的swapped相关代码
- 优化布局结构使用Stack实现双层悬浮按钮定位
- 为悬浮按钮预留底部空间,避免遮挡内容
- 新增sectionLoadingStates状态管理
- 实现分步加载逻辑_simulateSectionLoading
### 📱 用户体验提升
- **更直观的交互方式**
- 点击卡片即可切换到下一条诗词
- 双悬浮按钮设计,左右分布
- 上一条按钮在左,点赞按钮在右,符合操作习惯
- 悬浮按钮位于上层,始终可见和可操作
- 动态加载保持布局稳定,无页面跳动
- 分步加载提供清晰的加载进度反馈
- 简化界面,减少视觉干扰,突出内容展示
- 保持原有的下拉刷新功能
---
## v1.9.0 - 2026-03-25
### 🛠 技术重构
- **替换SQLite为SharedPreferences**
- 将SQLiteStorageController从SQLite实现改为SharedPreferences实现
- 移除sqflite和sqflite_common_ffi依赖
- 使用SharedPreferences实现本地键值对存储
- 保持原有API接口不变确保向后兼容
### 📦 依赖更新
- **移除SQLite相关依赖**
- 移除 `sqflite: ^2.4.2` 依赖
- 移除 `sqflite_common_ffi` 相关代码
- 保留 `shared_preferences` 作为唯一本地存储方案
### 🎯 功能优化
- **存储控制器优化**
- 简化初始化流程,无需数据库路径处理
- 移除平台权限问题,提升兼容性
- 减少包体积,降低依赖复杂度
- 提升存储操作性能
### 🔧 API保持
- **接口兼容性**
- 保持所有原有方法签名不变
- setString/getString
- setInt/getInt
- setBool/getBool
- setDouble/getDouble
- remove/clear/getKeys/containsKey
- 新增 setStringList/getStringList 方法
### 📚 OHOS兼容性
- **平台兼容保证**
- SharedPreferences天然支持OHOS平台
- 无需处理数据库文件路径权限
- 确保跨平台一致性体验
---
## v1.8.1 - 2026-03-23
### 🔧 错误修复
- **修复OHOS平台SQLite数据库路径权限问题**
- 解决"PathAccessException: Creation failed, path = '/.dart_tool' (OS Error: Permission denied)"错误
- 改进数据库路径获取逻辑,增加备用路径机制
- 确保在OHOS平台上能够正常创建和访问数据库文件
## v1.8.0 - 2026-03-23
### 🛠 技术重构
- **替换Hive为SQLite**
- 新增 `SQLiteStorageController` 存储控制器
- 基于sqflite实现本地存储功能
- 提供完整的键值对存储API
### 🔧 错误修复
- **彻底解决编译错误**
- 修复"Target of URI doesn't exist"错误
- 修复"Undefined name 'SharedPreferences'"错误
- 修复"The name 'SharedPreferences' isn't a type"错误
### 📦 依赖更新
- **添加SQLite支持**
- 新增 `sqflite: ^2.3.0` 依赖
- 新增 `path: ^1.8.3` 依赖
- 使用dependency_overrides解决版本冲突
### 🎯 功能实现
- **完整的存储功能**
- 支持String、int、bool、double等基本类型
- 支持对象序列化和反序列化
- 提供完整的CRUD操作接口
- 自动数据库初始化和管理
### 📚 OHOS兼容性
- **平台兼容保证**
- 使用SQLite确保跨平台兼容
- 解决Flutter版本识别问题
- 确保OHOS平台构建成功
## v1.7.0 - 2026-03-21
### 🛠 彻底重构
- **完全移除shared_preferences**
- 删除shared_preferences_controller.dart文件
- 统一使用HiveStorageController
- 修复所有编译错误和引用问题
### 🔄 代码统一
- **存储控制器标准化**
- hive_storage_controller.dart重命名为HiveStorageController
- 移除重复的控制器定义
- 统一API接口和调用方式
### 📦 依赖清理
- **构建问题彻底解决**
- 移除所有shared_preferences相关依赖
- 确保OHOS构建路径兼容性
- 简化项目依赖结构
### 🔧 修复内容
- **编译错误修复**
- 修复"uri_does_not_exist"错误
- 修复"undefined_identifier"错误
- 更新所有import语句
### 📚 OHOS兼容性
- **构建成功保证**
- 使用纯Dart库确保平台兼容
- 移除所有Flutter平台特定依赖
- 确保HAP构建无路径错误
---
## v1.6.0 - 2026-03-21
### 🛠 技术重构
- **完全移除shared_preferences依赖**
- 解决OHOS构建路径兼容性问题
- 替换为纯Dart的Hive存储方案
- 确保OHOS平台完全兼容
### 🔄 存储方案重构
- **Hive存储控制器**
- 重写SharedPreferencesController为HiveStorageController
- 提供相同的API接口确保向后兼容
- 支持所有数据类型String, int, double, bool, List, Map
- 更好的性能和类型安全
### 📦 依赖清理
- **移除问题依赖**
- 删除shared_preferences git依赖
- 保留Hive作为唯一本地存储方案
- 简化依赖树,减少构建复杂度
### 🔧 初始化优化
- **Hive初始化流程**
- 在main.dart中正确初始化Hive
- 使用Hive.initFlutter()确保Flutter兼容
- 统一的存储控制器初始化
### 📚 OHOS兼容性
- **构建问题解决**
- 修复"srcPath is not a relative path"错误
- 移除绝对路径依赖问题
- 确保OHOS HAP构建成功
---
## 版本说明
- 版本号格式:主版本号.次版本号.修订号
- CHANGELOG.md 仅保留最近 5 个版本记录
- 较早版本记录已开发完成的功能写入下方
1.主页 诗句加载 点赞
侧感手势
原生90/120帧率
### 开发进度
- 🏗️ **HarmonyOS桌面小组件** - 开发中包含2x2布局、天气显示、诗句展示等功能
- 优先级3
getx 加入
二维码能力
HarmonyOS HongMeng Kernel