词魂

词魂是一个微信小程序项目，面向英语词汇学习、单词对战、学习数据统计和复习安排。项目使用微信小程序原生框架、TypeScript、微信云开发、云函数和云数据库实现，适合作为小程序课程设计或 AIGC 辅助学习产品原型。

主要功能

• 词汇学习：日常练习、词汇检测、选项练习、认识/不认识练习。
• 单词对战：随机匹配、好友对战、人机对战。
• 生词与弱词：记录错词、不认识词和提示使用情况。
• 数据看板：展示学习次数、词数、正确率、弱词榜和对战记录。
• 学习助手：根据学习记录、弱词和对战数据整理学习建议与复盘内容。
• 设置与关于：题量、声音、发音、震动、清理数据等基础配置。

项目结构

-aigc-/
├── miniprogram/                 # 小程序前端
│   ├── pages/                   # 页面
│   ├── components/              # 组件
│   ├── utils/                   # 工具和配置
│   ├── models/                  # 前端数据模型
│   └── images/                  # 图片资源
├── cloudfunctions/server/        # 云函数入口、控制器、数据模型
├── typings/                      # 小程序和业务类型定义
├── project_materials/            # 课程材料、截图和文档
├── 项目技术与架构文档.md
├── 创新点与技术方案.md
├── 项目改造与修复记录.md
├── 学习反馈融合创新点评估与预测.md
├── project.config.json
└── package.json

关键页面

页面	说明
pages/home/home	首页和功能入口
pages/learning/learning	词汇学习流程
pages/combat/combat	对战流程
pages/review/review	生词本
pages/statistics/statistics	数据看板
pages/ranking/ranking	排行榜
学习助手页面目录	学习建议和对战复盘
pages/setting/setting	设置页

数据流

1. 用户完成学习或对战。
2. 前端调用云函数写入学习记录或对战记录。
3. 云函数更新用户数据、学习统计、掌握度和计划数据。
4. 首页、数据看板、弱词榜和学习助手读取最新结果。

本地运行

1. 使用微信开发者工具打开项目根目录。
2. 确认 project.config.json 中的小程序和云函数目录配置正确。
3. 在微信开发者工具中构建小程序 npm。
4. 上传并部署 cloudfunctions/server 云函数。
5. 准备 user、book、word、userWord、combatRecord、learningRecord、learningData、wordMastery、learningPlan 等集合。

检查清单

• 页面可正常进入和返回。
• 学习完成后首页和数据看板能刷新。
• 对战完成后总局数、胜利次数和对战记录能更新。
• 词库不足时页面有明确提示。
• 小屏设备下顶部栏、按钮和卡片不遮挡。
• 云函数部署后接口无明显报错。

维护说明

• 本仓库是独立微信小程序项目，不与课程实验仓库合并。
• 云开发环境 ID、真实密钥和个人配置不要提交。
• 修改核心功能后，同步更新技术文档、创新点说明和本 README。