Skip to content

HuangAdd9/Peanuts

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClassPet Pro - 班级宠物养成系统

项目概述

为教室希沃触摸一体机开发的班级互动宠物养成系统,将学生积分转化为可视化、可交互的游戏化体验。

当前功能

  • 大屏展示端 (index.html):38名学生宠物墙,触摸点击加减分
  • 手机管理端 (admin.html):批量加分、学生管理、数据导出、统计报表
  • 宠物进化系统:蛋 → 幼崽 → 成长期 → 完全体(4个阶段)
  • 5套宠物风格:萌宠风、幻想风、像素风、科幻风、国潮风
  • 音效系统:8-bit 风格游戏音效
  • 本地存储:localStorage 持久化数据
  • 宠物互动系统:喂食、玩耍、休息(影响饱食度、开心值、精力值)
  • 数据云同步:飞书Bitable API对接,支持多设备数据同步(可选功能)
  • 统计报表:积分趋势图、阶段分布图、积分排行榜
  • 现代化UI:动态渐变背景、玻璃态设计、悬浮动画
  • 全面响应式:完美适配各种尺寸的希沃大屏和移动设备

文件结构

├── index.html          # 大屏展示端
├── admin.html          # 手机管理端
├── js/
│   ├── app.js          # 大屏核心逻辑
│   ├── admin.js        # 管理端逻辑
│   ├── data-manager.js # 数据管理模块
│   ├── pets.js         # 宠物图片系统
│   ├── audio.js        # 音效系统
│   ├── effects.js      # 粒子特效
│   ├── feishu-sync.js  # 飞书Bitable同步(可选)
│   └── stats.js       # 统计报表模块
└── assets/
    └── css/
        ├── style.css   # 大屏样式(v4 - 现代化设计+响应式)
        └── admin.css   # 管理端样式(v4 - 现代化设计)

优化需求(优先级排序)

✅ P0 - 关键修复(已完成)

  1. 教师模式密码验证 ✅ - 当前简化为直接跳转,需要恢复密码验证功能
  2. 代码清理 ✅ - 删除重复文件(v5.js 等),统一代码风格

✅ P1 - 体验优化(已完成)

  1. 宠物动画 ✅ - 添加宠物呼吸、眨眼、跳跃等 idle 动画
  2. 加分反馈 ✅ - 点击加分时的粒子特效、飘字动画
  3. 进化庆祝 ✅ - 更炫酷的进化动画和音效

✅ P2 - 功能增强(已完成)

  1. 数据同步 ✅ - 完成飞书 Bitable 同步功能,支持配置界面、连接测试、自动同步
  2. 更多互动 ✅ - 宠物喂食、玩耍、休息等互动功能,包含饱食度、开心值、精力值系统
  3. 统计报表 ✅ - 班级积分趋势图、阶段分布图、积分排行榜、数据卡片

✅ P3 - 视觉优化(已完成)

  1. UI 美化 ✅ - 更现代化的界面设计
    • 动态渐变背景动画
    • 玻璃态设计(glassmorphism)
    • 悬浮动画和涟漪效果
    • 渐变文字和图标
    • 柔和的阴影系统
  2. 响应式优化 ✅ - 适配不同尺寸的希沃大屏
  • 超大屏(2560px+): 10列布局
  • 大屏(1920px-2559px): 8列布局
  • 标准大屏(1600px-1919px): 7列布局(希沃86寸推荐)
  • 中大屏(1366px-1599px): 6列布局
  • 普通屏(1024px-1365px): 5列布局
  • 小屏(768px-1023px): 4列布局
  • 手机竖屏(<768px): 3列布局
  • 横屏和不同屏幕比例优化
  • 触摸设备大点击区域优化
  • 深色模式支持
  • 高对比度模式支持
  • 减少动画偏好支持
  • 打印样式优化

📊 项目完成度

总体进度:10/10 (100%) 🎉

  • P0 任务: 2/2 (100%) ✅
  • P1 任务: 3/3 (100%) ✅
  • P2 任务: 3/3 (100%) ✅
  • P3 任务: 2/2 (100%) ✅

版本发布 v1.2.0 - "手机端完成版"

新特性:

  1. 📱 手机端学生页面 - 完整的学生端查看和管理功能
  2. 🎵 完整背景音乐 - 更换为用户提供的轻音乐,自动播放
  3. 👋 欢迎弹窗 - 解决浏览器自动播放限制问题
  4. 🏫 班级名称同步 - 班级名称统一为"二年级一班"
  5. 🔧 问题修复 - 修复多个语法错误和逻辑错误

功能亮点:

  • 学生可以在手机端登录查看自己的宠物
  • 支持宠物认养、自定义形象、奖励兑换
  • 完整触摸优化界面
  • 轻音乐自动播放无需点击
  • 班级名称在所有界面保持一致

🚀 发布 v1.2.0

功能清单

✅ 核心功能

  • 大屏宠物展示墙
  • 积分加减系统
  • 宠物进化(4阶段)
  • 教师密码验证
  • 本地数据存储

✅ 互动功能

  • 宠物喂食/玩耍/休息
  • 状态系统(饱食度/开心值/精力值)
  • 宠物风格切换(5种)
  • 音效系统

✅ 管理功能

  • 学生管理(增删改查)
  • 批量加分
  • 奖励兑换
  • 数据导出(Excel/JSON)
  • 飞书云同步(可选)

✅ 统计分析

  • 积分趋势图
  • 阶段分布图
  • 积分排行榜
  • 数据卡片统计

✅ 视觉体验

  • 现代化UI设计
  • 动态渐变背景
  • 玻璃态效果
  • 粒子特效
  • 进化庆祝动画

✅ 响应式适配

  • 完美适配希沃大屏(7种尺寸)
  • 手机端优化
  • 触摸设备优化
  • 深色模式
  • 无障碍支持

技术约束

  • 纯前端实现(HTML/CSS/JS)
  • 本地存储(localStorage)
  • 希沃大屏触摸交互
  • 手机端管理界面

访问方式

本地测试

python3 -m http.server 8080

本地访问链接:

GitHub Pages 部署

部署后访问链接:

GitHub Pages 配置步骤

  1. 访问 GitHub 仓库:https://github.com/fwei19921-dotcom/classpet-pro1.0
  2. 点击 Settings → Pages
  3. 配置:
    • Source: Deploy from a branch
    • Branch: main
    • Folder: / (root)
  4. 点击 Save
  5. 等待几分钟部署完成

Force rebuild Fri Mar 13 15:51:08 CST 2026

About

班级宠物养成系统 - 为教室希沃触摸一体机开发的班级互动宠物养成系统

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 36.0%
  • JavaScript 35.5%
  • CSS 13.7%
  • Python 11.4%
  • Vue 2.2%
  • Shell 1.2%