# Wiki Schema

## Domain
跨学科知识库：数学研究、AI/ML 研究、编程语言技术、学习笔记与阅读资料的综合整理。

## Conventions
- 文件名：小写，使用连字符，无空格（如 `transformer-architecture.md`, `linear-algebra-basics.md`）
- 每个 wiki 页面必须以 YAML frontmatter 开头（见下方）
- 使用 `[[wikilinks]]` 链接页面（每页至少 2 个出站链接）
- 更新页面时，必须更新 `updated` 日期
- 每个新页面必须添加到 `index.md` 的正确分类下
- 每个操作必须追加到 `log.md`
- 数学公式使用 LaTeX 格式：行内 `$...$`，块级 `$$...$$`
- 代码片段使用 fenced code blocks 并标明语言

## Frontmatter
```yaml
---
title: 页面标题
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary | paper | book
tags: [来自下方分类]
sources: [raw/articles/source-name.md]
---
```

## Tag Taxonomy

### 数学 (Mathematics)
- algebra - 代数
- analysis - 分析学
- geometry - 几何
- topology - 拓扑学
- number-theory - 数论
- probability - 概率论
- statistics - 统计学
- optimization - 优化理论
- linear-algebra - 线性代数
- calculus - 微积分
- discrete-math - 离散数学

### AI/ML
- deep-learning - 深度学习
- llm - 大语言模型
- transformer - Transformer 架构
- neural-network - 神经网络
- training - 训练方法
- inference - 推理优化
- fine-tuning - 微调
- alignment - 对齐/安全
- benchmark - 评测基准
- architecture - 模型架构
- paper - 学术论文

### 编程与技术
- python - Python 语言
- rust - Rust 语言
- javascript - JavaScript/TypeScript
- cpp - C/C++
- algorithm - 算法
- system-design - 系统设计
- concurrency - 并发编程
- performance - 性能优化
- tooling - 开发工具

### 元标签 (Meta)
- book - 书籍
- course - 课程
- tutorial - 教程
- concept - 概念解释
- comparison - 对比分析
- timeline - 时间线
- person - 人物
- organization - 组织/公司
- open-source - 开源项目
- research - 研究笔记

**规则**：每个页面使用的标签必须来自上述分类。如需新标签，先在此添加，再使用。防止标签泛滥。

## Page Thresholds
- **创建页面**：当实体/概念出现在 2+ 个来源中，或在一个来源中占据核心地位
- **添加到现有页面**：当来源提及已有内容时
- **不创建页面**：仅出现一次的次要细节，或超出领域范围的内容
- **拆分页面**：当页面超过 ~200 行时——拆分为子主题并交叉链接
- **归档页面**：当内容完全被取代时——移至 `_archive/`，从索引中移除

## Entity Pages（实体页面）
每个值得注意的实体一个页面。包含：
- 概述 / 是什么
- 关键事实和日期
- 与其他实体的关系（[[wikilinks]]）
- 来源引用

## Concept Pages（概念页面）
每个概念或主题一个页面。包含：
- 定义 / 解释
- 当前知识状态
- 未解决问题或争议
- 相关概念（[[wikilinks]]）
- 数学推导（如适用）

## Comparison Pages（对比页面）
并排分析。包含：
- 对比什么以及为什么
- 对比维度（表格格式优先）
- 结论或综合
- 来源

## Update Policy
当新信息与现有内容冲突时：
1. 检查日期——较新的来源通常优先于较旧的
2. 如果确实存在矛盾，注明两种观点及日期和来源
3. 在 frontmatter 中标记：`contradictions: [page-name]`
4. 在 lint 报告中标记供用户审核