Hooke / mlaj

更新错误提示信息，使其更清晰地指导用户操作，并移除调试用的console.warn语句

添加环境变量 VITE_CHECKIN_MULTI_ATTACHMENT 控制是否开启多附件功能。
当开关关闭时，混合类型附件提交会提示“请分别提交”。
当开关开启时，允许混合类型附件提交，并使用新的接口字段。
更新测试用例以覆盖开关开启和关闭的场景。

当新结构提交失败时，回退到旧结构参数格式重试
处理混合类型附件的错误提示
将editUploadTaskInfoAPI的HTTP方法从GET改为POST

重构 beforeReadGuard 函数，为视频和音频类型分别添加格式校验逻辑。视频类型保持原有的 MOV 格式拦截，音频类型新增对 .mp3, .m4a, .aac, .wav 格式的支持，并拦截不支持的格式（如 .wma）。同时更新了 accept 类型和上传提示文案以保持一致性。

移除 components.d.ts 中未使用的 VanDivider 类型声明。

移除图片、视频、音频和文本的独立上传页面，将相关路由从路由配置中删除
清理首页中已注释的导航函数，减少代码冗余
删除对应的Vue组件文件，统一打卡功能入口

在视频上传前检查文件格式，拦截MOV文件并显示兼容性提示对话框
将视频上传的accept类型限制为MP4格式，更新上传提示信息

- 删除 src/layouts/AppLayout.vue，统一使用 src/components/layout/AppLayout.vue
- 从组件类型声明中移除 VanTabbar 和 VanTabbarItem
- 更新 myClassPage.vue 导入以使用新的布局路径
- 同步更新 README、COMPONENTS 和 VUE_CODE_STYLE_GUIDE 中的文档说明

- 新增buildCdnImageUrl工具函数，为cdn域名图片自动追加七牛压缩参数
- 在多个组件中应用图片压缩，包括首页、课程卡片、活动卡片等
- 更新默认头像URL，添加压缩参数减少传输体积
- 更新README中的构建体积说明，反映当前优化状态

- 将 PdfViewer 和 VideoPlayer 组件改为异步加载，减少初始包体积
- 为视频播放器相关依赖添加动态导入，避免未使用时加载
- 在打包配置中添加手动分包策略，将 vue-office 和图像工具库分离为独立 chunk
- 优化 Safari 浏览器检测逻辑，避免直接导入 video.js 以支持懒加载

将原README中的详细内容拆分为多个文档，提升可维护性
- 新增docs/COMPONENTS.md：组件目录索引
- 新增docs/CHANGELOG.md：功能更新记录
- 新增docs/ARCHITECTURE.md：架构实现与工程配置
- 重构README.md为项目概览与快速索引

将徽章位置从 top-1 right-1 调整为 -top-2 -right-2，使其完全位于标签图标外部，避免与图标内容重叠导致视觉遮挡问题。

重构文件上传逻辑，支持在同一打卡中上传并显示多种类型的文件（图片、视频、音频）。移除按类型切换时清空文件列表的限制，新增文件类型计数显示。更新多个视图中的数据处理函数以支持按文件类型分类。

- 统一附件列表字段结构，将meta_id和file_type合并到files数组中
- 为getCheckinTeacherListAPI接口补充返回数据结构说明
- 同步更新teacher.js中getStudentUploadListAPI的注释

在视频封面缺失时，播放器区域显示为透明背景，导致视觉不一致。为 VideoPlayer 组件添加黑色背景，并在 StudyDetailPage 中动态设置封面容器的背景色：有封面时透明，无封面时黑色。同时优化 useVideoPlayer 配置逻辑，避免传递空的 poster 属性。

- 添加隐藏的预渲染节点，避免动态计算容器宽度导致的封面空白
- 在iOS微信环境中使用html2canvas替代html-to-image以解决兼容性问题
- 优化封面图片加载逻辑，添加原图兜底策略
- 调整样式和监听逻辑，确保数据变化时能正确触发重新生成

当评价内容为空时，调用 showToast 提示用户输入，改善用户体验。

- 将选中日期时的按钮文本从“选中 YYYY-MM-DD”简化为“更改日期”，提升简洁性
- 为按钮添加日历图标，并通过动态类名在选中和未选中状态间切换颜色
- 使用 flex 布局优化图标与文本的对齐，并添加状态颜色过渡效果

新增 useScrollRestoration 组合式函数，用于在打卡列表页面实现滚动位置恢复
当用户从打卡详情页返回时，自动恢复到之前的滚动位置，支持锚点定位和日历高度补偿
添加对应的单元测试，覆盖等待条件、超时处理和条件恢复等场景

在日历头部隐藏时，切换按钮仍会显示导致布局异常。通过添加 v-if 条件判断，仅在头部未隐藏时显示切换按钮，避免视觉错乱。

清理注册、课程详情和忘记密码页面中的注释标记，使代码注释更简洁

- 新增业务系统架构章节，涵盖用户认证、课程系统、打卡作业、活动、召回等核心模块
- 补充核心技术栈与实现细节，包括状态管理、文件处理、路由权限等
- 完善目录结构说明，清晰展示项目组织方式
- 更新功能更新记录，记录近期重要变更与优化点

更新多个视图文件的头注释信息，包括日期、最后编辑者和描述

添加重试次数限制判断条件canRetry
移除自动重试逻辑改为手动触发
优化错误提示UI样式和间距
添加重试后的错误状态检查定时器

添加任务详情准备状态检查，优化完成状态判断逻辑

- 使用模板统一管理课程详情显示逻辑
- 添加空状态提示组件替代注释掉的代码
- 移除不必要的条件渲染和注释

在日历组件中添加清空选中日期的功能，并优化日期切换按钮的显示样式和文本
当有选中日期时显示具体日期，无选中日期时显示"切换日期"
添加清空按钮用于快速清除当前选中状态

移除冗余的空状态组件，根据内容动态显示分隔线

当课程没有特色、亮点或学习目标时，才显示"暂无详情"。修复了原本逻辑中空状态和详情可能同时显示的问题

在课程详情页跳转至学习页时传递课程ID，并在学习页中监听课程ID变化时同步滚动位置

实现从课程详情页返回时恢复滚动位置的功能
添加数据属性标记课程目录项
新增滚动状态存储和恢复相关方法

将原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处理方案
- 补充模块解析和自动导入冲突解决建议

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