# 有约学习导航小程序前端

**Repository Path**: jamesloujun/NaviWechat

## Basic Information

- **Project Name**: 有约学习导航小程序前端
- **Description**: 学习导航：个人学习路径规划应用，通过创新的AI交互设计为不同学习阶段的用户提供个性化的学习导航服务。适合：教育技术专业师生做科研、教育信息化部门和教师搭建专属的学习工具。前端：微信小程序，后端：Pyton，数据库：MongoDB，LLM：任何AI大模型，如：通义千问，DeepSeek等。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-24
- **Last Updated**: 2025-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 学习导航, 小程序, 教育技术, 学习工具, Python

## README

# 有约学习导航小程序 - 开源项目

## 📚 项目简介

有约学习导航小程序是一个基于微信小程序的智能学习路径规划应用，通过创新的AI交互设计为不同学习阶段的用户提供个性化的学习导航服务。项目覆盖基础教育、高等教育、职业教育、从业资格和终身学习等多个领域，帮助用户构建系统化的知识体系。

**开源协议**: Apache 2.0  
**代码仓库**: [https://gitee.com/jamesloujun/NaviWechat](https://gitee.com/jamesloujun/NaviWechat)  
**在线体验**: 微信小程序搜索"有约学习导航"  
**合作联系**: hepuloujun@gmail.com

![输入图片说明](https://foruda.gitee.com/images/1761399890388396942/db274874_9600450.jpeg "2.jpg")
![输入图片说明](https://foruda.gitee.com/images/1761399912501358853/884b5dae_9600450.jpeg "3.jpg")
![输入图片说明](https://foruda.gitee.com/images/1761399939679053491/de0b4f8b_9600450.jpeg "4.jpg")
![输入图片说明](https://foruda.gitee.com/images/1761399962449900667/be6f798f_9600450.jpeg "9.jpg")
![输入图片说明](https://foruda.gitee.com/images/1761399982693693908/8a5cb9c8_9600450.jpeg "10.jpg")
![输入图片说明](https://foruda.gitee.com/images/1761400023270501260/ca825f6c_9600450.jpeg "11.jpg")
![输入图片说明](https://foruda.gitee.com/images/1761400042903581382/90e7037f_9600450.jpeg "13.jpg")

## 🧠 AI智能特色

### 🤖 核心AI能力

本项目深度集成通义千问大模型，实现以下智能学习功能：

#### 1. **智能内容生成**
```python
# 基于学习路径生成结构化学习内容
async def parse_qwen_response(response: str, logger) -> dict:
    return {
        "answer": "精要知识点解答",
        "whyItMatters": "学习价值说明", 
        "stopAndThink": "主动思考引导",
        "misconception": "常见误解纠正",
        "testQuestion": "智能测试题目",
        "interactiveList": ["基础概念1", "基础概念2"],
        "recommendedQuestions": ["延伸问题1", "延伸问题2"]
    }
```

#### 2. **学习路径智能审核**
```python
# AI自动审核学习内容相关性
async def check_learning_relevance(content: str, db: Database) -> str:
    prompt = "判断用户输入内容是否与学习有关..."
    # 返回 "Y"（相关）或 "N"（不相关）
```

#### 3. **个性化试题生成**
```python
# 根据学习路径项动态生成测试题目
test_question_prompt = f"""
"testQuestion": {{
    "stem": "与路径项'{sanitized_item}'相关的单选题",
    "options": ["A. 选项1", "B. 选项2", "C. 选项3", "D. 选项4"],
    "correctAnswer": "正确答案",
    "explanation": "详细解析"
}}
"""
```

### 🎯 AI在教育中的创新应用

#### 1. **结构化学习对话**
- **承上启下设计**: AI生成的每个知识点都明确其在学习路径中的位置
- **上下文感知**: 基于前序知识点和后续目标生成针对性内容
- **渐进式学习**: 确保知识点的连贯性和递进性

#### 2. **多维度学习支持**
```python
# 七维学习支持体系
learning_support = {
    "核心解答": "60-100字精要回答",
    "学习动机": "说明知识点的重要性", 
    "主动思考": "引导深度思考的问题",
    "误解纠正": "常见错误概念澄清",
    "即时测试": "知识点掌握程度检测",
    "基础巩固": "3-5个前置知识点",
    "知识延伸": "3-5个后续学习方向"
}
```

#### 3. **智能缓存优化**
```python
# 双重缓存机制提升响应速度
QWEN_CACHE = {}  # 内存缓存
+ 数据库持久化缓存  # MongoDB缓存
```

## 🚀 功能特性

### 核心功能
- **AI驱动学习路径规划** - 基于大模型的智能路径生成
- **多领域知识覆盖** - 从K12到职业发展的全阶段学习内容
- **交互式学习体验** - AI生成的主动思考、即时测试、误解纠正
- **学习进度可视化** - 实时跟踪学习状态和掌握程度
- **智能内容审核** - AI自动确保学习内容的相关性和质量

## 🛠️ 技术架构

### AI技术栈
- **大模型**: 通义千问 (qwen-turbo)
- **智能缓存**: 内存 + MongoDB双重缓存
- **内容审核**: AI自动学习相关性检测
- **试题生成**: 动态智能题目生成

### 前端技术栈
- **框架**: 微信小程序原生框架
- **开发语言**: WXML + WXSS + JavaScript
- **样式方案**: Flex布局 + CSS3动画
- **组件化**: 自定义组件开发

### 项目结构
```
miniprogram/
├── pages/                         # 页面模块
│   ├── index1/                   # 首页 - 学习导航入口
│   ├── expertPath/               # 专家学习路径
│   │   └── expertConversation/   # AI对话交互核心
│   └── ...                       # 其他页面
├── components/                   # 公共组件
└── ...
```

## 🏁 快速开始

### 环境要求
- 微信开发者工具（最新稳定版）
- 小程序AppID（测试可使用测试号）
- 通义千问API访问权限
- MongoDB数据库

### AI服务配置
```python
# 通义千问配置
QWEN_DEFAULT_OPTIONS = {
    "model": "qwen-turbo",
    "max_tokens": 500,
    "temperature": 0.4  # 控制创造性
}

# 缓存配置
QWEN_CACHE = {}  # 内存缓存
```

### 安装部署步骤

1. **克隆项目代码**
   ```bash
   git clone https://gitee.com/jamesloujun/NaviWechat.git
   cd NaviWechat
   ```

2. **配置AI服务**
   ```python
   # 在 api/utils/aliyun.py 中配置通义千问API
   async def get_correct_answer_from_qwen(prompt, options):
       # 实现通义千问API调用
       pass
   ```

3. **导入微信开发者工具**
   - 配置AppID和AI服务参数
   - 设置数据库连接

## 📖 核心功能详解

### AI对话学习系统 (`pages/expertPath/expertConversation`)

**智能学习流程**:

1. **路径项点击** → AI生成针对性内容
2. **七维学习支持** → 全方位知识构建  
3. **即时测试反馈** → 掌握程度评估
4. **学习路径更新** → 动态进度跟踪

**AI生成内容结构**:
```javascript
{
  "answer": "核心知识点精讲",
  "whyItMatters": "✨ 学习价值说明", 
  "stopAndThink": "🤔 主动思考引导",
  "misconception": "⚠️ 误解纠正",
  "testQuestions": [{
    "stem": "AI生成的测试题",
    "options": ["A. ...", "B. ...", "C. ...", "D. ..."],
    "correctAnswer": "A",
    "explanation": "AI提供的详细解析"
  }],
  "interactiveList": ["基础概念1", "基础概念2", "基础概念3"],
  "recommendedQuestions": ["延伸问题1", "延伸问题2", "延伸问题3"]
}
```

## 🌟 AI未来规划

我们计划进一步集成AI能力：
- [ ] 个性化学习路径推荐算法
- [ ] 多模态学习内容生成
- [ ] 学习行为智能分析
- [ ] 自适应难度调整
- [ ] 智能学习效果评估

## 📞 联系我们

- **项目负责人**: James Lou
- **邮箱**: hepuloujun@gmail.com  
- **开源地址**: [https://gitee.com/jamesloujun/NaviWechat](https://gitee.com/jamesloujun/NaviWechat)
- **重点关注**: AI教育应用、智能学习系统

---

**欢迎AI开发者、教育技术专家共同贡献，打造更智能的学习导航系统！**

*让AI成为每个学习者的个性化导师！*