yzfly Book to OKF
把一本书 / 长文 / 讲义,拆成一座互相链接的 OKF 知识库——灵感来自 Karpathy 的 LLM Wiki 里"读书时边读边建 fan-wiki"的例子。
何时使用
- 用户给一份书稿 / 长文 / 系列教程,想要可检索、可问答的概念网络;
- 写作者想为素材建立"实体—概念—主题"互链的第二大脑。
拆解模型(一个概念一个文件)
不要按"一章一文件"粗暴切分。按知识对象建概念:
概念类型(type) |
内容 |
|---|---|
Chapter |
每章摘要 + 指向其涉及的实体/概念 |
Concept |
一个核心概念/术语的独立页(可被多章引用) |
Entity |
人物、组织、地点、作品等实体页 |
Theme |
跨章节的主题/论点,记录它在哪些地方出现、如何演变 |
Timeline |
(适用时)事件时间线 |
工作流
- 先扫一遍全书,列出概念清单(章节 + 反复出现的实体/术语/主题)。先列再写。
- 用
../okf-creator/scripts/scaffold_okf.py起骨架(目录建议chapters/、concepts/、entities/、themes/)。 - 逐章 ingest(借鉴 Karpathy 的三操作):
- 写
Chapter摘要页; - 更新相关
Concept/Entity页(同一个人物在多章出现 → 持续补充同一页,而非每章新建); - 在
themes/记录主题演变; - 往根
log.md追加## YYYY-MM-DD一条。
- 写
- 建交叉链接:概念间用包内绝对链接互连,形成图谱(人物↔事件↔主题)。
- lint:找孤儿页、被提及却没建页的概念、矛盾点。
- 校验:
validate_okf.py。 - (可选)用
okf-to-book把知识库反向发布成可浏览的文档站/图谱。
原则
- 复用而非重复:同一概念只一页,各处链接它;
- 正文要执行洞察:摘要不是目录复述,要写出"这章到底说了什么、和别处怎么连";
- 保留出处:每个概念页用
# Citations标注书中位置(章节/页码),resource可指原文件。
多语言
中英双语书可用 i18n 约定:lang + canonical(见 规范译文末)。