niceeval 0.6.2 → 0.7.0

package/src/view/styles.css

@@ -62,6 +62,10 @@ a { color: inherit; }
   display: flex;
   align-items: center;
   justify-content: space-between;
+  /* space-between 只在有富余空间时才撑开相邻项;.shell-links 的 margin-left:auto 会把富余
+     空间全部吸收到它左侧,导致品牌与导航贴脸、shell-links 与语言切换贴脸。显式 gap 保证
+     每一对相邻项(品牌—导航、shell-links—语言切换)恒有最小间距,不依赖富余空间。 */
+  gap: 28px;
   padding: 0 clamp(20px, 5vw, 80px);
   background: color-mix(in oklch, var(--bg), transparent 4%);
   position: sticky;
@@ -959,9 +963,229 @@ a.brand:hover { opacity: 0.75; }
 .code-orphans { border: 1px solid var(--line); border-radius: 10px; padding: 10px 12px; }
 .code-orphans-head { font-size: 11px; color: var(--muted); margin-bottom: 8px; }
 
+/* ── Attempt 详情(契约:docs/feature/reports/view.md「Attempt 详情」) ── */
+.modal-sect {
+  font-size: 11px;
+  font-weight: 660;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--muted);
+  margin-bottom: 6px;
+}
+/* 断言区:仅源码不可用时出现的 fallback 呈现面。 */
+.attempt-asserts { margin-bottom: 14px; }
+.attempt-asserts-open {
+  margin-top: 6px;
+  border: 1px solid var(--line);
+  border-radius: 10px;
+  background: var(--panel);
+  overflow: hidden;
+}
+/* 复用 CodeView 的 .assert-detail 排版,但脱离代码行上下文:去掉行内缩进与左缘。 */
+.attempt-asserts .assert-detail { padding: 10px 12px; border-left: 0; background: transparent; }
+/* 长 expected/received(整文件 dump)一律有界滚动:断言明细无论住在失败索引 fallback、
+   源码行展开还是 NoSourceBody,都不把页面其余区块挤出视口。 */
+.assert-reason { max-height: 180px; overflow-y: auto; }
+/* 失败索引行:summary 一行是标题(徽章/名字/matcher/锚),明细收在行内一次展开。 */
+.fail-row { border-bottom: 1px solid var(--line); }
+.fail-row:last-child { border-bottom: 0; }
+.fail-sum {
+  display: flex;
+  align-items: baseline;
+  flex-wrap: wrap;
+  gap: 4px 8px;
+  padding: 8px 12px;
+  cursor: pointer;
+  user-select: none;
+  list-style: none;
+  min-width: 0;
+}
+.fail-sum::-webkit-details-marker { display: none; }
+.fail-sum::before {
+  content: "";
+  width: 0;
+  height: 0;
+  border-left: 4px solid var(--soft);
+  border-top: 3.5px solid transparent;
+  border-bottom: 3.5px solid transparent;
+  flex-shrink: 0;
+  align-self: center;
+  transition: transform 0.12s;
+}
+.fail-row[open] > .fail-sum::before { transform: rotate(90deg); }
+.fail-sum:hover { background: color-mix(in oklch, var(--panel), var(--line) 30%); }
+.fail-name {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 12px;
+  color: var(--text);
+  overflow-wrap: anywhere;
+}
+.fail-matcher {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 11.5px;
+  color: var(--muted);
+  overflow-wrap: anywhere;
+}
+.fail-body {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 2px 12px 10px 24px;
+}
+.assert-loc {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 11px;
+  color: var(--soft);
+  margin-left: 8px;
+  white-space: nowrap;
+}
+.asserts-passed { margin-top: 8px; }
+.asserts-passed > summary,
+.asserts-passed-group > summary {
+  cursor: pointer;
+  user-select: none;
+  font-size: 12px;
+  color: var(--muted);
+}
+.asserts-passed > summary:hover,
+.asserts-passed-group > summary:hover { color: var(--text); }
+.asserts-passed-group { margin: 6px 0 0 14px; }
+.asserts-passed-group > .assert-detail { margin-top: 4px; }
+
+/* ── Attempt 详情:统一时间树(整区默认收合;展开后主链分解条 + 默认收合的 children) ── */
+.attempt-timing { margin: 14px 0; }
+summary.timing-sum {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  cursor: pointer;
+  user-select: none;
+  list-style: none;
+}
+summary.timing-sum::-webkit-details-marker { display: none; }
+summary.timing-sum::before {
+  content: "";
+  width: 0;
+  height: 0;
+  border-left: 4px solid var(--soft);
+  border-top: 3.5px solid transparent;
+  border-bottom: 3.5px solid transparent;
+  flex-shrink: 0;
+  transition: transform 0.12s;
+}
+details[open] > summary.timing-sum::before { transform: rotate(90deg); }
+summary.timing-sum:hover .modal-sect { color: var(--text); }
+.timing-sum .modal-sect { margin-bottom: 0; }
+.phase-bar {
+  display: flex;
+  height: 8px;
+  border-radius: 4px;
+  overflow: hidden;
+  gap: 1px;
+  margin: 7px 0 8px;
+}
+.phase-seg { min-width: 2px; flex-basis: 0; }
+.phase-seg-1 { background: var(--series-1); }
+.phase-seg-2 { background: var(--series-2); }
+.phase-seg-3 { background: var(--series-3); }
+.phase-seg-4 { background: var(--series-4); }
+.phase-seg-5 { background: var(--series-5); }
+.phase-seg-6 { background: var(--series-6); }
+.phase-seg-bad { background: var(--bad); }
+.phase-list,
+.timing-kids { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; }
+.timing-kids { padding-left: 18px; margin-top: 2px; }
+.phase-row,
+.tnode-row { display: flex; align-items: center; gap: 7px; font-size: 12px; line-height: 1.7; min-width: 0; }
+summary.phase-row,
+summary.tnode-row { cursor: pointer; user-select: none; list-style: none; }
+summary.phase-row::-webkit-details-marker,
+summary.tnode-row::-webkit-details-marker { display: none; }
+summary.phase-row::before,
+summary.tnode-row::before {
+  content: "";
+  width: 0;
+  height: 0;
+  border-left: 4px solid var(--soft);
+  border-top: 3.5px solid transparent;
+  border-bottom: 3.5px solid transparent;
+  flex-shrink: 0;
+  transition: transform 0.12s;
+}
+details[open] > summary.phase-row::before,
+details[open] > summary.tnode-row::before { transform: rotate(90deg); }
+/* 无 children 的行:占位对齐有箭头的行。 */
+li.phase-row::before,
+li.tnode-row::before { content: ""; width: 4px; flex-shrink: 0; }
+.phase-dot { width: 8px; height: 8px; border-radius: 2px; flex-shrink: 0; }
+.phase-dot-none { background: transparent; }
+/* 名称列定宽:各行的耗时起始对齐成一列(最长 phase 名 telemetry.configure 也在宽度内)。 */
+.phase-name { color: var(--text); white-space: nowrap; width: 168px; flex-shrink: 0; }
+.phase-dur { color: var(--muted); font-variant-numeric: tabular-nums; white-space: nowrap; }
+.phase-fail { color: var(--bad); font-weight: 650; }
+.phase-kids {
+  font-size: 10px;
+  color: var(--soft);
+  border: 1px solid var(--line);
+  border-radius: 999px;
+  padding: 0 6px;
+  line-height: 1.5;
+}
+.tnode-label {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 11.5px;
+  color: var(--muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+}
+.tnode-meta { font-size: 11px; color: var(--soft); padding: 3px 0 3px 18px; }
+.tnode-trace { margin: 4px 0 6px 18px; }
+.phase-closing { margin-top: 8px; }
+.phase-closing-head { font-size: 11px; color: var(--soft); margin-bottom: 2px; }
+
+/* usage / sandbox 元信息 chips。 */
+.meta-chips { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 12px; }
+.meta-chip {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 11px;
+  color: var(--muted);
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  padding: 3px 9px;
+  background: var(--panel);
+}
+.meta-chip b { color: var(--text); font-weight: 640; }
+
 /* lightweight TS syntax tokens */
 .tok-comment { color: var(--soft); font-style: italic; }
 .tok-str { color: light-dark(#0a7d3c, #7ee787); }
 .tok-kw { color: light-dark(#9333ea, #c792ea); }
 .tok-num { color: light-dark(#b25000, #f0a36b); }
 .tok-fn { color: light-dark(#0b62d6, #82aaff); }
+
+/* ── 外壳:导航右侧外部链接与页脚(docs/feature/reports/library/shell.md) ── */
+.shell-links { display: flex; gap: 8px; align-items: center; margin-left: auto; }
+/* 链接自带 padding 撑大可点击区域(而非仅靠文字宽度);.shell-links 的 gap 相应收窄,
+   两条链接之间的视觉间距(padding + gap + padding)与改前基本持平。 */
+.shell-links a { color: var(--soft); text-decoration: none; font-size: 13px; display: inline-flex; align-items: center; gap: 6px; padding: 6px 4px; }
+.shell-links a:hover { color: var(--text); }
+/* ReportLink.icon:内联 SVG 字标,渲染在 label 前(shell.md「字段穷尽」)。 */
+.shell-link-icon { display: inline-flex; align-items: center; }
+.shell-link-icon svg { width: 14px; height: 14px; display: block; fill: currentColor; }
+.site-footer {
+  display: flex;
+  gap: 12px;
+  align-items: baseline;
+  justify-content: center;
+  flex-wrap: wrap;
+  padding: 24px 24px 32px;
+  color: var(--soft);
+  font-size: 12px;
+}
+/* 品牌行:hero 之下、品牌蓝,恒带官网链接(shell.md「行为约束」)。 */
+.hero .powered-by { display: block; margin-top: 16px; font-size: 12px; }
+.hero .powered-by a { color: var(--blue); text-decoration: none; }
+.hero .powered-by a:hover { text-decoration: underline; }
+.nre-page-error pre { white-space: pre-wrap; }

package/src/view/view-report.test.ts

@@ -1,10 +1,11 @@
 // cases: docs/engineering/unit-tests/reports/cases.md
 // niceeval view 的报告槽与宿主组合语义(docs/feature/reports/architecture.md「Selection 是计算入口」
-// 与裁决记录 6;公开行为准绳 docs-site/zh/guides/viewing-results.mdx / custom-reports.mdx)。
+// 与裁决记录 6;公开行为准绳 docs-site/zh/how-to/viewing-results.mdx / custom-reports.mdx)。
 // 覆盖:
-// - 组合语义与 show 对齐:位置前缀收窄报告槽 Selection、--experiment 过滤、匹配不到直说;
-// - 单文件模式共存:存在的文件路径 → 单文件模式,目录报错直说走 --run,其余按 eval 前缀;
-// - 报告槽恒在:裸跑填充 ExperimentComparison,--report 整槽替换;en / zh-CN 双语各渲染一遍;
+// - 组合语义与 show 对齐:位置前缀收窄报告槽 Scope、--experiment 过滤、匹配不到直说;
+// - 输入语义:位置参数只表示 eval id 前缀(不随文件系统状态改变),结果根走 --results,
+//   单开一份快照走 --snapshot(文件不可读时失败);
+// - 报告槽恒在:裸跑填充内建报告,--report 整槽替换;en / zh-CN 双语各渲染一遍;
 //   裸跑 ≡ --report <re-export ExperimentComparison 的文件>(等价性);
 // - --out 静态导出:index.html 含两个语言的报告块、官方样式与增强 runtime,报告块零 <script>;
 // - dev server 装载语义:报告文件变更 → 下次装载整页重算(mtime cache-busting)。
@@ -21,7 +22,8 @@ import { afterEach, describe, expect, it } from "vitest";
 // (see src/view/data.ts's comment) — a raw-src import would be a structurally-identical but
 // `instanceof`-incompatible class.
 import { ReportLoadError } from "../../dist/report/load.js";
-import { ViewInputError, loadViewScan } from "./data.ts";
+import { ViewInputError, loadViewScan, type ViewScan } from "./data.ts";
+import { renderHtml } from "./server.ts";
 import { buildView, resolveViewInput } from "./index.ts";
 import { runShow } from "../show/index.ts";
 import { RESULTS_FORMAT, RESULTS_SCHEMA_VERSION, type EvalResult, type Verdict } from "../types.ts";
@@ -96,47 +98,62 @@ async function seedRoot(): Promise<string> {
 
 // ───────────────────────── 位置参数语义(单文件模式共存) ─────────────────────────
 
-describe("resolveViewInput · 位置参数语义", () => {
-  it("存在的文件路径 → 单文件模式;其余位置参数按 eval id 前缀", async () => {
+describe("resolveViewInput · 输入语义", () => {
+  it("位置参数只表示 eval id 前缀:文件与目录路径不改变含义", async () => {
     const root = await seedRoot();
     const file = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "snapshot.json");
-    expect(resolveViewInput(root, [file])).toEqual({ input: file, patterns: [] });
+    // 恰好是存在文件/目录的位置参数也照常当前缀(后续按「无匹配」报错,不做模糊猜测)。
+    expect(resolveViewInput(root, [file])).toEqual({ patterns: [file] });
+    expect(resolveViewInput(root, ["compare_bub"])).toEqual({ patterns: ["compare_bub"] });
     expect(resolveViewInput(root, ["weather", "fixtures/button"])).toEqual({
       patterns: ["weather", "fixtures/button"],
     });
     expect(resolveViewInput(root, [])).toEqual({ patterns: [] });
   });
 
-  it("目录位置参数:报错直说走 --run(位置参数留给 eval id 前缀)", async () => {
+  it("--snapshot 单开一份快照文件;文件不可读时失败(与扫描模式的跳过相反)", async () => {
     const root = await seedRoot();
-    expect(() => resolveViewInput(root, ["compare_bub"])).toThrow(ViewInputError);
-    expect(() => resolveViewInput(root, ["compare_bub"])).toThrow(/--run/);
+    const file = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "snapshot.json");
+    expect(resolveViewInput(root, [], { snapshot: file })).toEqual({ input: file, patterns: [] });
+    expect(() => resolveViewInput(root, [], { snapshot: join(root, "nope.json") })).toThrow(ViewInputError);
+    expect(() => resolveViewInput(root, [], { snapshot: join(root, "nope.json") })).toThrow(/--snapshot/);
+    // 目录不是快照文件。
+    expect(() => resolveViewInput(root, [], { snapshot: join(root, "compare_bub") })).toThrow(/--snapshot/);
   });
 
-  it("单文件模式不与其它位置参数或 --run 混用,歧义报错直说", async () => {
+  it("--results 指向不存在的目录:直说", async () => {
     const root = await seedRoot();
-    const file = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "snapshot.json");
-    expect(() => resolveViewInput(root, [file, "weather"])).toThrow(/exactly one path/);
-    expect(() => resolveViewInput(root, [file], root)).toThrow(/--run/);
+    expect(() => resolveViewInput(root, [], { results: join(root, "nope") })).toThrow(/Results directory not found/);
   });
 
-  it("--run 指向不存在的目录:直说", async () => {
+  it("--results 换结果根,位置参数仍是前缀", async () => {
     const root = await seedRoot();
-    expect(() => resolveViewInput(root, [], join(root, "nope"))).toThrow(/Results directory not found/);
+    expect(resolveViewInput("/elsewhere", ["weather"], { results: root })).toEqual({ input: root, patterns: ["weather"] });
   });
 
-  it("--run 换结果根,位置参数仍是前缀", async () => {
+  it("--results 与 --snapshot 互斥:报错直说", async () => {
     const root = await seedRoot();
-    expect(resolveViewInput("/elsewhere", ["weather"], root)).toEqual({ input: root, patterns: ["weather"] });
+    const file = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "snapshot.json");
+    expect(() => resolveViewInput(root, [], { results: root, snapshot: file })).toThrow(/mutually exclusive/);
   });
 });
 
+
+/** 单页报告(裸跑 / 树形态 --report)的报告槽 HTML:规范化后唯一页 id 恒为 `report`。 */
+function slotHtml(scan: ViewScan): { en: string; "zh-CN": string } {
+  expect(scan.reportPages).toHaveLength(1);
+  expect(scan.reportPages[0]!.id).toBe("report");
+  return scan.reportPages[0]!.html as { en: string; "zh-CN": string };
+}
+
 // ───────────────────────── 组合语义(与 show 对齐) ─────────────────────────
 
 describe("loadViewScan · 组合语义", () => {
   it("位置前缀收窄报告槽 Selection;证据室快照不收窄,深链恒可达", async () => {
     const root = await seedRoot();
-    const { viewData, reportHtml } = await loadViewScan(root, { patterns: ["weather"] });
+    const scan = await loadViewScan(root, { patterns: ["weather"] });
+    const { viewData } = scan;
+    const reportHtml = slotHtml(scan);
     // 报告槽:两实验都只剩 weather/brooklyn 一题,范围外的失败不再出现。
     expect(reportHtml.en).toContain("compare/bub");
     expect(reportHtml.en).toContain("compare/codex");
@@ -148,7 +165,7 @@ describe("loadViewScan · 组合语义", () => {
 
   it("--experiment 过滤:报告槽 Selection 只留该实验", async () => {
     const root = await seedRoot();
-    const { reportHtml } = await loadViewScan(root, { experiment: "compare/codex" });
+    const reportHtml = slotHtml(await loadViewScan(root, { experiment: "compare/codex" }));
     expect(reportHtml.en).toContain("compare/codex");
     expect(reportHtml.en).not.toContain("compare/bub");
   });
@@ -162,7 +179,7 @@ describe("loadViewScan · 组合语义", () => {
 
   it("全部缺省:报告槽使用现刻水位口径(与 show 相同的合成规则)", async () => {
     const root = await seedRoot();
-    const { reportHtml } = await loadViewScan(root);
+    const reportHtml = slotHtml(await loadViewScan(root));
     // 默认报告的榜单含两个实验;官方组件的稳定类名在场。
     expect(reportHtml.en).toContain("compare/bub");
     expect(reportHtml.en).toContain("compare/codex");
@@ -175,17 +192,19 @@ describe("loadViewScan · 组合语义", () => {
 describe("loadViewScan · 默认报告槽(裸跑)", () => {
   it("裸跑产出的报告槽 HTML 与 --report <re-export ExperimentComparison 的文件> 完全一致(双语)", async () => {
     const root = await seedRoot();
-    const bare = await loadViewScan(root);
-    const viaReport = await loadViewScan(root, {
-      report: { path: DEFAULT_REPORT_REEXPORT, cwd: root },
-    });
-    expect(bare.reportHtml.en).toBe(viaReport.reportHtml.en);
-    expect(bare.reportHtml["zh-CN"]).toBe(viaReport.reportHtml["zh-CN"]);
+    const bare = slotHtml(await loadViewScan(root));
+    const viaReport = slotHtml(
+      await loadViewScan(root, {
+        report: { path: DEFAULT_REPORT_REEXPORT, cwd: root },
+      }),
+    );
+    expect(bare.en).toBe(viaReport.en);
+    expect(bare["zh-CN"]).toBe(viaReport["zh-CN"]);
   });
 
   it("报告槽双语渲染:同一棵树按 locale 渲染两遍,chrome 文案分语言、数据不分语言", async () => {
     const root = await seedRoot();
-    const { reportHtml } = await loadViewScan(root);
+    const reportHtml = slotHtml(await loadViewScan(root));
     expect(reportHtml.en).toContain("End-to-end pass rate"); // ExperimentList 主行(en)
     expect(reportHtml["zh-CN"]).toContain("端到端成功率"); // ExperimentList 主行(zh-CN)
     for (const html of [reportHtml.en, reportHtml["zh-CN"]]) {
@@ -199,8 +218,9 @@ describe("loadViewScan · 默认报告槽(裸跑)", () => {
 
   it("失败清单与警告住在报告槽里:ExperimentList 列出失败,壳的 viewData 不携带统计产物", async () => {
     const root = await seedRoot();
-    const { viewData, reportHtml } = await loadViewScan(root);
-    expect(reportHtml.en).toContain("fixtures/button");
+    const scan = await loadViewScan(root);
+    const { viewData } = scan;
+    expect(slotHtml(scan).en).toContain("fixtures/button");
     // viewData 只有证据室数据:快照 + skipped + 壳元信息。
     expect(viewData).not.toHaveProperty("overview");
     expect(viewData).not.toHaveProperty("table");
@@ -214,14 +234,14 @@ describe("loadViewScan · --report 报告槽", () => {
   it("报告树渲染为静态 HTML:官方水位 + 自定义摆法 + <Style> 产物 + 证据室深链,零 <script>", async () => {
     const root = await seedRoot();
     const scan = await loadViewScan(root, { report: { path: EXAM_REPORT, cwd: root } });
-    const html = scan.reportHtml.en;
+    const html = slotHtml(scan).en;
     expect(html).toContain("考试成绩单"); // 自定义 Section
     expect(html).toContain("nre-"); // 官方组件的稳定类名
     expect(html).toContain("<style>.exam-note { color: #4a7; }</style>"); // <Style> 随树带走
     expect(html).toMatch(/href="#\/attempt\/@[0-9a-z]+"/); // 失败案例深链进证据室(单段 locator 路由)
     expect(html).not.toContain("<script"); // 报告槽产物零客户端 JS,不 hydrate
     // 用户报告同样双语渲染两遍(壳按界面语言摆放)。
-    expect(scan.reportHtml["zh-CN"]).toContain("考试成绩单");
+    expect(slotHtml(scan)["zh-CN"]).toContain("考试成绩单");
     // 证据室数据契约(__NICEEVAL_VIEW_DATA__)原样保留:快照、locator、skipped 不动。
     expect(scan.viewData.snapshots.length).toBeGreaterThan(0);
     expect(scan.viewData.snapshots.flatMap((s) => s.results).every((r) => r.locator)).toBe(true);
@@ -235,15 +255,16 @@ describe("loadViewScan · --report 报告槽", () => {
       report: { path: EXAM_REPORT, cwd: root },
     });
     // 范围外的失败(fixtures/button)不再出现在报告里;范围内的实验行都在。
-    expect(scan.reportHtml.en).not.toContain("fixtures/button");
-    expect(scan.reportHtml.en).toContain("compare/bub");
-    expect(scan.reportHtml.en).toContain("compare/codex");
+    const html = slotHtml(scan);
+    expect(html.en).not.toContain("fixtures/button");
+    expect(html.en).toContain("compare/bub");
+    expect(html.en).toContain("compare/codex");
   });
 
   it("show --report 与 view --report 吃同一个报告文件,判定口径一致", async () => {
     const root = await seedRoot();
     let text = "";
-    const code = await runShow(root, [], { run: root, report: EXAM_REPORT }, {
+    const code = await runShow(root, [], { results: root, report: EXAM_REPORT }, {
       out: (s) => (text += s),
       err: () => {},
       width: 120,
@@ -251,9 +272,10 @@ describe("loadViewScan · --report 报告槽", () => {
     expect(code).toBe(0);
     const scan = await loadViewScan(root, { report: { path: EXAM_REPORT, cwd: root } });
     // 同一棵树的两个面:同一份失败清单与同一个自定义 Section。
+    const html = slotHtml(scan);
     for (const needle of ["考试成绩单", "compare/bub", "compare/codex", "fixtures/button"]) {
       expect(text).toContain(needle);
-      expect(scan.reportHtml.en).toContain(needle);
+      expect(html.en).toContain(needle);
     }
   });
 
@@ -270,6 +292,57 @@ describe("loadViewScan · --report 报告槽", () => {
   });
 });
 
+// ───────────────────── 外壳:title 落点(hero / <title>)与 ReportLink.icon ─────────────────────
+
+describe("loadViewScan · 外壳标题与 ReportLink.icon", () => {
+  /** 不经包入口也合法的最小外壳报告(与下方 reportSource 同一姿势):声明 title 与带 icon 的 link。 */
+  function shellReportSource(): string {
+    return [
+      'const FACES = Symbol.for("niceeval.report.faces");',
+      'const DEFINITION = Symbol.for("niceeval.report.definition");',
+      "const Block = (props) => Block[FACES].web(props);",
+      "Block[FACES] = {",
+      '  web: () => "SHELL_BODY",',
+      '  text: () => "SHELL_BODY",',
+      "};",
+      "const definition = {",
+      '  kind: "report",',
+      '  title: { en: "Memory Evals", "zh-CN": "记忆能力评测" },',
+      '  links: [{ label: "GitHub", href: "https://example.com", icon: { svg: "<svg data-mark></svg>" } }],',
+      "  scripts: [],",
+      "  styles: [],",
+      '  pages: [{ id: "report", title: "Report", content: { $$typeof: Symbol.for("react.transitional.element"), type: Block, props: {}, key: null } }],',
+      "};",
+      "Object.defineProperty(definition, DEFINITION, { value: true });",
+      "export default definition;",
+      "",
+    ].join("\n");
+  }
+
+  it("def.title 进 viewData.report.title,初始 <title> 同源烘进 HTML;link 的 icon svg 原样透传", async () => {
+    const root = await seedRoot();
+    const path = join(root, "shell-report.mjs");
+    await writeFile(path, shellReportSource(), "utf-8");
+    const scan = await loadViewScan(root, { report: { path, cwd: root } });
+    // 标题回退链第一级:def.title 原样(hero 与浏览器标题都吃它)。
+    expect(scan.viewData.report?.title).toEqual({ en: "Memory Evals", "zh-CN": "记忆能力评测" });
+    // ReportLink.icon 经 viewData 序列化边界原样透传(web 面在 label 前渲染,静态导出原样内联)。
+    expect(scan.viewData.report?.links).toEqual([
+      { label: "GitHub", href: "https://example.com", icon: { svg: "<svg data-mark></svg>" } },
+    ]);
+    const html = await renderHtml(scan);
+    expect(html).toContain("<title>Memory Evals</title>");
+  });
+
+  it("无 def.title 且快照无 name:标题落内置文案「Eval 运行结果 / Eval Results」,不再是产品名", async () => {
+    const root = await seedRoot(); // seedRoot 的快照都没有 name
+    const scan = await loadViewScan(root);
+    expect(scan.viewData.report?.title).toEqual({ en: "Eval Results", "zh-CN": "Eval 运行结果" });
+    const html = await renderHtml(scan);
+    expect(html).toContain("<title>Eval Results</title>");
+  });
+});
+
 // ───────────────────────── dev server 装载语义:整页重算 ─────────────────────────
 
 describe("loadViewScan · 报告文件变更整页重算", () => {
@@ -277,20 +350,21 @@ describe("loadViewScan · 报告文件变更整页重算", () => {
   function reportSource(marker: string): string {
     return [
       'const FACES = Symbol.for("niceeval.report.faces");',
+      'const DEFINITION = Symbol.for("niceeval.report.definition");',
       "const Block = (props) => Block[FACES].web(props);",
       "Block[FACES] = {",
       `  web: () => "${marker}",`,
       `  text: () => "${marker}",`,
       "};",
-      "export default {",
-      '  [Symbol.for("niceeval.report.definition")]: true,',
-      "  build: () => ({",
-      '    $$typeof: Symbol.for("react.transitional.element"),',
-      "    type: Block,",
-      "    props: {},",
-      "    key: null,",
-      "  }),",
+      "const definition = {",
+      '  kind: "report",',
+      "  links: [],",
+      "  scripts: [],",
+      "  styles: [],",
+      '  pages: [{ id: "report", title: "Report", content: { $$typeof: Symbol.for("react.transitional.element"), type: Block, props: {}, key: null } }],',
       "};",
+      "Object.defineProperty(definition, DEFINITION, { value: true });",
+      "export default definition;",
       "",
     ].join("\n");
   }
@@ -299,16 +373,16 @@ describe("loadViewScan · 报告文件变更整页重算", () => {
     const root = await seedRoot();
     const path = join(root, "report.mjs");
     await writeFile(path, reportSource("FIRST_RENDER"), "utf-8");
-    const first = await loadViewScan(root, { report: { path, cwd: root } });
-    expect(first.reportHtml.en).toContain("FIRST_RENDER");
+    const first = slotHtml(await loadViewScan(root, { report: { path, cwd: root } }));
+    expect(first.en).toContain("FIRST_RENDER");
 
     await writeFile(path, reportSource("SECOND_RENDER"), "utf-8");
     // mtime 精度兜底:显式把 mtime 拨到未来,确保与首次装载可区分。
     const future = new Date(Date.now() + 5000);
     await utimes(path, future, future);
-    const second = await loadViewScan(root, { report: { path, cwd: root } });
-    expect(second.reportHtml.en).toContain("SECOND_RENDER");
-    expect(second.reportHtml.en).not.toContain("FIRST_RENDER");
+    const second = slotHtml(await loadViewScan(root, { report: { path, cwd: root } }));
+    expect(second.en).toContain("SECOND_RENDER");
+    expect(second.en).not.toContain("FIRST_RENDER");
   });
 });
 
@@ -328,12 +402,12 @@ describe("buildView · --out 与 --report", () => {
 
     const html = await readFile(join(out, "index.html"), "utf-8");
     // 双语两个 <template> 静态块都在,壳按界面语言摆放。
-    expect(html).toContain('<template id="niceeval-report-en">');
-    expect(html).toContain('<template id="niceeval-report-zh-CN">');
+    expect(html).toContain('<template id="niceeval-report-report-en">');
+    expect(html).toContain('<template id="niceeval-report-report-zh-CN">');
     expect(html).toContain("考试成绩单");
     expect(html).toContain("nre-"); // 官方组件样式(report/react/styles.css)随页注入
     // 报告块本体零 <script>:静态块起于 <template>,内部只有标记与 <style>。
-    const block = html.split('<template id="niceeval-report-en">')[1]!.split("</template>")[0]!;
+    const block = html.split('<template id="niceeval-report-report-en">')[1]!.split("</template>")[0]!;
     expect(block).not.toContain("<script");
     // 证据室同站: artifact 按 /artifact/<base>/ 布局复制。
     expect(
@@ -341,17 +415,47 @@ describe("buildView · --out 与 --report", () => {
     ).toBe(true);
   });
 
+  it("--out 无档位:diff.json 有就带,o11y.json 永不复制", async () => {
+    const root = await seedRoot();
+    const artifactDir = join(root, "compare_codex", "2026-07-09T10-00-00-000Z", "weather", "brooklyn", "a0");
+    await mkdir(artifactDir, { recursive: true });
+    await writeFile(join(artifactDir, "events.json"), "[]", "utf-8");
+    await writeFile(join(artifactDir, "diff.json"), '{"windows":[]}', "utf-8");
+    await writeFile(join(artifactDir, "o11y.json"), "{}", "utf-8");
+
+    const out = join(root, "site");
+    await buildView({ input: root, out, allowSensitiveArtifacts: true });
+    const exported = join(out, "artifact", "compare_codex/2026-07-09T10-00-00-000Z/weather/brooklyn/a0");
+    expect(existsSync(join(exported, "diff.json"))).toBe(true);
+    expect(existsSync(join(exported, "events.json"))).toBe(true);
+    expect(existsSync(join(exported, "o11y.json"))).toBe(false);
+  });
+
+  it("--out 与位置参数 / --experiment 互斥:报错含 copySnapshots + filter 下一步", async () => {
+    const root = await seedRoot();
+    const out = join(root, "site");
+    for (const scan of [{ patterns: ["weather"] }, { experiment: "compare/bub" }]) {
+      const attempt = buildView({ input: root, out, allowSensitiveArtifacts: true, scan });
+      await expect(attempt).rejects.toBeInstanceOf(ViewInputError);
+      await expect(
+        buildView({ input: root, out, allowSensitiveArtifacts: true, scan }),
+      ).rejects.toThrow(/copySnapshots/);
+    }
+    // 同参数不带 --out 时照常收窄报告槽(不报错)。
+    await expect(loadViewScan(root, { patterns: ["weather"] })).resolves.toBeTruthy();
+  });
+
   it("默认导出(无 --report):报告槽填充 ExperimentComparison,双语块与增强 runtime 恒内联", async () => {
     const root = await seedRoot();
     const out = join(root, "site");
     await buildView({ input: root, out, allowSensitiveArtifacts: true });
     const html = await readFile(join(out, "index.html"), "utf-8");
-    expect(html).toContain('<template id="niceeval-report-en">');
-    expect(html).toContain('<template id="niceeval-report-zh-CN">');
+    expect(html).toContain('<template id="niceeval-report-report-en">');
+    expect(html).toContain('<template id="niceeval-report-report-zh-CN">');
     expect(html).toContain("nre-"); // 官方组件的稳定类名(KPI / 榜单 / 散点来自 nre 组件)
     // 渐进增强 runtime(排序 / 过滤 / tooltip)恒内联;报告块本体仍零 <script>。
     expect(html).toContain("__nreEnhanced");
-    const block = html.split('<template id="niceeval-report-en">')[1]!.split("</template>")[0]!;
+    const block = html.split('<template id="niceeval-report-report-en">')[1]!.split("</template>")[0]!;
     expect(block).not.toContain("<script");
   });
 });