【免费下载链接】ExamPass-Assistant把课堂讲义变成考试利器 一键将 PPT、Word、PDF 课件转化为结构清晰的知识清单和交互式测试题让复习事半功倍。 适用人群大学生、各个阶段老师、其他需要对付短期考试的朋友项目地址https://gitcode.com/gh_mirrors/ex/ExamPass-Assistant点击查看免费下载ExamPass-Assistant 把课堂 PPT、Word、PDF 讲义变成复习利器而它生成页面的核心就是一个轻量模板引擎 scripts/template_engine.py。本文是 template_engine 的 API 参考讲清save_knowledge_html、save_test、save_combined_html三个函数各自的参数、输入格式和自动行为让你无需读懂整个流水线就能快速生成自己的知识清单页和交互式测试页。3 个函数总览一个文件搞定页面生成模板引擎的思路很简单你只负责提供内容HTML 片段或题目 JSON它负责套上样式、自动目录、数学公式渲染和交互脚本。底层由 4 个模板文件拼装而成模板文件作用templates/page_template.html页面外壳预留__TITLE__、__CSS__、__BODY__等占位符templates/base.css所有页面共享的基础样式templates/test.css测试页专用样式计分卡、选项按钮等templates/test_js_template.js templates/test_labels.json交互脚本与中文界面文案三个公开函数一览函数输入产出页面save_knowledge_html知识清单 HTML 片段 带目录、公式渲染的清单页save_test题目 JSON 列表 可交互、可批改的测试页save_combined_html两者都要 顶部标签切换的合并页函数一save_knowledge_html 一键生成知识清单页调用签名源码见 scripts/template_engine.pysave_knowledge_html(body_html, output_path, title, slidesNone, kcsNone)参数说明body_html知识清单正文一段 HTML 片段含 H2/H3 标题即可触发自动目录output_path输出.html文件路径父目录不存在会自动创建title页面标题会注入为 H1slides可选渲染后的幻灯片列表提供后右侧出现「原始幻灯片对照」栏kcs可选章节知识组件列表与slides配合后标题自动带上可点击的「页N」定位小标签这个函数的隐藏福利是自动化传入的正文会被自动清理并增强剥离整页 HTML 外壳、修正公式分隔符、注入目录块全部逻辑在 scripts/template_engine.py 的_knowledge_body中完成。最小示例from template_engine import save_knowledge_html body h2第一章 导数/h2p…你的笔记内容…/p save_knowledge_html(body, out/第1章.html, 第一章 导数)函数二save_test 一键生成交互式测试页调用签名源码见 scripts/template_engine.pysave_test(questions, output_path, title, subtitle, duration_minutes30)questions是一个题目列表每题一个字典字段如下字段类型说明typestrchoice/multi/tf/fill/short/calc/code/essay/comprehensivepointsint该题分值questionstr题干可含pre、strong等格式标签optionslist选项列表选择/多选/填空类使用answerint / bool / list选择题为选项下标判断题用布尔值true/falseexplanationstr答案解析pitfallstr易错提醒页面以「易错提醒」展示一道题的完整样子完整契约见 agents/item-agent.md{ type: choice, points: 4, question: …, options: [A项, B项], answer: 1, explanation: …, pitfall: … }生成后页面自带计分卡、「提交批改」按钮和 AI 一键批改入口中文文案由 templates/test_labels.json 统一提供。引擎还会替你兜底判断题答案若误写成0/1或文字会被自动归一化为布尔值_sanitize_questions题干里没闭合的比如lowhigh也会被安全转义避免把后面所有题目吞掉_escape_stray_lt。from template_engine import save_test save_test(questions, out/第1章测试.html, 第一章 章节测试, duration_minutes40)函数三save_combined_html 清单测试合并为一页调用签名源码见 scripts/template_engine.pysave_combined_html(body_html, questions, output_path, title, slidesNone, kcsNone, subtitle, duration_minutes30)它把上面两个页面合并进同一个文件顶部是吸附式标签栏 知识清单 / 章节测试点击切换两个面板复用同一套幻灯片对照栏和答题引擎打印时还会自动展开为完整长页见 _TAB_CSS。参数含义与前两个函数完全一致。ExamPass 默认流水线的章节渲染就是靠它完成的可参考 scripts/render_chapters.py 的真实调用save_combined_html(note, questions, out, ch_label, slidesslides, kcskcs, subtitlef共 {len(questions)} 题)想改外观认识模板占位符如果你要定制页面关键是 _build_page 的填充逻辑——它把 templates/page_template.html 中的占位符逐个替换占位符填入内容__TITLE__页面title__CSS__base.css 各页面追加样式__BODY__你提供的正文__EXTRA_JS__页面专属脚本两个值得注意的细节JS 一定放在body之后——这是 DOM 能就绪的关键不要手动把脚本挪到head公式渲染开箱即用MathJax 配置已内置_MATHJAX_CONFIG且\(...\)、\[...\]会被自动转成更稳妥的$...$分隔符。想改中文文案按钮文字、题型分组标题直接编辑 templates/test_labels.json 即可无需动代码。快速上手10 行代码生成两页假设scripts/目录已在PYTHONPATH中参考 scripts/html_generator.py 的用法import sys sys.path.insert(0, scripts) from template_engine import save_knowledge_html, save_test, save_combined_html save_knowledge_html(body_html, out/knowledge.html, 我的知识清单) save_test(questions, out/quiz.html, 我的章节测试) save_combined_html(body_html, questions, out/combo.html, 清单测试)三个函数都会自动创建输出目录、写入 UTF-8 文件成功与否只需检查文件是否存在。常见坑与避坑指南tf 题答案写成了数字answer应为布尔值true/false引擎虽能容错但建议源头就写对硬约束见 agents/item-agent.md。JSON 字符串里出现裸双引号会导致json.loads失败、页面生成不出来引号处请用「」替代。LaTeX 反斜杠丢失JSON 里的\frac必须写成\\frac否则题目解析直接报错。正文传了整页 HTMLsave_knowledge_html会自动剥离head/style等外壳但仍建议只传body内的片段。改完模板文件不生效模板在模块加载时一次性读入_PAGE_TEMPLATE修改后需重启进程。你可能还会遇到的两个函数函数用途save_graph_html(tree_json, output_path, title)生成可交互的知识图谱页模板为 templates/graph_template.html见 scripts/template_engine.pysave_grade_report_html(grade_data, output_path)由批改结果生成独立的 HTML 成绩单含逐题点评与知识点掌握度条见 scripts/template_engine.py相关文件索引模板引擎核心scripts/template_engine.py简化封装清单页/测试页入口scripts/html_generator.py默认流水线渲染合并页scripts/render_chapters.py缓存生成示例含真实调用参数scripts/generate_cached.py题目字段契约与命题规则agents/item-agent.md页面模板与样式templates/page_template.html、templates/base.css、templates/test.css相关测试用例tests/test_html_generator.py掌握这三个函数你就拥有了 ExamPass 的页面生成层——换一套样式变量、接一份自己的题目 JSON就能为任意课程定制出带目录、带幻灯片对照、可自动批改的复习页面。赞分享【免费下载链接】ExamPass-Assistant把课堂讲义变成考试利器 一键将 PPT、Word、PDF 课件转化为结构清晰的知识清单和交互式测试题让复习事半功倍。 适用人群大学生、各个阶段老师、其他需要对付短期考试的朋友项目地址https://gitcode.com/gh_mirrors/ex/ExamPass-Assistant点击查看免费下载相关推荐beautiful-mermaid API参考6个核心函数速查清单renderMermaidSVG全参数详解beautiful mermaid API参考6个核心函数速查清单renderMermaidSVG全参数详解 beautiful mermaid 是一个开数据可视化图表库rescripts SDK 完全参考rescripts/utilities 全部 24 个 API 函数清单rescripts SDK 完全参考rescripts/utilities 全部 24 个 API 函数清单 rescripts 让你不用 eject 就能ExamPass完整指南一键将PPT/Word/PDF课件转化为知识清单与交互式测试题ExamPass完整指南一键将PPT/Word/PDF课件转化为知识清单与交互式测试题 ExamPass Assistant 是一款 AI 驱动的考试复习助手上一篇3分钟视频转PPTAI智能提取每一页幻灯片的完整指南下一篇Cowabunga Lite无需越狱的iOS 15个性化定制工具箱创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考