Hooke / mlaj

- 更新 README.md：标记所有开发任务为已完成
- 新增 CHANGELOG.md：记录欢迎页功能的完整变更日志
- 详细记录新增的组件、配置、环境变量和调试工具
- 记录技术细节、文件结构和使用指南

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 移除标题和底部按钮，简化页面结构
- 删除中心装饰圆圈，保持页面简洁
- 去掉图标背景装饰，放大图标尺寸至6rem
- 调整布局位置为不对称排列，打破完美对称
- 整体下移布局至页面中下部
- 修复文字倾斜问题，保持水平显示
- 优化文字与图标的间距

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 新增 WelcomeContent 组件：实现轨道式布局，3个功能入口环绕排列
- 新增 WelcomeEntryItem 组件：统一的功能入口卡片样式
- 新增 welcomeEntries 配置：课程中心、活动中心(外链)、个人中心
- 添加环境变量：VITE_WELCOME_PAGE_ENABLED 和 VITE_WELCOME_VIDEO_URL
- 支持外部链接跳转（活动中心）和内部路由跳转
- 添加浮动、脉冲等动画效果，提升视觉体验

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

第2-3阶段: 核心功能实现

新增组件：
- VideoBackground.vue (视频背景组件)
  * 支持自动播放、循环播放、静音
  * 自动从视频URL生成封面图 (七牛云 ?vframe/jpg/offset/0.001)
  * 完善的降级方案 (视频加载失败时使用静态背景图)
  * 支持 play/pause 方法暴露
  * 移动端兼容 (playsinline, x5-video-player-type)

- WelcomePage.vue (欢迎页视图)
  * 集成 VideoBackground 组件
  * 从环境变量读取视频URL
  * 预留内容区域插槽

路由与守卫：
- 路由配置: 添加 /welcome 路由 (routes.js)
- 首次访问检测: 检查 localStorage 标志位 (index.js)
- 标志位管理: hasVisitedWelcome(), markWelcomeVisited(), resetWelcomeFlag()
- 调试工具: window.resetWelcomeFlag(), window.showWelcome()
- URL参数: ?reset_welcome=true 重置标志

首次访问流程:
1. 用户首次访问 → 检测 localStorage 标志
2. 标志不存在 → 设置标志并跳转 /welcome
3. /welcome 页面显示视频背景和功能入口
4. 后续访问 → 直接进入目标页面

技术亮点:
- 七牛云视频处理参数自动生成封面图
- 移动端全屏视频优化
- 环境变量开关 (VITE_WELCOME_PAGE_ENABLED)
- 开发调试工具支持

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

添加欢迎页开发计划文档中的按钮图片资源文件 wecome_btn_1.png。

图标上传成功：
- 文件名: welcome_btn_1.png
- 七牛云URL: https://cdn.ipadbiz.cn/mlaj/images/welcome_btn_1.png
- 文件大小: 33.53KB (34,333 字节)
- Hash: FsqvctdBVJvXoQkAAEEhxuIRqX6h

配置更新：
- 所有功能入口统一使用七牛云图标URL
- 移除本地路径引用，改为CDN URL
- 更新文档说明图标已上传

技术优势：
- ✅ CDN加速，加载更快
- ✅ 无需提交大文件到git仓库
- ✅ 统一资源管理，便于更新
- ✅ 支持图片缓存和版本控制

更新文件：
- plan.md: 配置代码使用七牛云URL
- README.md: 更新图标资源说明
- brainstorm.md: 更新待确认事项

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

功能入口调整：
- 移除时光机入口，保留3个核心功能（课程、活动、我的）
- 图标改为使用图片: /img/wecome_btn_1.png
- 布局调整为环绕式，模拟天体行星轨道效果

布局设计：
- 🌌 环绕式布局: 3个图标呈弧形排列
- 📍 位置: 页面中下位置
- ✨ 效果: 星空宇宙主题，旋转虚线轨道
- 🖼️ 图标: 统一使用图片图标，圆形发光效果

技术实现：
- 使用绝对定位形成环绕效果
- 左侧: 课程中心 (左下)
- 顶部: 活动中心 (中上)
- 右侧: 个人中心 (右下)
- 添加旋转轨道动画 (60s 匀速旋转)

更新文件：
- plan.md: 更新功能入口配置和布局代码
- README.md: 更新开发进度和布局说明
- brainstorm.md: 更新待确认事项

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

功能入口更新：
- 活动中心标记为外链跳转 (isExternal: true)
- 外链地址: https://wxm.behalo.cc/pages/activity/activity
- 在 WelcomeEntryItem 组件中添加特殊处理逻辑

更新内容：
- plan.md: 配置中添加 isExternal 和 externalUrl 字段
- plan.md: handleClick 方法中添加外链跳转逻辑
- README.md: 添加活动中心外链跳转的注意事项
- brainstorm.md: 更新功能入口列表说明

技术实现：
- 使用 window.open() 打开新窗口
- 与底部导航栏 BottomNav.vue 的逻辑保持一致
- 未来可考虑集成到项目内

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

功能入口配置：
- 课程中心: /courses (对应底部Tab第2个入口)
- 活动中心: /activity (对应底部Tab第3个入口)
- 时光机: /recall/login (回顾功能)
- 个人中心: /profile (对应底部Tab第4个入口)

更新内容：
- plan.md: 新增完整的 welcomeEntries.js 配置
- README.md: 更新开发进度，标记功能入口为已完成
- brainstorm.md: 更新待确认事项

技术说明：
- 使用优先级排序 (priority 1-4)
- 每个入口包含：id, title, subtitle, icon, route, color
- 支持动态配置化，便于后续调整

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 新增通用七牛云上传工具 scripts/upload-to-qiniu.sh
  * 支持单文件上传和批量上传
  * 支持代理配置
  * 使用 rput 命令直接上传，更简单可靠

- ✅ 成功上传 welcome-bg.mp4 (17.57MB)
  * URL: https://cdn.ipadbiz.cn/mlaj/video/welcome-bg.mp4
  * Hash: lpipKorSMZBEVa-eCevwvcqkB8ZH
  * 封面图自动生成: ?vframe/jpg/offset/0.001

- 更新文档:
  * 修正七牛云 Bucket 名称为 ipadbiz
  * 更新上传说明，移除代理相关配置(本次未使用)
  * 添加文件信息和上传验证

技术说明:
- 七牛云空间: ipadbiz
- CDN 域名: cdn.ipadbiz.cn
- 上传路径: mlaj/video/welcome-bg.mp4

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 新增 README.md 项目说明文档，包含快速开始指南和常见问题
- 新增 upload-welcome-video.sh 视频上传脚本
- 更新 plan.md：采用七牛云视频处理参数自动生成封面图
- 更新 brainstorm.md：记录封面图方案探索过程
- 更新 .gitignore：忽略视频文件（*.mp4, *.mov 等）
- 更新 .env.development：切换代理服务器配置

技术亮点：
- 使用七牛云 ?vframe/jpg/offset/0.001 参数自动提取视频首帧
- 只需上传一个视频文件，无需单独准备封面图
- 视频文件已准备（welcome-bg.mp4），待上传到七牛云

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

新增欢迎页功能的详细开发计划文档，包括头脑风暴、架构设计和实现步骤
创建通用七牛云上传工具脚本，支持单文件上传和批量上传
添加视频背景组件和欢迎页路由配置的基础框架
实现首次访问检测逻辑，使用localStorage记录用户访问状态

将计划文档中的置顶功能API接口路径更新为实际使用的接口名称，确保文档与代码实现一致。

更新自动生成的类型声明文件，以包含 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 中的文档说明