# 知识库 Schema — 内容创作者 Wiki

本知识库用于沉淀小红书、微信公众号等平台的内容素材，提炼主题，积累创作灵感。
LLM 负责 wiki 层的全部写作和维护，人负责素材投喂、方向引导和最终创作。

---

## 三层架构

| 层 | 位置 | 所有者 | 说明 |
|---|---|---|---|
| Raw | 根目录（`*.md`、子文件夹均可） | 人 | 原始素材，不可变。文章剪藏、笔记截图、灵感草稿等 |
| Wiki | `wiki/` | LLM | 生成的结构化页面，人只读 |
| Schema | 本文件 (`CLAUDE.md`) | 人 + LLM | 约定与规则，需要调整时先改此文件 |

### Raw 素材存放约定
- 根目录下直接放 markdown 文件或按来源建子目录（如 `小红书/`、`公众号/`、`播客/`）
- 图片统一放 `assets/`，Obsidian 附件路径已配置指向此处
- 文件名格式：`来源-标题.md` 或自由命名，无强制要求

### Wiki 目录结构

```
wiki/
├── meta/              # 元数据文件（index.md、log.md）
├── sources/          # 每篇素材的摘要页（一对一）
├── topics/           # 主题/选题方向（多素材归纳）
├── entities/         # 实体页：人物、品牌、产品、账号
├── ideas/            # 创作灵感、选题构思、内容框架
└── raw/              # Layer 1: 不可变原始素材（可建于根目录或 wiki/raw/）
```

---

## 页面规范

### Frontmatter（所有 wiki 页面必须包含）

```yaml
---
type: source | topic | entity | idea | meta
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: []              # 自由标签，小写，用短横线连接
sources: []           # 关联的 wiki 内部页面路径（不带 .md 后缀，source 页必填）
---
```

### Source 页（`wiki/sources/`）
- 文件名：`{来源缩写}-{关键词}.md`，如 `xhs-护肤成分科普.md`
- 内容：原文核心观点摘要、关键数据/金句、可复用的内容角度
- 必须标注原始素材路径

### Topic 页（`wiki/topics/`）
- 围绕一个选题方向，综合多个 source
- 包含：主题概述、关键论点、素材引用、潜在创作角度
- 当 3+ 个 source 涉及同一主题时应创建 topic 页

### Entity 页（`wiki/entities/`）
- 人物、品牌、产品、账号等
- 包含：基本信息、相关内容汇总、值得关注的点

### Idea 页（`wiki/ideas/`）
- 创作灵感和选题构思
- 包含：核心 hook、目标受众、参考素材链接、初步大纲
- 状态标记：`draft` / `ready` / `published` / `abandoned`

---

## 操作流程

### Ingest（投喂素材）

1. 读取 raw 素材全文
2. 与用户讨论关键要点（除非用户要求批量处理）
3. 在 `wiki/sources/` 创建摘要页
4. 检查是否需要：创建/更新 topic 页、创建/更新 entity 页、生成 idea 页
5. 更新 `wiki/index.md`
6. 追加 `wiki/log.md` 条目：`## [YYYY-MM-DD] ingest | {标题}`

### Query（查询）

1. 先读 `wiki/index.md` 定位相关页面
2. 读取相关 wiki 页面，综合回答
3. 有价值的分析结果应存为新 wiki 页面（idea 或 topic）
4. 追加 log 条目：`## [YYYY-MM-DD] query | {问题摘要}`

### Lint（健康检查）

定期执行，检查：
- 孤立页面（无入链）
- 过时内容（source 更新但 topic 未同步）
- 缺失的交叉引用
- 有素材积累但未创建的 topic
- idea 页面状态是否需要更新
- 追加 log 条目：`## [YYYY-MM-DD] lint | 检查结果摘要`

---

## 链接与引用

- Wiki 页之间用 Obsidian 双链：`[[wiki/topics/护肤成分]]`
- 引用 raw 素材用相对路径：`[[小红书/某篇笔记.md]]`
- 页面内引用具体段落时用 blockquote + 来源标注

---

## Obsidian 配置备忘

- 附件目录：`assets/`
- 推荐插件：Dataview（frontmatter 查询）、Graph View（关系可视化）、Marp（幻灯片）