niceeval 0.5.4 → 0.6.1

package/src/view/server.ts

@@ -1,10 +1,11 @@
-// HTTP server 与静态资源:起本地 web、按需吐工件、把 viewData 烘焙进单个 HTML。
+// HTTP server 与静态资源:起本地 web、按需吐 artifact、把 viewData 烘焙进单个 HTML。
 // 数据读取与统计在 data.ts(openResults + 官方计算函数);这里只管「怎么送到浏览器」。
 
 import { createServer, type Server } from "node:http";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
-import { loadViewScan, viewRoot, type ViewScan, type ViewScanOptions } from "./data.ts";
+import { loadAttemptIndex, loadViewScan, viewRoot, type ViewScan, type ViewScanOptions } from "./data.ts";
+import type { AttemptHandle } from "../results/index.ts";
 import { formatThrown } from "../util.ts";
 
 export interface ViewOptions {
@@ -41,16 +42,16 @@ export async function startViewServer(opts: ViewOptions = {}): Promise<ViewServe
         res.end("ok");
         return;
       }
-      // 按需提供拆分工件(trace.json / events.json / …),前端展开时 fetch。
+      // 按需提供拆分 artifact(trace.json / events.json / …),前端展开时 fetch。
       // 路径式 /artifact/<rel> 与目录式静态导出的文件布局一致(见 view/index.ts 的 buildView),
       // 同一份前端产物在本地 server 和静态托管上用同一个相对 URL。
       if (url.pathname.startsWith("/artifact/")) {
-        await serveArtifact(root, decodeURIComponent(url.pathname.slice("/artifact/".length)), res);
+        await serveArtifact(root, decodeURIComponent(url.pathname.slice("/artifact/".length)), res, () => loadAttemptIndex(input));
         return;
       }
       // 兼容旧的 query 形式(0.2.x 前端烘焙的 HTML 可能还开着)。
       if (url.pathname === "/artifact") {
-        await serveArtifact(root, url.searchParams.get("p") ?? "", res);
+        await serveArtifact(root, url.searchParams.get("p") ?? "", res, () => loadAttemptIndex(input));
         return;
       }
       if (url.pathname !== "/") {
@@ -83,37 +84,56 @@ export async function startViewServer(opts: ViewOptions = {}): Promise<ViewServe
 
 /**
  * 把 viewData(只含原始值与相对路径,不含宿主机绝对路径)和前端产物烘焙进单个 HTML。
- * --report 在场时,报告 HTML 作为 <template id="niceeval-report"> 静态块烘在
- * __NICEEVAL_VIEW_DATA__ 旁(零客户端 JS、不 hydrate,自定义组件的 <Style> 产物
- * 已内联其中),并附官方组件样式(report/react/styles.css);前端只把这块摆进
- * 报告槽位置,不解析。
+ * 报告槽恒在:报告 HTML 作为 <template id="niceeval-report-en"> / <template
+ * id="niceeval-report-zh-CN"> 两个静态块烘在 __NICEEVAL_VIEW_DATA__ 旁(不 hydrate,
+ * 自定义组件的 <Style> 产物已内联其中),并恒内联官方组件样式(report/react/styles.css)
+ * 与渐进增强 runtime(report/react/enhance.js,内联 <script>:排序 / 过滤 / tooltip,
+ * document 级事件委托,报告块被前端搬进槽位也无需重绑;无 JS 时报告内容依旧完整);
+ * 前端只把当前界面语言对应的那块摆进报告槽位置,不解析。
  */
 export async function renderHtml(scan: ViewScan): Promise<string> {
   const template = await readViewAsset("template.html");
   const styles = await readViewAsset("client-dist/app.css");
   const app = await readViewAsset("client-dist/app.js");
-  const reportStyles =
-    scan.reportHtml !== undefined
-      ? await readFile(new URL("../report/react/styles.css", import.meta.url), "utf-8")
-      : undefined;
+  const [reportStyles, reportEnhance] = await Promise.all([
+    readFile(new URL("../report/react/styles.css", import.meta.url), "utf-8"),
+    readFile(new URL("../report/react/enhance.js", import.meta.url), "utf-8"),
+  ]);
 
   return template
     .replace(
       TEMPLATE_PLACEHOLDERS.styles,
-      () => `<style>\n${styles}\n</style>${reportStyles !== undefined ? `\n<style>\n${reportStyles}\n</style>` : ""}`,
+      () => `<style>\n${styles}\n</style>\n<style>\n${reportStyles}\n</style>\n<script>\n${reportEnhance}\n</script>`,
     )
-    .replace(TEMPLATE_PLACEHOLDERS.reportSlot, () =>
-      scan.reportHtml !== undefined ? `<template id="niceeval-report">${scan.reportHtml}</template>` : "",
+    .replace(
+      TEMPLATE_PLACEHOLDERS.reportSlot,
+      () =>
+        `<template id="niceeval-report-en">${scan.reportHtml.en}</template>\n` +
+        `<template id="niceeval-report-zh-CN">${scan.reportHtml["zh-CN"]}</template>`,
     )
     .replace(TEMPLATE_PLACEHOLDERS.viewData, () => JSON.stringify(scan.viewData).replace(/</g, "\\u003c"))
     .replace(TEMPLATE_PLACEHOLDERS.appCode, () => JSON.stringify(app).replace(/</g, "\\u003c"));
 }
 
-/** 安全地把 root 下的工件文件吐回去(限定 .json,且解析后必须仍在 root 内)。 */
+/** rel 的末段文件名;base = 去掉末段后剩下的部分(与 artifactUrl 的按段编码/拼接对称)。 */
+function splitArtifactRel(rel: string): { base: string; file: string } {
+  const segments = rel.split("/");
+  const file = segments.pop() ?? "";
+  return { base: segments.join("/"), file };
+}
+
+/**
+ * 安全地把 root 下的 artifact 文件吐回去(限定 .json,且解析后必须仍在 root 内)。
+ * sources.json 是唯一例外:落盘是去重后的引用(`{path, sha256}[]`),不能直接 piping 原字节——
+ * 按 base 反查 AttemptHandle,经它的 `.sources()` 解引用出完整内容(`{path, content}[]`)再回给
+ * 浏览器。attemptIndex 懒建(只在真的碰到 sources.json 请求时才付 openResults() 扫描的代价),
+ * events.json / trace.json 等其它 artifact 完全不受影响,原样走原文件读取。
+ */
 async function serveArtifact(
   root: string,
   rel: string,
   res: import("node:http").ServerResponse,
+  attemptIndex: () => Promise<Map<string, AttemptHandle>>,
 ): Promise<void> {
   const abs = resolve(root, rel);
   const within = abs === root || abs.startsWith(root + "/");
@@ -122,6 +142,21 @@ async function serveArtifact(
     res.end("bad artifact path");
     return;
   }
+
+  const { base, file } = splitArtifactRel(rel);
+  if (file === "sources.json") {
+    const attempt = (await attemptIndex()).get(base);
+    if (!attempt) {
+      res.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
+      res.end("artifact not found");
+      return;
+    }
+    const sources = await attempt.sources();
+    res.writeHead(200, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+    res.end(JSON.stringify(sources ?? []));
+    return;
+  }
+
   try {
     const body = await readFile(abs, "utf-8");
     res.writeHead(200, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });

package/src/view/shared/types.ts

@@ -1,46 +1,43 @@
 // server(data.ts)与前端(app/)共用的 view 数据形状。
 // viewData 会被序列化进静态 HTML,两边必须对同一份声明编程;只允许 type import。
 //
-// 统计层收编后(docs/view.md「用 Reports 积木重建 view」迁移顺序 2),烘进 HTML 的不再是
-// 私有 rows,而是官方数据契约:OverviewData / TableData(niceeval/report 的计算函数产物)
-// + 快照元信息(证据室数据)+ skipped / warnings。前端只做渲染与展示态交互,不再聚合。
+// viewData 只携带证据室与壳需要的东西:快照明细(locator / artifactBase 已注入)、
+// skipped、项目名与 run 元信息。统计口径(KPI / 榜单 / 挑选警告)整体住在报告槽的
+// 静态 HTML 里(ExperimentComparison 或 --report 的报告自己算),壳与报告之间没有第二条数据通道。
 
 import type { EvalResult, LocalizedText } from "../../types.ts";
-import type { OverviewData, TableData } from "../../report/types.ts";
+import type { ReportLocale } from "../../report/locale.ts";
+import type { AttemptLocator } from "../../results/locator.ts";
 
-// 官方契约的类型再导出(全部 type-only,前端打包时被擦除)。
-export type { MetricCell, MetricColumn, OverviewData, SelectionWarning, TableData } from "../../report/types.ts";
+export type { AttemptLocator };
 
 /**
- * attempt 的深链身份:run 目录名 + 该 attempt 在 summary.results 里的下标。
- * `#/attempt/<run>/<result>` 路由的参数——与 niceeval/results 的 AttemptRef、Reports 的
- * MetricCell.refs 同一身份契约,报告页(前门)与 view(证据室)靠它指向同一个 attempt。
+ * 报告槽的双语静态 HTML:同一棵报告树按 locale 渲染两遍(en / zh-CN),server 烘成
+ * 两个 <template> 静态块,前端按当前界面语言摆放对应块,切语言不重算数据。
  */
-export interface AttemptRef {
-  run: string;
-  result: number;
-}
+export type ReportSlotHtml = Record<ReportLocale, string>;
 
-/** view 侧的 attempt 结果 = 瘦身后的 EvalResult + loader 注入的深链身份与工件基址。 */
-export type ViewEvalResult = EvalResult & { attemptRef?: AttemptRef };
+/** view 侧的 attempt 结果 = 瘦身后的 EvalResult + loader 注入的深链身份(不透明 AttemptLocator,
+ * `#/attempt/@<locator>` 路由的参数,与 Reports 的 MetricCell.refs / `ctx.attemptHref` 同一身份契约)
+ * 与 artifact 基址。 */
+export type ViewEvalResult = EvalResult & { locator?: AttemptLocator };
 
 /**
- * 快照 = 单次跑的实验(experiment × run 切片),与 niceeval/results 的 Snapshot 同口径。
+ * 快照 = 单次跑的实验(experiment × 一次运行),与 niceeval/results 的 Snapshot 同口径。
  * 携带 attempt 明细供证据室(钻取 / AttemptModal / Runs / Traces)渲染;
  * 榜单统计不从这里算,吃 ViewData.table / overview 的官方产物。
  */
 export interface ViewSnapshot {
-  /** 落盘缺 experimentId 时是 "<agent>/<model>" 合成键(synthetic: true 同源)。 */
   experimentId: string;
-  synthetic?: boolean;
   agent: string;
   model?: string;
   startedAt: string;
-  /** 物理 run 目录名(= AttemptRef.run)。 */
+  /** 快照的根相对路径(= niceeval/results 的 AttemptRef.snapshot,两段:`<experiment-dir>/<snapshot-dir>`)。 */
   run: string;
-  /** 是否该实验最新一次快照 —— 榜单(results.latest() 口径)的成员。 */
+  /** 是否为该实验在 results.latest() 口径下的最新一次快照 —— 证据室的 latest 标记,与报告槽 Selection
+   (现刻水位,可能合成自更早快照)是两个独立概念,不要混用。 */
   latest: boolean;
-  /** 该快照的 attempt 明细(跨快照去重后的幸存条目;attemptRef / artifactBase 已注入)。 */
+  /** 该快照的 attempt 明细(跨快照去重后的幸存条目;locator / artifactBase 已注入)。 */
   results: ViewEvalResult[];
 }
 
@@ -60,23 +57,17 @@ export interface SkippedRunNotice {
 }
 
 /**
- * 烘焙进 HTML 的页面数据。时间/比率/成本一律传原始值(ISO 字符串、number),
- * 格式化统一由前端按当前界面 locale 做;官方 MetricCell 自带 display,前端直接渲染。
+ * 烘焙进 HTML 的页面数据(证据室与壳)。时间/成本一律传原始值(ISO 字符串、number),
+ * 格式化统一由前端按当前界面 locale 做。
  */
 export interface ViewData {
   /** 项目名(来自 config.name);hero 标题,可按 locale 多语言。 */
   name?: LocalizedText;
   /** 最近一次 run 的 startedAt(ISO);没有历史 run 时缺省。 */
   lastRunAt?: string;
-  /** 榜单合成自几个物理 run(latest 选集覆盖的 run 数);表头「合成来源」标注。 */
+  /** 报告槽 Selection 合成自几个物理 run;hero「合成来源」标注。 */
   composedRuns: number;
-  /** 官方 KPI(RunOverview.data 产物):totals + 选中快照元信息 + 选集 warnings 随行。 */
-  overview: OverviewData;
-  /** 默认报告(MetricTable.data,rows: "experiment"):每个实验最新一次快照的口径。 */
-  table: TableData;
-  /** 整体单行(MetricTable.data,常量维度):hero 的官方通过率,同一台聚合引擎。 */
-  overall: TableData;
-  /** 全部历史快照(跨快照按身份键去重后);Experiments 钻取吃 latest,Runs / Traces 吃全部。 */
+  /** 全部历史快照(跨快照按身份键去重后);修复 prompt 吃 latest,Runs / Traces 吃全部。 */
   snapshots: ViewSnapshot[];
   /** 读不了的落盘(三种原因);前端顶部横幅展示,不静默。 */
   skippedRuns?: SkippedRunNotice[];