feat: let a source name its reasoning tier, and say so when it contradicts itself

.env.example

@@ -16,6 +16,15 @@ LLM__QWEN__1__TIMEOUT_S=120
 # LLM__QWEN__1__TTFT_TIMEOUT_S=30        # 须与 INTER_TOKEN 成对;0 < inter < ttft < timeout
 # LLM__QWEN__1__INTER_TOKEN_TIMEOUT_S=15
 # LLM__QWEN__1__ENABLE_THINKING=true     # 三态: 缺省=不注入 / true=注入开启 / false=注入关闭
+#   本键是 REASONING_EFFORT 的语法糖: true ≡ auto、false ≡ none、缺省 ≡ 不表态
+# LLM__QWEN__1__REASONING_EFFORT=low     # 本源默认推理档位;缺省=不表态(随模型自己的默认档)
+#   八档(封闭词汇): none | auto | minimal | low | medium | high | xhigh | max
+#     none = 要求不推理(与"缺省不表态"是两回事);auto = 要求推理但不指定强度
+#   与 ENABLE_THINKING 语义矛盾会在装配期报错(如 true + none、false + low),
+#   不做"后者赢"的静默兜底——两个键说同一件事,矛盾就是配置错误
+#   模型不支持所配档位时报错并列出它真正支持的档(库带能力表,含出处与实测日期)
+# LLM__QWEN__1__EFFORT_FALLBACK=error    # 档位打空时: error(默认,报错) | nearest(映射到最近的档)
+#   默认报错的理由是钱: 静默的 medium→max 在部分模型上是数倍账单;nearest 等距取弱侧
 # LLM__QWEN__1__MISSING_DONE=retry       # SSE 缺 [DONE]: retry(默认) | salvage
 # LLM__QWEN__1__TRUST_ENV=true           # false = 绕过本地代理(LAN 直连)
 # LLM__QWEN__1__EXTRA_BODY={"temperature":0}   # 本源恒定的采样参数(JSON 对象串)