release 1.3.1

2026-04-01 18:40:21 +08:00
parent 91ef47f991
commit f0a62ed68b
60 changed files with 1750 additions and 313 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,152 @@ All notable changes to this project will be documented in this file.

 ---

+## [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

 ### 修改
@@ -15,137 +161,34 @@ All notable changes to this project will be documented in this file.

 ---

-## [1.3.14] - 2026-04-01
+## 软件特性功能

-### 修复
- 🐛 **彻底修复 AppBar 标题不显示问题**
-  - 移除 `TabbedNavAppBar` 中的自定义 `toolbarHeight`，使用 Flutter 默认值
-  - 移除 TabBar 的自定义高度包装（`PreferredSize` + `SizedBox`），直接使用 `TabBar` 作为 `bottom`
-  - 简化 TabBar 指示器配置，移除不必要的 `insets`
-  - 明确设置标题颜色为 `Colors.black87`
-  - 涉及文件：
-    - `lib/widgets/tabbed_nav_app_bar.dart` - 彻底修复 AppBar 标题显示
+### 已开发完成
+- ✅ iOS 风格界面设计
+- ✅ 诗词浏览与收藏
+- ✅ 搜索与分类
+- ✅ 答题挑战功能
+- ✅ 离线模式
+- ✅ 个性化设置
+- ✅ 投稿功能
+- ✅ 投票功能
+- ✅ 天气与十二时辰
+- ✅ 图片分享
+- ✅ 数据管理
+- ✅ 使用教程页面
+- ✅ 全站统计页面
+- ✅ 修复 AppBar 标题显示问题

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

-## [1.3.13] - 2026-04-01
+## 开发进度

-### 优化
- 🎨 **优化收藏页面布局**
-  - 去掉收藏页面卡片之间的空白间距
-  - 在卡片之间添加黑色半透明分割线
-  - 减少列表顶部padding，让内容更紧凑
-  - 移除卡片自身的底部margin，改用统一的分割线间距
-  - 涉及文件：
-    - `lib/views/footprint/all_list.dart` - 优化收藏页面布局
-
---
-
-## [1.3.12] - 2026-04-01
-
-### 新增
- ✨ **新增全站统计页面**
-  - 创建了iOS风格的全站统计页面，展示网站统计数据
-  - 页面包含：收录数量、热度统计、热门内容、建站时间等
-  - 支持下拉刷新，实时获取最新统计数据
-  - 使用主题色设计，与整体应用风格统一
-  - 添加了网络状态检测和错误处理
-  - 涉及文件：
-    - `lib/views/profile/components/entire-page.dart` - 新建全站统计页面
-    - `lib/views/profile/profile_page.dart` - 添加跳转到全站统计页面
-
-### 修复
- 🐛 **修复全站统计页面布局溢出问题**
-  - 调整了数量统计网格的宽高比，从1.1改为0.9，再优化为0.9
-  - 优化了统计卡片的内部间距和字体大小
-  - 减少了图标容器（36→32→28）和图标大小（20→18→16）
-  - 减少数值字体大小（18→16→14）和标签字体大小（11→10→9）
-  - 减少内部间距（12→10→8，8→6→4，4→2）
-  - 确保在不同屏幕尺寸下都能正常显示
-  - 涉及文件：
-    - `lib/views/profile/components/entire-page.dart` - 修复布局溢出
-
-### 优化
- ✨ **更新全站统计页面字段标签**
-  - 根据API文档更新，调整了统计字段的显示标签
-  - "已开设分类" → "项目"
-  - "已收录诗句" → "收录诗句"
-  - "审核中申请" → "审核中"
-  - "已拒绝申请" → "已拒绝"
-  - "文章数量" → "每日一句"（图标改为太阳）
-  - "已发布公告" → "推送"
-  - "开发者人数" → "开发者"
-  - 涉及文件：
-    - `lib/views/profile/components/entire-page.dart` - 更新字段标签
-
-### 改进
- 🎨 **重新设计数量统计布局为3x3网格**
-  - 保持3x3网格布局，从列表改回网格视图
-  - 每个网格项内部改为上下两行布局
-  - 上行（flex: 2）：icon和数据水平排列，比例1:1
-    - 有icon时：icon和数据各占一半
-    - 无icon时（收录诗句、分类标签）：数据自动占满整行
-  - 下行（flex: 1）：描述单独一行，居中显示
-  - 上下行比例：2:1
-  - 优化了网格项宽高比为1.0
-  - 增大了图标（24）和数值字体（22），提升可读性
-  - 涉及文件：
-    - `lib/views/profile/components/entire-page.dart` - 重新设计3x3网格布局
-
- ✨ **建站时间卡片增加天数显示**
-  - 自动计算从建站日期到现在的天数
-  - 在建站时间右侧显示"已运行 X 天"标签
-  - 使用主题色背景的圆角标签样式
-  - 涉及文件：
-    - `lib/views/profile/components/entire_page.dart` - 增加天数计算和显示
-
- 🔧 **修复代码规范问题**
-  - 添加 `library;` 指令修复悬空库文档注释警告
-  - 重命名文件 `entire-page.dart` → `entire_page.dart` 符合 Dart 命名规范
-  - 涉及文件：
-    - `lib/views/profile/components/entire_page.dart` - 文件重命名
-    - `lib/views/profile/profile_page.dart` - 更新 import 路径
-
- ⚡ **优化全站统计页面加载体验**
-  - 移除全局转圈加载动画，改为骨架屏预加载
-  - 页面进入时立即显示骨架屏布局，提升用户体验
-  - API 数据加载完成后平滑过渡到实际内容
-  - 涉及文件：
-    - `lib/views/profile/components/entire_page.dart` - 异步加载优化
-
- ✨ **全站统计页面头部添加刷新按钮**
-  - 在"情景诗词"标题右侧添加刷新图标
-  - 点击可重新加载统计数据
-  - 涉及文件：
-    - `lib/views/profile/components/entire_page.dart` - 添加刷新按钮
-
- ✨ **新增服务器信息弹窗组件**
-  - 创建美化的服务器信息弹窗组件 `ServerInfoDialog`
-  - 全站统计页面 AppBar 右侧添加信息图标，点击显示服务器信息
-  - 离线数据页面同步使用新的美化弹窗
-  - 弹窗显示：服务器时间、负载、响应时间、网络延迟等
-  - 响应时间自动判断状态（极快/快速/正常/较慢）
-  - 涉及文件：
-    - `lib/views/profile/components/server_info_dialog.dart` - 新建弹窗组件
-    - `lib/views/profile/components/entire_page.dart` - 添加信息图标
-    - `lib/views/profile/settings/offline-data.dart` - 使用新弹窗组件
-
---
-
-## [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 平台检查
-
---
-
-### 修复
- 优化了屏幕常亮功能的错误处理
- 增强了平台检测和日志输出
- 为不支持屏幕常亮的设备添加了专门的错误提示
+| 功能 | 优先级 | 状态 |
+|------|--------|------|
+| 使用教程 | 1 | ✅ 已完成 |
+| 投稿功能优化 | 2 | ✅ 已完成 |
+| 界面美化 | 3 | ✅ 已完成 |
+| 数据管理功能 | 1 | ✅ 已完成 |
+| 性能优化 | 4 | 🔄 进行中 |
+| 新功能开发 | 5 | 📋 计划中 |