Skip to content
bleakbelladonnalsPublic

About

No description or website provided.

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Latest commit

 

History

26 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

资料 → 交互学习页

这是一个零依赖本地生成器:把 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」压缩包。

三条核心命令

  1. 用全部四类实验生成单页:

    python3 generator/generate.py tests/sample.md --experiments all -o output/readme-demo.html
  2. 对一个目录批量生成 Query + GraphRAG 课程路线:

    python3 generator/generate.py tests --batch --experiments query,graph --out output/batch/
  3. 运行全量验收(含生成、批量、模板、深色、算法、上传与 ZIP 端到端冒烟):

    python3 scripts/verify.py

--experiments 接受逗号分隔的 chunk,vector,query,graph,也可直接传 all;默认为 chunk,vector。单页产物可直接通过 file:// 打开。

上传与 ZIP 下载

运行 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 开关

--llm 保留为可选增强开关。当 .keys/deepseek_key.txt 不存在时,命令会安静使用完整的本地规则模式;当前产物全部由本地生成,未调用外部 API。

About

No description or website provided.

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages