这是一个零依赖本地生成器:把 UTF-8 编码的 Markdown / TXT 课程资料转换为可双击打开的单文件 HTML。生成页包含来源化概念卡、真实算法实验与三类检查题,不需要联网、pip 或 npm。
- 单文件生成:长文按字符权重归并,稀疏大章按段落拆分,稳定输出 8–18 个学习章节。
- 目录批量生成:按文件名排序处理目录直属 md/txt,自动生成路线
index.html与前后站互链。 - 四类实验模板:切分检索
chunk、PCA 向量空间vector、Query 改写query、GraphRAG 共现关系图graph。 - 三类检查题:挖空、判断对错、单选,每题显示课程原文和来源。
- 深色模式:跟随
prefers-color-scheme,也可手动在「自动 / 开 / 关」之间切换;移动端布局含 800px / 520px 断点。 - ZIP 分享包:上传页和通过 HTTP 打开的生成页可下载「学习页 + README」压缩包。
-
用全部四类实验生成单页:
python3 generator/generate.py tests/sample.md --experiments all -o output/readme-demo.html
-
对一个目录批量生成 Query + GraphRAG 课程路线:
python3 generator/generate.py tests --batch --experiments query,graph --out output/batch/
-
运行全量验收(含生成、批量、模板、深色、算法、上传与 ZIP 端到端冒烟):
python3 scripts/verify.py
--experiments 接受逗号分隔的 chunk,vector,query,graph,也可直接传 all;默认为 chunk,vector。单页产物可直接通过 file:// 打开。
运行 python3 server.py 后打开 http://localhost:8700,拖入 md/txt 并点击「生成学习页」。成功后可新窗口打开 HTML,或直接下载 ZIP 分享包。服务只监听 127.0.0.1:8700,上传限 UTF-8 md/txt 且不超过 5MB。
generator/generate.py:解析、提炼、题目与四类实验模板。server.py:本地上传、生成页访问与 ZIP 打包。scripts/verify.py:零依赖全量验收器。scripts/build_handwritten_dark.py:为不可改动的手写原页重建深色增强副本。tests/:确定性生成、长文章节、批量互链、模板注入和 ZIP 单元测试。output/:真实课程产物、运行时生成页与handwritten-dark/手写页增强副本。
--llm 保留为可选增强开关。当 .keys/deepseek_key.txt 不存在时,命令会安静使用完整的本地规则模式;当前产物全部由本地生成,未调用外部 API。