用途:为智能教科书(如 geometry-course)生成所有图表与 MicroSim 的状态报告,便于审计各章视觉元素、跟踪实现状态、分析复杂度与 Bloom 分类分布,并在新增内容后更新文档。
主要能力:扫描 docs/chapters/ 下各章目录的 index.md,从带“#### Diagram:”标题的 <details> 块中提取图表与 MicroSim 规格,分析类型、状态、Bloom 分类层级、UI 元素数量、难度(Easy/Medium/Hard/Very Hard)与学习目标。生成两个文件到 docs/learning-graph/:diagram-table.md(含章号、标题链接、状态、类型、Bloom 层级、UI 元素数、难度)与 diagram-details.md(按章汇总、完整描述、学习目标)。
使用方式:若项目缺少脚本,先 mkdir -p src/diagram-reports 并将技能内 scripts/diagram-report.py 复制到 src/diagram-reports/diagram-report.py;确认工作目录为项目根、docs/chapters/ 含章节目录、docs/learning-graph/ 存在;运行 python src/diagram-reports/diagram-report.py。可选参数:--output-dir 指定输出目录、--format csv 或 html、--verbose 输出调试日志。报告需在 mkdocs.yml 的 Learning Graph 下配置链接,并用 mkdocs serve 预览。
适用场景:内容创建或更新后、评审前识别缺口、规划时平衡实现工作量、编写教师指南或项目文档。
限制:仅适用于含指定目录结构与 <details> 规格格式的智能教科书项目;无元素时需检查标题与块格式;缺失字段需在规格中补充 Type、Status、Learning Objective;链接失效需核对章节目录命名与锚点生成。其他平台、收费与效果信息暂未提供。