book-to-okf

name	book-to-okf
description	把长文, 书稿, 讲义或系列文章拆解为符合 OKF v0.2 的知识包(bundle), 按章节, 概念, 人物, 术语建立互链的概念页. 适用场景包括把一本书或长文档转成结构化知识库, 为写作素材建立可检索的概念网络, 把教程系列整理为 OKF. 当用户提到把书或长文转成 OKF, 拆书, 建立读书知识库, 或为书稿建概念库时触发.
type	Skill
title	Book to OKF
lang	zh
tags	["okf","book","写作","skill"]
license	MIT

Book to OKF

把一本书 / 长文 / 讲义,拆成一座互相链接的 OKF 知识库——灵感来自 Karpathy 的 LLM Wiki 里"读书时边读边建 fan-wiki"的例子。

何时使用

• 用户给一份书稿 / 长文 / 系列教程,想要可检索、可问答的概念网络;
• 写作者想为素材建立"实体—概念—主题"互链的第二大脑。

拆解模型(一个概念一个文件)

不要按"一章一文件"粗暴切分。按知识对象建概念:

概念类型(type)	内容
Chapter	每章摘要 + 指向其涉及的实体/概念
Concept	一个核心概念/术语的独立页(可被多章引用)
Entity	人物、组织、地点、作品等实体页
Theme	跨章节的主题/论点,记录它在哪些地方出现、如何演变
Timeline	(适用时)事件时间线

工作流

1. 先扫一遍全书,列出概念清单(章节 + 反复出现的实体/术语/主题)。先列再写。
2. 用 ../okf-creator/scripts/scaffold_okf.py 起骨架(目录建议 chapters/、concepts/、entities/、themes/)。
3. 逐章 ingest(借鉴 Karpathy 的三操作):
   • 写 Chapter 摘要页;
   • 更新相关 Concept/Entity 页(同一个人物在多章出现 → 持续补充同一页,而非每章新建);
   • 在 themes/ 记录主题演变;
   • 往根 log.md 追加 ## YYYY-MM-DD 一条。
4. 建交叉链接:概念间用包内绝对链接互连,形成图谱(人物↔事件↔主题)。
5. lint:找孤儿页、被提及却没建页的概念、矛盾点。
6. 校验:validate_okf.py。
7. (可选)用 okf-to-book 把知识库反向发布成可浏览的文档站/图谱。

原则

• 复用而非重复:同一概念只一页,各处链接它;
• 正文要执行洞察:摘要不是目录复述,要写出"这章到底说了什么、和别处怎么连";
• 保留出处:每个概念页用 # Citations 标注书中位置(章节/页码),resource 可指原文件。

多语言

中英双语书可用 i18n 约定:lang + canonical(见 规范译文末)。