从 2.0 到 3.0 :更智能的知识图谱,更专业的排版输出

🔗 永久链接 | GitHub | 知乎 | 语雀

🏠 官网

https://github.com/Kenshin/simpread-karpathy-llm-wiki-compiler

💡 前情提要

https://newsletter.simpread.pro/p/karpathy-llm-wiki-compiler-2

✍️ 升级说明

3.0 版本是一次面向知识可视化与输出质量的重大升级。核心目标只有一个:让这套 Wiki 方案不仅能整理知识,更能以专业的方式呈现知识。

🪄 GraphLens:知识图谱

An image to describe post

Wiki 页面自动生成 Mermaid 知识图谱,直观展示实体关系网络,一眼看清知识结构。

每个图谱实体都关联对应的本地快照,形成「图谱实体快照索引」表格,点击即可溯源到原文。支持多图谱模式,复杂主题可生成多个子图谱(如"塞北民族体系"、"西域民族体系")。

知识图谱置于头部摘要之后,作为 Wiki 可视化入口。图谱内容必须与当前 Wiki 正文强相关,不得引入正文中未出现的实体或关系。

更多详情 👉 graph/README.md

🎨 排版系统:专业级 HTML 输出

An image to describe post

内置两套排版方案,将 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 体验排版系统

🔎 关联阅读

1️⃣ 同步助手 1.5.2 版:Token 消耗直降 10 倍

2️⃣ 简悦 Andrej Karpathy LLM Wiki 方案 2.0 版