📚 自学教练
学完就练，练完就过
是什么
「自学教练」是一个专为自考/成考/职业考试教师设计的 AI 教学工具，由两个配合使用的能力组成：
- 能力一 · 学习指南：将抽象的讲义知识点转化为可视化、交互式的单文件 HTML 学习网页
- 能力二 · 刷题应用：将真题/模拟题转化为带四种练习模式的交互式刷题网页
两个能力组合形成完整的学习闭环：老师上传讲义 → 生成学习指南 → 学生自学 → 生成刷题网页 → 学生练习 → 通过率提升。
> 核心理念：不是替代老师，而是让老师的知识以最友好的方式到达学生手中。
能力一：学习指南
把抽象知识变成看得见、点得开的交互式网页
核心设计理念
- 拒绝密集文字：大字号、宽行距、宽内边距，留白呼吸感
- 沉浸式交互：知识点不全部摊开，通过"点击、切换、展开"逐步曝光
- 讲师友好：标注"互动提示"，方便老师引导学生
- 单文件交付：所有代码封装在一个 HTML 文件中
5 大核心交互组件
| 组件 | 适用场景 | 效果 |
|---|---|---|
| 渐变沉浸式头部 | 网页顶部标题区 | 主色+辅助色渐变，视觉冲击力强 |
| 横向标签页切换 | 步骤/原则/方法论 | 点击切换内容，带淡入动画 |
| 情景连线高亮测试 | 案例与理论匹配 | 点击场景，对应知识点放大高亮 |
| 魔法反转 | 对比错误vs正确示例 | 点击按钮，低分答案升级为满分卷面 |
| 互动自测翻牌 | 简答题/问答题复习 | 点击展开标准答案，带淡入动画 |
技术规格
- Tailwind CSS (CDN) + FontAwesome (CDN) + Vanilla JS
- 配色系统可自定义（主色/辅助色/点缀色/背景色）
- 响应式设计：桌面/平板/手机均适配
- 文件大小：约 50-100KB
输入输出
输入：任意格式的教学资料
- Markdown / Word / PDF 讲义
- 真题解析 / 复习提纲
- 纯文本知识点
输出：单文件 HTML 学习指南网页
- 双击即可打开
- 可通过微信/邮件/网盘分享
- 老师用记事本就能改内容
能力二：刷题应用
把真题变成学生愿意刷的交互式应用
四种练习模式
| 模式 | 交互要点 |
|---|---|
| 刷题模式 | 做一题即时显示答案和解析，标记对/错/未答 |
| 考试模式 | 全程隐藏答案，交卷后统一出成绩与考试报告 |
| 背题模式 | 直接展示所有题目+高亮正确答案+完整解析 |
| 错题本 | 自动汇总错题，支持"一键只刷错题" |
核心特性
- 智能解析题目：用户粘贴任意格式题目，AI 自动解析为标准结构
- 题库数据在文件顶部：
QUESTION_BANK常量置于代码第一行，老师用记事本就能改 - 学习进度持久化：localStorage 保存错题和成绩，支持导出/导入 JSON 跨设备迁移
- 零外部依赖：不引入任何 CDN，纯内联 CSS/JS，机房断网也能用
- 精美交互反馈：答对绿色渐变+勾动画，答错轻微抖动+红色标记+自动展开解析
支持的题型
| 类型 | 代码 |
|---|---|
| 单选题 | 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 文件备份
- 学生的做题数据完全在本地，保护隐私
