K12-KnowledgeTopology-Digital-Tutor:基于 Vue 3 + TypeScript + Vite 的中小学知识拓扑数字教师系统

中小学知识拓扑数字教师,解决中小学生知识点上下文连接的问题,当前大多数学生无法将9年义务教育体系对应课程的所有知识点都串联起来,为了让学生们针对某个知识点的前置知识、后续知识、相关知识点都能充分的连接起来,让学生们在9年义务教育过程中能对各科目的整体知识体系有完整的了解,由此产生的想法,用本次活动来实现,希望能对大家有所帮助。

Branch1Tags0

智能虚拟人知识拓扑交互系统 (Knowledge Topology System)

中小学知识拓扑数字教师,解决中小学生知识点上下文连接的问题,当前大多数学生无法将9年义务教育体系对应课程的所有知识点都串联起来,为了让学生们针对某个知识点的前置知识、后续知识、相关知识点都能充分的连接起来,让学生们在9年义务教育过程中能对各科目的整体知识体系有完整的了解,由此产生的想法,用本次活动来实现,希望能对大家有所帮助。

image.png

本项目基于 Vue 3 + TypeScript + Vite 构建的前端顶尖交互应用。系统深度集成了 3D 虚拟人渲染 (XmovAvatar)、大语言模型 (LLM) 以及 实时语音识别 (ASR),不仅实现了自然、流畅的人机对话,更核心地打造了一套知识拓扑结构可视化引擎,通过动态生成的“知识地图”重塑学习与认知的交互边界。

视频演示地址:https://www.bilibili.com/video/BV1n1rUB3E7h/


核心亮点:知识拓扑可视化

在传统的 AI 交互中,知识往往是以线性的文字形式呈现,难以展示复杂的逻辑关联。本项目通过 协议解析引擎,将 AI 深度思考的结果实时转化为直观、可交互的拓扑图谱。

知识拓扑的重要意义

  1. 结构化认知:将零散的知识点通过“属于”、“相关”、“前置依赖”等逻辑关系串联,帮助用户建立系统化的知识网络。
  2. 可视化路径:清晰展示学科知识的演进方向,例如:初中化学的知识脉络如何从“物质构成”延展到“化学变化”。
  3. 沉浸式交互:用户不再是被动的信息接收者,可以通过缩放、拖拽和过滤,主动探索知识的深度与广度。

image.png


功能特性

1. 深度虚拟人交互

  • 3D 驱动渲染:集成 XmovAvatar SDK,实现表情生动、口型同步的 3D 虚拟人播报。
  • 智能播报过滤:创新的播报锁机制。数字人在播报文本时,会自动跳过用于生成拓扑图的 JSON 代码块,确保语音交互的自然流畅。

2. 高性能拓扑引擎

  • 动态布局算法:采用交错半径与圆周分布算法,自动处理多节点重叠问题,确保图谱清晰。
  • 自由交互体验:
    • 缩放与平移:支持 50% - 300% 的自由缩放及画布平移。
    • 自由拖拽:所有节点均可鼠标左键拉动,实时调整布局。
    • 分类过滤:支持按关系分类(如:仅显示“属于”关系)进行动态筛选。
  • 高清导出:
    • PNG/JPG 高清下载:通过 Canvas 2倍采样渲染,提供印刷级的知识图谱导出。
    • SVG 源码获取:支持下载矢量图源码,方便二次编辑。

3. 智慧语音解析 (ASR)

  • 实时识别:基于腾讯云 ASR,支持精准的语音转文字。
  • 极简控制:支持“语音解析”与“停止语音解析”的一键切换,视觉反馈直观。

4. 业务适配逻辑

  • 全学段覆盖:内置小学、初中全学科知识体系入口。
  • 精准映射:根据教学大纲动态调整年级显示(如:物理从八年级开始,化学仅限九年级)。

部署与启动

环境要求

  • Node.js: >= 18.0.0
  • 包管理器: pnpm (推荐) 或 npm

1. 克隆与安装

# 安装依赖
pnpm install

2. 开发环境启动

# 启动本地开发服务器
pnpm run dev

启动后访问控制台输出的地址(默认为 http://localhost:5173)。

3. 生产环境构建

# 构建生产环境资源
pnpm run build

# 预览构建效果
pnpm run preview

技术栈

  • Core: Vue 3.5+, TypeScript 5.8
  • Build: Vite 7.1
  • Visualization: SVG (滤镜/渐变/贝塞尔曲线) + Canvas (采样导出)
  • SDKs: XmovAvatar (3D), 腾讯云 ASR
  • AI: 豆包 (Ark API)

快速配置

  1. 虚拟人配置: 填写 AppId 与 AppSecret 开启 3D 渲染。
  2. ASR 配置: 配置腾讯云 SecretID/Key 开启语音。
  3. AI 配置: 填入豆包 API 密钥,选择 doubao-1-5-pro 模型以获得最佳拓扑解析效果。

使用指南

  1. 路径选择:在右侧面板通过“进阶拓扑 (初中)” -> “化学” -> “九年级上册”选择节点。
  2. 拓扑探索:点击“开启拓扑讲解”,系统将展示复杂的知识网。
  3. 交互操作:使用鼠标滚轮缩放,左键拖拽节点或画布,点击“PNG图片”保存你的学习成果。

许可证

本项目仅供学术交流与演示使用。

Introduction

中小学知识拓扑数字教师,解决中小学生知识点上下文连接的问题,当前大多数学生无法将9年义务教育体系对应课程的所有知识点都串联起来,为了让学生们针对某个知识点的前置知识、后续知识、相关知识点都能充分的连接起来,让学生们在9年义务教育过程中能对各科目的整体知识体系有完整的了解,由此产生的想法,用本次活动来实现,希望能对大家有所帮助。

Customize your domain