From 52f98aea3716624c12f81e2c52e4ecd0f1d656af Mon Sep 17 00:00:00 2001 From: PanQiWei <594557445@qq.com> Date: Thu, 9 Apr 2026 17:55:44 +0800 Subject: [PATCH] fix: embed card PNGs in ch-06 articles (data-card + index overview) Cards were generated but never referenced in markdown files. - Added data-card attributes to all 12 article divs (6 ZH + 6 EN) - Embedded overview PNG in both index.md files Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/en/mental-models/ch-06-causality/01-humes-fork.md | 2 +- .../mental-models/ch-06-causality/02-ocean-of-correlation.md | 2 +- docs/en/mental-models/ch-06-causality/03-the-ladder.md | 2 +- docs/en/mental-models/ch-06-causality/04-causal-discipline.md | 2 +- .../mental-models/ch-06-causality/05-the-cost-of-honesty.md | 2 +- .../mental-models/ch-06-causality/06-the-dao-of-causality.md | 2 +- docs/en/mental-models/ch-06-causality/index.md | 4 ++++ docs/zh/mental-models/ch-06-causality/01-humes-fork.md | 2 +- .../mental-models/ch-06-causality/02-ocean-of-correlation.md | 2 +- docs/zh/mental-models/ch-06-causality/03-the-ladder.md | 2 +- docs/zh/mental-models/ch-06-causality/04-causal-discipline.md | 2 +- .../mental-models/ch-06-causality/05-the-cost-of-honesty.md | 2 +- .../mental-models/ch-06-causality/06-the-dao-of-causality.md | 2 +- docs/zh/mental-models/ch-06-causality/index.md | 2 ++ 14 files changed, 18 insertions(+), 12 deletions(-) diff --git a/docs/en/mental-models/ch-06-causality/01-humes-fork.md b/docs/en/mental-models/ch-06-causality/01-humes-fork.md index 2c9636a..af0701d 100644 --- a/docs/en/mental-models/ch-06-causality/01-humes-fork.md +++ b/docs/en/mental-models/ch-06-causality/01-humes-fork.md @@ -1,6 +1,6 @@ # Hume's Fork -
+
For roughly two thousand years, "cause" needed no explanation. diff --git a/docs/en/mental-models/ch-06-causality/02-ocean-of-correlation.md b/docs/en/mental-models/ch-06-causality/02-ocean-of-correlation.md index c9df8d9..8577806 100644 --- a/docs/en/mental-models/ch-06-causality/02-ocean-of-correlation.md +++ b/docs/en/mental-models/ch-06-causality/02-ocean-of-correlation.md @@ -1,6 +1,6 @@ # The Ocean of Correlation -
+
Hume proved something unsettling: even humans — equipped with physical bodies and the ability to directly manipulate the world — have never actually observed causation itself. All we have is constant conjunction and habit. diff --git a/docs/en/mental-models/ch-06-causality/03-the-ladder.md b/docs/en/mental-models/ch-06-causality/03-the-ladder.md index 2768ad7..2306262 100644 --- a/docs/en/mental-models/ch-06-causality/03-the-ladder.md +++ b/docs/en/mental-models/ch-06-causality/03-the-ladder.md @@ -1,6 +1,6 @@ # The Ladder -
+
How deep is the ocean of correlation? Put differently: if causal reasoning has *levels*, where does an LLM sit? diff --git a/docs/en/mental-models/ch-06-causality/04-causal-discipline.md b/docs/en/mental-models/ch-06-causality/04-causal-discipline.md index 732f75f..cde4b92 100644 --- a/docs/en/mental-models/ch-06-causality/04-causal-discipline.md +++ b/docs/en/mental-models/ch-06-causality/04-causal-discipline.md @@ -1,6 +1,6 @@ # Causal Discipline -
+
The ladder made the situation clear: LLMs naturally inhabit the first rung — association. Many valuable engineering problems require second- or even third-rung reasoning. diff --git a/docs/en/mental-models/ch-06-causality/05-the-cost-of-honesty.md b/docs/en/mental-models/ch-06-causality/05-the-cost-of-honesty.md index 97e45b5..662849a 100644 --- a/docs/en/mental-models/ch-06-causality/05-the-cost-of-honesty.md +++ b/docs/en/mental-models/ch-06-causality/05-the-cost-of-honesty.md @@ -1,6 +1,6 @@ # The Cost of Honesty -
+
Causal discipline sounds eminently reasonable — evidence grading, temporal constraints, hypothesis verification, reasoning provenance. Who would object to "making the system more honest"? diff --git a/docs/en/mental-models/ch-06-causality/06-the-dao-of-causality.md b/docs/en/mental-models/ch-06-causality/06-the-dao-of-causality.md index c1c9669..87cda57 100644 --- a/docs/en/mental-models/ch-06-causality/06-the-dao-of-causality.md +++ b/docs/en/mental-models/ch-06-causality/06-the-dao-of-causality.md @@ -1,6 +1,6 @@ # The Dao of Causality -
+
Five articles in, the structure of causal discipline is clear. diff --git a/docs/en/mental-models/ch-06-causality/index.md b/docs/en/mental-models/ch-06-causality/index.md index b522448..4ca75c8 100644 --- a/docs/en/mental-models/ch-06-causality/index.md +++ b/docs/en/mental-models/ch-06-causality/index.md @@ -12,6 +12,10 @@ This chapter asks a structural question: when your reasoning engine learns from --- +![Causality — LLM lives in an ocean of correlation, harness builds causal discipline](assets/causality-overview.png) + +--- + | # | Article | One-liner | |---|---------|-----------| | 01 | [Hume's Fork](01-humes-fork.md) | Humans themselves have never observed causation — Hume showed we rely on constant conjunction and habit, not rational proof | diff --git a/docs/zh/mental-models/ch-06-causality/01-humes-fork.md b/docs/zh/mental-models/ch-06-causality/01-humes-fork.md index c3cdafa..977c7de 100644 --- a/docs/zh/mental-models/ch-06-causality/01-humes-fork.md +++ b/docs/zh/mental-models/ch-06-causality/01-humes-fork.md @@ -1,6 +1,6 @@ # 休谟的叉子 -
+
两千多年来，"因果"这个词几乎不需要解释。 diff --git a/docs/zh/mental-models/ch-06-causality/02-ocean-of-correlation.md b/docs/zh/mental-models/ch-06-causality/02-ocean-of-correlation.md index c639d56..b18b219 100644 --- a/docs/zh/mental-models/ch-06-causality/02-ocean-of-correlation.md +++ b/docs/zh/mental-models/ch-06-causality/02-ocean-of-correlation.md @@ -1,6 +1,6 @@ # 相关性的海洋 -
+
休谟证明了一件令人不安的事：即使是人类——拥有物理身体、能亲手推台球、能用实验干预世界的人类——也从未直接观察到因果关系本身。我们依赖的是恒常连结和习惯。 diff --git a/docs/zh/mental-models/ch-06-causality/03-the-ladder.md b/docs/zh/mental-models/ch-06-causality/03-the-ladder.md index 4324ad4..c65215a 100644 --- a/docs/zh/mental-models/ch-06-causality/03-the-ladder.md +++ b/docs/zh/mental-models/ch-06-causality/03-the-ladder.md @@ -1,6 +1,6 @@ # 因果的阶梯 -
+
相关性的海洋有多深？换一种问法：如果因果推理有"层次"，那么 LLM 停留在哪一层？ diff --git a/docs/zh/mental-models/ch-06-causality/04-causal-discipline.md b/docs/zh/mental-models/ch-06-causality/04-causal-discipline.md index ba86881..06dae02 100644 --- a/docs/zh/mental-models/ch-06-causality/04-causal-discipline.md +++ b/docs/zh/mental-models/ch-06-causality/04-causal-discipline.md @@ -1,6 +1,6 @@ # 因果纪律 -
+
阶梯让我们看清了处境：LLM 天然停留在第一层——关联层。而很多有价值的工程问题需要第二层甚至第三层的推理。 diff --git a/docs/zh/mental-models/ch-06-causality/05-the-cost-of-honesty.md b/docs/zh/mental-models/ch-06-causality/05-the-cost-of-honesty.md index b6e20d6..dcc155d 100644 --- a/docs/zh/mental-models/ch-06-causality/05-the-cost-of-honesty.md +++ b/docs/zh/mental-models/ch-06-causality/05-the-cost-of-honesty.md @@ -1,6 +1,6 @@ # 诚实的代价 -
+
因果纪律听起来很合理——证据分级、时序约束、假说验证、推理溯源。谁会反对"让系统更诚实"？ diff --git a/docs/zh/mental-models/ch-06-causality/06-the-dao-of-causality.md b/docs/zh/mental-models/ch-06-causality/06-the-dao-of-causality.md index d810e10..4622575 100644 --- a/docs/zh/mental-models/ch-06-causality/06-the-dao-of-causality.md +++ b/docs/zh/mental-models/ch-06-causality/06-the-dao-of-causality.md @@ -1,6 +1,6 @@ # 因果之道 -
+
五篇文章走下来，因果纪律的结构已经清晰了。 diff --git a/docs/zh/mental-models/ch-06-causality/index.md b/docs/zh/mental-models/ch-06-causality/index.md index 93d0a77..ae3dcae 100644 --- a/docs/zh/mental-models/ch-06-causality/index.md +++ b/docs/zh/mental-models/ch-06-causality/index.md @@ -10,6 +10,8 @@ 这一章追问一个结构性问题：当你的推理引擎从相关性中学习，而你的应用需要因果性的可靠性时，系统的什么地方需要补上这个差距？答案不是让模型"变得更聪明"——而是让整个系统对自己保持诚实。我们管这叫因果纪律。 +![因果——LLM 生活在相关性的海洋里，harness 划出因果的航道](assets/causality-overview.png) + --- | # | 篇章 | 一句话 |