SCHEMA

Wiki Schema

Domain

个人知识库 — 涵盖投资（股票、港股、A股、美股）、计算机科学（前端、后端、云原生、设计模式）、AI编程、经济学、商业观察等领域。源自 Kai 的 Obsidian 笔记。

Conventions

• File names: lowercase, hyphens, no spaces, Chinese pinyin or English (e.g., alibaba.md, lof-arbitrage.md)
• Every wiki page starts with YAML frontmatter (see below)
• Use [[wikilinks]] to link between pages (minimum 2 outbound links per page)
• When updating a page, always bump the updated date
• Every new page must be added to index.md under the correct section
• Every action must be appended to log.md
• Provenance markers: On pages that synthesize 3+ sources, append ^[raw/articles/source-file.md] at the end of paragraphs whose claims come from a specific source.

Frontmatter

---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [from taxonomy below]
sources: [raw/articles/source-name.md]
confidence: high | medium | low
contested: true                        # set when the page has unresolved contradictions
contradictions: [other-page-slug]      # pages this one conflicts with
---

Tag Taxonomy

投资

• stock, hong-kong-stock, a-stock, us-stock, ipo, convertible-bond, lof-arbitrage, earnings, portfolio, trading

公司

• company, tech-company, ai-company, retail
• home-appliance
• paper-industry
• baijiu, liquor-industry
• pcb-industry
• mining

人物

• person, investor, entrepreneur

技术

• frontend, backend, cloud-native, docker, kubernetes, database, redis, mysql, algorithm, design-pattern, webgl, threejs, nodejs, ai-coding, browser, semiconductor, robot, 3d-printing, additive-manufacturing

概念

• economics, time-management, population, gdp, trade-war, commercial-space

AI

• llm, ai-programming, claude, gemini, deepseek, ai-agent
• ai-chip, domestic-substitute

生活

• life, reflection, observation

Rule: every tag on a page must appear in this taxonomy. If a new tag is needed, add it here first, then use it.

Page Thresholds

• Create a page when an entity/concept appears in 2+ sources OR is central to one source
• Add to existing page when a source mentions something already covered
• DON’T create a page for passing mentions, minor details, or things outside the domain
• Split a page when it exceeds ~200 lines — break into sub-topics with cross-links

Entity Pages

One page per notable entity. Include:

• Overview / what it is
• Key facts and dates
• Relationships to other entities (wikilinks)
• Source references

Concept Pages

One page per concept or topic. Include:

• Definition / explanation
• Current state of knowledge
• Open questions or debates
• Related concepts (wikilinks)