SCHEMA

Wiki Schema

Domain

A 股交易与投资分析 — 涵盖交易纪律、选股框架、板块轮动、个股研究、市场日报、网格回测、持仓管理等。

Conventions

• File names: lowercase, hyphens, no spaces (e.g., trading-discipline.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. This lets a reader trace each claim back without re-reading the whole raw file. Optional on single-source pages where the sources: frontmatter is enough.

Frontmatter

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

confidence and contested are optional but recommended for opinion-heavy or fast-moving topics. Lint surfaces contested: true and confidence: low pages for review so weak claims don’t silently harden into accepted wiki fact.

raw/ Frontmatter

Raw sources ALSO get a small frontmatter block so re-ingests can detect drift:

---
source_url: https://example.com/article   # original URL, if applicable
ingested: YYYY-MM-DD
sha256: <hex digest of the raw content below the frontmatter>
---

The sha256: lets a future re-ingest of the same URL skip processing when content is unchanged, and flag drift when it has changed. Compute over the body only (everything after the closing ---), not the frontmatter itself.

Tag Taxonomy

交易纪律与框架

• trading-discipline, trading-framework, risk-management, position-sizing, stop-loss, take-profit, entry-exit

选股与分析

• stock-picking, sector-rotation, theme-investing, fundamental-analysis, technical-analysis, capital-flow, sentiment

板块与概念

• sector, concept, industry, theme, leader, sentiment-ticket

个股研究

• stock-analysis, one-pager, earnings, valuation, moat, management

市场日报与复盘

• daily-report, market-note, observation, signal, news-digest, review

网格与回测

• grid-trading, backtest, etf, t0, intraday

持仓管理

• portfolio, holding, closed-position, trade-history

工具与数据

• wind, tushare, akshare, data-source, api, script

Meta

• comparison, timeline, best-practice, tutorial, overview, reference

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

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
• Archive a page when its content is fully superseded — move to _archive/, remove from index

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)

Comparison Pages

Side-by-side analyses. Include:

• What is being compared and why
• Dimensions of comparison (table format preferred)
• Verdict or synthesis
• Sources

Update Policy

When new information conflicts with existing content:

1. Check the dates — newer sources generally supersede older ones
2. If genuinely contradictory, note both positions with dates and sources
3. Mark the contradiction in frontmatter: contradictions: [page-name]
4. Flag for user review in the lint report