一文看懂LLM Wiki项目结构:purpose.md、schema.md、raw/wiki目录全景导览
2026/9/15 17:22:13 网站建设 项目流程

一文看懂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.mdschema.mdraw/wiki三大目录,几分钟理清每个文件的作用。

整体架构:三层文件结构

LLM Wiki 的结构源自 Karpathy 提出的知识库构建模式(仓库内保留了原始方法论文档 llm-wiki.md)。核心是清晰的三层架构

层级目录/文件谁来写你能做什么
原始资料层raw/你(只读给 LLM)导入文档、图片
Wiki 层wiki/LLM 生成并维护只读、浏览、编辑
规则层purpose.mdschema.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.mdschema.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 做维护者"的工作流

小结:记住这张结构图

  1. purpose.md定方向,schema.md定规则
  2. raw/只进不改,wiki/由 LLM 持续生长
  3. index.md+log.md让 LLM 在小规模下也能高效导航,无需向量 RAG 基础设施
  4. 想深入了解摄入流程如何读取这两个文件,可查看 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询