niceeval 0.6.2 → 0.7.1

package/src/report/react/ExperimentList.tsx

@@ -1,17 +1,20 @@
-// ExperimentList:实体列表的第一级。web 面是一行一个 experiment 的固定列比较表；
-// 每行用原生 <details> 展开到 Eval 与 Attempt locator。数据仍完全来自
-// ExperimentList.data(),不恢复旧 ExperimentTable 的混合实体计算层。
+// ExperimentList:实体列表的第一级。web 面是一行一个 experiment 的固定八列比较表
+// (Experiment / Model / Agent / Avg duration / End-to-end pass rate / Tokens / Cost / Result),
+// 每行用原生 <details> 展开到 Eval 与 Attempt locator。数据完全来自 experimentListData(),
+// 组件不重算、不推断组边界。
 
 import type { ReactElement } from "react";
 import type { AttemptLocator } from "../../results/locator.ts";
 import type { AttemptListItem, ExperimentListEvalRow, ExperimentListItem } from "../types.ts";
-import { attemptItemReason, experimentDisplayName } from "../format.ts";
+import { experimentDisplayName } from "../format.ts";
 import { DEFAULT_REPORT_LOCALE, localeText, type ReportLocale } from "../locale.ts";
-import { AttemptLocatorBadge } from "./AttemptList.tsx";
+import { AttemptLocatorBadge, failureSummaryText } from "./AttemptList.tsx";
 import { MetricCellView } from "./cell.tsx";
 import { colorClassForKey } from "./colors.ts";
 import { cx, formatDurationMs, formatUSD, verdictMark } from "./format.ts";
 
