dsh-math-calculator 2.3.0 → 2.3.2

package/src/help.ts

@@ -512,6 +512,94 @@ const RECIPE_BODY = (): string => `【锚点 sanity】工具不知道这个数
   [{label:"单价", expr:"u=5"}, {label:"小计", expr:"u*3"}]
   ★ 中间某步失败时，依赖它的下游会明确报错，不会变成「虚成功」
 
+【文明崩溃推演】财政链，每步可核对（用 formula 逐条调，数值自己代入）
+  ① effective_tax_rate     名义税率 30% 但实际只 10% → 征管弱，20% 是漏征+逃亡
+  ② fiscal_balance         收入 10% GDP、支出 15% → 赤字 5%
+  ③ primary_balance        PB = −5% + 利息 3% = −2% GDP
+     → 不是被旧债拖垮，而是**经营本身在亏**（结构性危机，比单纯赤字严重）
+  ④ fiscal_sustainability  i=8%、g=2%、d=80% → 需 PB ≥ 6%×0.8 = 4.8%，实际 −2%
+     → 缺口 6.8%/年，十年翻倍
+  ⑤ seigniorage            税加不动、借债又 i>g → 只能铸币 → 通胀上升
+     → 通胀推高 i → 回到 ④，死亡螺旋
+  ⑥ fiscal_autonomy        刚性 85% → 没有可裁量的钱，改革也推不动
+  ★ 这套链能推出「为什么这个政权看着还能撑、其实已在螺旋里」，
+    比「因为腐败所以要亡」可信得多——腐败只是其中一环。
+
+【巨兽可行性推演】生物链，回答「这么大的生物能不能活」
+  ① sa_volume_ratio        体重 ×8 → 表面积 ×4 → 单位体重散热与摄氧都 ÷2
+  ② fick_diffusion         A∝M^(2/3)、δ∝M^(1/3) → 供氧能力 ∝ M^(1/3)
+  ③ diffusion_time         若无循环，1 m 组织扩散需 158 年 → 必须有循环系统
+  ④ peclet_number          血管里 Pe≫1 → 对流主导，扩散送不到深处
+  ⑤ michaelis_menten       血红蛋白结合是饱和式 → 浓度再高也提不上去
+  ⑥ gompertz_growth        生长必然饱和 → 有上限体型
+  ★ 结论通常是「不能靠扩散活，必须进化出循环 + 换气」，而不是「不可能」
+    —— 差别在于前者给了可行路径。
+
+【材料推演】三层链：**微观决定 → 本构 → 构件失效**
+  分两档起步：① 只想要工程结论 → 从 B 开始，硬设定 E/σ_y/K_IC/ρ
+              ② 想让材料「自洽地生出来」→ 从 A 开始，从键强度推
+
+  A. 微观决定（材料属性从基础物理量推出）
+     输入：每原子结合能（J）、原子间距、键的非谐性 γ
+     ① melting_from_cohesive   T_m ≈(2/3)·E_k/k_B
+        ★ 反推设计：要熔点 2000°C → 需要多大结合能？这一条能算
+        ⚠ 系数 0.036（不是 2/3！）由 12 种金属实测反算得来：
+          Fe 1797K vs 实测 1811（−0.8%）、W −0.5%、Mo −1.6%、Ag −0.4%
+          但 Al +52%、Mg +52% 偏高 —— 轻金属的结合能构成不同，别用它推轻合金
+        ⚠ 输入是**每原子**结合能（J），若资料给 kJ/mol 要先除以 6.022e23
+     ② ideal_strength          σ_ideal ≈ E/10
+        ★ 真正有用的是**比值**：实际强度只有理论的 1/100(工艺差) ~ 1/10(精密)
+        「这个文明的冶金水平」= 他们能发挥百分之几
+     ③ pugh_ductility          G/K >0.57 偏脆、<0.57 偏韧
+        ★ 更强的键往往同增 K 与 G —— 这条检查「变强了但更脆」的副作用
+     ④ gruneisen_expansion     α = γ·C_v/(3KV)
+        ★ 补闭环：原来 α 只能硬填，现在由 K、C_v、γ 推出来
+     ⑤ wiedemann_franz         κ/σ = L₀·T（L₀ 是基本常数）
+        ★ 罕见的严格关系：设了电导率，导热系数自动定，不必两个都编
+
+     ★ 关键的物理直觉：**结合能越深 → 势能井越陡 → E 越大 → 熔点与强度都上升**
+       所以「改基础物理量」不是各自拍脑袋，而是有方向、有幅度的推导。
+
+  B. 本构（应力 → 应变 → 失效）
+    输入：E、σ_y、K_IC、ρ
+     ① hooke_law              σ = E·ε。σ=200MPa → ε=1e-3
+                             ★ 弹性区公理；超屈服后失效，别用它算大变形
+     ② safety_factor_check    σ_allow = σ_y/n。200/235=1.18 → 低于 1.5，不安全
+                             n 取 1.5~2（静载）／2~4（冲击）／3~6（疲劳）
+     ③ fracture_kic           σ_c = K_IC/(Y·√(πa))
+                             5mm 裂纹 → 30e6/√(π·0.005)=239MPa（与屈服几乎相等）
+                             ★ σ_c ∝1/√a：裂纹 1mm→1cm，承载降 √10≈3.2 倍
+                             ⚠ 仅脆性/小范围屈服；高韧材料会低估（需 J 积分）
+     ④ hall_petch             σ_y = σ₀ + k_y·d^(−1/2)
+                             ★ 同一成分，晶粒细化一档强度可翻倍
+                             「锻造水平」= 这个文明能达到的 d
+                             ⚠ 有反 Hall-Petch 区（纳米晶反而变弱）
+     ⑤ ashby_index            M = E^a·σ^b/ρ^c
+                             轻而刚的梁 E^½/ρ ｜ 轻而强的梁 σ^(2/3)/ρ ｜ 储能 σ²/E
+                             ★ 把「这合金轻又强」从形容词变成可比的数
+
+  C. 构件失效（接已有的工程公式）
+     buckling_euler / beam_bending_stress / beam_uniform_load_deflection / bolt_shear_capacity
+     ★ 到这一步才谈「这根梁要多粗」—— 前面两层定材料，这层定尺寸
+
+  完整例子（铁：结合能 415 kJ/mol、E=2e11、σy=235MPa、K_IC=30MPa·√m、ρ=7850）
+      输入换算：415 kJ/mol ÷ 6.022e23 = 6.89e-19 J/原子
+      melting_from_cohesive  → 1797 K（实测铁 1811 K，−0.8% ✓ 自洽）
+      ideal_strength         → 2e10 Pa = 20 GPa（理论值上限）
+      实际/理论 = 235e6/2e10 = **1.2%** → 属「工艺一般」而非精密
+        （精密工艺能到 10%，差一个数量级 —— 这就是该调的世界观参数）
+      pugh_ductility         设 G=8e10、K=1.6e11 → 0.5 <0.57，韧性好 ✓
+      hooke_law              200MPa → ε=1e-3
+      safety_factor_check    许用 156.7MPa，而实际 200MPa
+                             200/156.7=1.28 → 只有 1.28 倍余量，低于要求的 1.5
+      fracture_kic           5mm 裂纹时 σ_c=239MPa，与屈服 235MPa 之比 **1.02**
+     ★ 结论：这钢的瓶颈不在强度而在**裂纹容限**——
+       5mm 裂纹就让承载降到屈服线，所以要定期探伤、限制缺陷尺寸。
+       这是单看屈服强度绝对推不出来的结论。
+
+  ★ 一条纪律：工具**不判断你的材料合不合理**，只保证「基于你给的性质，后果算对」。
+    A 层给方向、B 层给数值、C 层给尺寸 —— 想让哪层自洽，就从哪层起步。
+
 【失败时】返回 ok=false + error.type / message / hint，按 hint 修正即可，不会崩溃。
   常见 error.type：
     non_finite         结果非有限（除以零、log(0)）
@@ -622,8 +710,94 @@ const DOMAINS_BODY = (): string => `【工程 / 生物 / 宏观】三块的常
                             ★ 0.15 对 0.03 即约 12%，三年物价翻倍
                             「滥发货币导致崩溃」时用它量化
 
