Fuyuan's KB — LLM Wiki Schema¶

此文件定义了 Fuyuan's KB（docs/fuyuans-kb/）的维护规范，遵循 Karpathy LLM Wiki 模式。

目录结构¶

docs/fuyuans-kb/
├── index.md              ← 首页（自动更新统计）
├── AGENTS.md             ← 本文件 — Schema 定义
├── log.md                ← 追加式操作日志
│
├── raw/                  ← 📖 不可变原文 — 只读，绝不修改
│   ├── resources/        ←   话题参考、文章、研究报告
│   ├── areas/            ←   持续关注领域
│   ├── projects/         ←   项目相关原文
│   └── archives/         ←   已归档
│
├── wiki/                 ← ✍️ ProMan 维护的知识库
│   ├── summaries/        ←   每篇文章的摘要页
│   ├── concepts/         ←   跨领域概念页
│   └── entities/         ←   人物、公司、工具
│
├── articles/             ← 📚 文章推荐入口
├── ideas/                ← 💡 想法笔记（不修改原文，只追加）
├── reading/              ← 📖 阅读记录
├── podcasts/             ← 🎙 播客精华
└── clips/                ← 🎬 视频文字稿

Ingest 流程¶

当 Fuyuan 要求处理新内容时：

读原文 — 在 raw/resources/ 或用户直接提供的内容
写摘要 — 在 wiki/summaries/<slug>.md 中，需包含：
YAML frontmatter: title, source, tags, created, updated, category
3-5 条 Key Takeaways
可引用的 Notable Quotes
创建概念页和实体页 — 如果原文引入新概念/人物/工具，创建 wiki/concepts/ 或 wiki/entities/
分类索引 — 写入 raw/resources/index.md（新增原文）+ wiki/index.md（分类列出）
更新 index.md（首页）— 更新统计数字
更新 log.md — 追加一行：## [YYYY-MM-DD] ingest | <标题>

Query 流程¶

当 Fuyuan 提问时：

搜 wiki/index.md 找到相关页面
读对应页面 — 从 wiki/summaries/、wiki/concepts/、wiki/entities/ 读取
合成回答 — 引用源页面
价值持续的答案 — 保存为新的 wiki 页

约定¶

Frontmatter¶

---
title: 文章标题
source: https://...
tags: [tag1, tag2]
created: YYYY-MM-DD
updated: YYYY-MM-DD
category: 工程管理 / 开发者成长 / ...
---

重要约束¶

❌ 永远不修改 raw/ 下的原文
❌ 不删除原文文件
❌ log.md 只追加，不删改历史
✅ 涉及 Fuyuan's KB 的操作前，先读本文件和 ~/cbrain/CBRULES.md

Fuyuan's KB — LLM Wiki Schema¶

目录结构¶

Ingest 流程¶

Query 流程¶

约定¶

Frontmatter¶

分类（进化中，根据内容自然扩充）¶

重要约束¶