用途:该技能面向内容驱动型站点,检查跨文件的数据与资源一致性,例如课程数据引用的素材文件是否存在、路由是否覆盖、ID 是否稳定。它不判断页面能否正确渲染,渲染验证属于 web-visual-verification。
主要能力:包含五类审计。一是跨产物引用解析,检查 course-data.js 的 materials[] 是否被路由覆盖、文件是否存在、是否被单元引用;二是资源覆盖与缺口分析,统计各章节文本长度与图片数量,列出缺少插图的候选章节;三是内联数据与源文件漂移,比对 index.html 中内联的 window.COURSE 与源 Markdown;四是 ID 稳定性与复用,检查 task.id、quiz.id、unit.id 是否重复或被重命名,并交叉校验 quiz[N].sourceUnit 与 materials[].id;五是产物检查,例如用 JSZip 检查 DOCX 内嵌图片数量。
使用方式:脚本放在 scripts/audit-.mjs,报告输出到 data/audit-.md。审计脚本始终以 0 退出,即使发现问题也不阻断,报告以摘要开头并用 emoji 标注警告、错误与备注,便于快速浏览。若问题必须阻断发布,应提升为带 assert.* 的验证脚本。
适用场景:重大内容发布前、增删单元或素材后、企业版交付前、规划下一轮迭代时,以及用户感觉“哪里不对”但看不到运行时错误时。
限制:不用于判断页面渲染是否正确;不应在 CI 中当作验证门禁运行;报告需人工阅读与判断,自动化不替人做取舍。资料未提供具体安装命令、收费与平台信息。