xiaoyang111222/cn-math-taxonomy

选用指南

AI 根据 README 整理 · 2026/10/22 18:36:33

目标用户

主要面向初中数学教师和课程专家，用于审核先修关系和课程对齐。

查看 README 依据

功能：左侧可按学科、年级/册次、类型筛选并搜索（名称、描述、章节）；可勾选是否显示小学先修节点。点击知识点后显示描述、掌握标准、诊断题（答案默认折叠）、**先修链**（向上递归，树状或分层列表两种视图，边上标注硬/软先修及理由），以及**它是哪些后续知识点的先修**。地址栏 `#cnm_219` 形式的 hash 可直接定位到某个知识点。 ## 后续建议 1. 请初中数学教师先审先修边（尤其是 hard 边），并用教材实物或人教社官方目录核对九下的章名、章号和小节号。 2. 请课程专家审核 `standards` 映射（尤其 inferred），并考虑为 15 条无对应知识点的课标条款补点；再补充每个知识点的常见错误、典型例题。 3. 用真实学生答题数据校准诊断题与先修强度。 ## 许可证 / License 本项目（知识图谱数据、题库、诊断工具代码及文档）采用 [知识共享 署名-非商业性使用 4.0 国际许可协议（CC BY-NC 4.0）](https://creativecommons.org/licenses/by-nc/4.0/deed.zh-hans) 授权，完整条款见 [LICENSE](LICENSE)。 - ✅ 可以免费用于个人学习、教学、研究，可以修改和再分发，但需署名并注明来源（本仓库链接）。

使用方式

使用浏览器访问，需要启动静态服务器，并可运行Node脚本进行测试和截图。

查看 README 依据

python3 -m http.server 8000 # 访问 http://localhost:8000/diagnose/ （演示：?target=cnm_221&demo=1） node tests/test_engine.js # 引擎测试 node scripts/screenshot.js # 冒烟测试 + 截图（需要本机 Chrome） ``` 算法说明、判题规则、URL 参数与局限见 [diagnose/README.md](diagnose/README.md)；浏览页 `index.html` 右上角也有入口。每个知识点最多问 2 题，诊断结果只是线索。 ## 题库（第五轮） `data/questions.json`：给 315 个正式知识点各建 4–5 道题，**共 1407 题**；`topics.json` 里原有的 `diagnostic_question` 迁移为每个知识点的第 1 题（id 后缀 `_q1`），原字段保留不动。 | 统计 | 数量 | |---|---|

检查：JSON 合法；id 唯一；必填字段齐全；`domain`/`type`/`strength` 取值合法；每条边的两端都存在；无自环、无重复边；无环（有环时打印环路）；每个非外部知识点要么有先修边要么有 `root_reason`；没有完全孤立的节点。并打印按领域、按册次的数量以及边数、hard/soft 数。第三轮新增：`standards` 引用的课标 id 必须存在于 `data/cn-curriculum-standards.json`，`confidence` 只能是 `exact`/`inferred`，课标文件自身的 id 格式与编号连续性；并打印课标条目数、映射覆盖率；正式知识点 `standards` 为空时只打印警告（至多 30 个），设置 `STRICT_STANDARDS=1` 才视为错误。全部通过时输出 `VALIDATION PASSED` 且退出码为 0，否则输出错误并以非 0 退出。 ## 打开浏览页面 页面通过 `fetch` 读取 `data/*.json`，浏览器不允许直接用 `file://` 打开，请在本目录启动一个静态服务器： ```bash python3 -m http.server 8000 # 然后访问 http://localhost:8000/ ```

部署要求

需要Python 3以运行校验和服务器，另需Node和可选的无头Chrome用于测试。

查看 README 依据

python3 -m http.server 8000 # 访问 http://localhost:8000/diagnose/ （演示：?target=cnm_221&demo=1） node tests/test_engine.js # 引擎测试 node scripts/screenshot.js # 冒烟测试 + 截图（需要本机 Chrome） ``` 算法说明、判题规则、URL 参数与局限见 [diagnose/README.md](diagnose/README.md)；浏览页 `index.html` 右上角也有入口。每个知识点最多问 2 题，诊断结果只是线索。 ## 题库（第五轮） `data/questions.json`：给 315 个正式知识点各建 4–5 道题，**共 1407 题**；`topics.json` 里原有的 `diagnostic_question` 迁移为每个知识点的第 1 题（id 后缀 `_q1`），原字段保留不动。 | 统计 | 数量 | |---|---|

