kb/SCHEMA.md

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/       #   手动分享的文章、网页
├── wiki/              # 编译后的知识页
│   ├── investing/     #   投资相关
│   ├── tech/          #   技术相关
│   ├── life/          #   生活相关
│   └── decisions/     #   决策日志（最高价值）
└── _archive/          # 已废弃页面

Frontmatter

raw 文件

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

wiki 页面

---
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: 孤儿页 → 提示

Page Templates

Stock Thesis

# [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

# [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

# [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