写作原则Four rules

01三层分开Three layers

• 事实层：原文怎么说、数据是多少。带编号引用，可直接点回来源。 Facts: what the source says and what the numbers are. Numbered, clickable references.
• 推断层：我根据事实推出来的结论。用黄色卡片标注「推断」，并写清推理链。 Inferences: what I derive from the facts — marked in amber, with the reasoning shown.
• 观点层：我的偏好与判断，没有对错可言。用紫色卡片标成观点，不和事实混在一段里。 Opinions: preferences and judgement calls, marked in violet and never blended into a factual paragraph.

02数字必须能追Numbers must be traceable

凡出现性能、价格、市场规模一类的数字，都要回答三个问题：谁说的（官方／第三方／我自己测）、在什么口径下、样本是什么。做不到就写「官方口径」并说明来源是营销材料。 For any performance, price or size number, three questions must be answered: who measured it, under what definition, on what sample. If that cannot be established, the note says "vendor claim" and says so plainly.

03示意与实测分开Illustration vs measurement

图分两类：一类是把概念画清楚（图上会写「示意图」），一类是跑出来的结果（图上会写数据来源与口径）。两者不混着用，也不把示意图当成证据。 Two kinds of figures: sketches that explain a concept, and results that were actually run. Both are labelled; a sketch is never used as evidence.

04更新与勘误Updates and errata

每篇底部有版本号和更新日志。事实错了直接改并记在日志里；观点变了另起一段写「我改主意的原因」，不悄悄覆盖旧文。 Every note carries a version number and a changelog. Factual errors get fixed and recorded; changed opinions are written as a new paragraph explaining why, never silently overwritten.

05不写什么What is left out

• 产业格局预测、融资与市场规模推算：噪声大于信息。Market-size forecasts and funding gossip: more noise than signal.
• 任何雇主或客户的真实数据、系统名、字段名与流程细节。Any real data, system name, field name or process detail from an employer or client.
• 没有出处的「业内都知道」。"Everyone knows" without a source.

06引用格式How to cite these notes

Aylon (2026). <title>. Notes. https://aayloo.github.io/notes/<slug>/