一文看懂LLM Wiki项目结构:purpose.md、schema.md、raw/wiki目录全景导览
【免费下载链接】llm_wikiLLM Wiki is a cross-platform desktop application that turns your documents into an organized, interlinked knowledge base — automatically. Instead of traditional RAG (retrieve-and-answer from scratch every time), the LLM incrementally builds and maintains a persistent wiki from your sources。项目地址: https://gitcode.com/GitHub_Trending/ll/llm_wiki
LLM Wiki是一个跨平台桌面应用,能把你的文档自动转化为有组织、相互关联的持久化知识库。与传统 RAG 每次查询都从头检索不同,它让大模型增量构建并持续维护一个 Markdown Wiki。想用好它,先看懂项目结构是关键——本文带你全景导览purpose.md、schema.md与raw/wiki三大目录,几分钟理清每个文件的作用。
整体架构:三层文件结构
LLM Wiki 的结构源自 Karpathy 提出的知识库构建模式(仓库内保留了原始方法论文档 llm-wiki.md)。核心是清晰的三层架构:
| 层级 | 目录/文件 | 谁来写 | 你能做什么 |
|---|---|---|---|
| 原始资料层 | raw/ | 你(只读给 LLM) | 导入文档、图片 |
| Wiki 层 | wiki/ | LLM 生成并维护 | 只读、浏览、编辑 |
| 规则层 | purpose.md、schema.md | 你 + LLM 共同演化 | 调整目标与规则 |
对应地,系统围绕三个核心操作运转:Ingest(摄入)把新资料读进 Wiki、Query(查询)从 Wiki 检索作答、Lint(检查)定期维护健康度。
purpose.md:知识库的"灵魂"
purpose.md是这个项目相对原始方法论的重要新增——它回答的是**"这个 Wiki 为什么存在"**:
- 定义目标、关键问题、研究范围、正在演进的论点
- LLM 在每次摄入和每次查询时都会读取它获取上下文(参见 src/lib/ingest.ts 中读取
purpose.md的逻辑) - LLM 会根据你的使用模式建议更新它
一句话区分:schema.md是结构规则,purpose.md是方向意图。
schema.md:LLM 维护 Wiki 的规则手册
schema.md是"让 LLM 成为有纪律的 Wiki 维护者"的关键配置,通常定义:
- 页面类型表:entity(实体)、concept(概念)、source(资料)、query(问题)、comparison(对比)、synthesis(综合)、overview(概要)
- 命名规范:如
kebab-case.md、资料来源用author-year-slug.md - Frontmatter 格式:每个页面必带的 YAML 元信息(type、title、sources 等)
- 交叉引用规则:
[[wikilink]]语法与矛盾处理流程
创建项目时,这些文件由场景模板自动生成(研究、阅读、个人成长、商业、通用五套模板,各自预配置purpose.md和schema.md),实现代码见 src/lib/templates.ts 与 src-tauri/src/commands/project.rs。
raw/ 目录:只读的原始资料层
raw/是你的事实来源,LLM 只读不改:
raw/ ├── sources/ # 上传的文档(PDF、DOCX、网页剪藏等,不可变) └── assets/ # 本地图片两个实用特性值得注意:应用会自动监听raw/sources/的外部变更——在应用外新增或删除文件,也会触发同样的摄入/删除生命周期;删除资料时,级联清理会同步移除对应的 Wiki 摘要页面。
wiki/ 目录:LLM 生成与维护的核心
wiki/由 LLM 完全拥有,是知识沉淀的地方:
wiki/ ├── index.md # 内容目录,LLM 查询时的导航入口 ├── log.md # 时序操作日志(摄入、查询、Lint) ├── overview.md # 全局概要,每次摄入后自动重新生成 ├── entities/ # 人物、组织、产品 ├── concepts/ # 理论、方法、技术 ├── sources/ # 资料摘要 ├── queries/ # 保存的聊天回答 + 研究 ├── synthesis/ # 跨资料综合分析 └── comparisons/ # 并列对比得益于[[wikilink]]交叉引用,Wiki 会生长出一张关系网——在知识图谱视图中清晰可见:
隐藏目录:应用状态都在这里
.llm-wiki/—— 应用配置、聊天历史(.llm-wiki/chats/{id}.json)、审核项.obsidian/—— 自动生成的 Obsidian 仓库配置,wiki/目录可直接作为 Obsidian 仓库打开,实现"Obsidian 做浏览器、LLM 做维护者"的工作流
小结:记住这张结构图
purpose.md定方向,schema.md定规则raw/只进不改,wiki/由 LLM 持续生长index.md+log.md让 LLM 在小规模下也能高效导航,无需向量 RAG 基础设施- 想深入了解摄入流程如何读取这两个文件,可查看 README_CN.md 的"项目结构"章节与 src/lib/wiki-schema.ts
先创建项目、导几份文档,剩下的交给 LLM——你负责策划资料与提问,维护的琐事它全包了 🚀
【免费下载链接】llm_wikiLLM Wiki is a cross-platform desktop application that turns your documents into an organized, interlinked knowledge base — automatically. Instead of traditional RAG (retrieve-and-answer from scratch every time), the LLM incrementally builds and maintains a persistent wiki from your sources。项目地址: https://gitcode.com/GitHub_Trending/ll/llm_wiki
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考