Connected Knowledge for Education Agents
面向教育 Agent 的开放知识图谱与数据基础设施。
让课程标准、知识点、先修关系、教材、讲解与习题,在同一张图中相连。
🌐 在线探索 · 📦 下载数据 · ✨ 核心能力 · 🔌 接入应用 · 🚀 本地运行
展示插图保留论文与早期网站快照;当前规模以本文数据概览和下载包 manifest 为准。
一次教学任务通常需要同时回答:这个知识点是什么?学它之前需要会什么?在哪本教材中讲?可以用什么题目练习?
EduGraph 以共享的 Concept 标识连接课程要求、先修关系和教学资源,让一次检索能够沿着明确的关系继续探索:
- 知识有联系:Topic 组织内容层级,PREREQUISITE 表达知识依赖,帮助定位前置知识与后续学习目标。
- 教材有视角:不同出版社的年级、册次和章节编排映射到同一套 Concept,便于对照教学安排。
- 资源可复用:讲解、习题、课标和教材映射保留关联标识,可用于检索、备课以及教育 Agent 的上下文构建。
EduGraph 提供可查询、可追溯的知识与资源;接入它的教育应用据此组织教学。
|
从一个知识点出发,查看关联知识、讲解与习题,按目标组织学习顺序。 打开图谱浏览器 → |
围绕同一知识点比较不同教材的年级、册次、章节位置与教学角色。 查看使用步骤 → |
下载 JSONL 数据,复用检索与图查询模块,为自己的教育应用准备上下文。 查看接入示例 → |
在 EduGraph Explorer 中搜索知识点,点击节点即可查看前置知识、后继知识、讲解、例题、课标与教材编排。无需登录,无需安装。
左侧检索 · 中间探索知识关系与教材编排 · 右侧查看关联教学资源
| 从哪里开始? | 可以看到什么? |
|---|---|
| 分数 → | 从知识关系出发,查看例题与不同出版社的教材位置。 |
| 小数与分数的互化 → | 查看先修依赖,并根据已掌握的知识生成学习顺序。 |
| 关于数据集 → | 浏览知识全景、跨学段关系与数据说明,下载完整公开包。 |
试一试「分数」:
- 打开上面的知识点链接,在中间切换前置、后继或全部关系,点击邻居节点继续探索。
- 在右侧切换讲解、例题、教材与课标;进入教材编排视图,对照人教版、北师大版等教材的位置。
- 选择学习目标,打开学习路径并标记已掌握知识;也可以复制知识点链接或导出单点 JSON,与他人分享。
| 能力 | 在浏览器里做什么 | |
|---|---|---|
| 🔎 | 知识检索 | 中文搜索、学科与学段筛选、Topic 层级导航。 |
| 🕸️ | 关系探索 | 展开 1–3 跳前置/后继关系,点击、拖动和缩放局部知识图。 |
| 🧭 | 学习路径 | 选择目标,结合已掌握集合,生成满足先修约束的可行顺序。 |
| 📚 | 教材视图 | 对照不同出版社的册次与章节顺位,查看匹配的教材参考封面。 |
| ✏️ | 讲解与习题 | 查看 KeyPoints、例题、答案解析及关联课标。 |
| 📦 | 开放数据 | 分享知识点链接、导出单点 JSON、下载完整 JSONL 数据与校验文件。 |
当前 **v0.28.0 公开预览(public-preview)**覆盖 18 个学科、3 个学段、41 个实际学科—学段分区。以下为主图的精确计数;独立来源目录视图另列,不重复计入教材总量。新增 Concept、先修关系与教学资源保留各自的真实审核状态,机器复核不等于教师审核。
覆盖学科:数学、语文、英语、物理、化学、生物、历史、地理、道德与法治/思想政治、科学、信息技术、音乐、美术、艺术、日语、俄语、体育与健康、通用技术。本轮新增初中日语、小学体育与健康、初中体育与健康三个分区,并扩充九门高中学科。日语与俄语覆盖初中和高中;体育与健康、音乐、美术覆盖小学、初中和高中;艺术覆盖初中和高中,通用技术覆盖高中。全图覆盖三学段,不表示每门学科均覆盖三个学段。
| 知识与关系 | 数量 | 教学资源 | 数量 |
|---|---|---|---|
| Concept · 知识点 | 8,892 | KeyPoint · 讲解要点 | 19,445 |
| Topic · 主题 | 1,676 | Exercise · 习题 | 10,730 |
| PREREQUISITE · 先修关系 | 6,443 | StandardItem · 课标条目 | 5,445 |
| REFINES · 分类层级 | 10,257 | Textbook · 教材册次 | 1,161 |
| COVERS · 课标关联 | 13,427 | Chapter · 教材章节 | 12,607 |
| TEACHES · 教材关联 | 23,411 | Subject / Stage · 学科 / 学段 | 18 / 3 |
相较 v0.27.0,本轮将 1,580 条课标要求接入原构建流程,新增 1,703 个 Concept、166 个 Topic、3,686 条讲解要点、1,703 道习题和 510 条先修关系,同时新增 3,125 条 COVERS、1,834 条 REFINES。课标组织层另增 151 个主题、561 个子主题。
| 扩充范围 | 新增 Concept | 新增讲解要点 | 新增习题 |
|---|---|---|---|
| 初中日语 | 108 | 222 | 108 |
| 小学、初中体育与健康 | 265 | 547 | 265 |
| 高中语文、英语、历史、生物、化学、物理、数学、地理、思想政治 | 1,330 | 2,917 | 1,330 |
| 合计 | 1,703 | 3,686 | 1,703 |
- 课标驱动生成:经候选生成、去重合并、讲解与习题生成、模型复核和返修后,按现有 JSONL 结构接入共享知识图谱。
- 资源与关系衔接:每个新增 Concept 均有关联课标、讲解和习题;先修关系通过语义核对和无环检查。新增讲解与习题为模型生成并复核的内容。
- 保留既有数据:原有 7,189 个 Concept 的标识、节点内容及既有资源和关系完整保留。教材层与独立来源视图沿用上一版,新增知识点不自动宣称已有教材关联。
相较 v0.26.0,v0.27.0 依据《义务教育俄语课程标准(2022年版)》新增 127 个 Concept、12 个 Topic、101 个课标条目,配套 269 条讲解要点、127 道习题、62 条先修关系、187 条 COVERS 和 135 条 REFINES。课标组织层另增 4 个主题、8 个子主题。
| 俄语范围 | Concept | 讲解要点 | 习题 |
|---|---|---|---|
| 初中(v0.27.0 新增) | 127 | 269 | 127 |
| 高中(原样保留) | 108 | 230 | 108 |
| 俄语合计 | 235 | 499 | 235 |
- 资源覆盖:新增 127 个 Concept 均有讲解和习题;保留的新增资源已完成机器复核,未声称教师审核。
- 课标可追溯:101 个新增 StandardItem 中,93 个已有 COVERS 关联;其余 8 个保留为明确的覆盖缺口,不以知识点资源齐全替代课标覆盖率。
- 衔接已有数据:原有 7,062 个 Concept 及其既有资源和关系原样保留;教材册次、章节、TEACHES 与独立来源视图延续上一版。初中俄语新增 Concept 不自动声明已有教材映射。
v0.26.0 相较 v0.25.0 新增 1,313 个 Concept、134 个 Topic、691 个课标条目,并为此前缺少讲解与习题的 311 个已有 Concept 补齐资源。该轮讲解要点净增 3,387 条,习题新增 1,624 道。下表记录 v0.26.0 的扩充范围和当时规模。
| 扩充学科 | 新增 Concept | v0.26.0 Concept | v0.26.0 讲解要点 | v0.26.0 习题 |
|---|---|---|---|---|
| 通用技术 | +380 | 380 | 807 | 380 |
| 美术 | +233 | 390 | 791 | 390 |
| 体育与健康 | +218 | 218 | 474 | 218 |
| 日语 | +140 | 140 | 295 | 140 |
| 俄语 | +108 | 108 | 230 | 108 |
| 音乐 | +100 | 192 | 388 | 192 |
| 艺术 | +86 | 148 | 302 | 148 |
| 语文(书法内容) | +32 | 466 | 1,006 | 602 |
| 信息技术 | +16 | 185 | 373 | 185 |
- 沿用原构建流程:从官方课标要求生成候选,经去重与核对后写入既有 Concept / Topic 结构;讲解、习题和先修提案通过原流水线的真实模型 API 生成,并执行机器复核与关系检查。
- 资源补齐:该轮新增及补齐范围内,每个 Concept 均有讲解与习题;音乐、美术、艺术已具备这两类资源及先修关系。讲解与习题为模型生成内容,并非教材正文摘录。
- 课标可追溯:新增 691 个 StandardItem 对应 662 条独立原文要求及 29 条学段投影;COVERS 净增 1,839 条。课标条目数与独立来源要求数分别统计。
- 衔接已有数据:该轮保留原有 5,749 个 Concept 的标识与节点内容;先修图经传递归约后保留原有可达关系。教材册次、章节、TEACHES 与独立来源视图原样延续;新增 Concept 不自动声明已有教材映射。
此前 v0.24.0 接入 ChinaTextbook 中既有十学科的一批主教材来源;相较 v0.21.0,该批增加 361 册教材、4,048 个目录节点和 1,044 条 TEACHES。随后信息技术扩充增加 48 册教材、1,681 个目录节点和 396 条 TEACHES。本轮保留这些教材数据,不将知识点扩充等同于 ChinaTextbook 全部资源已覆盖。
- 980 份主教材来源完成范围匹配:结合学科、学制、系列或主编、年级和册次识别教材;957 份对应单一主图记录,23 份对应同系列多个年份记录。活动手册、读本等 72 份补充材料暂未纳入本轮。
- 619 份独立来源视图:已覆盖的教材保留其主图记录,ChinaTextbook 中不同来源的目录分别保存。这里含 4,451 个目录节点、359 条候选 TEACHES,通过辅助索引连接已有教材,不因 PDF 或年份差异重复计算教材册数。
- 本次原样延续独立视图:上述 619 份视图及其 4,451 个目录节点、359 条候选关联沿用 v0.24.0 内容,仅随新包放置于
source-views-v0.28.0/,索引以carried_from记录直接继承版本 v0.27.0;不将其重新计算为本轮新增。 - 审核状态可追溯:619 份独立视图中,391 份恢复了目录候选,228 份尚无可用目录;范围匹配不代表目录完整。该批目录深化和独立来源匹配保留
draft/uncertain标记,其他记录保留各自的审核状态。
论文中的历史数据分析快照:图中知识点、学科、教材与覆盖率数字对应扩充前的数据;当前公开预览规模以上表和 manifest 为准。
📥 下载公开预览数据包 · SHA-256 校验 · Data Card
下载包同时包含 v0.28.0/ 主图和 source-views-v0.28.0/ 独立来源视图。两层共享知识点,且教材范围重叠,不能直接相加作为数据集规模。
只想浏览,直接打开 在线 Explorer;只需数据,直接 下载公开预览包。开发或自部署可使用以下步骤。
需要 Node.js ≥ 20.11 和 tar。网页与构建工具无需安装 npm 依赖。
git clone https://github.com/OpenRaiser/EduGraph.git
cd EduGraph
npm run build
npm test
npm run dev打开 **http://127.0.0.1:4173/EduGraph/**。首次构建会校验并解压公开数据包,生成检索索引和 41 个按学科、学段划分的资源文件。
复用仓库现有的检索与图查询模块,即可为 Agent 准备结构化上下文。模型调用、学生状态管理和教学策略由你的应用层接入。
| 应用需要 | EduGraph 提供 | 可用于 |
|---|---|---|
| 找到相关知识 | 知识点名称、别名、学科与学段筛选 | 知识检索与候选节点召回 |
| 理解知识依赖 | 前置/后继关系、Topic 层级、可行学习顺序 | 前置知识回顾与学习路径展示 |
| 获得教学素材 | 讲解、习题及答案解析、课标与教材映射 | 备课、练习选择与检索增强上下文 |
下面的示例使用 「小数与分数的互化」 查询知识、资源及先修学习路径。先执行 npm run build,再将代码保存为仓库根目录的 example.mjs,运行 node example.mjs:
import { readFile } from 'node:fs/promises';
import { createModel, findNodes } from './web/model.mjs';
const read = async file =>
JSON.parse(await readFile(new URL(`./dist/${file}`, import.meta.url), 'utf8'));
const model = createModel(
await read('data/graph.json'),
await read('data/search.json')
);
const [concept] = findNodes(model, '小数与分数的互化', {
subject: 'mathematics', stage: 'primary'
});
if (!concept) throw new Error('未找到知识点');
const manifest = await read('data/manifest.json');
const shard = await read(`data/resources/${concept.subject}/${concept.stage}.json`);
const known = []; // 已掌握知识点的 key,可由应用传入
const context = {
release: manifest.version,
concept,
neighbors: model.graph.neighbors(concept.key, { k: 1 }),
learningPath: model.graph.learningPath([concept.key], known),
resources: shard.concepts[concept.id]
};
console.log(JSON.stringify(context, null, 2));输出包含知识点、按跳数组织的前置/后继、学习路径,以及 keypoints、exercises、standards、teaches 四组关联资源。课标映射的 from 对应 dist/data/standards.json 中的 id;教材映射的 from 对应分区中的 chapters[].chapter_id,再由 textbook_id 关联教材册次。
持久化引用请保存 concept.key;concept.id 是当前构建内的索引。完整来源与审核字段可在原始 JSONL 包中查看,浏览器 JSON 为展示与查询选取了其中的字段。
data/
edugraph-v0.28.0.tar.gz 公开预览主图、来源视图及数据说明
edugraph-v0.28.0.tar.gz.sha256
source-views-v0.28.0/ 沿用 v0.24.0 的独立来源视图与教材关联索引
textbooks.jsonl 来源视图的教材元数据
chapters.jsonl 各来源自己的目录层级与顺序
teaches.jsonl 目录到已有 Concept 的候选关联
source-links.jsonl 来源视图与主图教材的对应关系
index.json 视图规模、范围说明与校验信息
open/v0.28.0/ 构建时解压,Git 忽略;通过归档分发
knowledge-points/ Concept、Topic、REFINES、PREREQUISITE
keypoints/ 讲解要点
exercises/ 习题、答案与解析
standards/ 课标条目
standards-alignment/ COVERS 关联
textbook-alignment/ 教材、章节与 TEACHES 关联
web/ 图谱浏览器、查询模块与展示素材
scripts/ 构建、预览、发布与线上验证
tests/ 真实数据与关联完整性测试
docs/assets/ README 展示素材
| 关系 | 方向 | 含义 |
|---|---|---|
REFINES |
子节点 → 父主题 | 组织知识的分类层级。 |
PREREQUISITE |
前置 Concept → 后继 Concept | 表达知识依赖。 |
COVERS |
课标条目 → Concept | 将课程要求绑定到共享知识。 |
TEACHES |
教材章节 → Concept | 保留主讲、复习、提及等教学角色。 |
资源也通过 Concept 标识连接:讲解记录中的 kp_key 指向知识点;习题记录中的 kp_keys 保存题目关联的知识点列表。上表中的 from / to 则记录有方向的关系,可通过索引进行双向查询。各类文件的字段说明见 Data Card。
📖 语义与使用说明
- 教材编排顺序与先修关系分别保存;教材轨道的箭头不转换成先修边。
- 教材目录视图保留章节顺位与关联知识点,公开包未包含原书章节标题和印刷编号。
- 独立来源视图沿用
Textbook、TextbookChapter、TEACHES类型;source-links.jsonl是辅助索引,不新增知识点或先修边。系列匹配不等于完全相同出版版次;多个候选教材记录会保留歧义,不合并两套目录的教学顺序。 - 学习路径是先修约束下的一条可行顺序;已掌握标记仅保存在当前浏览器。
- 数据保留原始来源与审核状态。资源存在和关联正确性是不同指标,机器审核不表示人工核验。
- 日语、俄语覆盖初中和高中;体育与健康覆盖小学、初中和高中;通用技术覆盖高中。音乐、美术、艺术已有讲解与习题。教材关联仍按实际核对结果展示,缺少映射不表示原教材没有相应内容。
- 新增 Concept 保留草稿来源,新增先修边保留候选状态,COVERS 为自动匹配;本轮保留的新增讲解、习题已完成机器复核,未声称教师审核。完整范围与历史遗留状态见 Data Card。
- 教材参考封面按出版社、学科、系列与册次匹配,具体印次未逐一核验;点击封面可追溯来源。未匹配时使用文字封面。
- 完整公开数据包不含真实学生历史记录,浏览器也不向服务器上传学习标记。
| 分支 | 内容 |
|---|---|
main |
网页源码、公开数据、说明与构建脚本。 |
gh-pages |
自动生成的网站,可直接由 GitHub Pages 托管。 |
向 main 推送后,GitHub Actions 自动构建、运行数据测试、检查发布文件范围并部署。随后访问线上资源,验证全部数据分片、检索与下载校验和。
npm run audit:site # 检查可发布文件、来源记录和完整数据包欢迎通过 Issues 反馈问题,或通过 Pull Request 提交改进:
- 数据纠错:提供知识点
key、相关资源或关系的标识、公开数据版本,以及建议修改的依据。 - 浏览体验:附上可复现的知识点链接、操作步骤与预期表现,帮助改进检索、图谱和教材视图。
- 接入示例:分享基于公开数据的查询、教学资源组织或教育应用示例,注明依赖与运行方式。
使用公开数据时,请标注 EduGraph、所用数据版本和数据许可。下面是仓库资源的 BibTeX 引用,方便在研究或项目说明中使用:
TBD- 代码:Apache 2.0
- 公开教育数据:CC BY-SA 4.0,详细说明见 Data Card。
- 教材来源核对:基于 TapXWorld/ChinaTextbook 的固定来源快照构建结构候选与关联。公开包不分发教材 PDF、正文、OCR 文本或原目录标题。
- 教材封面:来自 TapXWorld/ChinaTextbook,保留每张图片的来源与匹配信息。封面版权归相应出版社及权利人,不随教育数据重新授予 CC BY-SA 许可,见 封面来源说明。
- 项目展示风格参考 PAGER 与 PaperFit;README 的介绍与使用引导参考 AgentPilot 的组织方式。
进入 EduGraph → · 反馈与建议 · 返回顶部 ↑
