从 2.0 到 3.0 :更智能的知识图谱,更专业的排版输出
🏠 官网
https://github.com/Kenshin/simpread-karpathy-llm-wiki-compiler
💡 前情提要
https://newsletter.simpread.pro/p/karpathy-llm-wiki-compiler-2
✍️ 升级说明
3.0 版本是一次面向知识可视化与输出质量的重大升级。核心目标只有一个:让这套 Wiki 方案不仅能整理知识,更能以专业的方式呈现知识。
🪄 GraphLens:知识图谱

Wiki 页面自动生成 Mermaid 知识图谱,直观展示实体关系网络,一眼看清知识结构。
每个图谱实体都关联对应的本地快照,形成「图谱实体快照索引」表格,点击即可溯源到原文。支持多图谱模式,复杂主题可生成多个子图谱(如"塞北民族体系"、"西域民族体系")。
知识图谱置于头部摘要之后,作为 Wiki 可视化入口。图谱内容必须与当前 Wiki 正文强相关,不得引入正文中未出现的实体或关系。
更多详情 👉 graph/README.md
🎨 排版系统:专业级 HTML 输出

内置两套排版方案,将 Markdown Wiki 转化为精美 HTML 文件,输出到 outputs/ 目录。
| 维度 | --lite(默认) |
--kami |
|---|---|---|
| 依赖 | 零依赖开箱即用 | 需安装 kami skill |
| 定位 | 屏幕优先 | 屏幕 + 打印 |
| 暗色模式 | ✅ 支持 | ❌ 不支持 |
| PDF 输出 | ❌ 不支持 | ✅ 支持 |
| 图表组件 | 8 种 SVG | 14 种 |
--lite 核心特点:
-
零依赖,生成自包含 HTML,浏览器直接打开
-
暗色模式:自动跟随系统偏好 + 手动 toggle
-
Mermaid 知识图谱:AI 转内联 SVG(零 JS),复杂图谱自动降级 CDN
-
8 种图表组件:Timeline / Bar / Donut / Line / Quadrant / Tree / Waterfall / Venn
-
LXGW WenKai 开源中文字体,屏幕可读性佳
触发方式:
/render 星巴克 --lite ← 直接排版 wiki/星巴克.md
/report 星巴克 --lite ← 生成简报后排版
/ask 星巴克相关问题 --lite ← 生成回答后排版
查询关键词 星巴克 --lite ← MCP 搜索后排版
不指定 --lite 或 --kami 时,默认走 --lite。
更多详情 👉 tools/template/README.md
同时配套本地预览工具,可一键查看渲染效果 👉 tools/render/README.md
🔧 index_map.txt 生成工具
独立的映射表生成脚本,无需依赖同步助手即可创建 index_map.txt。
自动扫描 raw/{主题}/ 目录下所有 .md 文件,提取 [本地快照](http://localhost:7026/reading/xxx) 中的快照 ID 和 [原文地址](https://...) 中的原文链接,生成标准格式映射表。
使用方式:
# 生成单个主题的 index_map.txt
tools/generate-index-map.py -m 霸王茶姬 瑞幸
# 批量生成所有主题
tools/generate-index-map.sh -a
使用场景:
-
从其他来源导入 raw 文件,需要快速生成映射表
-
同步助手版本不支持自动生成 index_map.txt
-
需要重建或修复已有的 index_map.txt
更多详情 👉 indexes/README.md
📦 如何升级
1️⃣ 更新代码到 [最新版本](
2️⃣ 执行 /refresh 重新加载协议
3️⃣ 执行 /gen fix.md 批量修复 Sources 映射表与知识图谱
4️⃣ (可选)生成 index_map.txt:tools/generate-index-map.sh -a
5️⃣ (可选)执行 /render {主题} --lite 体验排版系统