Hooke / mlaj

添加关于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元素支持，优化视频播放体验
添加视频资源探测功能，提供更好的错误提示和重试机制
重构视频源处理逻辑，支持自动识别视频格式

重构作业描述显示逻辑，根据选中的子任务显示对应的描述或主任务描述
优化富文本内容的样式，确保图片、表格等元素在容器内正确显示且不溢出

在用户信息和认证上下文中添加get_is_teacher函数，用于从不同字段中判断教师身份并统一返回0或1

在多个模块中添加统一的未读消息数量提取函数，支持从不同字段获取未读数量
优化底部导航栏的未读消息显示逻辑，改为计算属性方式
移除冗余代码并更新用户信息处理逻辑