kapathy-LLM-WIKI-

本项目是一个基于 Karpathy 的 LLM Wiki 理念 构建的 Obsidian 知识库。它不是一个临时问答仓库，而是一套让 LLM 持续维护、逐步累积、长期可用的知识编译系统。

核心理念

将碎片化的信息编译成结构化、高度相互链接、可追溯的知识网络，便于 AI 辅助学习、研究与长期沉淀。

• raw/ 保存不可变的原始来源。
• wiki/ 保存已经整理、交叉引用、持续更新的 canonical 知识。
• output/ 保存查询、分析、报告等阶段性交付物，避免把临时产物直接混入知识层。

Git 与隐私

• raw/ 通常包含个人收藏、网页剪藏、会议记录或私有资料，建议默认不纳入公开版本控制。
• wiki/ 中的知识页可能带有个人判断、研究脉络与长期积累，是否公开应由你自行决定。
• output/ 更适合存放阶段性分析、草稿、专题报告与 lint 报告，通常也不建议默认公开。

分层职责

raw/

• 只存放原始来源及其附件。
• 目录结构由用户自行决定，不应从目录名推断主题、语言或优先级。
• LLM 只能读取，不能修改、重命名、移动或删除真实来源文件。
• 若存在 .gitkeep 等占位文件，应忽略，它们不属于来源材料。

wiki/

• 这是唯一的知识编译层与 canonical 知识层。
• LLM 在这里维护来源摘要、概念页、实体页、综合页、索引与日志。
• 页面应尽量复用和更新现有内容，而不是无节制新增重复页面。

output/

• 这是查询和交付产物层，不默认视为 canonical 知识。
• 查询结果、比较稿、专题分析、lint 报告优先写入这里。
• 只有经过提炼、确认具备长期复用价值的内容，才提升进 wiki/。

CLAUDE.md

• 这是 Agent 的行为规范与工作流说明。
• 当你用 Claude Code 或其他 Agent 维护这个仓库时，应先读取该文件，再执行 ingest、query 或 lint。

最短工作流

/ingest 路径

• 读取 raw/ 下的来源文件。
• 先检查 wiki/index.md、wiki/overview.md 与相关页面，避免重复造页。
• 在 wiki/sources/ 新建或更新对应来源页。
• 将新信息整合进相关 wiki/concepts/、wiki/entities/ 或 wiki/syntheses/。
• 同步更新 wiki/index.md 与 wiki/log.md。

/query 问题

• 先从 wiki/index.md 定位相关页面。
• 基于现有 wiki 内容回答问题，并用 [[wikilink]] 回指相关知识页。
• 若需要落盘，默认写入 output/analyses/，并更新 output/index.md 与 output/log.md。
• 只有当结果经过提炼、确认具备长期复用价值时，才提升进 wiki/。

/lint

• 检查孤儿页、断链、缺少反向链接的页面。
• 检查无来源支撑的论断与被新来源挑战但尚未更新的旧结论。
• 将 lint 报告默认写入 output/reports/。
• 若 lint 推动了实质性 wiki 修正，再更新 wiki/index.md 与 wiki/log.md。