Hooke / mlaj

将原ui目录下的组件按功能分类移动到新的子目录中：
- 将GradientHeader、ConfirmDialog等基础组件移至common目录
- 将CourseCard、LiveStreamCard等课程相关组件移至courses目录
- 将FrostedGlass等视觉特效组件移至effects目录
- 将VideoPlayer、AudioPlayer等媒体组件移至media目录
- 将CheckInDialog等打卡相关组件移至checkin目录
- 更新所有引用路径以匹配新的目录结构

为TaskCascaderFilter、AddTargetDialog、CheckInList等组件添加详细的JSDoc注释
将LiveStreamCard组件的英文注释转换为中文
完善postCountModel组件的类型检查和空值处理
为CheckinDetailPage的关键方法添加详细说明

为AppLayout、CourseCard等组件和useShare、useTracking等工具函数添加了详细的JSDoc注释，包括功能描述、参数说明和返回值类型。这些注释将提升代码可读性和维护性，帮助开发者快速理解组件和函数的用途及使用方法。

新增的注释涵盖了组件props、methods、events等关键部分，并遵循了统一的文档格式标准。对于复杂逻辑的函数，添加了详细的实现说明和使用示例。

这些文档更新不会影响现有功能，但会显著改善开发体验和代码可维护性。

添加关于Vue 3 TypeScript开发、Volar工具链、性能优化和测试相关的13个最佳实践文档，涵盖模板类型检查、CSS模块、路由参数类型等核心场景

- 新增vue-tsc严格模板检查规则
- 添加CSS模块严格类型验证指南
- 补充Volar 3.0迁移问题解决方案
- 包含Pinia测试和SSR HMR调试实践
- 添加defineModel和withDefaults的TypeScript处理方案
- 补充模块解析和自动导入冲突解决建议

- 添加业务系统架构详细说明，包括用户认证、课程系统、打卡作业系统等模块
- 记录近期功能更新，包括教师端功能、登录逻辑优化、课程详情页改进等
- 完善目录结构说明和技术栈实现细节

添加对 .flac, .ogg, .wma, .m4a 格式的支持，以兼容更多音频文件类型

style(checkin): 优化打卡卡片图片布局

修改学习课程页面底部间距从30vh增加到80vh以提供更多空间
重构打卡卡片图片布局，使用固定宽高比和更合理的间距

修复初始化时日期选择逻辑错误，优化日期参数传递方式
添加状态变量跟踪用户是否主动选择日期
确保页面刷新和导航时正确加载数据

在CollapsibleCalendar和taskHomePage组件中，将硬编码的附件类型映射逻辑替换为统一的工具函数normalizeAttachmentTypeConfig，提高代码复用性和可维护性

实现附件类型配置的归一化处理，支持多种后端格式
添加文件大小限制映射和计算逻辑
更新上传组件以显示动态限制大小
添加相关测试用例

在任务打卡成功时，将选中项的 is_gray 和 is_finish 状态设置为 true，以正确反映任务完成状态

将task_list和timeout_task_list的初始化及数据处理逻辑移到课程数据加载成功后执行，确保数据正确性

将多处重复的打卡任务列表字段映射逻辑提取为工具函数 normalizeCheckinTaskItems
统一处理字段映射逻辑，避免散落在各页面导致维护困难

为课程页面中的任务数据添加is_finish和checkin_subtask_id字段，用于跟踪任务完成状态和关联打卡子任务

在打卡详情页中，根据任务类型动态显示附件类型标签为必选或可选
在打卡目标列表组件中，为必填项添加红色星号标识

在CourseDetailPage.vue中添加缺失的checkin_subtask_id字段
在CheckInList.vue中增加对checkin_subtask_id的校验

将视频播放器核心逻辑拆分为多个组合式函数，包括视频源处理、资源探测和播放叠层管理
提取视频类型判断和HLS支持检测到独立模块
优化错误处理和弱网提示的显示逻辑

修复 v-show 改为 v-if 避免视频播放器隐藏时继续消耗资源
改进视频类型推断逻辑，支持从 videoId 扩展名识别类型
优化清晰度插件初始化逻辑，确保在 m3u8 源下正确工作
增强原生 HLS 播放能力检测，避免不必要的 VHS 覆盖

统一在所有VideoPlayer组件中添加use-native-on-ios=false属性，避免iOS平台上的播放问题

- 在视频播放器组件中添加HLS下载速度显示和调试信息展示
- 新增debug模式用于显示详细调试信息
- 优化网络状态检测逻辑，增加微信环境下的网络类型检测
- 添加相关测试用例验证功能

清理不再需要的流量警告相关代码，包括组件模板、样式和逻辑
简化播放控制流程，直接使用原生播放方法

当检测到用户使用移动网络且视频文件较大时，显示流量消耗警告弹窗
新增网络类型检测功能，支持微信内置浏览器环境
重构播放逻辑，统一通过requestPlay处理播放请求

添加网络速度检测功能，当视频缓冲或卡顿时显示当前网络速度
新增网络速度覆盖层UI组件，包含网络状态提示和具体速度值
为原生播放器和video.js播放器添加相关事件监听

新增 videojs-contrib-quality-levels 和 videojs-hls-quality-selector 插件
支持自动识别 m3u8 多码率并在控制条显示清晰度切换菜单

允许通过 useNativeOnIos 属性控制 iOS 环境下是否强制使用原生播放器
默认保持原生播放器行为，但可在需要时切换为 Video.js

处理当 to 对象缺少 matched 属性时的边界情况，确保授权检查逻辑的健壮性

添加 videojs-contrib-quality-levels 和 videojs-hls-quality-selector 依赖
在视频播放器中集成多码率切换功能，支持七牛云多码率 .m3u8 地址
自动在控制条显示清晰度切换菜单（PC/Android端）

添加 touch-action 样式以解决 Video.js 在移动端拖动进度条时的报错问题，同时优化视频播放器的触摸交互

为视频播放器逻辑添加清晰的注释标记
重新组织代码结构使其更易读

将视频播放器核心逻辑抽离为useVideoPlayer组合式函数，优化错误处理和重试机制
添加hls.js依赖以支持HLS视频格式播放
简化VideoPlayer组件代码，提高可维护性

为iOS微信环境添加原生video元素支持，优化视频播放体验
添加视频资源探测功能，提供更好的错误提示和重试机制
重构视频源处理逻辑，支持自动识别视频格式