CHANGELOG.md
6.74 KB
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
Added
API Generator Skill (OpenAPI 文档自动生成)
- 从 OpenAPI 文档自动生成 API 代码功能，支持完整的 OpenAPI 3.0.1 规范
- API 变更检测：自动检测新增、修改、删除的接口，识别破坏性变更
- 增量更新机制：智能备份和基线管理，避免误报
-
api:generate和api:diff命令：简化 API 生成和变更对比流程 - 完整文档模板和示例：包含 GET/POST 请求和响应结构示例
- 新增依赖：
js-yaml@4.1.1
[2026-01-29]
Added
代码质量工具链
- ESLint + Prettier 代码规范配置
- Husky + lint-staged Git Hooks 自动化检查
- 完整的 E2E 测试认证方案
文档优化
- 将 AI 辅助开发工作流文档从 ideas 移至 done 目录
- 添加 AI 辅助开发工作流优化方案文档
- 重组文档目录结构，分类整理所有文档
[2026-01-28]
Added
欢迎页功能 (Welcome Page)
- 首次访问欢迎页 (
/welcome)，用户首次打开应用时自动展示 - VideoBackground 组件：全屏视频背景，支持自动播放、循环播放、移动端优化
- WelcomeContent 组件：欢迎页内容区域，采用水平布局展示 3 个功能入口
- WelcomeEntryItem 组件：可复用的功能入口卡片组件
- 功能入口配置化管理 (
welcomeEntries)，支持内部路由和外部链接 - 首次访问检测：基于 localStorage 的标志位和路由守卫（仅访问 /welcome 时触发）
- 调试工具：开发环境下提供
window.resetWelcomeFlag()和window.showWelcome() - 环境变量：
VITE_WELCOME_PAGE_ENABLED（功能开关）、VITE_WELCOME_VIDEO_URL（视频 URL）
资源上传
- 通用七牛云上传工具
scripts/upload-to-qiniu.sh，支持单文件和批量上传 - 上传欢迎页背景视频：17.57MB 星空宇宙主题视频
- 上传欢迎页图标：33.53KB 功能入口图标
Changed
欢迎页布局和样式优化
- 添加"美乐爱觉"标题图片，复用召回页设计资源
- 调整布局方式：从环绕式布局改为水平排列，3 个功能入口在一行显示
- 优化尺寸：图标尺寸调整为 5rem，文字大小调整为 0.95rem
- 改进对称性：使用
justify-content: space-between确保左右边距一致 - 优化位置：布局更靠底部，padding-bottom 设置为 3rem
欢迎页访问逻辑优化
- 调整首次访问检测逻辑：不再自动拦截所有页面跳转到欢迎页
- 访问根目录
/时不会跳转到欢迎页 - 只有直接访问
/welcome时才判断是否首次访问
[2026-01-27]
Changed
TypeScript 类型优化
- 从
vue重新导出 Slot 和 Slots 类型，解决类型导入问题
[2026-01-26]
Added
打卡系统增强
-
打卡草稿缓存功能 (
useCheckinDraft)：防止数据丢失，自动保存和恢复 - 多附件功能：支持文本、图片、视频、音频混合上传与显示
-
打卡卡片优化 (CheckinCard)：
- 长文本折叠功能
- 多附件 Tab 切换
- 移除
van-tabs的animated和swipeable属性
- 草稿恢复时的作业有效性校验：作业失效时自动清理草稿
- 优化附件预览和编辑回填逻辑
- 基于
useCheckin的通用提交流程
教师端功能
- 老师置顶与取消置顶打卡的 API 接口
Changed
用户体验优化
- 移除文本输入框的字符限制与字数显示
- 为 CDN 图片添加压缩参数以优化加载性能
- 优化选中日期时切换按钮的显示样式和文本
Fixed
- 修复多类型附件提交时的错误提示信息
- 修复提交任务时接口兼容性问题
- 修复音频上传格式校验逻辑
- 修复视频封面缺失时的背景显示问题
[2026-01-25]
Changed
Git 配置优化
- 忽略开发工具与文档目录（.claude, .cursor, .specify, .trae, .github, docs）
- 从 .gitignore 中移除 docs 目录
[2026-01-24]
Added
CDN 图片优化
- 为
cdn.ipadbiz.cn域名的图片自动添加压缩参数
Changed
架构优化
- 移除独立的媒体打卡页面以简化路由结构
- 移除遗留布局目录 (
/src/layouts) 并更新相关文档 - 重构组件目录结构，将 UI 组件按功能分类到对应子目录
Fixed
- 限制视频上传格式并添加 MOV 格式提示
- 修复音频上传格式校验逻辑并移除未使用的 Divider 组件
[2026-01-23]
Added
打卡系统增强
- 多类型文件混合上传与显示：同时支持文本、图片、视频、音频
- 打卡滚动恢复功能：改善用户体验，返回页面时恢复滚动位置
- 清空选中日期功能：优化日期切换按钮显示
文件上传
- 扩展支持的音频格式列表
Fixed
- 修复海报生成在 iOS 微信中失败和封面空白问题
- 修复提交评价时为空内容添加提示
- 修复折叠日历组件在隐藏头部时按钮显示异常
- 修复视频封面缺失时的背景显示问题
[2026-01-22]
Added
课程学习体验优化
- 课程详情页和课程学习页的滚动位置同步功能
- 课程目录滚动位置记忆功能
- 动态文件大小限制功能
Changed
组件重构
- 重构组件目录结构，将 UI 组件按功能分类到对应子目录
Fixed
- 修复打卡页面日期选择和加载逻辑问题
- 修复打卡详情页附件类型标签显示问题
- 修复签到小作业 ID 未传递的问题
- 修复课程大纲打卡互动数据初始化问题
- 优化课程详情页空白状态和分隔线显示逻辑
- 完成任务后更新选中项的状态
[2026-01-21]
Added
附件管理
- 动态文件大小限制功能
- 附件类型显示工具函数
Fixed
- 修复打卡详情页附件类型标签显示问题
- 修复签到小作业 ID 未传递的问题
- 修复课程大纲打卡互动数据初始化问题
[2026-01-20]
Changed
视频播放器重构
- 重构视频播放器逻辑，拆分功能模块
- 移除网络速度显示覆盖层注释代码
Fixed
- 修复视频播放器条件渲染和清晰度插件问题
- 改进视频播放器重试逻辑并优化错误处理样式
历史功能更新（2025 及更早）
详细的早期功能更新已迁移到各业务模块文档：
Last updated: 2026-01-29