检查：JSON 合法；id 唯一；必填字段齐全；`domain`/`type`/`strength` 取值合法；每条边的两端都存在；无自环、无重复边；无环（有环时打印环路）；每个非外部知识点要么有先修边要么有 `root_reason`；没有完全孤立的节点。并打印按领域、按册次的数量以及边数、hard/soft 数。第三轮新增：`standards` 引用的课标 id 必须存在于 `data/cn-curriculum-standards.json`，`confidence` 只能是 `exact`/`inferred`，课标文件自身的 id 格式与编号连续性；并打印课标条目数、映射覆盖率；正式知识点 `standards` 为空时只打印警告（至多 30 个），设置 `STRICT_STANDARDS=1` 才视为错误。全部通过时输出 `VALIDATION PASSED` 且退出码为 0，否则输出错误并以非 0 退出。 ## 打开浏览页面 页面通过 `fetch` 读取 `data/*.json`，浏览器不允许直接用 `file://` 打开，请在本目录启动一个静态服务器： ```bash python3 -m http.server 8000 # 然后访问 http://localhost:8000/ ```

已知限制

内容和数据未经教师审核，九下目录为第三方来源推定，题库较小且未校准，当前许可证允许非商业使用。

查看 README 依据

# 中国初中数学（七—九年级）知识图谱 · 第一版草稿 用「知识点节点 + 先修边」的有向无环图（DAG）描述人教版初中数学（七上至九下）的知识结构，数据格式参考 [Marble os-taxonomy](https://github.com/withmarbleapp/os-taxonomy)（`topics` + `dependencies`）。 > **状态声明：这是 AI 生成的初稿，未经任何教师审核。** > 知识点的拆分粒度、掌握标准、诊断题答案，尤其是**先修关系（哪些是 hard、哪些是 soft，甚至某条边该不该存在）都需要一线初中数学教师审核**后才能用于教学、诊断或学习路径推荐。诊断题答案虽经抽查心算，但没有逐题由人工复核。 ## 数据来源与对齐依据

题目与答案全部由 AI 生成、未经教师审核，复核者与出题者是同一模型家族；格式、核验方法、统计与局限见 [docs/questions.md](docs/questions.md)。 ## 已知局限 - **审核缺位**：见开头状态声明；先修关系、hard/soft 强度、诊断题难度与区分度都没有经过教师或学生数据检验。 - **覆盖不均**：统计与概率现为 43 个，但全部集中在七下、八下、九下三册（新教材只在这三册安排统计与概率，不含七上、八上、九上）；九下目录为第三方来源推定，非官方、待核（见上）；教材中的“阅读与思考”“数学活动”“小结”“信息技术应用”等栏目没有单独成点，仅少数“综合与实践”“探究与发现”并入。 - **粒度不统一**：个别知识点（如各类应用题）按题型归并，个别（如三角形全等的各判定）拆得较细，需按实际教学再调。 - **题库很小**：每个知识点 4–5 题、诊断时最多问 2 题，题与答案由 AI 生成、未经教师审核，难度与干扰项没有学生数据校准，不能代替完整测评。 - **按教材顺序推断**：部分先修边（如命题、定理类内容）反映的是教材编排而非严格逻辑依赖，已尽量标为 `soft`。 ## 运行校验 ```bash python3 scripts/validate.py ```

功能：左侧可按学科、年级/册次、类型筛选并搜索（名称、描述、章节）；可勾选是否显示小学先修节点。点击知识点后显示描述、掌握标准、诊断题（答案默认折叠）、**先修链**（向上递归，树状或分层列表两种视图，边上标注硬/软先修及理由），以及**它是哪些后续知识点的先修**。地址栏 `#cnm_219` 形式的 hash 可直接定位到某个知识点。 ## 后续建议 1. 请初中数学教师先审先修边（尤其是 hard 边），并用教材实物或人教社官方目录核对九下的章名、章号和小节号。 2. 请课程专家审核 `standards` 映射（尤其 inferred），并考虑为 15 条无对应知识点的课标条款补点；再补充每个知识点的常见错误、典型例题。 3. 用真实学生答题数据校准诊断题与先修强度。 ## 许可证 / License 本项目（知识图谱数据、题库、诊断工具代码及文档）采用 [知识共享 署名-非商业性使用 4.0 国际许可协议（CC BY-NC 4.0）](https://creativecommons.org/licenses/by-nc/4.0/deed.zh-hans) 授权，完整条款见 [LICENSE](LICENSE)。 - ✅ 可以免费用于个人学习、教学、研究，可以修改和再分发，但需署名并注明来源（本仓库链接）。