新增高惊讶度节点视觉放大选项；新增高惊讶度目标弱化入边选项；文案、UI改进

backend/visit_stats.py

@@ -16,6 +16,27 @@ _API = defaultdict(int)
 _OS_REPORTS = defaultdict(int)  # 与同页「首轮心跳」(delta_active_sec == total_active_sec) 对齐，仅凭该包附带 client_os 计一次
 _VALID_CLIENT_OS = frozenset({"ios", "android", "windows", "macos", "linux", "unknown"})
 
+# client/src/ts/utils/settingsMenuManager.ts handleVisitStatsClick：PAGE_ORDER / API_ORDER / OS_ORDER
+_STATS_PAGE_ORDER = (
+    "index.html",
+    "analysis.html",
+    "compare.html",
+    "chat.html",
+    "attribution.html",
+    "gen_attribute.html",
+)
+_STATS_API_ORDER = (
+    "analyze",
+    "analyze_semantic",
+    "chat",
+    "causal_flow",
+    "prediction_attribute",
+    "prediction_attribute__attribution.html",
+    "prediction_attribute__chat.html",
+    "prediction_attribute__analysis.html",
+)
+_STATS_OS_ORDER = ("ios", "android", "windows", "macos", "linux", "unknown")
+
 # RLock：_persist_tick 在已持锁时调用 _sample_locked_counters，同线程需可重入。
 _LOCK = threading.RLock()
 
@@ -32,6 +53,8 @@ _HF_REPO = "dqy08/info-lens-stats"
 _HF_TOKEN = os.environ.get("HF_TOKEN_stats_write")
 _HF_TOTAL_FILE = "stats_total.json"
 _HF_DELTA_DIR = "stats_delta"
+
+
 def _stats_record(saved_at: str, body: dict) -> dict:
     """total / delta 磁盘与仓库共用：saved_at + 计数字段 + server_platform（若有）"""
     return {"saved_at": saved_at, **body}
@@ -73,6 +96,13 @@ def _restart_log_repo_path() -> str:
     return f"{_HF_DELTA_DIR}/{_delta_time_slug()}.restart.log"
 
 
+def _ordered_str_int_map(primary: tuple[str, ...], m: Mapping[str, object]) -> dict[str, int]:
+    primary_set = frozenset(primary)
+    head = [k for k in primary if k in m]
+    tail = sorted(k for k in m if k not in primary_set)
+    return {k: int(m[k]) for k in (*head, *tail)}
+
+
 def _download_stats_total() -> dict | None:
     """从 HF Dataset 读取 stats_total.json，失败返回 None。"""
     if not _HF_TOKEN:
@@ -310,6 +340,13 @@ def _merge_from_sample(s: dict) -> tuple[dict, dict, dict]:
         for k in set(bpo) | set(so)
     }
 
