Hooke / mlaj

更新自动生成的类型声明文件，以包含 Vue 的 Slot 和 Slots 类型，确保类型完整性并支持模板中的插槽类型检查。

更新 26.1.26 新功能开发计划文档，重新组织内容结构并完善细节：
- 按优先级重新排序功能：置顶、评论、评论列表为高优先级，海报为中优先级
- 新增教师评论管理功能需求
- 完善数据字段定义和 API 接口汇总
- 细化开发步骤为四个阶段并明确里程碑
- 补充边界条件、性能优化和测试计划

添加 SKILLS_GUIDE.md 文档，系统整理所有可用 Claude Code Skills 及其使用指南。同时在 26.1.26 新功能开发计划中补充内容规范和数据统计相关讨论点，完善功能规划。

不再忽略docs目录以将其纳入版本控制

添加项目架构、组件索引、变更记录、工作流和开发计划等文档
- ARCHITECTURE.md: 系统架构与工程配置说明
- COMPONENTS.md: 组件目录索引与说明
- CHANGELOG.md: 功能更新记录
- 工作流.md: 开发工作流程指南
- 暂存用户打卡信息.md: 草稿功能详细规划
- 26.1.26新功能开发计划.md: 打卡互动功能规划
- TODO/26.1.26新功能.md: 功能开发清单

新增 TEACHER_PIN 和 TEACHER_UNPIN 两个API端点，并导出对应的 teacherPinCheckinAPI 和 teacherUnpinCheckinAPI 函数，以支持老师对打卡进行置顶操作。

避免多tab高度不一致时容器被最高的内容撑开，导致短内容下方出现空白区域

- 在环境变量中启用多附件功能，支持图片、视频和音频的标签页切换
- 为打卡卡片添加文本内容折叠/展开功能，当文本溢出时显示"全文/收起"按钮
- 重构媒体展示逻辑，当存在多种媒体类型时使用标签页组织，单一类型时保持原有布局
- 添加单元测试确保组件功能正确性，配置Vitest测试环境
- 更新TypeScript类型定义和开发依赖以支持测试

在恢复打卡草稿前，检查草稿中保存的作业ID是否仍在当前可用作业列表中。如果作业已失效（如被删除或截止），则提示用户并清空草稿，避免恢复无效数据。

- 添加详细目录结构，便于快速导航
- 新增快速开始章节，包含环境准备和新手指南
- 扩展常用开发命令和目录结构说明
- 完善核心架构模式解释，补充组合式函数详情
- 新增常见问题与解决方案章节，涵盖Video.js、API调用、Vant组件等常见问题
- 更新功能更新记录，按时间分类整理
- 优化组件目录结构说明，增加文档索引

由于当前测试需要，暂时移除身份证号格式验证，以便测试流程能顺利通过。添加了TODO注释以便后续恢复验证。

移除学生详情页、打卡详情页和学生记录页中点评和留言输入框的maxlength与show-word-limit属性，以统一输入体验并避免在只读状态下显示无关的限制提示。

移除已完成的优化项，更新剩余项的描述和优先级。
将“统一API返回结构”的重点从调整判断逻辑改为逐步替换fn为request。
删除已完成的“收敛用户态来源”和“清理重复实现”条目。
新增“固化格式化规则”作为第三项。

添加 .claude、.cursor、.specify、.trae、.github 和 docs 到 .gitignore 文件，避免将特定 IDE 配置、开发工具生成文件以及文档构建目录提交到版本库。

- 新增 useCheckinDraft composable，支持草稿的自动保存、恢复和清理
- 在打卡详情页集成草稿功能：自动保存表单内容，进入时提示恢复
- 优化文件上传逻辑，确保草稿恢复后能正确预览附件
- 修复 countValue 初始化顺序导致的 ReferenceError
- 更新环境变量配置，添加 VITE_CHECKIN_DRAFT_CACHE 开关
- 完善相关文档和测试用例

添加 .trae/rules/update-changelog.md 文件，明确对话任务完成后更新 changelog.md 的规范。规定版本号采用 YYYY-MM-DD 格式，内容为任务描述，以保持项目变更记录的一致性和可追溯性。

移除课程目录列表后的多余条件判断，使分隔线始终显示以保持布局一致。
在文件上传结果处理逻辑前添加中文注释，明确代码意图。

更新错误提示信息，使其更清晰地指导用户操作，并移除调试用的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 条件判断，仅在头部未隐藏时显示切换按钮，避免视觉错乱。