【Hello AI 科技致善】用 SOLO + Godot 为乡村教师打造知识点可视化教学助手——3D星系导图 + 认知地图,让知识之间的关系看得见

摘要

面向乡村教师群体,在备课和课堂展示场景下提供知识点关系可视化能力。通过 3D 星系思维导图、2D 思维导图和 2D 认知地图三种视图,教师可以把"极限→连续→导数"这类隐性知识链路变成学生一眼能看懂的图形,解决"老师心里有数,学生脑子里没图"的核心痛点。


真实场景与需求

目标人群:乡村中学理科教师(尤其是数学、物理)。

痛点:乡村教师通常一人带多个班、跨年级教学,备课时间极其有限。教一个知识点时,最大的困难不是自己不懂,而是没办法直观告诉学生"这个知识和之前学的什么有关、后面会用到哪里"。比如教"导数"时,学生不知道"极限"和"连续"是前置知识,导致理解断层。

现有做法及不足:粉笔在黑板上画关系图——擦掉就没了,无法积累和复用。PPT 可以做,但制作一张知识点关系图的时间成本太高,而且是静态线性的,无法体现网状关系。乡村学校网络条件不稳定,纯在线工具加载慢、学习成本高。教师需要的是一个离线可用、开箱即用、视觉直观的工具。


作品介绍

基于 Godot 4.6 引擎的桌面应用(GDScript 开发,35 个源文件),专为教师设计了三种知识视图:

① 3D 星系思维导图 — 课堂展示用

知识点像星球一样悬浮在 3D 空间中,按章节分组用 Fibonacci 球面算法排列在球面上。颜色标注掌握度(红色=没学会 / 黄色=了解 / 绿色=掌握),教师可以拖拽旋转,用投影仪投到大屏上给学生看——“我们今天学的导数在这个位置,它的前置知识在这里,延伸知识在那里”。支持星系模式按父节点自动分组,一眼看清整个学科的知识结构。

② 2D 思维导图 — 备课整理用

XMind 风格的左右展开树形图,贝塞尔曲线连线,支持拖拽调整和撤销重做(Command Pattern 撤销栈)。教师用来整理章节知识结构,备课时快速搭好框架。

③ 2D 认知地图 — 核心差异化功能

题目和知识点之间不是简单的父子关系,而是支持 5 种关系类型:用到、可替换、前置、延伸、自定义。力导向算法自动布局,双击任意题目进入独立画布,上区是"用到的知识点",下区是"前置知识",中间是题目本身,连线上标注关系类型。教师可以为一道典型例题标注完整的知识链路,学生看到的不是孤立的一道题,而是"这道题从哪里来、通向哪里"的完整地图。


用 SOLO 实现的过程

拆解策略

我没有让 SOLO 一次做完,而是拆成 4 个独立模块逐个协作:

  1. 场景管理骨架(学科选择 → Tab 切换 → 三个视图容器)

  2. 3D 星系模式(Fibonacci 球面布局 + Jolt 物理引擎轨道相机)

  3. 2D 认知地图(题目卡片列表 + 独立画布分层布局 + 力导向关系连线)

  4. 数据层(JSON 存储 + 跨视图同步 + 撤销重做栈)

关键 Prompt 示例

给 3D 星系模式:“知识点按父节点分组,每组用 Fibonacci 球面算法排列,掌握度用三态颜色区分——红/黄/绿,相机支持轨道旋转和缩放,鼠标悬停显示知识点名称。”

给认知地图:“双击题目卡片进入独立画布,上区放用到/延伸的知识点,下区放前置知识,中间是题目本身不可移动,连线用贝塞尔曲线并标注关系类型,知识节点支持拖拽。”

踩过的坑

  • Godot UI 布局:SOLO 最开始按 Web Flexbox 思维写 Control 节点布局,全部错位。后来明确告诉 SOLO 用 Godot 的 VBoxContainer / HBoxContainer 嵌套体系才解决。教训:要告诉 SOLO 具体用哪个引擎的哪个 API,不要用抽象描述。

  • 3D 节点太少时的球面塌缩:少于 10 个知识点时 Fibonacci 球面布局会把节点挤成一团,调整了 golden angle 的累积半径计算后修复。

  • 撤销重做的数据一致性:知识点、题目、关系分散在不同 JSON 文件中,一次操作可能涉及多文件修改。SOLO 帮我设计了 Command Pattern 的撤销栈来保证原子性。

  • 离线场景优化:核心功能完全离线可用,不依赖网络,适合乡村学校环境。


成果展示

技术栈:Godot 4.6 · GDScript · Jolt Physics · D3D12 · Forward Plus 渲染器

GitHub 仓库https://github.com/nlbn3501/-

核心能力一览

功能 说明
学科/知识点管理 完整 CRUD,支持掌握度三态标记
3D 星系导图 Fibonacci 球面布局 + 轨道相机,适合课堂投影展示
2D 思维导图 左右展开 + 贝塞尔连线 + 拖拽 + 撤销重做
2D 认知地图 5 种关系类型 + 力导向布局 + 独立题目画布
离线可用 核心功能不依赖网络,适合乡村学校环境
数据持久化 JSON 文件存储,自动备份/恢复

验证方式

  • 功能验证:已实现学科管理 → 知识点录入 → 3D/2D 视图切换 → 认知地图关系编辑的端到端流程

  • 场景验证:设计了"高中数学·极限与连续"的完整知识图谱样例,包含 12 个知识点节点和 8 道典型题目的关系网络,验证了从"老师录知识点"到"课堂展示关系图"的完整链路

下一步规划

  • "一键导出知识图谱为图片"功能,方便教师打印分发给学生

  • “课堂模式”——教师标注重点路径,学生端只看到简化视图

  • 探索与乡村学校的真实对接,收集一线教师反馈迭代