+    total_page_sec = _ordered_str_int_map(_STATS_PAGE_ORDER, total_page_sec)
+    total_api = _ordered_str_int_map(_STATS_API_ORDER, total_api)
+    total_os = _ordered_str_int_map(_STATS_OS_ORDER, total_os)
+    ord_pg = _ordered_str_int_map(_STATS_PAGE_ORDER, sp)
+    ord_api = _ordered_str_int_map(_STATS_API_ORDER, sa)
+    ord_os = _ordered_str_int_map(_STATS_OS_ORDER, so)
+
     tpl, tav = s["bp"] + s["sw_pl"], s["bav"] + s["sw_av"]
 
     public = {
@@ -323,16 +360,16 @@ def _merge_from_sample(s: dict) -> tuple[dict, dict, dict]:
     stats_body = {
         "page_loads": tpl,
         "active_visits": tav,
+        "os": total_os,
         "page_sec": total_page_sec,
         "api": total_api,
-        "os": total_os,
     }
     delta_body = {
         "page_loads": s["sw_pl"],
         "active_visits": s["sw_av"],
-        "page_sec": sp,
-        "api": sa,
-        "os": so,
+        "os": ord_os,
+        "page_sec": ord_pg,
+        "api": ord_api,
     }
     return public, stats_body, delta_body
 

client/src/css/gen_attribute.scss

@@ -103,7 +103,8 @@
   // 节点标签：与测量层同源 1em × display-scale × node-text-font-scale（后者略小于 1 替代固定 padding）
   #results.gen-attr-results-surface.LMF .gen-attr-dag-svg .gen-attr-dag-node-text {
     font-size: calc(
-      1em * var(--gen-attr-dag-display-scale, 1) * var(--gen-attr-dag-node-text-font-scale, 0.9)
+      1em * var(--gen-attr-dag-display-scale, 1) *
+        var(--gen-attr-dag-node-text-font-scale, 0.9) * var(--gen-attr-dag-node-ci-visual-scale, 1)
     );
     font-family: inherit;
     font-weight: inherit;
@@ -387,6 +388,14 @@ body.gen-attribute-page .input-section {
   margin-top: 10px;
 }
 
+// Start / Model 行与首行 DAG 参数（含 layout mode）之间略加大，避免与按钮挤在一起
+.gen-attribute-page
+  .input-section
+  > .textarea-wrapper.chat-prompt-actions-row
+  + .gen-attr-dag-measure-width-row {
+  margin-top: 30px;
+}
+
 .attribution-exclude-prompt-patterns-header {
   flex-wrap: wrap;
 

client/src/css/home.scss

@@ -185,6 +185,7 @@ html[data-theme='dark'] body.nav-landing-page {
 .nav-landing-card {
   display: flex;
   flex-direction: column;
+  position: relative;
   gap: $nav-card-gap;
   padding: $nav-card-pad-block $nav-card-pad-inline;
   border-radius: $nav-card-radius;
@@ -196,11 +197,52 @@ html[data-theme='dark'] body.nav-landing-page {
   transition: background 0.15s ease, border-color 0.15s ease;
   box-sizing: border-box;
 
-  &:hover {
+  &:hover:not(:has(.nav-landing-card-badge:hover, .nav-landing-card-badge:focus-visible)) {
     background: var(--nav-landing-card-bg-hover, #dcdcdc);
   }
 }
 
+.nav-landing-card-badge {
+  position: absolute;
+  top: -10px;
+  right: 12px;
+  z-index: 2;
+  height: 22px;
+  padding: 0 10px;
+  border-radius: 9999px;
+  border: 1px solid rgba(212, 107, 8, 0.35);
+  background: rgba(255, 247, 230, 0.78);
+  color: rgba(141, 73, 0, 0.86);
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 22px;
+  white-space: nowrap;
+  cursor: pointer;
+  opacity: 0.82;
+  transition: opacity 0.16s ease, background-color 0.16s ease, border-color 0.16s ease, color 0.16s ease;
+}
+
+.nav-landing-card-badge:hover,
+.nav-landing-card-badge:focus-visible {
+  opacity: 1;
+  border-color: #ffb86b;
+  background: #fff2d9;
+  color: #ad4e00;
+}
+
+html[data-theme='dark'] .nav-landing-card-badge {
+  border-color: rgba(212, 107, 8, 0.42);
+  background: #383028;
+  color: rgba(237, 214, 192, 0.95);
+}
+
+html[data-theme='dark'] .nav-landing-card-badge:hover,
+html[data-theme='dark'] .nav-landing-card-badge:focus-visible {
+  border-color: #ffb86b;
+  background: #4a4034;
+  color: #fff2e8;
+}
+
 html[data-theme='dark'] .nav-landing-card {
   border-color: var(--border-color, #333);
 }

client/src/gen_attribute.html

@@ -225,6 +225,26 @@
                             <span class="semantic-submode-label">px</span>
                         </span>
                     </div>
+                    <div class="gen-attr-dag-measure-width-row semantic-submode-row">
+                        <span class="semantic-submode-group">
+                            <label class="semantic-submode-label">
+                                <input type="checkbox" id="gen_attr_dag_node_ci_visual_scale" checked
+                                    title="When checked, generated nodes are visually enlarged based on their conditional information (surprisal). Takes effect on next generation."
+                                    data-i18n="title">
+                                Enlarge high-surprisal nodes
+                            </label>
+                        </span>
+                    </div>
+                    <div class="gen-attr-dag-measure-width-row semantic-submode-row">
+                        <span class="semantic-submode-group">
+                            <label class="semantic-submode-label">
+                                <input type="checkbox" id="gen_attr_dag_edge_weaken_high_surprisal" checked
+                                    title="When checked, edges leading to high-surprisal (uncertain) target tokens are visually weakened by the mutual information ratio. Takes effect on next generation."
+                                    data-i18n="title">
+                                Weaken attribution to high-surprisal target
+                            </label>
+                        </span>
+                    </div>
                     <div class="gen-attr-dag-measure-width-row semantic-submode-row">
                         <span class="semantic-submode-group">
                             <label class="semantic-submode-label">

client/src/scripts/injectPageMetaIntoHtml.js

@@ -114,7 +114,12 @@ function injectPageMeta(html, pageKey, doc) {
                 navKey === 'genAttribute'
                     ? `<video class="nav-landing-card-shot" muted loop playsinline autoplay preload="metadata" aria-hidden="true"></video>`
                     : `<div class="nav-landing-card-shot" aria-hidden="true"></div>`;
+            const badge =
+                navKey === 'genAttribute'
+                    ? `<span class="nav-landing-card-badge" title="Go to demo on RedNote: xhslink.com/o/A7VLi99aBvG" data-i18n="text,title">100K+ plays on RedNote</span>`
+                    : '';
             const inner =
+                badge +
                 `<div class="nav-landing-card-text">` +
                 `<span class="nav-landing-card-title" data-i18n>${escapeHtmlText(navMeta.title)}</span>` +
                 `<span class="nav-landing-card-subtitle" data-i18n>${escapeHtmlText(navMeta.subtitle)}</span>` +

client/src/ts/attribution/genAttributeDagLinkSegment.ts

@@ -1,13 +1,13 @@
-/** 轴对齐矩形节点：用于连线从边界起止（与 layout 所用的 x,y 左上角一致）。 */
+/** 轴对齐矩形节点：用于连线从边界起止，以矩形中心坐标表示。 */
 export type DagLinkRectNode = {
-    x: number;
-    y: number;
+    cx: number;
+    cy: number;
     nodeW: number;
     nodeH: number;
 };
 
 function nodeCenter(n: DagLinkRectNode): { cx: number; cy: number } {
-    return { cx: n.x + n.nodeW / 2, cy: n.y + n.nodeH / 2 };
+    return { cx: n.cx, cy: n.cy };
 }
 
 /** 轴对齐矩形（半宽 hw、半高 hh）中心沿单位向量 (ux,uy) 到边界的距离。 */

client/src/ts/attribution/genAttributeDagTextMeasure.ts

@@ -6,9 +6,9 @@ import { visualizeSpecialChars } from '../utils/tokenDisplayUtils';
 import type { PromptTokenSpan } from './genAttributeDagPreprocess';
 
 export type GenAttrDagTokenGeom = {
-    /** 锚点 fragment 左上角（见 {@link geomFromTokenFragments}），DAG 节点框同点对齐 */
-    originX: number;
-    originY: number;
+    /** token 基础矩形（1× 尺寸）的中心坐标；同行 token 的 cy 相同，与 CI 缩放无关。 */
+    cx: number;
+    cy: number;
     width: number;
     height: number;
 };
@@ -93,8 +93,8 @@ function geomFromTokenFragments(frags: TokenFragmentRect[], raw: string): GenAtt
         : 1;
     const widthSum = Math.max(geomWidthSum, expandedFloor);
     return {
-        originX: first.x,
-        originY: first.y,
+        cx: first.x + widthSum / 2,
+        cy: first.y + hFirst / 2,
         width: widthSum,
         height: hFirst,
     };

client/src/ts/attribution/genAttributeDagView.ts

@@ -1,6 +1,6 @@
 import * as d3 from 'd3';
 import { DirectedGraph } from 'graphology';
-import type { D3Sel } from '../utils/Util';
+import { calculateSurprisal, type D3Sel } from '../utils/Util';
 import { visualizeSpecialChars } from '../utils/tokenDisplayUtils';
 import {
     clampDagEdgeTopPCoverage,
@@ -11,6 +11,11 @@ import {
     type PromptTokenSpan,
 } from './genAttributeDagPreprocess';
 import { DAG_EDGE_MIN_DISPLAY_OPACITY } from './genAttributeDagEdgeDisplay';
+import {
+    computeMutualInformationRatio,
+    computeConditionalInformationRatio,
+    FULL_CONFIDENCE_PROBABILITY_BASELINE,
+} from '../utils/surprisalMath';
 import { isOffsetSpanFullyExcluded } from './attributionDisplayModel';
 import {
     alignAndAggregateByNode,
@@ -39,6 +44,9 @@ import { paintTextFlowLayout } from './genAttributeDagViewTextFlowMode';
 import { paintSpiralLayout } from './genAttributeDagViewSpiralMode';
 import { tr } from '../lang/i18n-lite';
 
+/** 与 {@link ToolTip} 中 surprisal 数值格式一致（`.3g`） */
+const DAG_TITLE_SURPRISAL_FMT = d3.format('.3g');
+
 /** 再次挂载前执行上一轮 detach（当前为空操作，保留扩展点） */
 const detachGenAttributeDagPanel = new WeakMap<HTMLElement, () => void>();
 
@@ -55,35 +63,39 @@ export function clampDagCompactness(n: number): number {
     return Math.min(DAG_COMPACTNESS_MAX, Math.max(DAG_COMPACTNESS_MIN, n));
 }
 
-/**
- * 零信心概率基准 p₀：surprisal log₂(1/p₀) 视作单 token 的绝对信息量参照（此处 20 bit）。
- * p = p₀ 时 {@link computeMutualInformationRatio} 为 0。
- */
-const ZERO_CONFIDENCE_PROBABILITY_BASELINE = 2 ** -20;
 
-function clamp01(n: number): number {
-    return Math.min(1, Math.max(0, n));
+
+/** 节点 CI 视觉放大开关；`false` 时所有生成节点 ciVisualScale 恒为 1×，下次 update() 起生效。 */
+let dagNodeCiVisualScaleEnabled = true;
+export function setDagNodeCiVisualScaleEnabled(enabled: boolean): void {
+    dagNodeCiVisualScaleEnabled = enabled;
+}
+
+/** 高惊讶度目标边弱化开关；`false` 时 mutualInformationRatio 恒为 1（不弱化），下次 update() 起生效。 */
+let dagEdgeWeakenHighSurprisalEnabled = true;
+export function setDagEdgeWeakenHighSurprisalEnabled(enabled: boolean): void {
+    dagEdgeWeakenHighSurprisalEnabled = enabled;
 }
 
 /**
- * 互信息率 α：在参照熵 log₂(1/p₀) 下，将「前文与目标 token 的可对齐程度」
- * (log₂(1/p₀) − log₂(1/p)) / log₂(1/p₀) = log₂(p/p₀) / log₂(1/p₀) clamp 到 [0,1]。
- * 低 surprisal → 高 α；仅用于本步入边透明度，不参与边筛选。缺省 `target_prob` 时返回 1（兼容旧缓存）。
+ * DAG 生成节点矩形/标签缩放：CI=0→1×，CI=1→2×（prompt 节点恒用 1，见建点处）。
+ * p > {@link FULL_CONFIDENCE_PROBABILITY_BASELINE}（surprisal < 3 bit）时截断为 1×，不放大。
+ * {@link dagNodeCiVisualScaleEnabled} 为 false 时恒返回 1。
  */
-function computeMutualInformationRatio(targetProb: number | undefined): number {
-    if (targetProb === undefined) return 1;
-    if (!Number.isFinite(targetProb) || targetProb <= 0) return 0;
+function dagGeneratedNodeCiVisualScale(targetProb: number | undefined): number {
+    if (!dagNodeCiVisualScaleEnabled) return 1;
+    if (targetProb !== undefined && Number.isFinite(targetProb) && targetProb > FULL_CONFIDENCE_PROBABILITY_BASELINE) return 1;
+    return 1 + computeConditionalInformationRatio(targetProb);
+}
 
-    return clamp01(
-        Math.log2(targetProb / ZERO_CONFIDENCE_PROBABILITY_BASELINE) /
-            Math.log2(1 / ZERO_CONFIDENCE_PROBABILITY_BASELINE)
-    );
+/** 原生 `<title>` 中 CI/MI 百分号展示，与 Top-K 概率列 {@link formatTopkTooltipProbabilityPercent} 同形。 */
+function formatCiMiRatiosLineForTooltip(ciRatio: number, miRatio: number): string {
+    const ci = Number.isFinite(ciRatio) ? formatTopkTooltipProbabilityPercent(ciRatio) : String(ciRatio);
+    const mi = Number.isFinite(miRatio) ? formatTopkTooltipProbabilityPercent(miRatio) : String(miRatio);
+    return `CI/MI: ${ci} / ${mi}`;
 }
 
-/**
- * 节点/边原生 `<title>` 中互信息率 α 的展示：α∈[0,1] 转为百分号字符串，
- * 与 analysis 主视图 Tooltip 中 Top-K 概率列 {@link formatTopkTooltipProbabilityPercent} 同形。
- */
+/** 边原生 `<title>` 中互信息率 α 的展示（节点 title 改用 {@link formatCiMiRatiosLineForTooltip}）。 */
 function formatMutualInformationRatioForTooltip(miRatio: number): string {
     if (!Number.isFinite(miRatio)) return String(miRatio);
     return formatTopkTooltipProbabilityPercent(miRatio);
@@ -109,12 +121,17 @@ type DagNodeAttrs = {
      */
     start: number;
     end: number;
-    /** 节点框左上角（与测量层 origin 同坐标系） */
-    x: number;
-    y: number;
-    /** 测量层几何 × display-scale 后的宽、高 */
+    /**
+     * 节点矩形中心坐标。center 不随 CI 缩放变化，故同行 token 的 cy 始终相等，
+     * 可直接用于 {@link snapSubwordNode} 同行��测，无需额外 baseY 字段。
+     */
+    cx: number;
+    cy: number;
+    /** 测量层几何 × display-scale × CI 缩放 后的宽、高 */
     nodeW: number;
     nodeH: number;
+    /** CI 视觉缩放倍数 `1 + CI` ∈ [1, 2]；prompt 节点为 `1`。供 CSS 字号变量使用。 */
+    ciVisualScale: number;
     /** {@link visualizeSpecialChars}（DAG：仅「空格后是 [A-Za-z0-9]」保留空格，其余空格为 ·），建点后不变 */
     displayLabel: string;
     /** 原生 `<title>` 全文（与 `DISABLE_DAG_NODE_TOOLTIPS` 无关，便于切换时不必重算） */
@@ -141,9 +158,10 @@ type DagLink = {
     titleText: string;
 };
 
-/** 与 {@link refreshNodeLinkHighlight} 中边的 `stroke-opacity` 一致：`normalizedScore × mutualInformationRatio`。 */
+/** 与 {@link refreshNodeLinkHighlight} 中边的 `stroke-opacity` 一致：`normalizedScore × mutualInformationRatio`（开关关闭时 MI 系数恒为 1）。 */
 function dagLinkStrokeOpacity(d: Pick<DagLink, 'normalizedScore' | 'mutualInformationRatio'>): number {
-    return (d.normalizedScore ?? 1) * (d.mutualInformationRatio ?? 1);
+    const mi = dagEdgeWeakenHighSurprisalEnabled ? (d.mutualInformationRatio ?? 1) : 1;
+    return (d.normalizedScore ?? 1) * mi;
 }
 
 function dagLinkEndpointKey(source: string, target: string): string {
@@ -295,7 +313,7 @@ function linkEndInsetBaseAtUnitScalePx(measureLayerEl: HTMLElement): number {
 }
 
 function nodeRx(d: DagNode): number {
-    return Math.min(9, d.nodeW / 2, d.nodeH / 2);
+    return Math.min(d.nodeW / 2, d.nodeH / 2);
 }
 
 export type GenAttributeDagHandle = {
@@ -401,8 +419,14 @@ function buildNodeNativeTitleText(
     ];
     const { targetProb } = d;
     if (targetProb !== undefined && Number.isFinite(targetProb)) {
-        lines.push(`Prob: ${formatTopkTooltipProbabilityPercent(targetProb)}`);
-        lines.push(`MI ratio: ${formatMutualInformationRatioForTooltip(computeMutualInformationRatio(targetProb))}`);
+        lines.push(`\nProb: ${formatTopkTooltipProbabilityPercent(targetProb)}`);
+        lines.push(`Information: ${DAG_TITLE_SURPRISAL_FMT(calculateSurprisal(targetProb))} bits`);
+        lines.push(
+            formatCiMiRatiosLineForTooltip(
+                computeConditionalInformationRatio(targetProb),
+                computeMutualInformationRatio(targetProb),
+            ),
+        );
     }
     return lines.join('\n');
 }
@@ -445,15 +469,15 @@ function buildLinkTitleText(
 const GLUE_EDGE_CHAR = /^(?:(?!\p{Script=Han})\p{L}|['\-_])$/u;
 
 /**
- * 子词拼接：offset 紧贴、同行、prev 末码点与当前首码点均满足 {@link GLUE_EDGE_CHAR}
- * → 左移到 prev 右缘（链式调用时 prev.x 已调整，自动支持多段续片）。
+ * 子词拼接：offset 紧贴、同行（cy 相等）、prev 末码点与当前首码点均满足 {@link GLUE_EDGE_CHAR}
+ * → 将当前节点中心 cx 紧贴 prev 右缘（链式调用时 prev.cx 已调整，自动支持多段续片）。
  */
 function snapSubwordNode(node: DagNode, prev: DagNode | null): void {
-    if (!prev || prev.end !== node.start || node.y !== prev.y) return;
+    if (!prev || prev.end !== node.start || node.cy !== prev.cy) return;
     const last = [...prev.label].at(-1) ?? '';
     const first = [...node.label][0] ?? '';
     if (!GLUE_EDGE_CHAR.test(last) || !GLUE_EDGE_CHAR.test(first)) return;
-    node.x = prev.x + prev.nodeW;
+    node.cx = prev.cx + (prev.nodeW + node.nodeW) / 2;
 }
 
 /** 焦点 + 一层入邻（直接祖先）+ 一层出邻（直接后代），用于选中/悬停高亮范围 */
@@ -801,6 +825,7 @@ export function initGenAttributeDagView(
         });
     }
 
+    let dragPointerOffset: { x: number; y: number } | null = null;
     const drag = d3
         .drag<SVGGElement, DagNode>()
         // 与 d3 默认 filter 一致，并仅在「当前节点已单击选中」时允许拖动手势生效，减少误拖
@@ -812,16 +837,22 @@ export function initGenAttributeDagView(
                 selectedId === d.id &&
                 layoutMode === 'text-flow'
         )
-        .on('start', (event) => {
+        .on('start', (event, d) => {
             event.sourceEvent?.stopPropagation();
+            const [x, y] = d3.pointer(event, rootG.node());
+            dragPointerOffset = { x: x - d.cx, y: y - d.cy };
         })
         .on('drag', (event, d) => {
             layoutDirty = true;
             userDraggedNodes = true;
             const [x, y] = d3.pointer(event, rootG.node());
-            d.x = x;
-            d.y = y;
+            const offset = dragPointerOffset ?? { x: 0, y: 0 };
+            d.cx = x - offset.x;
+            d.cy = y - offset.y;
             paint();
+        })
+        .on('end', () => {
+            dragPointerOffset = null;
         });
 
     /**
@@ -949,7 +980,10 @@ export function initGenAttributeDagView(
                     // 节点身份 append-only、几何（nodeW/nodeH）一旦建立不再变化（drag 仅改 x/y，
                     // 由 paint 通过 transform 处理），故与几何相关的属性���在 enter 写一次即可；
                     // 同理 `--prompt` class 依据 step === -1，step 初始化后不变。
-                    const g = enter.append('g').attr('class', 'gen-attr-dag-node');
+                    const g = enter
+                        .append('g')
+                        .attr('class', 'gen-attr-dag-node')
+                        .style('--gen-attr-dag-node-ci-visual-scale', (d: DagNode) => String(d.ciVisualScale));
                     g.classed('gen-attr-dag-node--prompt', (d: DagNode) => d.step === -1);
                     if (!DISABLE_DAG_NODE_TOOLTIPS) {
                         g.append('title').text((d: DagNode) => d.nativeTitleText);
@@ -1034,10 +1068,11 @@ export function initGenAttributeDagView(
                 step: -1,
                 start: ns,
                 end: ne,
-                x: g.originX,
-                y: g.originY,
+                cx: g.cx,
+                cy: g.cy,
                 nodeW: g.width * displayScale,
                 nodeH: g.height * displayScale,
+                ciVisualScale: 1,
                 displayLabel,
                 nativeTitleText: buildNodeNativeTitleText({
                     displayLabel,
@@ -1081,16 +1116,18 @@ export function initGenAttributeDagView(
         const displayLabel = visualizeSpecialChars(token, {
             spaceDotExceptBeforeAsciiLetterOrNumber: true,
         });
+        const ciVisualScale = dagGeneratedNodeCiVisualScale(response.target_prob);
         const targetNode: DagNode = {
             id: targetId,
             label: token,
             step: stepProcessed,
             start: targetStart,
             end: targetEnd,
-            x: g.originX,
-            y: g.originY,
-            nodeW: g.width * displayScale,
-            nodeH: g.height * displayScale,
+            cx: g.cx,
+            cy: g.cy,
+            nodeW: g.width * displayScale * ciVisualScale,
+            nodeH: g.height * displayScale * ciVisualScale,
+            ciVisualScale,
             displayLabel,
             nativeTitleText: buildNodeNativeTitleText({
                 displayLabel,

client/src/ts/attribution/genAttributeDagViewLinearArcMode.ts

@@ -25,7 +25,7 @@ export function clampLinearArcAdjacentGap(px: number): number {
     );
 }
 
-type LinearArcNodeLike = { nodeW: number };
+type LinearArcNodeLike = { nodeW: number; nodeH: number; ciVisualScale: number };
 
 /** `step === -1` 表示 prompt（与 `genAttributeDagView` 中 `DagNode.step` 约定一致） */
 type LinearArcSteppedNode = LinearArcNodeLike & { step: number };
@@ -76,7 +76,8 @@ export function paintLinearArcLayout<
         if (srcCx === undefined || tgtCx === undefined) {
             throw new Error('paintLinearArcLayout: link endpoint not in linear node list');
         }
-        const y = LINEAR_ARC_BASELINE_Y;
+        // 用未放大的半高（nodeH / ciVisualScale / 2）定位弧端点，使所有节点顶部对齐同一 y 基线。
+        const y = LINEAR_ARC_BASELINE_Y - src.nodeH / (2 * src.ciVisualScale);
         const dx = Math.abs(tgtCx - srcCx);
         const arcH = dx * 0.4;
         const upY = y - arcH;
@@ -98,6 +99,6 @@ export function paintLinearArcLayout<
     nodeSel.attr('transform', (d) => {
         const cx = centerXByNode.get(d);
         if (cx === undefined) return null; // 不在布局列表中（已 display:none），不更新 transform
-        return `translate(${cx - d.nodeW / 2},${LINEAR_ARC_BASELINE_Y})`;
+        return `translate(${cx - d.nodeW / 2},${LINEAR_ARC_BASELINE_Y - d.nodeH / 2})`;
     });
 }

client/src/ts/attribution/genAttributeDagViewSpiralMode.ts

@@ -10,6 +10,8 @@ const SPIRAL_SPACING = 60;
 const SPIRAL_ARC_STEP = 40;
 /** 螺旋旋转相位（弧度）：控制螺旋臂展开方向。0 = 向右，-Math.PI/2 = 向上。 */
 const SPIRAL_PHASE = Math.PI * 0.6;
+/** 螺旋上第一个（起始位置）token 的相对视觉放大倍数（仅 spiral 布局）。 */
+const SPIRAL_FIRST_TOKEN_SCALE = 2;
 // ────────────────────────────────────────────────────────────────────────────
 
 type SpiralNodeLike = { nodeW: number; nodeH: number };
@@ -63,10 +65,19 @@ export function paintSpiralLayout<
         positionByNode.set(nodes[i]!, rawPos[i]!);
     }
 
+    const firstSpiralNode = nodes.length > 0 ? nodes[0]! : null;
+    const effNodeSize = (n: NodeDatum) =>
+        firstSpiralNode !== null && n === firstSpiralNode
+            ? { nodeW: n.nodeW * SPIRAL_FIRST_TOKEN_SCALE, nodeH: n.nodeH * SPIRAL_FIRST_TOKEN_SCALE }
+            : { nodeW: n.nodeW, nodeH: n.nodeH };
+
     // 节点：中心落在螺旋点，矩形保持水平
     nodeSel.attr('transform', (d) => {
         const pos = positionByNode.get(d);
         if (pos === undefined) return null;
+        if (firstSpiralNode !== null && d === firstSpiralNode) {
+            return `translate(${pos.cx},${pos.cy}) scale(${SPIRAL_FIRST_TOKEN_SCALE}) translate(${-d.nodeW / 2},${-d.nodeH / 2})`;
+        }
         return `translate(${pos.cx - d.nodeW / 2},${pos.cy - d.nodeH / 2})`;
     });
 
@@ -76,18 +87,10 @@ export function paintSpiralLayout<
         const pa = positionByNode.get(src);
         const pb = positionByNode.get(tgt);
         if (pa === undefined || pb === undefined) return;
-        const srcRect = {
-            x: pa.cx - src.nodeW / 2,
-            y: pa.cy - src.nodeH / 2,
-            nodeW: src.nodeW,
-            nodeH: src.nodeH,
-        };
-        const tgtRect = {
-            x: pb.cx - tgt.nodeW / 2,
-            y: pb.cy - tgt.nodeH / 2,
-            nodeW: tgt.nodeW,
-            nodeH: tgt.nodeH,
-        };
+        const sw = effNodeSize(src);
+        const tw = effNodeSize(tgt);
+        const srcRect = { cx: pa.cx, cy: pa.cy, nodeW: sw.nodeW, nodeH: sw.nodeH };
+        const tgtRect = { cx: pb.cx, cy: pb.cy, nodeW: tw.nodeW, nodeH: tw.nodeH };
         const seg = linkSegmentThroughNodeRects(srcRect, tgtRect, linkEndInsetPx);
         d3.select(this)
             .selectAll('path.gen-attr-dag-link-visible')

client/src/ts/attribution/genAttributeDagViewTextFlowMode.ts

@@ -2,8 +2,8 @@ import * as d3 from 'd3';
 import { linkSegmentThroughNodeRects } from './genAttributeDagLinkSegment';
 
 type TextFlowNodeLike = {
-    x: number;
-    y: number;
+    cx: number;
+    cy: number;
     nodeW: number;
     nodeH: number;
 };
@@ -23,5 +23,5 @@ export function paintTextFlowLayout<LinkDatum, NodeDatum extends TextFlowNodeLik
             .selectAll('path.gen-attr-dag-link-visible')
             .attr('d', `M ${seg.x1} ${seg.y1} L ${seg.x2} ${seg.y2}`);
     });
-    nodeSel.attr('transform', (d) => `translate(${d.x},${d.y})`);
+    nodeSel.attr('transform', (d) => `translate(${d.cx - d.nodeW / 2},${d.cy - d.nodeH / 2})`);
 }

client/src/ts/gen_attribute.ts

@@ -25,6 +25,8 @@ import {
 } from './attribution/genAttributeDagPreprocess';
 import {
     initGenAttributeDagView,
+    setDagNodeCiVisualScaleEnabled,
+    setDagEdgeWeakenHighSurprisalEnabled,
     type DagLayoutMode,
     clampDagCompactness,
     clampLinearArcAdjacentGap,
@@ -97,6 +99,8 @@ const GEN_ATTR_DAG_LAYOUT_MODE_STORAGE_KEY = 'info_radar_gen_attr_dag_layout_mod
 const GEN_ATTR_DAG_PLAYBACK_STEP_MS_STORAGE_KEY = 'info_radar_gen_attr_dag_playback_step_ms';
 const GEN_ATTR_DAG_REPLAY_PACING_MODE_STORAGE_KEY = 'info_radar_gen_attr_dag_replay_pacing_mode';
 const GEN_ATTR_DAG_PLAYBACK_TOTAL_S_STORAGE_KEY = 'info_radar_gen_attr_dag_playback_total_s';
+const GEN_ATTR_DAG_NODE_CI_VISUAL_SCALE_STORAGE_KEY = 'info_radar_gen_attr_dag_node_ci_visual_scale';
+const GEN_ATTR_DAG_EDGE_WEAKEN_HIGH_SURPRISAL_STORAGE_KEY = 'info_radar_gen_attr_dag_edge_weaken_high_surprisal';
 const GEN_ATTR_DAG_HIDE_INACTIVE_EDGES_STORAGE_KEY = 'info_radar_gen_attr_dag_hide_inactive_edges';
 const GEN_ATTR_DAG_HIDE_EXCLUDED_TOKENS_STORAGE_KEY = 'info_radar_gen_attr_dag_hide_excluded_tokens';
 const GEN_ATTR_DAG_LINEAR_ARC_GAP_STORAGE_KEY =
@@ -379,6 +383,12 @@ function applyDagLayoutModeUi(): void {
 const dagHideExcludedTokensInput = document.getElementById(
     'gen_attr_dag_hide_excluded_tokens'
 ) as HTMLInputElement | null;
+const dagNodeCiVisualScaleInput = document.getElementById(
+    'gen_attr_dag_node_ci_visual_scale'
+) as HTMLInputElement | null;
+const dagEdgeWeakenHighSurprisalInput = document.getElementById(
+    'gen_attr_dag_edge_weaken_high_surprisal'
+) as HTMLInputElement | null;
 const dagHideInactiveEdgesInput = document.getElementById(
     'gen_attr_dag_hide_inactive_edges'
 ) as HTMLInputElement | null;
@@ -408,6 +418,50 @@ if (dagPlaybackTotalSInput) dagPlaybackTotalSInput.value = String(initialDagPlay
 applyDagReplaySpeedUi();
 
 const genAttrResultsNode = genAttrResultsEl.node() as HTMLElement | null;
+function readStoredDagNodeCiVisualScale(): boolean {
+    try {
+        const v = localStorage.getItem(GEN_ATTR_DAG_NODE_CI_VISUAL_SCALE_STORAGE_KEY);
+        return v === null ? true : v === '1';
+    } catch {
+        return true;
+    }
+}
+const initialDagNodeCiVisualScale = readStoredDagNodeCiVisualScale();
+if (dagNodeCiVisualScaleInput) dagNodeCiVisualScaleInput.checked = initialDagNodeCiVisualScale;
+setDagNodeCiVisualScaleEnabled(initialDagNodeCiVisualScale);
+dagNodeCiVisualScaleInput?.addEventListener('change', () => {
+    const enabled = dagNodeCiVisualScaleInput.checked;
+    try {
+        localStorage.setItem(GEN_ATTR_DAG_NODE_CI_VISUAL_SCALE_STORAGE_KEY, enabled ? '1' : '0');
+    } catch {
+        /* ignore */
+    }
+    setDagNodeCiVisualScaleEnabled(enabled);
+    tryResetAndReplayDag();
+});
+
+function readStoredDagEdgeWeakenHighSurprisal(): boolean {
+    try {
+        const v = localStorage.getItem(GEN_ATTR_DAG_EDGE_WEAKEN_HIGH_SURPRISAL_STORAGE_KEY);
+        return v === null ? true : v === '1';
+    } catch {
+        return true;
+    }
+}
+const initialDagEdgeWeakenHighSurprisal = readStoredDagEdgeWeakenHighSurprisal();
+if (dagEdgeWeakenHighSurprisalInput) dagEdgeWeakenHighSurprisalInput.checked = initialDagEdgeWeakenHighSurprisal;
+setDagEdgeWeakenHighSurprisalEnabled(initialDagEdgeWeakenHighSurprisal);
+dagEdgeWeakenHighSurprisalInput?.addEventListener('change', () => {
+    const enabled = dagEdgeWeakenHighSurprisalInput.checked;
+    try {
+        localStorage.setItem(GEN_ATTR_DAG_EDGE_WEAKEN_HIGH_SURPRISAL_STORAGE_KEY, enabled ? '1' : '0');
+    } catch {
+        /* ignore */
+    }
+    setDagEdgeWeakenHighSurprisalEnabled(enabled);
+    tryResetAndReplayDag();
+});
+
 function applyDagHideInactiveEdges(hide: boolean): void {
     if (!genAttrResultsNode) return;
     genAttrResultsNode.classList.toggle('gen-attr-dag-hide-inactive-edges', hide);
@@ -871,6 +925,18 @@ function isDagBusy(): boolean {
     return inFlight || dagPlaybackTimer !== null || dagLastTokenDwellTimer !== null;
 }
 
+/** 非忙状态下 reset + replay + fit，供各设置项切换后复用。忙时为 no-op。 */
+function tryResetAndReplayDag(): void {
+    if (isDagBusy()) return;
+    const h = runnerHandle;
+    dagHandle.reset();
+    if (h && h.tokenCount > 0) {
+        replayRunnerStepsIntoDag(h, currentRunPromptSpans.length > 0 ? currentRunPromptSpans : undefined);
+    }
+    dagHandle.fitViewportToContent();
+    dagHandle.clearNodeSelection();
+}
+
 dagMeasureWidthInput?.addEventListener('change', () => {
     const raw = parseInt(dagMeasureWidthInput.value, 10);
     const w = Number.isFinite(raw)
@@ -883,14 +949,7 @@ dagMeasureWidthInput?.addEventListener('change', () => {
         /* ignore */
     }
     dagHandle.setMeasureWidthPx(w);
-    if (isDagBusy()) return;
-    const h = runnerHandle;
-    dagHandle.reset();
-    if (h && h.tokenCount > 0) {
-        replayRunnerStepsIntoDag(h, currentRunPromptSpans.length > 0 ? currentRunPromptSpans : undefined);
-    }
-    dagHandle.fitViewportToContent();
-    dagHandle.clearNodeSelection();
+    tryResetAndReplayDag();
 });
 
 dagCompactnessInput?.addEventListener('change', () => {
@@ -903,14 +962,7 @@ dagCompactnessInput?.addEventListener('change', () => {
         /* ignore */
     }
     dagHandle.setDagCompactness(c);
-    if (isDagBusy()) return;
-    const h = runnerHandle;
-    dagHandle.reset();
-    if (h && h.tokenCount > 0) {
-        replayRunnerStepsIntoDag(h, currentRunPromptSpans.length > 0 ? currentRunPromptSpans : undefined);
-    }
-    dagHandle.fitViewportToContent();
-    dagHandle.clearNodeSelection();
+    tryResetAndReplayDag();
 });
 
 dagEdgeTopPCoverageInput?.addEventListener('change', () => {
@@ -925,14 +977,7 @@ dagEdgeTopPCoverageInput?.addEventListener('change', () => {
         /* ignore */
     }
     dagHandle.setEdgeTopPCoverage(c);
-    if (isDagBusy()) return;
-    const h = runnerHandle;
-    dagHandle.reset();
-    if (h && h.tokenCount > 0) {
-        replayRunnerStepsIntoDag(h, currentRunPromptSpans.length > 0 ? currentRunPromptSpans : undefined);
-    }
-    dagHandle.fitViewportToContent();
-    dagHandle.clearNodeSelection();
+    tryResetAndReplayDag();
 });
 
 dagLinearArcIntervalInput?.addEventListener('change', () => {
@@ -1300,7 +1345,7 @@ async function applyGenAttrCachedRun(
     }
 }
 
-/** Cached history 与 `?content=` 共用；`shouldTouch` 为 true 时 touch MRU 并刷新下拉镜像。 */
+/** 从缓存恢复运行；`shouldTouch` 为 true 时 touch MRU（下拉选中恒为 false，↑ 置顶走单独路径）。 */
 async function restoreGenAttrFromCachedRun(
     contentKey: string,
     shouldTouch: boolean,

client/src/ts/home.ts

@@ -22,6 +22,7 @@ const GEN_ATTRIBUTE_HOME_DEMO_SLUG: Record<'en' | 'zh', string> = {
     en: 'Write a sonnet about love',
     zh: '写一首绝句，主题是春天',
 };
+const GEN_ATTRIBUTE_BADGE_LINK = 'http://xhslink.com/o/A7VLi99aBvG';
 
 function applyGenAttributeNavCardHref(): void {
     const a = document.querySelector<HTMLAnchorElement>('a.nav-landing-card[data-nav-page="genAttribute"]');
@@ -43,7 +44,20 @@ function syncGenAttributeCardPreviewVideo(theme: Theme): void {
     v.src = DAG_PREVIEW_BY_THEME[theme];
 }
 
+function bindGenAttributeBadgeLink(): void {
+    const badge = document.querySelector<HTMLElement>(
+        'a.nav-landing-card[data-nav-page="genAttribute"] .nav-landing-card-badge'
+    );
+    if (!badge) return;
+    badge.addEventListener('click', (event: MouseEvent) => {
+        event.preventDefault();
+        event.stopPropagation();
+        window.open(GEN_ATTRIBUTE_BADGE_LINK, '_blank', 'noopener');
+    });
+}
+
 applyGenAttributeNavCardHref();
+bindGenAttributeBadgeLink();
 
 const apiPrefix = URLHandler.parameters['api'] || '';
 const { api } = initializeCommonApp(apiPrefix);

client/src/ts/lang/translations.ts

@@ -29,6 +29,8 @@ export const translations: Translations = {
         '- attribute a predicted token to its context': '- 将预测 token 归因到上下文',
         'LLM Causal Flow': 'LLM Causal Flow 因果流',
         '- explore the context-attribution DAG': '- 探索上下文归因的 DAG 关系图',
+        '100K+ plays on RedNote': '小红书 10万+次播放',
+        'Go to demo on RedNote: xhslink.com/o/A7VLi99aBvG': '在小红书打开demo：xhslink.com/o/A7VLi99aBvG）',
         // 合成标题串（<title>）：英文 key 与 injectPageMeta documentTitleEn 拼接一致
         'Info Lens - A toolbox for exploring the informational nature of LLMs and language': 'Info Lens 信息透镜 - 用于探索 LLM 与语言的信息本质的工具箱',
         "Info Highlight - highlight the 'informative' parts": 'Info Highlight 信息高亮 - 高亮“信息量大”的地方',

client/src/ts/utils/SurprisalColorConfig.ts

@@ -1,5 +1,6 @@
 import * as d3 from "d3";
 import { isFiniteNumber } from "./Util";
+import { REFERENCE_MAX_SURPRISAL_BITS } from "./surprisalMath";
 
 /**
  * 惊讶度颜色配置模块
@@ -11,7 +12,7 @@ import { isFiniteNumber } from "./Util";
 // ==========================================
 
 /** Token surprisal 的最大值，用于颜色映射（默认上限，可被调用方传入的可选 max 覆盖） */
-const TOKEN_SURPRISAL_MAX = 18;
+const TOKEN_SURPRISAL_MAX = REFERENCE_MAX_SURPRISAL_BITS;
 
 /** Byte surprisal 的最大值，用于颜色映射 */
 const BYTE_SURPRISAL_MAX = 6;

client/src/ts/utils/cachedHistoryUi.ts

@@ -27,8 +27,7 @@ export type InitCachedHistoryQueryDropdownOptions = {
     listMru: () => Promise<CachedHistoryListRow[]>;
     /**
      * 第一参为 {@link CachedHistoryListRow.contentKey}（与 `?content=` 一致）。
-     * 第二参 `shouldTouch` 与 {@link initQueryHistoryDropdown} 的 `onHistorySelect` 一致：
-     * 是否应对关联 MRU 执行 touch（悬停为 false）。
+     * 第二参恒为 false：列表点击或悬停预览均不 bump MRU，仅 {@link onPromote}（↑）会 touch。
      */
     onSelectEntry: (
         contentKey: string,
@@ -40,7 +39,7 @@ export type InitCachedHistoryQueryDropdownOptions = {
 };
 
 /**
- * 三页 Cached history 共用的「无 input + MRU 异步刷新 + 悬停预览」接线。
+ * 三页 Cached history 共用的「无 input + MRU 异步刷新 + 悬停预览」接线；选中条目不写 MRU。
  * 返回 `refreshList` 供 URL hydrate 等与下拉无关的路径刷新内存列表。
  */
 export function initCachedHistoryQueryDropdown(
@@ -60,8 +59,8 @@ export function initCachedHistoryQueryDropdown(
         filterHistoryByInput: false,
         onSelect: () => {},
         fillInputOnSelect: false,
-        onHistorySelect: (contentKey, shouldTouch) => {
-            void Promise.resolve(options.onSelectEntry(contentKey, shouldTouch, ctx));
+        onHistorySelect: (contentKey) => {
+            void Promise.resolve(options.onSelectEntry(contentKey, false, ctx));
         },
         onRemove: options.onRemove,
         onPromote: options.onPromote,

client/src/ts/utils/settingsMenuManager.ts

@@ -374,7 +374,7 @@ export class SettingsMenuManager {
     }
 
     private async handleVisitStatsClick(): Promise<void> {
-        /** Visit stats 弹窗专用：主序列与 webpack 顶层页 / access_log 归类一致 */
+        // backend/visit_stats.py：_STATS_PAGE_ORDER / _STATS_API_ORDER / _STATS_OS_ORDER
         const PAGE_ORDER = [
             'index.html',
             'analysis.html',
@@ -445,14 +445,19 @@ export class SettingsMenuManager {
         };
 
         const fetchAndRender = async (container: d3.Selection<HTMLDivElement, unknown, HTMLElement, any>) => {
-            container.selectAll('*').remove();
-            const block = container
-                .append('div')
-                .attr('class', 'visit-stats-body')
-                .style('margin', '0')
-                .style('white-space', 'pre-wrap')
-                .style('font', 'inherit')
-                .style('font-size', '13px');
+            let block = container.select<HTMLDivElement>('div.visit-stats-body');
+            if (block.empty()) {
+                block = container
+                    .append('div')
+                    .attr('class', 'visit-stats-body')
+                    .style('margin', '0')
+                    .style('white-space', 'pre-wrap')
+                    .style('font', 'inherit')
+                    .style('font-size', '13px');
+            } else {
+                // 与 Model Management 一致：用透明度保留占位，避免清空 DOM 导致弹窗高度塌陷抖动
+                block.style('opacity', '0');
+            }
             try {
                 const data = await this.api.getVisitStats();
                 if (!data?.success) throw new Error('bad');
@@ -460,6 +465,7 @@ export class SettingsMenuManager {
             } catch {
                 block.text('Failed to load stats.');
             }
+            block.style('opacity', '1');
         };
 
         showDialog({

client/src/ts/utils/surprisalMath.ts

@@ -0,0 +1,51 @@
+/**
+ * 惊讶度与信息量的数学基础模块。
+ * 颜色映射相关常量见 {@link SurprisalColorConfig}。
+ */
+
+/**
+ * 零信心概率基准 p₀：surprisal log₂(1/p₀) 视作单 token 的绝对信息量参照。
+ * 超过此值视为模型已无法有效预测，各处可视化统一在此封顶。
+ * 此处为 18 bit，大致对应模型的词表大小256K时的平均token概率。
+ */
+export const ZERO_CONFIDENCE_PROBABILITY_BASELINE = 2 ** -18;
+
+/** 与 p₀ 对应的参照 surprisal 上界（bit）；同时作为 token 着色标尺上限。 */
+export const REFERENCE_MAX_SURPRISAL_BITS = Math.log2(1 / ZERO_CONFIDENCE_PROBABILITY_BASELINE);
+
+/**
+ * 全信心概率阈值 p₁：surprisal 低于对应 bit 数时视作模型已充分自信，视觉上不放大节点。
+ * 此处为 3 bit，对应概率 > 1/8（约 12.5%）。
+ */
+export const FULL_CONFIDENCE_PROBABILITY_BASELINE = 2 ** -3;
+
+/** 与 p₁ 对应的 surprisal 下界（bit）；低于此值的节点 ciVisualScale 截断为 1×。 */
+export const REFERENCE_NO_SURPRISAL_BITS = Math.log2(1 / FULL_CONFIDENCE_PROBABILITY_BASELINE);
+
+function clamp01(n: number): number {
+    return Math.min(1, Math.max(0, n));
+}
+
+/**
+ * 互信息率 α：在参照熵 log₂(1/p₀) 下，将「前文与目标 token 的可对齐程度」
+ * (log₂(1/p₀) − log₂(1/p)) / log₂(1/p₀) = log₂(p/p₀) / log₂(1/p₀) clamp 到 [0,1]。
+ * 低 surprisal → 高 α；仅用于本步入边透明度，不参与边筛选。缺省 `target_prob` 时返回 1（兼容旧缓存）。
+ */
+export function computeMutualInformationRatio(targetProb: number | undefined): number {
+    if (targetProb === undefined) return 1;
+    if (!Number.isFinite(targetProb) || targetProb <= 0) return 0;
+    return clamp01(
+        Math.log2(targetProb / ZERO_CONFIDENCE_PROBABILITY_BASELINE) / REFERENCE_MAX_SURPRISAL_BITS
+    );
+}
+
+/**
+ * 条件信息量比率 CI：surprisal/max = (−log₂ p) / log₂(1/p₀) clamp 到 [0,1]，
+ * 与 {@link computeMutualInformationRatio} 对称（同 p 下 CI + MI = 1）。
+ * 缺省 `target_prob` 时返回 0；非法或 p≤0 时返回 1。
+ */
+export function computeConditionalInformationRatio(targetProb: number | undefined): number {
+    if (targetProb === undefined) return 0;
+    if (!Number.isFinite(targetProb) || targetProb <= 0) return 1;
+    return clamp01(-Math.log2(targetProb) / REFERENCE_MAX_SURPRISAL_BITS);
+}