+const DEFAULT_ATTEMPT_HREF = (locator: AttemptLocator): string => `#/attempt/${locator}`;
+
 const verdictOrder = ["passed", "failed", "errored", "skipped"] as const;
 
 function passRateTone(value: number | null): string | undefined {
@@ -34,8 +37,8 @@ function formatDate(value: string, locale: ReportLocale): string {
 
 function VerdictSummary({ item, locale }: { item: ExperimentListItem; locale: ReportLocale }): ReactElement {
   const parts = verdictOrder
-    .filter((verdict) => item.verdicts[verdict] > 0)
-    .map((verdict) => `${item.verdicts[verdict]} ${localeText(locale, `verdict.${verdict}`)}`);
+    .filter((verdict) => item.evalVerdicts[verdict] > 0)
+    .map((verdict) => `${item.evalVerdicts[verdict]} ${localeText(locale, `verdict.${verdict}`)}`);
   return <span className="nre-experiment-pill">{parts.join(" / ") || "—"}</span>;
 }
 
@@ -43,12 +46,14 @@ function ExperimentAttemptRow({
   attempt,
   last,
   attemptHref,
+  locale,
 }: {
   attempt: AttemptListItem;
   last: boolean;
   attemptHref: (locator: AttemptLocator) => string;
+  locale: ReportLocale;
 }): ReactElement {
-  const reason = attemptItemReason(attempt);
+  const reason = failureSummaryText(attempt, locale);
   return (
     <li className={cx("nre-experiment-attempt-row", `nre-eval-${attempt.verdict}`)}>
       <span className="nre-attempt-branch" aria-hidden="true">{last ? "└─" : "├─"}</span>
@@ -57,8 +62,9 @@ function ExperimentAttemptRow({
       </span>
       <span className="nre-eval-attempt-metrics">
         {formatDurationMs(attempt.durationMs)}
-        {attempt.costUSD !== undefined && <> · {formatUSD(attempt.costUSD)}</>}
+        {attempt.costUSD !== null && <> · {formatUSD(attempt.costUSD)}</>}
       </span>
+      {/* passed attempt 的 Result 是 —,不罗列通过的 assertions */}
       <span className="nre-eval-reason">{reason ?? "—"}</span>
     </li>
   );
@@ -73,10 +79,11 @@ function EvalAttempts({
   attemptHref: (locator: AttemptLocator) => string;
   locale: ReportLocale;
 }): ReactElement {
-  const duration = row.duration.value === null ? localeText(locale, "cell.missing") : formatDurationMs(row.duration.value);
-  const cost = row.cost.value === null ? localeText(locale, "cell.missing") : formatUSD(row.cost.value);
+  const duration = row.durationMs.value === null ? localeText(locale, "cell.missing") : formatDurationMs(row.durationMs.value);
+  const cost = row.costUSD.value === null ? localeText(locale, "cell.missing") : formatUSD(row.costUSD.value);
   return (
     <li className="nre-experiment-eval">
+      {/* Eval 父行只显示折叠判定、Attempt 数与题级平均;失败原因只在 Attempt 子行 */}
       <div className={cx("nre-experiment-eval-header", `nre-eval-${row.verdict}`)}>
         <span className={cx("nre-eval-verdict", `nre-verdict-${row.verdict}`)}>{verdictMark(row.verdict)}</span>
         <span className="nre-eval-id">{row.evalId}</span>
@@ -94,6 +101,7 @@ function EvalAttempts({
             attempt={attempt}
             last={index === row.attempts.length - 1}
             attemptHref={attemptHref}
+            locale={locale}
           />
         ))}
       </ul>
@@ -107,7 +115,7 @@ function Flags({ flags, locale }: { flags: Record<string, unknown> | undefined;
     <div className="nre-experiment-flags">
       <span>{localeText(locale, "experimentList.flags")}</span>
       {Object.entries(flags).map(([key, value]) => (
-        <b key={key}>{key}={String(value)}</b>
+        <b key={key}>{key}={typeof value === "string" ? value : JSON.stringify(value)}</b>
       ))}
     </div>
   );
@@ -127,6 +135,7 @@ function ExperimentRow({
   return (
     <details className="nre-experiment-entry">
       <summary className="nre-experiment-summary">
+        {/* relativeTo 只影响显示末段;完整 id 仍是排序 / 着色 / 过滤 / 折叠的键 */}
         <span className="nre-experiment-name" data-sort-value={item.experimentId}>
           <b className={cx("nre-experiment-id", "nre-key", colorClassForKey(item.experimentId))}>
             {experimentDisplayName(item.experimentId, relativeTo)}
@@ -139,19 +148,22 @@ function ExperimentRow({
         </span>
         <span data-sort-value={item.model ?? ""}>{item.model ?? localeText(locale, "experimentList.defaultModel")}</span>
         <span data-sort-value={item.agent}>{item.agent}</span>
-        <span className="nre-num" data-sort-value={item.duration.value ?? ""}>
-          <MetricCellView cell={item.duration} locale={locale} />
+        <span className="nre-num" data-sort-value={item.durationMs.value ?? ""}>
+          <MetricCellView cell={item.durationMs} locale={locale} />
         </span>
-        <span className={cx("nre-num", passRateTone(item.passRate.value))} data-sort-value={item.passRate.value ?? ""}>
-          <MetricCellView cell={item.passRate} locale={locale} />
+        <span
+          className={cx("nre-num", passRateTone(item.endToEndPassRate.value))}
+          data-sort-value={item.endToEndPassRate.value ?? ""}
+        >
+          <MetricCellView cell={item.endToEndPassRate} locale={locale} />
         </span>
         <span className="nre-num" data-sort-value={item.tokens.value ?? ""}>
           <MetricCellView cell={item.tokens} locale={locale} />
         </span>
-        <span className="nre-num" data-sort-value={item.cost.value ?? ""}>
-          <MetricCellView cell={item.cost} locale={locale} />
+        <span className="nre-num" data-sort-value={item.costUSD.value ?? ""}>
+          <MetricCellView cell={item.costUSD} locale={locale} />
         </span>
-        <span data-sort-value={item.verdicts.passed}><VerdictSummary item={item} locale={locale} /></span>
+        <span data-sort-value={item.evalVerdicts.passed}><VerdictSummary item={item} locale={locale} /></span>
       </summary>
       <div className="nre-experiment-detail">
         <Flags flags={item.flags} locale={locale} />
@@ -166,15 +178,15 @@ function ExperimentRow({
 }
 
 export function ExperimentList({
-  items,
-  attemptHref,
+  data,
+  attemptHref = DEFAULT_ATTEMPT_HREF,
   filter = false,
   className,
   locale = DEFAULT_REPORT_LOCALE,
   relativeTo,
 }: {
-  items: ExperimentListItem[];
-  attemptHref: (locator: AttemptLocator) => string;
+  data: readonly ExperimentListItem[];
+  attemptHref?: (locator: AttemptLocator) => string;
   filter?: boolean;
   className?: string;
   locale?: ReportLocale;
@@ -187,7 +199,7 @@ export function ExperimentList({
     localeText(locale, "experimentList.avgDuration"),
     localeText(locale, "experimentList.passRate"),
     localeText(locale, "experimentList.tokens"),
-    localeText(locale, "experimentList.estimatedCost"),
+    localeText(locale, "experimentList.cost"),
     localeText(locale, "experimentList.result"),
   ];
   const board = (
@@ -204,8 +216,8 @@ export function ExperimentList({
           </button>
         ))}
       </div>
-      {items.length === 0 && <p className="nre-experiment-list-empty">{localeText(locale, "attemptList.empty")}</p>}
-      {items.map((item) => (
+      {data.length === 0 && <p className="nre-experiment-list-empty">{localeText(locale, "attemptList.empty")}</p>}
+      {data.map((item) => (
         <ExperimentRow key={item.experimentId} item={item} attemptHref={attemptHref} locale={locale} relativeTo={relativeTo} />
       ))}
     </div>

package/src/report/react/MetricBars.tsx

@@ -6,7 +6,7 @@
 import type { ReactElement } from "react";
 import type { MatrixData, MetricCell } from "../types.ts";
 import type { AttemptLocator } from "../../results/locator.ts";
-import { DEFAULT_REPORT_LOCALE, resolveMetricLabel, type ReportLocale } from "../locale.ts";
+import { DEFAULT_REPORT_LOCALE, resolveLocalizedText, resolveMetricLabel, type ReportLocale } from "../locale.ts";
 import { colorClassForKey, seriesClassForKey } from "./colors.ts";
 import { cx } from "./format.ts";
 
@@ -52,7 +52,7 @@ export function MetricBars({
         className="nre-bars-svg"
         viewBox={`0 0 ${WIDTH} ${HEIGHT}`}
         role="img"
-        aria-label={`${metricLabel} by ${data.rows} × ${data.columns}`}
+        aria-label={`${metricLabel} by ${data.rowDimension} × ${data.columnDimension}`}
       >
         {groupKeys.map((group, gi) => {
           const x0 = PLOT.left + gi * groupWidth;
@@ -71,7 +71,8 @@ export function MetricBars({
                 const h = Math.max(1, ratioOf(cell.value as number) * plotHeight);
                 const x = startX + si * barWidth;
                 const y = PLOT.bottom - h;
-                const title = `${group} · ${series}: ${cell.display}(${cell.samples}/${cell.total})`;
+                const display = resolveLocalizedText(cell.display, locale);
+                const title = `${group} · ${series}: ${display}(${cell.samples}/${cell.total})`;
                 const rect = (
                   <rect
                     className={cx("nre-bar", seriesClassForKey(series))}
@@ -89,7 +90,7 @@ export function MetricBars({
                     {attemptHref && locator ? <a href={attemptHref(locator)}>{rect}</a> : rect}
                     {/* 柱顶标数值;覆盖不全时把 samples/total 一并标出,不藏 */}
                     <text className="nre-bar-value" x={x + barWidth / 2} y={y - 4} textAnchor="middle">
-                      {cell.samples < cell.total ? `${cell.display} ${cell.samples}/${cell.total}` : cell.display}
+                      {cell.samples < cell.total ? `${display} ${cell.samples}/${cell.total}` : display}
                     </text>
                   </g>
                 );

package/src/report/react/MetricLine.tsx

@@ -7,7 +7,7 @@
 
 import type { ReactElement } from "react";
 import type { LineData } from "../types.ts";
-import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveMetricLabel, type ReportLocale } from "../locale.ts";
+import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText, resolveMetricLabel, type ReportLocale } from "../locale.ts";
 import { seriesClassForKey } from "./colors.ts";
 import { cx } from "./format.ts";
 
@@ -52,6 +52,7 @@ export function MetricLine({
   const missing = data.rows.filter((r) => r.x === null || r.y.value === null);
   const drawableRows = data.rows.filter((r) => r.x !== null && r.y.value !== null);
   const yLabel = resolveMetricLabel(data.y.label, locale, data.y.key);
+  const xLabel = resolveMetricLabel(data.x.label, locale, data.x.key);
 
   const missingNote =
     missing.length > 0 ? (
@@ -83,7 +84,7 @@ export function MetricLine({
     series: r.series,
     xValue: r.x as number,
     yValue: r.y.value as number,
-    title: `${r.key}\n${data.x.label}: ${r.xDisplay}\n${yLabel}: ${r.y.display}(${r.y.samples}/${r.y.total})`,
+    title: `${r.key}\n${xLabel}: ${resolveLocalizedText(r.xDisplay, locale)}\n${yLabel}: ${resolveLocalizedText(r.y.display, locale)}(${r.y.samples}/${r.y.total})`,
     px: xScale.scale(r.x as number),
     py: yScale.scale(r.y.value as number),
   }));
@@ -103,10 +104,14 @@ export function MetricLine({
 
   const xTicks = xScale.lo === xScale.hi ? [xScale.lo] : [xScale.lo, xScale.hi];
   const yTicks = yScale.lo === yScale.hi ? [yScale.lo] : [yScale.lo, yScale.hi];
-  const xDisplayFor = (value: number) =>
-    drawableRows.find((r) => r.x === value)?.xDisplay ?? String(value);
-  const yDisplayFor = (value: number) =>
-    drawableRows.find((r) => r.y.value === value)?.y.display ?? String(value);
+  const xDisplayFor = (value: number) => {
+    const row = drawableRows.find((r) => r.x === value);
+    return row === undefined ? String(value) : resolveLocalizedText(row.xDisplay, locale);
+  };
+  const yDisplayFor = (value: number) => {
+    const row = drawableRows.find((r) => r.y.value === value);
+    return row === undefined ? String(value) : resolveLocalizedText(row.y.display, locale);
+  };
 
   return (
     <figure className={cx("nre", "nre-metric-line", className)}>
@@ -114,7 +119,7 @@ export function MetricLine({
         className="nre-line-svg"
         viewBox={`0 0 ${WIDTH} ${HEIGHT}`}
         role="img"
-        aria-label={`${yLabel} by ${data.x.label}`}
+        aria-label={`${yLabel} by ${xLabel}`}
       >
         <rect
           className="nre-line-plot"
@@ -125,7 +130,7 @@ export function MetricLine({
           fill="none"
         />
         <text className="nre-line-xlabel" x={(PLOT.left + PLOT.right) / 2} y={HEIGHT - 8} textAnchor="middle">
-          {data.x.label}
+          {xLabel}
           {data.x.unit ? `(${data.x.unit})` : ""}
         </text>
         <text

package/src/report/react/MetricMatrix.tsx

@@ -40,13 +40,13 @@ export function MetricMatrix({
         {resolveMetricLabel(data.metric.label, locale, data.metric.key)}
         {data.metric.unit && <span className="nre-unit">({data.metric.unit})</span>}
         <span className="nre-matrix-axes">
-          {data.rows} × {data.columns}
+          {data.rowDimension} × {data.columnDimension}
         </span>
       </caption>
       <thead>
         <tr>
           <th scope="col" className="nre-dimension">
-            {data.rows}
+            {data.rowDimension}
           </th>
           {columnKeys.map((column) => (
             // 列键 = 维度键(如 agent):稳定散列上色,与 scatter 的线、DeltaTable 的行同色

package/src/report/react/MetricScatter.tsx

@@ -1,5 +1,6 @@
 // MetricScatter:质量 × 成本 frontier 的积木,内联 SVG、零图表库、零 hooks。
-// 轴向随 better:"lower" 的轴反向画,「好」的角落恒在右上(成本轴 $20 → $0 就是这么来的);
+// 轴向随 better:"lower" 的轴反向画(值大在左/下),「更好」恒指向右上;方向提示恒为
+// 「越靠右上越好」且仅当两轴都声明 better 时显示;刻度显示真实值。
 // niceTicks 刻度 + 网格线;每个点直接标注(placePointLabels 候选位择优:避开其它标签、
 // 数据点与画布边界,离开左右紧邻位时补 leader line);
 // 同系列的点按 x 值排序连线,系列图例列在图下。x 或 y 为 null 的点不画,
@@ -10,7 +11,7 @@
 import type { ReactElement } from "react";
 import type { MetricColumn, ScatterData } from "../types.ts";
 import { formatMetricValue } from "../format.ts";
-import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveMetricLabel, type ReportLocale } from "../locale.ts";
+import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText, resolveMetricLabel, type ReportLocale } from "../locale.ts";
 import { niceTicks, placePointLabels } from "./chart-math.ts";
 import { colorClassForKey, seriesClassForKey } from "./colors.ts";
 import { cx } from "./format.ts";
@@ -33,22 +34,54 @@ interface DrawablePoint {
   py: number;
 }
 
-/** 点的直接标签:experiment id 的末段(完整 id 在 <title> 里)。 */
-function pointLabel(key: string): string {
-  return key.split("/").filter(Boolean).at(-1) ?? key;
+/**
+ * 点的直接标签:末段在当前 data 中唯一才缩成末段;重名时逐步加长为能区分它们的最短
+ * 路径后缀(完整 id 与两轴值仍进 <title>)。
+ */
+function pointLabels(keys: readonly string[]): Map<string, string> {
+  const segsOf = (key: string) => key.split("/").filter(Boolean);
+  const depth = new Map<string, number>(keys.map((key) => [key, 1]));
+  for (;;) {
+    const byLabel = new Map<string, string[]>();
+    for (const key of keys) {
+      const segs = segsOf(key);
+      const label = segs.slice(-Math.min(depth.get(key)!, segs.length)).join("/") || key;
+      byLabel.set(label, [...(byLabel.get(label) ?? []), key]);
+    }
+    let grew = false;
+    for (const group of byLabel.values()) {
+      if (group.length < 2) continue;
+      for (const key of group) {
+        const segs = segsOf(key);
+        if (depth.get(key)! < segs.length) {
+          depth.set(key, depth.get(key)! + 1);
+          grew = true;
+        }
+      }
+    }
+    if (!grew) {
+      const out = new Map<string, string>();
+      for (const key of keys) {
+        const segs = segsOf(key);
+        out.set(key, segs.slice(-Math.min(depth.get(key)!, segs.length)).join("/") || key);
+      }
+      return out;
+    }
+  }
 }
 
 /**
- * 一根轴:niceTicks 撑出整齐的值域,值 → 像素做线性映射;
- * better: "lower" 时反向,好的一端固定在右 / 上。
+ * 一根轴:niceTicks 撑出整齐的值域,值 → 像素做线性映射。轴方向跟随指标的 `better`:
+ * `better: "lower"` 的轴反向渲染(值大的一端在左 / 下),「更好」因此恒指向右与上;
+ * 刻度标签始终显示真实值,反向只改方向不改数字(docs/feature/reports/library/metric-views.md)。
  */
-function axisScale(values: number[], better: MetricColumn["better"], pixelLo: number, pixelHi: number) {
+function axisScale(values: number[], pixelLo: number, pixelHi: number, invert: boolean) {
   const ticks = niceTicks(Math.min(...values), Math.max(...values), 5);
   const lo = ticks[0];
   const hi = ticks[ticks.length - 1];
   const scale = (v: number) => {
     let t = (v - lo) / (hi - lo || 1);
-    if (better === "lower") t = 1 - t; // 反向:值越低越靠「好」的一端
+    if (invert) t = 1 - t;
     return pixelLo + t * (pixelHi - pixelLo);
   };
   return { ticks, scale };
@@ -91,9 +124,24 @@ export function MetricScatter({
 
   const axisLabel = (label: string, col: MetricColumn) => `${label}${col.unit ? `(${col.unit})` : ""}`;
 
-  const xScale = axisScale(drawableRows.map((r) => r.x.value as number), data.x.better, MARGIN.left, MARGIN.left + PLOT_W);
-  // y 像素轴向下增长:better:"higher" 高值在上 → 映射到 [bottom, top];"lower" 由 axisScale 反向后同样落到上方
-  const yScale = axisScale(drawableRows.map((r) => r.y.value as number), data.y.better, MARGIN.top + PLOT_H, MARGIN.top);
+  // 轴方向跟随 better:lower 反向(值大在左 / 下),higher 与未声明正向。
+  const xScale = axisScale(
+    drawableRows.map((r) => r.x.value as number),
+    MARGIN.left,
+    MARGIN.left + PLOT_W,
+    data.x.better === "lower",
+  );
+  // y 像素轴向下增长:正向 = 高值在上 → 映射到 [bottom, top];lower 反向 = 高值在下。
+  const yScale = axisScale(
+    drawableRows.map((r) => r.y.value as number),
+    MARGIN.top + PLOT_H,
+    MARGIN.top,
+    data.y.better === "lower",
+  );
+  const labelByKey = pointLabels(drawableRows.map((r) => r.key));
+  // 方向提示恒为「越靠右上越好」,仅当两轴都声明 better 时显示——任一轴未声明,
+  // 组件不猜「更好」朝哪边,整图无提示。
+  const showBetterHint = data.x.better !== undefined && data.y.better !== undefined;
 
   const points: DrawablePoint[] = drawableRows.map((r) => {
     const xValue = r.x.value as number;
@@ -101,12 +149,11 @@ export function MetricScatter({
     return {
       key: r.key,
       series: r.series,
-      label: pointLabel(r.key),
+      label: labelByKey.get(r.key) ?? r.key,
       xValue,
       yValue,
-      // hover 内容:experiment(点键)+ 系列(series,ExperimentComparison 传的是 agent 维度,
-      // 有则加一行;无系列的散点没有这行)+ 两轴 display 与 samples/total(docs/feature/reports/library.md「MetricScatter」行为清单)
-      title: `${r.key}${r.series !== undefined ? `\n${r.series}` : ""}\n${xLabel}: ${r.x.display}(${r.x.samples}/${r.x.total})\n${yLabel}: ${r.y.display}(${r.y.samples}/${r.y.total})`,
+      // hover 内容:experiment(点键)+ 系列(有则加一行)+ 两轴 display 与 samples/total
+      title: `${r.key}${r.series !== undefined ? `\n${r.series}` : ""}\n${xLabel}: ${resolveLocalizedText(r.x.display, locale)}(${r.x.samples}/${r.x.total})\n${yLabel}: ${resolveLocalizedText(r.y.display, locale)}(${r.y.samples}/${r.y.total})`,
       px: xScale.scale(xValue),
       py: yScale.scale(yValue),
     };
@@ -149,10 +196,17 @@ export function MetricScatter({
           ))}
         </g>
 
-        {/* 「好」的角落恒在右上:轴向已按 better 反转,这里只是把这句契约写在图上 */}
-        <text className="nre-scatter-better-hint" x={MARGIN.left + PLOT_W - 6} y={MARGIN.top + 14} textAnchor="end">
-          {localeText(locale, "scatter.betterHint")}
-        </text>
+        {/* 轴向已随 better 反正,「更好」恒指向右上;提示只在两轴都声明 better 时出现 */}
+        {showBetterHint && (
+          <text
+            className="nre-scatter-better-hint"
+            x={MARGIN.left + PLOT_W - 6}
+            y={MARGIN.top + 14}
+            textAnchor="end"
+          >
+            {localeText(locale, "scatter.betterUpperRight")}
+          </text>
+        )}
 
         {/* 刻度:已格式化的整齐值(formatMetricValue 与计算侧同一套) */}
         <g className="nre-scatter-axis nre-scatter-axis-y">

package/src/report/react/MetricTable.tsx

@@ -1,43 +1,20 @@
 // MetricTable:行维度 × 指标列。没有实体下钻——要展开到 experiment 的 Eval 或 Eval 的
 // Attempt,用 ExperimentList / EvalList,这个组件只表达任意维度 × 任意指标。
-// 行按传入顺序渲染——排序发生在计算侧(tableData 的 sort 参数),组件不重排;
+// 行按传入顺序渲染——排序发生在计算侧(metricTableData 的 sort 参数),组件不重排;
 // 静态 HTML 以数据侧预排的顺序呈现即完整。web 面额外输出渐进增强的 data 属性:
 // 所有表头带 data-nre-sort、格子带 data-sort-value,enhance.js 在场时点表头
 // 可就地重排(纯展示态交互,不改口径);filter 开时在表格前渲染过滤输入框。
-// meta 在场(rows: "experiment")时补 Model / Agent / Verdicts 列,列序对齐 view
-// 原生榜单:experiment、model、agent、指标列…、verdicts。
 // 列头以箭头标注 better 方向;samples < total 的格子带覆盖率角标;
 // 一组全 null 渲染成「缺数据」,绝不画 0(逻辑在 MetricCellView)。
 
 import type { ReactElement } from "react";
-import type { TableData, TableRowMeta } from "../types.ts";
+import type { TableData } from "../types.ts";
 import type { AttemptLocator } from "../../results/locator.ts";
 import { DEFAULT_REPORT_LOCALE, localeText, resolveMetricLabel, type ReportLocale } from "../locale.ts";
 import { MetricCellView } from "./cell.tsx";
 import { colorClassForKey } from "./colors.ts";
 import { cx } from "./format.ts";
 
-/** verdict 计票 pill(「3 passed / 1 failed」):非零判定各一枚,全零如实空。 */
-function VerdictTally({
-  verdicts,
-  locale,
-}: {
-  verdicts: NonNullable<TableRowMeta["verdicts"]>;
-  locale: ReportLocale;
-}): ReactElement {
-  const kinds = (["passed", "failed", "errored", "skipped"] as const).filter((k) => verdicts[k] > 0);
-  return (
-    <span className="nre-verdict-tally">
-      {kinds.map((kind) => (
-        <span key={kind} className={cx("nre-verdict-pill", `nre-verdict-${kind}`)}>
-          {verdicts[kind]} {localeText(locale, `verdict.${kind}`)}
-        </span>
-      ))}
-      {kinds.length === 0 && <span className="nre-missing">—</span>}
-    </span>
-  );
-}
-
 export function MetricTable({
   data,
   attemptHref,
@@ -51,27 +28,13 @@ export function MetricTable({
   className?: string;
   locale?: ReportLocale;
 }): ReactElement {
-  const hasMeta = data.rows.some((row) => row.meta !== undefined);
-  const hasModel = data.rows.some((row) => row.meta?.model !== undefined);
-  const hasVerdicts = data.rows.some((row) => row.meta?.verdicts !== undefined);
-
   const table = (
     <table className={cx("nre", "nre-metric-table", !filter && className)}>
       <thead>
         <tr>
           <th scope="col" className="nre-dimension" data-nre-sort="">
-            {data.dimension}
+            {data.rowDimension}
           </th>
-          {hasMeta && hasModel && (
-            <th scope="col" className="nre-meta-col" data-nre-sort="">
-              {localeText(locale, "table.model")}
-            </th>
-          )}
-          {hasMeta && (
-            <th scope="col" className="nre-meta-col" data-nre-sort="">
-              {localeText(locale, "table.agent")}
-            </th>
-          )}
           {data.columns.map((col) => (
             <th scope="col" key={col.key} className="nre-metric-col" data-nre-sort="">
               {resolveMetricLabel(col.label, locale, col.key)}
@@ -87,11 +50,6 @@ export function MetricTable({
               )}
             </th>
           ))}
-          {hasVerdicts && (
-            <th scope="col" className="nre-verdicts-col" data-nre-sort="">
-              {localeText(locale, "table.verdicts")}
-            </th>
-          )}
         </tr>
       </thead>
       <tbody>
@@ -104,28 +62,7 @@ export function MetricTable({
               data-sort-value={row.key}
             >
               {row.key}
-              {/* rows: "experiment" 专属:eval/attempt 数 + 最后运行时间,行键下的一行紧凑摘要
-                  (旧 ExperimentRow 的 "N eval results · N runs · 最后运行时间") */}
-              {row.meta?.evals !== undefined && (
-                <div className="nre-row-meta-sub">
-                  {localeText(locale, "overview.evalsCount", { n: row.meta.evals })}
-                  {row.meta.attempts !== undefined && row.meta.attempts > row.meta.evals
-                    ? ` · ${localeText(locale, "overview.attemptsCount", { n: row.meta.attempts })}`
-                    : ""}
-                  {row.meta.lastRunAt ? ` · ${localeText(locale, "latestRun", { run: row.meta.lastRunAt })}` : ""}
-                </div>
-              )}
             </th>
-            {hasMeta && hasModel && (
-              <td className="nre-td nre-meta-cell" data-sort-value={row.meta?.model ?? ""}>
-                {row.meta?.model ?? <span className="nre-missing">—</span>}
-              </td>
-            )}
-            {hasMeta && (
-              <td className="nre-td nre-meta-cell" data-sort-value={row.meta?.agent ?? ""}>
-                {row.meta?.agent ?? <span className="nre-missing">—</span>}
-              </td>
-            )}
             {data.columns.map((col) => {
               const cell = row.cells[col.key];
               return (
@@ -133,21 +70,12 @@ export function MetricTable({
                   {cell ? (
                     <MetricCellView cell={cell} attemptHref={attemptHref} locale={locale} />
                   ) : (
-                    // 数据侧没给这个格子(理论上 tableData 不会缺列)——按空处理,不编数
+                    // 数据侧没给这个格子(理论上 metricTableData 不会缺列)——按空处理,不编数
                     <span className="nre-empty" />
                   )}
                 </td>
               );
             })}
-            {hasVerdicts && (
-              <td className="nre-td nre-verdicts-cell" data-sort-value={row.meta?.verdicts?.passed ?? ""}>
-                {row.meta?.verdicts ? (
-                  <VerdictTally verdicts={row.meta.verdicts} locale={locale} />
-                ) : (
-                  <span className="nre-missing">—</span>
-                )}
-              </td>
-            )}
           </tr>
         ))}
       </tbody>

package/src/report/react/ScopeSummary.tsx

@@ -0,0 +1,86 @@
+// ScopeSummary:一个范围的摘要卡——快照时间窗、experiment / eval / attempt 数、判定计票、
+// 端到端成功率与总成本。data 恒携带 eval 级与 attempt 级两份计票;呈现 prop `votes`
+// 只选择显示哪一级(默认 "eval"),不改变 data。成功率与总成本只渲染算好的 MetricCell,
+// 不现场重算(docs/feature/reports/library/summaries.md「ScopeSummary」)。
+
+import type { ReactElement } from "react";
+import type { ScopeSummaryData, VerdictTally } from "../types.ts";
+import { DEFAULT_REPORT_LOCALE, localeText, type ReportLocale } from "../locale.ts";
+import { MetricCellView } from "./cell.tsx";
+import { cx } from "./format.ts";
+
+function VerdictTallyView({ tally, locale }: { tally: VerdictTally; locale: ReportLocale }): ReactElement {
+  const kinds = (["passed", "failed", "errored", "skipped"] as const).filter((k) => tally[k] > 0);
+  return (
+    <span className="nre-verdict-tally">
+      {kinds.map((kind) => (
+        <span key={kind} className={cx("nre-verdict-pill", `nre-verdict-${kind}`)}>
+          {tally[kind]} {localeText(locale, `verdict.${kind}`)}
+        </span>
+      ))}
+      {kinds.length === 0 && <span className="nre-missing">—</span>}
+    </span>
+  );
+}
+
+export function ScopeSummary({
+  data,
+  votes = "eval",
+  className,
+  locale = DEFAULT_REPORT_LOCALE,
+}: {
+  data: ScopeSummaryData;
+  /** 显示哪一级计票;默认 "eval"。data 恒携带两级,votes 只选择呈现。 */
+  votes?: "eval" | "attempt";
+  className?: string;
+  locale?: ReportLocale;
+}): ReactElement {
+  const tally = votes === "attempt" ? data.attemptVerdicts : data.evalVerdicts;
+  return (
+    <div className={cx("nre", "nre-scope-summary", className)} data-votes={votes}>
+      <dl className="nre-scope-kpis">
+        <div className="nre-scope-kpi nre-scope-kpi-rate">
+          <dt>{localeText(locale, "scopeSummary.passRate")}</dt>
+          <dd>
+            <MetricCellView cell={data.endToEndPassRate} locale={locale} />
+          </dd>
+        </div>
+        <div className="nre-scope-kpi">
+          <dt>{localeText(locale, "scopeSummary.experiments")}</dt>
+          <dd>{data.experiments}</dd>
+        </div>
+        <div className="nre-scope-kpi">
+          <dt>{localeText(locale, "scopeSummary.evals")}</dt>
+          <dd>{data.evals}</dd>
+        </div>
+        <div className="nre-scope-kpi">
+          <dt>{localeText(locale, "scopeSummary.attempts")}</dt>
+          <dd>{data.attempts}</dd>
+        </div>
+        <div className="nre-scope-kpi nre-scope-kpi-verdicts">
+          <dt>{localeText(locale, votes === "attempt" ? "scopeSummary.votesAttempt" : "scopeSummary.votesEval")}</dt>
+          <dd>
+            <VerdictTallyView tally={tally} locale={locale} />
+          </dd>
+        </div>
+        <div className="nre-scope-kpi">
+          <dt>{localeText(locale, "scopeSummary.totalCost")}</dt>
+          <dd>
+            <MetricCellView cell={data.totalCostUSD} locale={locale} />
+          </dd>
+        </div>
+      </dl>
+      {/* 时间窗:贡献当前数据的快照 startedAt 范围;空范围不编造当前时间 */}
+      {data.range.latestStartedAt !== null && (
+        <p className="nre-scope-summary-range">
+          {data.range.earliestStartedAt !== null && data.range.earliestStartedAt !== data.range.latestStartedAt
+            ? localeText(locale, "scopeSummary.range", {
+                from: data.range.earliestStartedAt,
+                to: data.range.latestStartedAt,
+              })
+            : data.range.latestStartedAt}
+        </p>
+      )}
+    </div>
+  );
+}