niceeval 0.8.1 → 0.9.1

package/src/show/report-host.test.ts

@@ -8,16 +8,32 @@ import {
   BUILT_IN_PAGE_TITLE,
   BUILT_IN_REPORT_TITLE,
   HostReportError,
+  loadHostReport,
   localizeText,
   localizedTextEquals,
   normalizeHostReport,
   resolveReportTitle,
   showCommand,
 } from "./report-host.ts";
-import { pageIndexText } from "./render.ts";
+import { otherPagesText } from "./render.ts";
+// dist-sourced:裸宿主装载的就是这份预编译产物的默认导出(show 与 view 同一条路),
+// raw-src import 会是另一份模块实例,引用等同断言必须对着 dist。
+import distBuiltInReport from "../../dist/report/built-in/index.js";
 
 const tree = { kind: "node" }; // 页 content 对宿主是不透明值,规范化不解析树
 
+describe("裸宿主装载内建报告", () => {
+  it("缺省(无 --report)装载 niceeval/report/built-in 的默认导出:三页与其 content 同引用", async () => {
+    const host = await loadHostReport(process.cwd(), undefined);
+    const builtIn = distBuiltInReport as { pages: readonly { id: string; content: unknown }[] };
+    expect(host.pages.map((p) => p.id)).toEqual(["report", "attempts", "traces"]);
+    expect(builtIn.pages.map((p) => p.id)).toEqual(["report", "attempts", "traces"]);
+    for (let i = 0; i < host.pages.length; i++) {
+      expect(host.pages[i]!.content).toBe(builtIn.pages[i]!.content); // 同一份默认导出,不是复制品
+    }
+  });
+});
+
 describe("装载规范化:外壳 + 非空页列表", () => {
   it("content 缩写展开为唯一页 id `report`,页名是内置页名「报告 / Report」", () => {
     const report = normalizeHostReport({ kind: "report", content: tree }, "reports/frontier.tsx");
@@ -45,13 +61,13 @@ describe("装载规范化:外壳 + 非空页列表", () => {
     expect(report.footer).toBe("Published nightly.");
   });
 
-  it("content 与 pages 恰好声明一个:同给 / 同缺都报错,文案给出 <ExperimentComparison /> 下一步", () => {
+  it("content 与 pages 恰好声明一个:同给 / 同缺都报错,文案给出 extends: standard 下一步", () => {
     for (const bad of [
       { kind: "report", content: tree, pages: [{ id: "a", title: "A", content: tree }] },
       { kind: "report", title: "T" },
     ]) {
       expect(() => normalizeHostReport(bad, "reports/site.tsx")).toThrow(HostReportError);
-      expect(() => normalizeHostReport(bad, "reports/site.tsx")).toThrow(/<ExperimentComparison \/>/);
+      expect(() => normalizeHostReport(bad, "reports/site.tsx")).toThrow(/niceeval\/report\/built-in/);
     }
   });
 
@@ -141,7 +157,7 @@ describe("LocalizedText 回退:locale → en → 键字典序第一个非空值"
   });
 });
 
-describe("页索引与索引命令上下文", () => {
+describe("其余页索引与索引命令上下文", () => {
   const report = normalizeHostReport(
     {
       kind: "report",
@@ -155,34 +171,35 @@ describe("页索引与索引命令上下文", () => {
     "reports/site.tsx",
   );
 
-  it("索引命令保留当前 --results / --report 与位置参数,复制即可复现下一层视图", () => {
-    const text = pageIndexText({
-      report,
-      title: "记忆能力评测",
+  it("只列未渲染的页,索引命令保留当前 --results / --report 与位置参数,复制即可复现下一层视图", () => {
+    // 渲染的是 overview,其余页索引只含 exam 一行——与「渲染初始页 + 尾部附其余页索引」
+    // 的新行为一致(docs/feature/reports/show/reports.md Case 2)。
+    const text = otherPagesText({
+      otherPages: report.pages.filter((p) => p.id !== "overview").map((p) => ({ id: p.id, title: p.title })),
       command: { patterns: [], results: "tmp/published-results", report: "reports/site.tsx" },
       locale: "zh-CN",
     });
-    expect(text).toContain("记忆能力评测 · 2 页");
-    expect(text).toContain("niceeval show --results tmp/published-results --report reports/site.tsx --page overview");
+    expect(text).toContain("其余页：");
     expect(text).toContain("niceeval show --results tmp/published-results --report reports/site.tsx --page exam");
-    expect(text).toContain("总览");
     expect(text).toContain("成绩单");
+    expect(text).not.toContain("总览");
+    expect(text).not.toContain("--page overview");
   });
 
-  it("show 不消费 links:页索引不含 icon svg 与 href(icon 是 web 面属性)", () => {
-    const text = pageIndexText({
-      report,
-      title: "Memory Evals",
+  it("show 不消费 links:其余页索引不含 icon svg 与 href(icon 是 web 面属性)", () => {
+    const text = otherPagesText({
+      otherPages: report.pages.filter((p) => p.id !== "overview").map((p) => ({ id: p.id, title: p.title })),
       command: { patterns: [] },
       locale: "en",
     });
+    expect(text).toContain("Other pages:");
     expect(text).not.toContain("<svg");
     expect(text).not.toContain("https://example.com");
   });
 
-  it("showCommand 按序携带位置参数与 --experiment / --results / --report / --page", () => {
+  it("showCommand 按序携带位置参数与 --exp / --results / --report / --page", () => {
     expect(
       showCommand({ patterns: ["memory/swelancer"], experiment: "dev-e2b", report: "reports/site.tsx", page: "exam" }),
-    ).toBe("niceeval show memory/swelancer --experiment dev-e2b --report reports/site.tsx --page exam");
+    ).toBe("niceeval show memory/swelancer --exp dev-e2b --report reports/site.tsx --page exam");
   });
 });

package/src/show/report-host.ts

@@ -7,8 +7,8 @@
 // - 装载规范化唯一产物是「外壳 + 非空页列表」:`defineReport(树)` ≡ `{ content: 树 }` ≡
 //   `pages: [{ id: "report", title: 内置页名, content: 树 }]`。
 // - 标题回退单点:def.title → Scope 中唯一且相同(LocalizedText 深相等)的非空快照 name →
-//   内置文案「Eval 运行结果 / Eval Results」。落点是首页 hero、浏览器标题与 show 页索引标题行;
-//   页头品牌位恒为 NiceEval 字标,不归 title。
+//   内置文案「Eval 运行结果 / Eval Results」。宿主落点是浏览器标题与 show 页索引标题行;
+//   页内 hero 标题由 Hero 组件消费同一取值链(ctx.report.title),宿主页头无品牌位。
 // - LocalizedText 回退:当前 locale → en → 按 locale 键字典序的第一个非空值。
 //
 // ⚠ 集成状态:src/report/** 正被并行重写(plan/reports-redesign-implementation.md)。这里把宿主
@@ -212,11 +212,12 @@ export function normalizeHostReport(definition: unknown, sourceLabel: string): H
     const hasContent = def.content !== undefined;
     const hasPages = def.pages !== undefined;
     if (hasContent === hasPages) {
-      // content / pages 同缺或同给:装载期完整用户反馈,下一步是 content: <ExperimentComparison />。
+      // content / pages 同缺或同给:装载期完整用户反馈(defineReport 产物恒已折叠,这里只拦
+      // 手搓 kind:"report" 的无类型输入),下一步指向内建视图的 extends 复用。
       throw new HostReportError(
         `${sourceLabel}: a report declares exactly one of "content" or "pages" — ` +
           (hasContent ? "it declares both. " : "it declares neither. ") +
-          `To render the built-in report content, write: content: <ExperimentComparison />.`,
+          `To render the built-in report, write extends: standard (import { standard } from "niceeval/report/built-in").`,
       );
     }
     const pages: HostReportPage[] = hasPages
@@ -319,7 +320,7 @@ export interface HostCommandContext {
 /** 按上下文拼一条可复制的 show 命令(页索引 / 组索引共用的携带规则)。 */
 export function showCommand(ctx: HostCommandContext, extra: string[] = []): string {
   const parts = ["niceeval show", ...ctx.patterns];
-  if (ctx.experiment !== undefined) parts.push(`--experiment ${ctx.experiment}`);
+  if (ctx.experiment !== undefined) parts.push(`--exp ${ctx.experiment}`);
   if (ctx.results !== undefined) parts.push(`--results ${ctx.results}`);
   if (ctx.report !== undefined) parts.push(`--report ${ctx.report}`);
   if (ctx.page !== undefined) parts.push(`--page ${ctx.page}`);

package/src/show/show.test.ts

@@ -163,6 +163,57 @@ describe("默认报告:跨快照合成的现刻水位(ExperimentComparison text
     expect(out).not.toMatch(/\[[EXD⏱,]+\]/);
   });
 
+  it("裸 show 是内建报告首页:页首 Hero 标题行 + 最后运行 meta,尾部附 attempts / traces 页索引(命令带 --results 上下文)", async () => {
+    // docs/feature/reports/show/default-report.md:Hero 两行在页首,「其余页」两行在尾部。
+    const root = await seedComposedRoot();
+    const { out, code } = await show(root, []);
+    expect(code).toBe(0);
+    const lines = out.split("\n");
+    expect(lines[0]).toBe("Eval Results"); // 标题回退链终点(快照无 name、无 --report title)
+    expect(lines[1]).toMatch(/^Last run \d{4}-\d{2}-\d{2} \d{2}:\d{2}$/); // Hero meta 行
+    // 尾部「其余页」索引:只列未渲染的两页,命令携带完整 --results 上下文,复制即可复现。
+    const tailAt = out.indexOf("Other pages:");
+    expect(tailAt).toBeGreaterThan(-1);
+    const tail = out.slice(tailAt);
+    expect(tail).toContain(`niceeval show --results ${root} --page attempts`);
+    expect(tail).toContain(`niceeval show --results ${root} --page traces`);
+    expect(tail).not.toContain("--page report"); // 已渲染的首页不进索引
+  });
+
+  it("裸 show 的 --page attempts / traces 渲染内建证据页(AttemptList / TraceWaterfall 的 text 面)", async () => {
+    const root = await seedComposedRoot();
+    const attempts = await show(root, [], { page: "attempts" }, 160);
+    expect(attempts.code).toBe(0);
+    // AttemptList text 面:范围内每个 attempt 一条,失败行带主失败摘要。
+    expect(attempts.out).toContain("fixtures/button");
+    expect(attempts.out).toContain("weather/brooklyn");
+    expect(attempts.out).toMatch(/@1[0-9a-z]{7}/);
+    const traces = await show(root, [], { page: "traces" }, 160);
+    expect(traces.code).toBe(0);
+    // TraceWaterfall text 面:每 attempt 一行,行尾是可复制的 --timing 下钻命令。
+    expect(traces.out).toMatch(/niceeval show @1[0-9a-z]{7} --timing/);
+    expect(traces.out).toContain("no trace"); // fixture 无 trace artifact:如实显示缺失
+  });
+
+  it("裸 show 的选择警告由页内 ScopeWarnings 组件显示(partial-coverage 按动作聚合成组头行)", async () => {
+    const root = await makeRoot();
+    await writeSnapshot(
+      root,
+      "2026-07-08T10-00-00-000Z",
+      {
+        experimentId: "compare/bub",
+        startedAt: "2026-07-08T10:00:00.000Z",
+        knownEvalIds: ["weather/brooklyn", "weather/queens"], // 少跑一题 → partial-coverage
+      },
+      [res("weather/brooklyn", "passed")],
+    );
+    const { out, code } = await show(root, [], {}, 160);
+    expect(code).toBe(0);
+    // 警告块在 Hero 之后、组内容之前;组头一行含实验 id、徽标与可复制命令。
+    expect(out).toMatch(/^! compare\/bub — coverage 1\/2 → niceeval exp compare\/bub$/m);
+    expect(out.indexOf("Eval Results")).toBeLessThan(out.indexOf("! compare/bub"));
+  });
+
   it("裸 show 的默认报告 chrome 跟随 locale", async () => {
     const root = await seedComposedRoot();
     process.env.NICEEVAL_LANG = "zh-CN";
@@ -172,17 +223,24 @@ describe("默认报告:跨快照合成的现刻水位(ExperimentComparison text
       expect(out).toContain("成本 × 端到端成功率 没有可绘制的数据");
       expect(out).toContain("1 通过 / 1 失败");
       expect(out).toMatch(/\bbub\s+默认\s+bub\s+1s\s+50%/);
+      // 页首 Hero 与尾部页索引同样跟随 locale(内置文案与页名)。
+      expect(out.split("\n")[0]).toBe("Eval 运行结果");
+      expect(out).toContain("其余页：");
+      expect(out).toContain("追踪");
     } finally {
       process.env.NICEEVAL_LANG = "en";
     }
   });
 
-  it("窄终端截断长 eval 与原因,每一行都不超过终端显示宽度", async () => {
+  it("窄终端截断长 eval 与原因,报告正文每一行都不超过终端显示宽度", async () => {
     const root = await seedComposedRoot();
     const { out, code } = await show(root, [], {}, 60);
     expect(code).toBe(0);
     expect(out).toContain("fixtures/button");
-    for (const line of out.trimEnd().split("\n")) {
+    // 「其余页」索引里的命令是可复制的完整命令(携带 --results 绝对路径),复制即可执行,
+    // 永不为宽度折行——宽度约束只作用于报告正文。
+    const body = out.slice(0, out.indexOf("Other pages:"));
+    for (const line of body.trimEnd().split("\n")) {
       expect(stringWidth(line), line).toBeLessThanOrEqual(60);
     }
   });
@@ -438,6 +496,85 @@ describe("--report 装载", () => {
     return path;
   }
 
+  /**
+   * 两页文件:overview / exam,各自的 text 面输出一个可断言的标记字符串——够验证
+   * 「渲染初始页 + 尾部附其余页索引,不倾倒其余页内容」而不需要引入更多组合语义
+   * (docs/feature/reports/show/reports.md Case 2)。
+   */
+  async function writeMultiPageReportFile(dir: string): Promise<string> {
+    const path = join(dir, "site.mjs");
+    await writeFile(
+      path,
+      [
+        'const FACES = Symbol.for("niceeval.report.faces");',
+        'const DEFINITION = Symbol.for("niceeval.report.definition");',
+        "const Overview = () => null;",
+        "Overview[FACES] = { web: () => null, text: () => \"OVERVIEW PAGE CONTENT\" };",
+        "const Exam = () => null;",
+        "Exam[FACES] = { web: () => null, text: () => \"EXAM PAGE CONTENT\" };",
+        "const definition = {",
+        '  kind: "report",',
+        "  links: [],",
+        "  scripts: [],",
+        "  styles: [],",
+        "  pages: [",
+        '    { id: "overview", title: { en: "Overview", "zh-CN": "总览" }, content: { type: Overview, props: {} } },',
+        '    { id: "exam", title: { en: "Exam", "zh-CN": "成绩单" }, content: { type: Exam, props: {} } },',
+        "  ],",
+        "};",
+        "Object.defineProperty(definition, DEFINITION, { value: true });",
+        "export default definition;",
+        "",
+      ].join("\n"),
+      "utf-8",
+    );
+    return path;
+  }
+
+  it("多页文件:渲染初始页(缺省第一页)+ 尾部附其余页索引,不倾倒其余页内容", async () => {
+    // show() 测试助手缺省把 root 当 --results 传下去(见上方 show() 定义),
+    // 因此索引命令恒含 --results;这里的默认 locale 是 en(beforeAll 固定)。
+    const root = await seedComposedRoot();
+    const report = await writeMultiPageReportFile(root);
+    const { out, code } = await show(root, [], { report });
+    expect(code).toBe(0);
+    expect(out).toContain("OVERVIEW PAGE CONTENT");
+    expect(out).not.toContain("EXAM PAGE CONTENT");
+    expect(out).toContain("Other pages:");
+    expect(out).toContain(`niceeval show --results ${root} --report ${report} --page exam`);
+    expect(out).toContain("Exam");
+    expect(out).not.toContain("--page overview"); // 已渲染的页不进「其余页」索引
+  });
+
+  it("多页文件:--page 选中的页渲染,尾部索引只列剩下的页", async () => {
+    const root = await seedComposedRoot();
+    const report = await writeMultiPageReportFile(root);
+    const { out, code } = await show(root, [], { report, page: "exam" });
+    expect(code).toBe(0);
+    expect(out).toContain("EXAM PAGE CONTENT");
+    expect(out).not.toContain("OVERVIEW PAGE CONTENT");
+    expect(out).toContain("Other pages:");
+    expect(out).toContain(`niceeval show --results ${root} --report ${report} --page overview`);
+    expect(out).not.toContain("--page exam");
+  });
+
+  it("单页定义直接渲染,无「其余页」段", async () => {
+    const root = await seedComposedRoot();
+    const report = await writeReportFile(root);
+    const { out, code } = await show(root, [], { report });
+    expect(code).toBe(0);
+    expect(out).not.toContain("其余页");
+    expect(out).not.toContain("Other pages");
+  });
+
+  it("其余页索引命令保留当前 --results / --report 与位置参数上下文,复制即可复现下一层视图", async () => {
+    const root = await seedComposedRoot();
+    const report = await writeMultiPageReportFile(root);
+    const { out, code } = await show(root, ["weather"], { report, results: root });
+    expect(code).toBe(0);
+    expect(out).toContain(`niceeval show weather --results ${root} --report ${report} --page exam`);
+  });
+
   it("装载 + 注入 Selection + attemptCommand 下钻命令", async () => {
     const root = await seedComposedRoot();
     const report = await writeReportFile(root);
@@ -455,7 +592,7 @@ describe("--report 装载", () => {
     expect(out).toContain("CUSTOM weather/brooklyn ·");
   });
 
-  it("--experiment 让 Selection 只留该实验", async () => {
+  it("--exp 让 Selection 只留该实验", async () => {
     const root = await seedComposedRoot();
     await writeSnapshot(
       root,
@@ -521,7 +658,7 @@ describe("--report 装载", () => {
     const builtin = await show(root, [], { page: "typo" });
     expect(builtin.code).toBe(1);
     expect(builtin.err).toContain('page "typo" not found in the built-in report');
-    expect(builtin.err).toContain("Available pages: report");
+    expect(builtin.err).toContain("Available pages: report, attempts, traces");
   });
 });
 

package/src/view/app/App.test.tsx

@@ -1,8 +1,9 @@
 // cases: docs/engineering/unit-tests/reports/cases.md
 // 「外壳、页面与 Tabs」分区——
-// 品牌位恒为 NiceEval 字标(声明 title 也不覆盖)、hero 走标题回退链(与浏览器标题同源;
-// document.title 由 useEffect 设置,静态渲染不执行,这里断言 hero 即断言同一个 shellTitle)、
-// ReportLink.icon 渲染在 label 前(web 面)。契约:docs/feature/reports/library/shell.md「行为约束」。
+// 宿主页头不渲染任何品牌位、宿主无 hero 区(hero / 品牌行是页内组件,见 site-components 测试);
+// view 导航只有报告定义声明的页(声明序),宿主不追加或保留任何导航项;
+// ReportLink.icon 渲染在 label 前(web 面)。契约:docs/feature/reports/library/shell.md「行为约束」、
+// docs/feature/reports/view.md「页面构成」。
 
 import { renderToStaticMarkup } from "react-dom/server";
 import { beforeAll, describe, expect, it } from "vitest";
@@ -14,14 +15,18 @@ beforeAll(() => {
   (globalThis as { location?: unknown }).location = { hash: "", search: "", pathname: "/" };
 });
 
-const reportPages = { report: { en: "<p>REPORT_BODY</p>", "zh-CN": "<p>REPORT_BODY</p>" } };
+const reportPages = {
+  report: { en: "<p>REPORT_BODY</p>", "zh-CN": "<p>REPORT_BODY</p>" },
+  attempts: { en: "<p>ATTEMPTS_BODY</p>", "zh-CN": "<p>ATTEMPTS_BODY</p>" },
+  traces: { en: "<p>TRACES_BODY</p>", "zh-CN": "<p>TRACES_BODY</p>" },
+};
 
 function dataWithShell(report: ViewData["report"]): ViewData {
   return { composedRuns: 1, snapshots: [], ...(report !== undefined ? { report } : {}) };
 }
 
-describe("外壳:品牌位、hero 标题与 ReportLink.icon", () => {
-  it("声明 title 后品牌位仍是 NiceEval 字标;hero 显示走完回退链的报告标题", () => {
+describe("外壳:宿主恒有 NiceEval 品牌位、无 hero,导航只有报告页", () => {
+  it("宿主页头有恒定品牌字标、无 hero 区:hero 是页内组件不归宿主,品牌归宿主", () => {
     const html = renderToStaticMarkup(
       <App
         data={dataWithShell({
@@ -33,19 +38,76 @@ describe("外壳:品牌位、hero 标题与 ReportLink.icon", () => {
         reportPages={reportPages}
       />,
     );
-    // 品牌位:恒定的 NiceEval 字标,不吃报告 title。
-    const brand = html.match(/class="brand"[\s\S]*?<\/a>/)![0];
-    expect(brand).toContain(">NiceEval</span>");
-    expect(brand).not.toContain("Memory Evals");
-    // hero:报告 title(node 环境 locale 回退 en)。
-    const hero = html.match(/<h1>[\s\S]*?<\/h1>/)![0];
-    expect(hero).toContain("Memory Evals");
+    // 宿主页头恒有 NiceEval 品牌字标,外链官网;报告定义不能覆盖或移除。
+    expect(html).toContain('class="brand"');
+    expect(html).toContain("NiceEval");
+    expect(html).toContain("niceeval.com");
+    // 品牌位是页头字标,不是 hero 的 Powered by 行——后者是页内组件,不落宿主壳。
+    expect(html).not.toContain("Powered by");
+    // 宿主无 hero 区:标题只落浏览器 <title>(useEffect,静态渲染不执行),不落任何宿主节点。
+    expect(html).not.toContain('class="hero"');
+    expect(html).not.toContain("<h1");
+    expect(html).not.toContain("Memory Evals");
   });
 
-  it("缺外壳声明(旧数据)时 hero 落内置文案 Eval Results,品牌位不变", () => {
-    const html = renderToStaticMarkup(<App data={dataWithShell(undefined)} reportPages={reportPages} />);
-    expect(html.match(/<h1>[\s\S]*?<\/h1>/)![0]).toContain("Eval Results");
-    expect(html.match(/class="brand"[\s\S]*?<\/a>/)![0]).toContain(">NiceEval</span>");
+  it("导航项 = 报告定义声明的页,按声明序;宿主不追加 Attempts / Traces 等任何项", () => {
+    const html = renderToStaticMarkup(
+      <App
+        data={dataWithShell({
+          title: "T",
+          links: [],
+          pages: [
+            { id: "overview", title: { en: "Overview", "zh-CN": "总览" } },
+            { id: "exam", title: { en: "Exam", "zh-CN": "成绩单" } },
+          ],
+          initialPageId: "overview",
+        })}
+        reportPages={{
+          overview: { en: "<p>A</p>", "zh-CN": "<p>A</p>" },
+          exam: { en: "<p>B</p>", "zh-CN": "<p>B</p>" },
+        }}
+      />,
+    );
+    const triggers = html.match(/role="tab"/g) ?? [];
+    expect(triggers).toHaveLength(2); // 恰为声明的两页,无宿主追加项
+    expect(html.indexOf("Overview")).toBeLessThan(html.indexOf("Exam")); // 声明序
+    expect(html).not.toContain("#/attempts");
+    expect(html).not.toContain("#/traces");
+  });
+
+  it("裸 view(内建报告三页声明)导航恰为 报告 · Attempts · 追踪,来自页列表而非宿主", () => {
+    const html = renderToStaticMarkup(
+      <App
+        data={dataWithShell({
+          title: { en: "Eval Results", "zh-CN": "Eval 运行结果" },
+          links: [],
+          pages: [
+            { id: "report", title: { en: "Report", "zh-CN": "报告" } },
+            { id: "attempts", title: "Attempts" },
+            { id: "traces", title: { en: "Traces", "zh-CN": "追踪" } },
+          ],
+          initialPageId: "report",
+        })}
+        reportPages={reportPages}
+      />,
+    );
+    expect(html.match(/role="tab"/g)).toHaveLength(3);
+    for (const label of ["Report", "Attempts", "Traces"]) expect(html).toContain(label);
+  });
+
+  it("树形态定义(单页 report)导航只有一项", () => {
+    const html = renderToStaticMarkup(
+      <App
+        data={dataWithShell({
+          title: "T",
+          links: [],
+          pages: [{ id: "report", title: { en: "Report", "zh-CN": "报告" } }],
+          initialPageId: "report",
+        })}
+        reportPages={{ report: reportPages.report }}
+      />,
+    );
+    expect(html.match(/role="tab"/g)).toHaveLength(1);
   });
 
   it("ReportLink.icon 的内联 SVG 渲染在 label 前,原样内联", () => {

package/src/view/app/App.tsx

@@ -1,27 +1,21 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { detectLocale, makeTranslator, persistLocale, setDocumentLocale } from "./i18n.ts";
 import type { Locale, LocalizedText, ReportSlotHtml, Tab, ViewData, ViewReportPageMeta, ViewResult } from "./types.ts";
-import { flattenAttempts, resultFromUrl } from "./lib/rows.ts";
+import { resultFromUrl } from "./lib/rows.ts";
 import { parseAttemptHash, resolveAttemptLocator, unresolvedAttemptWarning } from "./lib/attempt-route.ts";
-import { formatDateTime } from "./lib/format.ts";
-import { CopyFixPrompt } from "./components/CopyControls.tsx";
-import { SkippedRunsBanner } from "./components/SkippedRunsBanner.tsx";
 import { AttemptModal } from "./components/AttemptModal.tsx";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "./components/ui/tabs.tsx";
-import { AttemptsView } from "./pages/AttemptsPage.tsx";
-import { TracesView } from "./pages/TracesPage.tsx";
 
-// 导航组成固定(docs/feature/reports/view.md「页面构成」):报告页按声明顺序在前
-// (路由 `#/page/<id>`,`--page <id>` 定初始页),内置的 Attempts、Traces 证据页恒排在
-// 报告页之后——证据页由宿主拥有,报告定义不能移除或重排它们。
-// 报告页的 tab 值带 `page:` 前缀,避免与证据页 id(attempts / traces)撞名。
-const EVIDENCE_TABS: { id: Tab; label: "nav.attempts" | "nav.traces" }[] = [
-  { id: "attempts", label: "nav.attempts" },
-  { id: "traces", label: "nav.traces" },
-];
+// 导航组成只有一条规则(docs/feature/reports/view.md「页面构成」):导航项 = 报告定义声明的页,
+// 按声明顺序排列(路由 `#/page/<id>`,`--page <id>` 定初始页)。宿主不追加、不保留任何导航项——
+// 裸 view 的「报告 / Attempts / 追踪」三个 tab 就是内建报告的三页。页面里的 hero、Scope 警告
+// 都不是宿主渲染的:它们是页内的站点组件(Hero / ScopeWarnings)。宿主保留的是机器
+// 加一个恒定的品牌位:管线与路由、attempt 详情路由、文档单例(<title>)、语言切换,以及
+// 页头左端的 NiceEval 字标(docs/feature/reports/architecture.md「宿主保留的只有机器」)。
 
-/** niceeval 官网;web 面 hero 下方恒含指向它的 `Powered by NiceEval` 一行,无关闭配置。 */
-const NICEEVAL_SITE_URL = "https://niceeval.com";
+// niceeval 官网。页头品牌字标与 hero 下的 `Powered by NiceEval` 行都外链到它,
+// utm_medium 区分点击来自哪个品牌位(shell.md「行为约束」)。
+const BRAND_HREF = "https://niceeval.com/?utm_source=report&utm_medium=brand";
 
 /**
  * LocalizedText 的确定回退(docs/feature/reports/library/shell.md):当前 locale → en →
@@ -61,23 +55,20 @@ function ReportSlot({ html }: { html: string }) {
   return <div className="report-slot" dangerouslySetInnerHTML={markup} />;
 }
 
-/** `#/page/<id>` / `#/attempts` / `#/traces` → tab 值;认不出返回 null(交给初始页兜底)。 */
+/** `#/page/<id>` → tab 值;认不出返回 null(交给初始页兜底)。 */
 function tabFromHash(hash: string, pages: ViewReportPageMeta[]): Tab | null {
   const pageMatch = /^#\/page\/([a-z0-9-]+)$/.exec(hash);
   if (pageMatch && pages.some((p) => p.id === pageMatch[1])) return `page:${pageMatch[1]}`;
-  if (hash === "#/attempts") return "attempts";
-  if (hash === "#/traces") return "traces";
   return null;
 }
 
-/** tab 值 → hash 路由(报告页 `#/page/<id>`,证据页 `#/attempts` / `#/traces`)。 */
+/** tab 值 → hash 路由(报告页 `#/page/<id>`)。 */
 function hashForTab(tab: Tab): string {
-  return tab.startsWith("page:") ? `#/page/${tab.slice("page:".length)}` : `#/${tab}`;
+  return `#/page/${tab.slice("page:".length)}`;
 }
 
 export function App({ data, reportPages }: { data: ViewData; reportPages: Record<string, ReportSlotHtml> }) {
   const snapshots = data.snapshots ?? [];
-  const attempts = useMemo(() => flattenAttempts(snapshots), [snapshots]);
   const [locale, setLocale] = useState<Locale>(() => detectLocale());
   const t = useMemo(() => makeTranslator(locale), [locale]);
 
@@ -99,9 +90,9 @@ export function App({ data, reportPages }: { data: ViewData; reportPages: Record
     persistLocale(locale);
   }, [locale]);
 
-  // 首页 hero 与浏览器标题跟随外壳标题(回退链在 server 侧走完:def.title → 唯一快照 name →
-  // 内置文案「Eval 运行结果 / Eval Results」);缺声明(旧数据)时按内置文案兜底。
-  // 页头品牌位不归它——那里是恒定的 NiceEval 字标。
+  // 浏览器标题是宿主文档单例:跟随外壳标题(回退链在 server 侧走完:def.title →
+  // 唯一快照 name → 内置文案「Eval 运行结果 / Eval Results」);缺声明(旧数据)时按内置文案兜底。
+  // 页面里的 hero 标题不归宿主——它是页内 Hero 组件,同一取值链经 ctx.report.title 贯通。
   const shellTitle = localizedText(data.report?.title, locale) ?? t("hero.title");
   useEffect(() => {
     document.title = shellTitle;
@@ -123,7 +114,9 @@ export function App({ data, reportPages }: { data: ViewData; reportPages: Record
   }, []);
 
   // 浏览器前进/后退、手改 hash、页内链接(attempt 深链与 `#/page/<id>` 页路由)统一从
-  // hashchange 分发:attempt hash 开证据室弹窗,页/证据室 hash 切当前 tab。
+  // hashchange 分发:attempt hash 开证据室弹窗,页 hash 切当前 tab。
+  // attempt 详情路由对有效根解析(viewData.snapshots 即有效根):收窄之内、不在页面统计
+  // 口径(现刻水位)里的历史 attempt 仍能经深链打开,报告里的证据引用不因统计口径失效。
   useEffect(() => {
     const onHashChange = () => {
       const locator = parseAttemptHash(location.hash);
@@ -163,9 +156,11 @@ export function App({ data, reportPages }: { data: ViewData; reportPages: Record
     <Tabs value={tab} onValueChange={(v) => selectTab(v as Tab)}>
       <header className="topbar">
         {/* 页头左端是恒定的 NiceEval 品牌字标(与 Powered by 行同族的产品品牌位),
-            报告定义不能覆盖或移除;报告 title 的落点是下方 hero 与浏览器标题。 */}
-        <a className="brand" href={hashForTab(`page:${initialPageId}`)}>
-          <span className="mark" />
+            报告定义不能覆盖或移除,点击外链官网;报告 title 的落点是页内 hero 与浏览器标题。
+            rel 用 noopener 而非 noreferrer:保留 Referer(默认策略只发 origin),官网统计由此
+            得知点击来自哪个报告站点;utm 只负责区分品牌位。 */}
+        <a className="brand" href={BRAND_HREF} target="_blank" rel="noopener">
+          <span className="mark" aria-hidden="true" />
           <span>NiceEval</span>
         </a>
         <TabsList aria-label={t("nav.label")}>
@@ -174,11 +169,6 @@ export function App({ data, reportPages }: { data: ViewData; reportPages: Record
               {localizedText(page.title, locale) ?? page.id}
             </TabsTrigger>
           ))}
-          {EVIDENCE_TABS.map((item) => (
-            <TabsTrigger key={item.id} value={item.id}>
-              {t(item.label)}
-            </TabsTrigger>
-          ))}
         </TabsList>
         {data.report?.links?.length ? (
           <nav className="shell-links" aria-label="Links">
@@ -208,53 +198,14 @@ export function App({ data, reportPages }: { data: ViewData; reportPages: Record
         </div>
       </header>
       <main>
-        <section className="hero">
-          {/* hero 标题 = 走完回退链的报告标题(与浏览器标题同源)。 */}
-          <h1>{shellTitle}</h1>
-          <div className="meta">
-            <span>
-              {/* viewData 只带原始值(ISO / number),这里按当前界面 locale 格式化。 */}
-              <b>{t("hero.lastRun")}</b> {data.lastRunAt ? formatDateTime(data.lastRunAt, locale) : t("hero.noRuns")}
-            </span>
-            {data.composedRuns > 0 ? (
-              // 报告槽是跨 run 合成的现刻水位,hero 如实标注合成来源(几个 run)。
-              <span>{t("hero.composedFrom", { count: data.composedRuns })}</span>
-            ) : null}
-          </div>
-          {/* 品牌行:恒在 hero 之下、恒带官网链接,不占 footer 的语义位、没有关闭配置
-              (shell.md「行为约束」)。 */}
-          <span className="powered-by">
-            <a href={NICEEVAL_SITE_URL} target="_blank" rel="noreferrer">
-              Powered by NiceEval
-            </a>
-          </span>
-        </section>
-
-        <SkippedRunsBanner skippedRuns={data.skippedRuns ?? []} t={t} />
-
         {pages.map((page) => (
           <TabsContent key={`page:${page.id}`} value={`page:${page.id}`} id={`tab-page-${page.id}`}>
-            {/* 壳区:报告槽上方靠右的批量修复 prompt 按钮。失败清单从 viewData.snapshots
-                现算(latest 口径),默认报告与 --report 两种填充下都在。 */}
-            <div className="section-sub-head">
-              <span className="group-detail-label" />
-              <div className="controls">
-                <CopyFixPrompt snapshots={snapshots} t={t} />
-              </div>
-            </div>
             {/* 报告槽:server 侧逐页渲染好的静态 HTML(含 <Style> 产物),按当前页与界面语言
-                摆放对应块;Scope 警告由报告页内呈现,壳不设第二条通道。
+                摆放对应块;hero、品牌行、Scope 警告、批量修复 prompt 都是页内组件,壳不再渲染。
                 attempt 深链是普通 <a href="#/attempt/…">,经 hashchange 打开证据室弹窗。 */}
             <ReportSlot html={reportPages[page.id]?.[locale] || reportPages[page.id]?.en || ""} />
           </TabsContent>
         ))}
-
-        <TabsContent value="attempts">
-          <AttemptsView attempts={attempts} t={t} />
-        </TabsContent>
-        <TabsContent value="traces">
-          <TracesView attempts={attempts} t={t} />
-        </TabsContent>
       </main>
       {footerText ? (
         <footer className="site-footer">