📚 自学教练

学完就练，练完就过

是什么

「自学教练」是一个专为自考/成考/职业考试教师设计的 AI 教学工具，由两个配合使用的能力组成：

• 能力一 · 学习指南：将抽象的讲义知识点转化为可视化、交互式的单文件 HTML 学习网页
• 能力二 · 刷题应用：将真题/模拟题转化为带四种练习模式的交互式刷题网页

两个能力组合形成完整的学习闭环：老师上传讲义 → 生成学习指南 → 学生自学 → 生成刷题网页 → 学生练习 → 通过率提升。

> 核心理念：不是替代老师，而是让老师的知识以最友好的方式到达学生手中。

能力一：学习指南

把抽象知识变成看得见、点得开的交互式网页

核心设计理念

1. 拒绝密集文字：大字号、宽行距、宽内边距，留白呼吸感
2. 沉浸式交互：知识点不全部摊开，通过"点击、切换、展开"逐步曝光
3. 讲师友好：标注"互动提示"，方便老师引导学生
4. 单文件交付：所有代码封装在一个 HTML 文件中

5 大核心交互组件

| 组件 | 适用场景 | 效果 |

|:---|:---|:---|

| 渐变沉浸式头部 | 网页顶部标题区 | 主色+辅助色渐变，视觉冲击力强 |

| 横向标签页切换 | 步骤/原则/方法论 | 点击切换内容，带淡入动画 |

| 情景连线高亮测试 | 案例与理论匹配 | 点击场景，对应知识点放大高亮 |

| 魔法反转 | 对比错误vs正确示例 | 点击按钮，低分答案升级为满分卷面 |

| 互动自测翻牌 | 简答题/问答题复习 | 点击展开标准答案，带淡入动画 |

技术规格

• Tailwind CSS (CDN) + FontAwesome (CDN) + Vanilla JS
• 配色系统可自定义（主色/辅助色/点缀色/背景色）
• 响应式设计：桌面/平板/手机均适配
• 文件大小：约 50-100KB

输入输出

输入：任意格式的教学资料

• Markdown / Word / PDF 讲义
• 真题解析 / 复习提纲
• 纯文本知识点

输出：单文件 HTML 学习指南网页

• 双击即可打开
• 可通过微信/邮件/网盘分享
• 老师用记事本就能改内容

能力二：刷题应用

把真题变成学生愿意刷的交互式应用

四种练习模式

| 模式 | 交互要点 |

|:---|:---|

| 刷题模式 | 做一题即时显示答案和解析，标记对/错/未答 |

| 考试模式 | 全程隐藏答案，交卷后统一出成绩与考试报告 |

| 背题模式 | 直接展示所有题目+高亮正确答案+完整解析 |

| 错题本 | 自动汇总错题，支持"一键只刷错题" |

核心特性

1. 智能解析题目：用户粘贴任意格式题目，AI 自动解析为标准结构
2. 题库数据在文件顶部：QUESTION_BANK 常量置于代码第一行，老师用记事本就能改
3. 学习进度持久化：localStorage 保存错题和成绩，支持导出/导入 JSON 跨设备迁移
4. 零外部依赖：不引入任何 CDN，纯内联 CSS/JS，机房断网也能用
5. 精美交互反馈：答对绿色渐变+勾动画，答错轻微抖动+红色标记+自动展开解析

支持的题型

| 类型 | 代码 |

|:---|:---|

| 单选题 | single |

| 多选题 | multiple |

| 判断题 | judge |

| 简答题 | qa |

输入输出

输入：任意格式的题目

• 从 Word 拷贝的题目
• 截图/笔记中的题目
• 真题 PDF 中的题目

输出：单文件 HTML 刷题应用

• 双击即可打开
• 学生可在机房/手机/家用电脑使用
• 学习记录可跨设备迁移

两个能力如何配合

老师的工作流：

  讲义/知识点              真题/模拟题
      ↓                       ↓
  学习指南能力              刷题应用能力
      ↓                       ↓
  可视化学习网页            交互式刷题网页
      ↓                       ↓
      └────── 发给学生 ──────┘
                ↓
         学完就练，练完就过
                ↓
           通过率提升

学习指南解决"看不懂"的问题：把抽象知识变成可视化、可交互的学习体验。

刷题应用解决"记不住"的问题：把枯燥题目变成有反馈、有成就感的练习体验。

两者组合，就是一个完整的教学闭环。

工作流程

场景一：老师备课

老师：
  "这是《马克思主义基本原理》第三章的讲义，帮我做一个学习指南网页"
  "这是近5年的真题，帮我做一个刷题网页"

AI：
  → 解析讲义，提取知识点，生成学习指南 HTML
  → 解析真题，构建题库，生成刷题应用 HTML

老师拿到两个文件，发到班级群，学生双击就能用。

场景二：学生自学

学生打开学习指南：
  → 看到精美的知识点页面
  → 点击标签页切换不同章节
  → 点击"查看答案"自测
  → 点击"魔法按钮"看满分答案 vs 低分答案对比

学生打开刷题网页：
  → 选择"刷题模式"逐题练习
  → 做对的题标绿，做错的自动展开解析
  → 考前切换到"考试模式"模拟真实考试
  → 考前最后看"错题本"，只刷做错的题

场景三：考试前突击

考前3天：
  1. 打开学习指南，快速过一遍知识点（标签页切换）
  2. 打开自测翻牌，遮住答案自问自答
  3. 打开刷题网页，进入"考试模式"模拟一次
  4. 打开错题本，只刷做错的题
  5. 进考场 ✅

报告输出格式

所有生成的网页都是单文件 HTML：

| 类型 | 技术栈 | 特点 |

|:---|:---|:---|

| 学习指南 | Tailwind CSS + FontAwesome CDN + Vanilla JS | 视觉冲击力强，交互丰富 |

| 刷题应用 | 纯内联 CSS/JS（零外部依赖） | 断网也能用，机房友好 |

共同特点：

• 单文件交付，双击即可打开
• 响应式布局，手机/电脑/平板均可使用
• 可通过微信/邮件/网盘分享
• 老师用记事本就能修改内容
• 可部署到 COS/Netlify 生成在线链接

信号灯系统

本技能不涉及信号灯（非成长跟踪类工具）。

数据安全

• 所有数据存储在浏览器本地（localStorage）
• 不上传任何数据到服务器
• 学习记录可导出为 JSON 文件备份
• 学生的做题数据完全在本地，保护隐私