# KB Schema

> LLM 驱动的个人知识库。大哥的第二大脑外存。
> 原则：默认全存，人类筛选，Agent 编译。

## Domain

大哥的知识域：技术（DevOps/K3s/Cloudflare/Agent）、投资（AI/半导体/云/澳洲税）、生活（墨尔本/钢琴/家庭）

## Conventions

- 文件名：英文小写连字符，无空格无中文（如 `nvidia-thesis.md`）
- wiki 页面用 `[[wikilinks]]` 互连，每页最少 2 个出链
- `updated` 只在实际内容变更时更新，不是 agent 碰过就改
- 新 raw 文件自动进入 `raw/YYYY-MM/`

## Directory Structure

```
kb/
├── SCHEMA.md          # 本文件
├── log.md             # 操作日志
├── raw/               # 源材料（按月分桶，不可变）
│   ├── links/         #   从 Links App 自动同步的新闻
│   └── YYYY-MM/       #   手动分享的文章、网页
├── prefs/             # Agent 行为偏好（多工具共享，先 search 再写）
├── projects/          # 进行中的项目（状态/目标/下一步，细节在 wiki）
├── wiki/              # 编译后的知识页
│   ├── INDEX.md       #   自动生成索引（scripts/reindex.sh，勿手改）
│   ├── investing/     #   投资相关
│   ├── tech/          #   技术相关
│   ├── life/          #   生活相关
│   └── decisions/     #   决策日志（最高价值）
└── _archive/          # 已废弃页面
```

## Frontmatter

### raw 文件

```yaml
---
source_url: https://...
ingested: YYYY-MM-DD
status: inbox | absorbed | skipped | failed_fetch
---
```

### wiki 页面

```yaml
---
title: "页面标题"
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [domain/subtag]
sources: [raw/YYYY-MM/file.md]
---
```

## Tag System (open prefix)

| Prefix | 初始 tags |
|--------|----------|
| `tech/` | `infra`, `k3s`, `cf-workers`, `llm`, `agent`, `homelab`, `devops`, `networking`, `security`, `database` |
| `inv/` | `semi`, `cloud`, `ai`, `thesis`, `earnings`, `tax`, `valuation`, `macro`, `risk`, `strategy` |
| `life/` | `music`, `piano`, `health`, `family`, `melbourne`, `australia` |

新 tag 直接用，lint 只建议不拦截。

## Operations

### Ingest (采集 — 即时)
大哥分享 URL/粘贴 → Agent 抓取内容 → 保存 `raw/YYYY-MM/YYYY-MM-DD-slug.md`
→ status: inbox

### Absorb (消化 — 人类触发)
1. 读 raw
2. rg 搜 wiki/ 找相关页面
3. 优先更新已有页面
4. 必要时建新页（清晰有价值才建）
5. 更新 status → absorbed

### Query (查询)
rg 搜 wiki/ + raw/ → 结果标 [wiki] 或 [raw] → 合成回答

### Lint (健康检查)
- P0: 断链 → 必须修
- P1: 投资页 >60天未更新 → 建议修
- P2: 孤儿页 → 提示

### Reindex (索引 — 结构变更后)
`scripts/reindex.sh` → 重新生成 `wiki/INDEX.md`（frontmatter title + 正文首行）。
新页面、改名、删除后都要 reindex。INDEX.md 勿手改。

## Page Templates

### Stock Thesis
```markdown
# [Company] Thesis
- Conviction: [high/medium/low]
- Entry: [date] @ [price]
- Thesis: [3-5 bullet reasons]
- Risks: [what would break the thesis]
- Catalysts: [upcoming events]
- Last review: [date]
```

### Decision Log
```markdown
# [Decision Title]
- Date: YYYY-MM-DD
- Context: [what was the situation]
- Options considered: [list]
- Decision: [what was chosen]
- Rationale: [why]
- Outcome (if known): [what happened]
```

### Tech Runbook
```markdown
# [Component] Runbook
- Purpose: [what it does]
- Location: [repo/namespace/URL]
- Key configs: [critical settings]
- Common issues: [problems + fixes]
- Links: [[related-page]]
```

## Kill / Merge Policy

- 被取代的页面前端加 `superseded_by: [[new-page]]`
- 移到 `_archive/`
- 保留 wikilinks 可点击

## Language Policy

- 正文：中文（技术术语保留英文）
- 文件名：英文 slug
- [[wikilinks]]：英文 slug