DEEPSEEK API · TOOL-CALLING AGENT · 师-人-机协作

Chapter Learning Agent

把任意教材章节,变成一份高质量的学习方案、一套带答案解析的练习题库、 一个可玩的游戏世界——全程由 DeepSeek 驱动的智能体自主完成: 定位章节 → 完整阅读 → 章节理解 → 方案设计 → 出题 → 心理学 QA → 独立验证。

8 个 Agent 工具 10 阶段固定状态机 7 条学习心理学原则 3 层防幻觉硬闸门 2 质检循环
0生成练习题(含答案解析)
0步 Agent 真实工作日志
0%章节阅读覆盖率(强制)
0/7心理学原则 QA 通过
0%产物带教材页码溯源
How it works

一条流水线,两种玩法

教师放入教材,智能体完成剩下的一切;学生在网页里学习,或走进由本章知识生成的游戏世界。

输入教材章节
→
LOCATE定位章节
→
READ完整阅读
→
UNDERSTAND章节理解
→
DESIGN方案设计
→
GENERATE生成练习
→
QA7 原则检查
→
VERIFY独立验证
→
输出学习 / 游戏
System Architecture

系统架构全景

可交互架构图:拖拽平移、滚轮缩放、点击节点追踪关系。前端 · FastAPI 后端 · DeepSeek API · 双质检循环 · 产物溯源,一图看清。

architecture — 实时动画架构图(悬停节点高亮 · 粒子沿数据流移动)
放入教材 统一页模型 Tool Calling 循环 阶段 Prompt 驱动 7 原则修订 阶段 8 验证 修正题库落盘 读取渲染 🎮 模式切换 学习 · 作答 📚 教师 · 提供教材 PDF · TXT · MD · DOCX · PPTX 外部 📄 文档解析层 pdfplumber · pypdf · 编码回退 统一「页」模型 · 解析缓存 后端 🛠️ Agent 工具层 ×8 find_section · read_pages search_local · submit 校验 … 后端 🧠 DeepSeek API deepseek-chat · 原生 Tool Calling 指数退避重试 · 错误分类容错 云端 🗂️ 章节产物 · 溯源 学习方案 · 题库 · QA 报告 全部带「文件 + 页码」出处 数据 🔍 独立验证员 逐题重新解题 · 不信任初稿 发现错误 → 自动修正 → 复查轮 后端 ⚙️ 状态机控制器 TARGET → LOCATE → … → COMPLETE 十阶段硬闸门 · 每步产物强制校验 核心 🧪 心理学 QA · 7 原则 逐条检查 → 修订 → 复查循环 不通过即自动改方案 / 题库 后端 🎓 学生 学习 · 作答 · 游玩 · 查看报告 外部 📖 Web 学习端 逐句引导 · 即时反馈 · 掌握自查 真实进度报告 · 错题回顾 前端 🎮 游戏模式 · Phaser 世界地图 · 答题战斗 · XP 等级 知识点 → 关卡 · Boss 综合试炼 前端 后端 ×5 前端 ×2 云服务 ×1 数据 ×1 外部 ×2
Learning Psychology

7 条学习游戏心理学原则 · 逐条落地

不是口号——每一条原则都对应系统里一个可检验的机制,并由 Agent 的独立 QA 阶段逐条审查、不通过即自动修订。

01

目标明确

Clear Goal
  • 每个学习阶段开场先展示「本阶段目标」——可检验的行为,不是形容词
  • 通关面板展示本关学习目标与通关奖励
落在:学习模式阶段开场 · 关卡面板
02

即时反馈

Immediate Feedback
  • 选择题点击即判分:答对绿框+伤害特效,答错红框+正确答案
  • 每题解析讲清「为什么」,并附教材页码依据
落在:练习作答 · 游戏战斗 · 学习模式自评
03

真实进度

Real Progress
  • 掌握标准 = 「能独立证明消去律」这类可验证行为,禁止虚假进度条
  • 学习报告只统计真实作答:掌握几题、未掌握几题、错题回顾
落在:掌握标准自查 · 学习报告 · XP 与掌握度分离
04

有意义的选择

Meaningful Agency
  • 阶段开场可选「先学内容」或「跳过内容直接练习」
  • 学习路径分支:基础巩固 or 直接挑战,由学生自评决定
落在:学习模式分支 · 阶段选择点
05

小步成功

Small Wins
  • 章节拆为多个阶段,每阶段都有明确的完成时刻
  • 阶段完成页即时统计「本阶段 X/Y 题掌握」+ 顶部进度条推进
落在:阶段完成页 · 进度条 · LEVEL UP
06

难度–能力匹配

Challenge–Skill Match
  • 题目按基础→中等→挑战渐进排列,敌人血量与题量匹配
  • 每个常见失败点都配补救策略(重读哪个定义、做哪个反例)
落在:题目难度分级 · 失败点补救 · 游戏难度
07

认知牵引

Curiosity · Information Gap
  • 用反直觉反例开场:自然数上的减法「看起来是运算」却因 1−2=−1 不封闭
  • 先抛意外结论再引入定义,内容逐条揭示而非一次性灌输
落在:方案设计意图 · 学习模式逐句揭示
Quality Loops

为什么它产出的内容可信

教育产品的底线是内容质量。三个机制兜底,每一条都被真实跑通过。

GROUNDING

教材锚定 · 防幻觉三闸门

Agent 的知识来源被强制限定为用户教材:页码只能来自真实检索结果;章节未 100% 读完不许进入设计阶段;每条定义、定理、题目都必须携带「文件 + 页码」出处,否则被 Schema 校验直接拒绝。

PSYCHOLOGY QA

心理学原则 · 自动修订

独立的 QA 角色按 7 条原则逐条审查学习方案与题库;任何一条不通过,Agent 必须修改产物并重新复查,最多 3 轮。真实运行中它曾自主发现「掌握标准不可检验」并重写后通过。

VERIFY

独立验证 · 逐题重解

最终验证员对每道题独立重新解题,不信任第一次生成的答案。真实运行中它抓到了选项重复缺陷并自动修正,随后进入第二轮复查确认清零——「验证员」与「出题者」角色分离,不护短。

现在,走进这个由教材生成的学习世界

内置「抽象代数 · 第一章」完整成果:18 道题 · 7 阶段学习方案 · 可玩的游戏地图。打开即可学习与游玩。

🎓 进入系统 → 部署于 Cloudflare Pages · 静态演示内置第一章完整成果 · 完整版(任意章节 + 上传教材)已在 系统内持续提供