20260420:first commit
This commit is contained in:
115
SCHEMA.md
Normal file
115
SCHEMA.md
Normal file
@@ -0,0 +1,115 @@
|
||||
# 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 报告中标记供用户审核
|
||||
Reference in New Issue
Block a user