SuperAPI AI 工具集

add-xapi-events-to-microsim

数据与分析

查看项目

更新于 10-20 17:14

技能介绍

该技能把 xAPI 事件记录加入已有的交互式 MicroSim 或章节测验页面,目标是在不改变仿真本身行为的前提下记录学生做了什么。每个仿真的接入代码是一层很薄的映射,通常 20 至 60 行,调用共享运行时,而不是复制运行时。

主要能力:运行时根据配置决定 Full 或 Compact 模式并构造所有 statement,同时执行生产者约定并渲染教学面板;技能负责判断哪些交互属于证据、证明什么、对应哪个概念,然后接线。技能附带库检测、概念查找、运行时安装、状态同步、无运行时检查、iframe 高度测量等脚本,并针对 p5 DOM 控件、p5 canvas 命中测试、Mermaid、图片热点叠加、章节测验页、vis-network、vis-timeline、Chart.js、Plotly、Leaflet 和纯 HTML/SVG 控件提供适配器说明。

使用方式:先定位书籍根目录(含 mkdocs.yml)与 docs/sims/<sim-name>/,用 detect-library.py 从 script 标签识别库并读取对应适配器;完整阅读仿真 JS 和 HTML,清点所有交互,按证据类别分类并给用户查看交互→类别→片段键→概念表;再依据学习图谱 CSV 把对象映射到概念 ID,在代码中通过 LRS.conceptId() 写入;用 install-runtime.py 确认或安装运行时;在 main.html 中加入脚本块和 CSS,在仿真 JS 中创建一个 LRSSim 实例、为每个对象创建句柄并在原有事件处理器中调用;在 metadata.json 中设置 xapi 块(页面级 concept 和 objects 映射);用 sync-status.py --apply 在导航中标记 instrumented;最后用 measure-iframe.py 重新测量 iframe 高度。批量处理整本书时可按共享库或模板分组并行,由协调者统一完成安装、参考仿真接线以及最终同步、严格构建和逐个检查。

适用场景:已有可用的 MicroSim 或章节测验需要记录学习行为;为生产仿真临时开启 ?xapi=teaching 查看 statement 日志;为整本书的仿真批量接入 xAPI。

限制与注意事项:只记录仿真设计所针对的行为,不记录所有可检测动作;短于 600 毫秒的悬停、短于 250 毫秒的误点、短于 1 秒的页面停留以及程序自身触发的事件属于噪声;答案从不折叠进 Compact 汇总;模式与教学 UI 来自配置而非仿真本身;不得编辑运行时或 vendored 库,应通过包装函数和添加监听器实现;仿真必须在没有运行时的情况下仍可运行,调用处需用 window.LRSSim 或空 lrs 保护;若脚本报告书籍副本与标准版存在漂移,应停止并告知用户,不要自行使用 --force;概念映射没有真正匹配时留空并告知,不猜测最近标签;测验答案键与章节矛盾时应报告给用户,而不是自行修改。