-★ 这些式子的共同特点：**缩放律比绝对值更重要**。算出来的数可以偏，
-  但「跨度翻倍挠度 16 倍」这类关系错了就是硬伤——那是判断合不合理的第一道关。`
+════ 材料·本构与微观决定（materials/）════
+【本构：应力→应变→失效】
+  hooke_law                 σ = E·ε（弹性区公理，与材料种类无关）
+                            ★ 补上了库里断掉的一环：有 strain 定义却没有应力
+  safety_factor_check       σ_allow = σ_y/n（静载 1.5~2、冲击 2~4、疲劳 3~6）
+                            ★ 安全系数是工程惯例不是物理律，失效后果重就取大
+  fracture_kic              σ_c = K_IC/(Y·√(πa))
+                            ★ σ_c ∝ 1/√a：裂纹长一档，承载降 √10≈3.2 倍
+                            这就是为什么压力容器要定期探伤、大件比小试样更脆
+  ashby_index               M = E^a·σ^b/ρ^c（指数由几何形式决定）
+                            轻而刚的梁 E^½/ρ ｜ 轻而强的梁 σ^(2/3)/ρ ｜ 弹性储能 σ²/E
+                            ★ 把「选材」从审美变成可计算：设定说「这合金轻又强」→ 一算就知排第几
+
+【微观决定：材料属性从基础物理量推出】
+  ideal_strength            σ_ideal ≈ E/10（Frenkel；E/5~E/15 都有人用）
+                            ★ 真正有用的是比值：实际强度只有理论的 1/100~1/10
+                            **这个比值就是「冶金水平」** —— 工艺差的世界只能发挥 1%
+  melting_from_cohesive     T_m ≈ (2/3)·(结合能/k_B)（Lindemann）
+                            ★ 熔点能从结合能推 → 可反推设计：「要熔点 2000°C 的金属」
+  pugh_ductility            G/K > 0.57 偏脆，< 0.57 偏韧
+                            ★ K 与 G 都由键势推出，所以脆性也能从底层推
+  gruneisen_expansion       α = γ·C_v/(3KV)
+                            ★ 补上闭环：原来 α 是硬设定，现在能由 K、C_v、γ 推
+  hall_petch                σ_y = σ₀ + k_y·d^(−1/2)
+                            ★ 晶粒细化一个数量级，强度可翻倍 ——「锻造水平」= 能达到的 d
+                            ⚠ 有反 Hall-Petch 区（纳米晶粒下反而变弱）
+  wiedemann_franz           κ/σ = L₀·T（L₀ = 2.44e-8 是基本常数）
+                            ★ 罕见的严格关系：设了电导率，导热系数自动定
+
+════ 生物·通用（biology/scaling, transport, genetics, growth, kinetics）════
+  sa_volume_ratio           A ∝ M^(2/3) → 面积/体积 ∝ M^(−1/3)（**纯几何**）
+                            ★ 体重 ×8 → 面积 ×4 → 单位体重散热 ÷2（为什么会过热）
+                            同理鳃面积也只 ×4 → 摄氧 ÷2（为什么会缺氧）
+  fick_diffusion            J = D·A·ΔC/δ（鳃/肺/皮肤/根/细胞膜同一个式子）
+                            ★ A∝M^(2/3)、δ∝M^(1/3) → 供氧 ∝ M^(1/3)
+                            这就是「大生物必须换气而不能靠扩散」的定量证明
+  diffusion_time            t ≈ Δx²/(2D)
+                            ★ 1 µm→5 ms ｜ 10 µm→0.5 s（细胞够用）｜ 1 mm→83 min ｜ 1 m→158 年
+                            能立刻否掉「靠扩散供氧的巨兽」，用的是硬数学而非估计
+  peclet_number             Pe = L·u/D（扩散 vs 对流）
+                            ★ Reynolds 数的质量输运版：库里已有动量版，缺这个
+                            Pe≪1 扩散主导（微循环）、Pe≫1 必须泵（大血管）
+  hardy_weinberg            p² + 2pq + q² = 1（**纯概率论**，无生物假设）
+                            ★ 常算 2pq：隐性携带者比例。p=.9 q=.1 → 携带者 18% 而表现型只 1%
+  gompertz_growth           N = a·exp(−b·exp(−c·t))
+                            ★ 比指数/logistic 更贴合**有机体**真实生长（logistic 偏种群）
+  michaelis_menten          v = Vmax·S/(Km+S)
+                            ★ 一条式子覆盖五种现象：酶、载体转运、Holling 摄食、受体结合、养分吸收
+                            S≪Km 近线性、S≫Km 饱和 —— 这是「处理能力有限」的通用形状
+  q10_temperature           R = R₀·Q₁₀^((T−T₀)/10)
+                            ★ 生物界**实际使用**的温度律（生态模型几乎都用它，不用 Ea）
+                            与 arrhenius 并存：化学用 Arrhenius、生物用 Q₁₀
+
+════ 政权财政（power/fiscal）════
+  fiscal_balance            D = T − G（**会计恒等式**）
+                            ★ 关键细节：赤字**不含借债** —— 借来的钱是「赤字融资」不是收入
+                            把借债算成收入，就是财政崩溃前的典型自欺
+  primary_balance           PB = T −(G − 利息) = 财政余额 + 利息
+                            ★ 判断「还有没有救」的第一条判据：
+                            PB 正而总赤字负 → 经营赚钱、被旧债利息拖垮（可救）
+                            PB 负 → 经营本身在亏（结构性危机）
+  fiscal_sustainability     Δd = (i−g)·d − PB
+                            ★ i>g 时债务自我膨胀 —— 古代帝国（高利率低增长）财政脆弱的根源
+                            工业革命后的高增长期能承受高债务，就是这条的另一面
+  seigniorage               铸币税 ≈ 通胀 × 实际货币余额
+                            ★ 财政与货币的唯一接口：税收加不动、借债又 i>g → 只能铸币
+                            历史上几乎所有恶性通胀都发生在财政危机之后
+  effective_tax_rate        ETR = 实际税收/GDP（≠ 名义税率）
+                            ★ 差额正是漏征+逃亡。「名义 vs 实际」的差距 = 政权渗透能力
+                            前工业国家 ETR 通常只有 5%~10%
+  fiscal_autonomy           可裁量支出占比 = 1 − 刚性占比
+                            ★ 「改革为什么推不动」的定量答案：
+                            刚性 80%+ → 几乎没有政策自由度，任何冲击直接触发危机
+
+════ 宏观恒等式（econ/macro, econ/growth）════
+  gdp_expenditure           Y = C + I + G +(X−M)（会计恒等式）
+                            ★ 能立刻暴露不闭合的设定：C+I+G 超过 Y → 差额只能来自净进口或举债
+  growth_accounting         g_Y = g_A + α·g_K +(1−α)·g_L
+                            ★ 人口与资本都停时 g_Y ≈ g_A —— 这就是停滞文明为何停滞
+                            来源：BLS 官方 TFP 方法即基于此
+  convergence_speed         λ =(1−α)(n+δ+g)，差距按 e^(−λt) 收敛
+                            ★ 补 solow_steady_state 缺的那半：它给终点，这条给多久到达
+  fisher_money              MV = PY（V 是**可调的世界观参数**）
+                            ★ 金属货币社会 V 低、信用货币社会 V 高
+
+★ 这些式子的共同特点：**缩放律与恒等式比绝对值更重要**。算出来的数可以偏，
+  但「跨度翻倍挠度 16 倍」「PB = T −(G−利息)」这类关系错了就是硬伤。
+  可查 operation="help", helpTopic="policy" 看文明推演配方。`
 /**
  * 各节注册表。**顺序即目录顺序**，而顺序决定「AI 会不会翻到它」。
  *
@@ -719,9 +893,9 @@ export const HELP_TOPICS: HelpTopic[] = [
     tier: 'core',
     /** 新增节，文档中尚无信号；按用户明确要求保留 core。 */
     weight: 0,
-    title: '工程 / 生物 / 宏观（29 条领域公式）',
-    summary: '梁柱应力挠度、热机效率煤耗、管流泵功率、载畜量营养级、劳动力货币通胀。每条都写了 scaling 律。',
-    aliases: ['工程', '生物', '经济', '宏观', '建筑', '结构', '热机', '流体', '生态', '畜牧', '通胀'],
+    title: '工程 / 生物 / 材料 / 财政 / 宏观（57 条领域公式）',
+    summary: '梁柱应力、热机煤耗、管流泵功率；扩散供氧、异速生长、遗传平衡；胡克与断裂韧性、熔点与结合能；财政赤字与债务螺旋、GDP 恒等式与增长核算。每条都写了 scaling 律或恒等式来源。',
+    aliases: ['工程', '生物', '材料', '经济', '宏观', '财政', '税收', '债务', '建筑', '结构', '热机', '流体', '生态', '畜牧', '通胀', '作物'],
     body: DOMAINS_BODY,
   },
   {