niceeval 0.5.1 → 0.5.3

package/src/report/aggregate.ts

@@ -18,15 +18,15 @@ import type {
   Metric,
   MetricCell,
   MetricColumn,
-  ParamRef,
+  FlagRef,
 } from "./types.ts";
 import { formatMetricValue } from "./format.ts";
 
 // 复合键分隔符:NUL 不会出现在 eval id / experimentId / ISO 时间里,拼接键不会串味
 const KEY_SEP = "\u0000";
 
-/** param 未声明时的组名:不猜,如实归一组。 */
-export const PARAM_UNSET = "(unset)";
+/** flag 未声明时的组名:不猜,如实归一组。 */
+export const FLAG_UNSET = "(unset)";
 
 /** 计算函数的第一参:选集(warnings 随行)或手工挑的快照数组(没有挑选过程,自然无警告)。 */
 export type SnapshotsInput = Selection | Snapshot[];
@@ -105,33 +105,33 @@ export function evalGroupOf(id: string): string {
   return slash === -1 ? id : id.slice(0, slash);
 }
 
-function isParamRef(dimension: DimensionInput): dimension is ParamRef {
-  return typeof dimension === "object" && "kind" in dimension && dimension.kind === "param";
+function isFlagRef(dimension: DimensionInput): dimension is FlagRef {
+  return typeof dimension === "object" && "kind" in dimension && dimension.kind === "flag";
 }
 
-/** experiment 声明的 params(经 runner 原样透传进持久化字段 ExperimentRunInfo.params)。 */
-function paramsOf(attempt: AttemptHandle): Record<string, unknown> | undefined {
-  return attempt.result.experiment?.params;
+/** experiment 声明的 flags(经 runner 原样透传进持久化字段 ExperimentRunInfo.flags)。 */
+function flagsOf(attempt: AttemptHandle): Record<string, unknown> | undefined {
+  return attempt.result.experiment?.flags;
 }
 
-/** param 声明值 → 组标签:label 函数优先,其余 String();未声明 → PARAM_UNSET。 */
-export function paramGroupKey(ref: ParamRef, item: Item): string {
-  const value = paramsOf(item.attempt)?.[ref.name];
-  if (value === undefined) return PARAM_UNSET;
+/** flag 声明值 → 组标签:label 函数优先,其余 String();未声明 → FLAG_UNSET。 */
+export function flagGroupKey(ref: FlagRef, item: Item): string {
+  const value = flagsOf(item.attempt)?.[ref.name];
+  if (value === undefined) return FLAG_UNSET;
   // 持久化字段是 Record<string, unknown>;声明侧的合法值就是这三种标量
   if (typeof ref.label === "function") return ref.label(value as string | number | boolean);
   return String(value);
 }
 
-/** param 作轴:要求数值;未声明或非数值 → null(点不画,注脚报数)。 */
-export function paramAxisValue(ref: ParamRef, item: Item): number | null {
-  const value = paramsOf(item.attempt)?.[ref.name];
+/** flag 作轴:要求数值;未声明或非数值 → null(点不画,注脚报数)。 */
+export function flagAxisValue(ref: FlagRef, item: Item): number | null {
+  const value = flagsOf(item.attempt)?.[ref.name];
   return typeof value === "number" ? value : null;
 }
 
 export function dimensionKey(dimension: DimensionInput, item: Item): string {
   if (typeof dimension !== "string") {
-    if (isParamRef(dimension)) return paramGroupKey(dimension, item);
+    if (isFlagRef(dimension)) return flagGroupKey(dimension, item);
     return dimension.of(item.attempt);
   }
   const result = item.attempt.result;

package/src/report/components.tsx

@@ -159,7 +159,7 @@ export const MetricScatter = Object.assign(
 );
 MetricScatter.displayName = "MetricScatter";
 
-/** 趋势线:x 是 experiment 声明的 param(param()),同系列按 x 排序连线。 */
+/** 趋势线:x 是 experiment 声明的 flag(flag()),同系列按 x 排序连线。 */
 export const MetricLine = Object.assign(
   defineComponent<MetricLineProps>({
     web: (props) => <MetricLineWeb {...props} />,

package/src/report/compute.ts

@@ -19,7 +19,7 @@ import type {
   Metric,
   MetricCell,
   OverviewData,
-  ParamRef,
+  FlagRef,
   ScatterData,
   ScoreboardData,
   TableData,
@@ -39,7 +39,7 @@ import {
   experimentIdOf,
   filterItems,
   groupItems,
-  paramAxisValue,
+  flagAxisValue,
   resolveInput,
   snapshotKeyOf,
   toColumn,
@@ -52,7 +52,7 @@ import { formatMetricValue, formatPlainNumber } from "./format.ts";
 // ───────────────────────── MetricTable.data ─────────────────────────
 
 export interface TableDataOptions<M extends readonly Metric[]> {
-  /** 行维度(内置 / 自定义 / param())。 */
+  /** 行维度(内置 / 自定义 / flag())。 */
   rows: DimensionInput;
   /** 每列一个指标;列键 = metric.name 的字面量,拼错编译不过。 */
   columns: M;
@@ -289,10 +289,10 @@ export async function scatterData(input: SnapshotsInput, opts: ScatterDataOption
 // ───────────────────────── MetricLine.data ─────────────────────────
 
 export interface LineDataOptions {
-  /** x 轴:experiment 声明的 param(数值),不解析 experiment 命名。 */
-  x: ParamRef;
+  /** x 轴:experiment 声明的 flag(数值),不解析 experiment 命名。 */
+  x: FlagRef;
   y: Metric;
-  /** 可选:每个系列一条线(param 或普通维度);省略 = 单系列。 */
+  /** 可选:每个系列一条线(flag 或普通维度);省略 = 单系列。 */
   series?: DimensionInput;
 }
 
@@ -303,7 +303,7 @@ export async function lineData(input: SnapshotsInput, opts: LineDataOptions): Pr
   const groups = groupItems(items, "experiment");
   const rows: LineData["rows"] = [];
   for (const [key, group] of groups) {
-    const x = paramAxisValue(opts.x, group[0]); // param 是 experiment 级声明,组内一致
+    const x = flagAxisValue(opts.x, group[0]); // flag 是 experiment 级声明,组内一致
     rows.push({
       key,
       series: opts.series ? dimensionKey(opts.series, group[0]) : undefined,

package/src/report/dual-face.test.tsx

@@ -228,7 +228,7 @@ describe("MetricLine 双面", () => {
     `);
   });
 
-  it("两面同口径:未声明 param 的点两面都不画、注脚同数", () => {
+  it("两面同口径:未声明 flag 的点两面都不画、注脚同数", () => {
     expect(html).toContain("1 point missing data");
     expect(term).toContain("1 point missing data");
     expect(html).not.toContain('data-key="ultra/legacy"'); // 注脚 title 如实列缺数据的点,但不画

package/src/report/{param.ts → flag.ts}

@@ -1,18 +1,18 @@
-// param():把 experiment 声明的 params 当维度或轴(docs/reports.md「params 与新摆法」)。
+// flag():把 experiment 声明的 flags 当维度或轴(docs/reports.md「flags 与新摆法」)。
 // 变量来自配置,不来自命名 —— 报告不解析 experiment id 字符串抠变量。
 
-import type { ParamRef } from "./types.ts";
+import type { FlagRef } from "./types.ts";
 
-export function param(
+export function flag(
   name: string,
   opts?: {
     /** 组标签 / 轴标签;函数形态把声明值折成组名(如 `(v) => \`${v} agents\``)。 */
     label?: string | ((value: string | number | boolean) => string);
     unit?: string;
   },
-): ParamRef {
+): FlagRef {
   if (typeof name !== "string" || name.length === 0) {
-    throw new Error("param: name must be a non-empty string (the key declared in the experiment's params).");
+    throw new Error("flag: name must be a non-empty string (the key declared in the experiment's flags).");
   }
-  return { kind: "param", name, label: opts?.label, unit: opts?.unit };
+  return { kind: "flag", name, label: opts?.label, unit: opts?.unit };
 }

package/src/report/index.ts

@@ -8,9 +8,9 @@
 // ./web.ts,只有那一侧 import react-dom。写报告文件的项目要装 react(.tsx 编译产物
 // import react/jsx-runtime)。
 
-// 指标与 param
+// 指标与 flag
 export { defineMetric, passRate, examScore, durationMs, tokens, costUSD } from "./metrics.ts";
-export { param } from "./param.ts";
+export { flag } from "./flag.ts";
 
 // 报告基座与双面组件基座
 export { defineReport, isReportDefinition, renderReportToText } from "./report.ts";
@@ -84,7 +84,7 @@ export type {
   MetricCell,
   MetricColumn,
   OverviewData,
-  ParamRef,
+  FlagRef,
   ScatterData,
   ScoreboardData,
   SelectionWarning,

package/src/report/react/MetricLine.tsx

@@ -1,4 +1,4 @@
-// MetricLine:趋势线——x 是 experiment 声明的 param(有序变量),每个系列一条线。
+// MetricLine:趋势线——x 是 experiment 声明的 flag(有序变量),每个系列一条线。
 // 与 MetricScatter 的分工:scatter 的两轴都是测出来的指标(找 frontier),
 // line 的 x 是你配置的变量(看趋势)。x 轴正常升序;y 轴向随 better;
 // x 或 y 缺数据的点不画,注脚如实报数;每个点带 <title> hover,可经 pointHref 下钻。

package/src/report/react/fixtures.ts

@@ -207,7 +207,7 @@ export const lineData: LineData = {
       y: { value: 0.7, display: "70%", samples: 6, total: 6, refs: [] },
     },
     {
-      // 未声明 param 的 experiment:作轴不画点,注脚报数
+      // 未声明 flag 的 experiment:作轴不画点,注脚报数
       key: "ultra/legacy",
       series: "1 agents",
       x: null,

package/src/report/report.test.ts

@@ -1,7 +1,7 @@
 // niceeval/report 计算层的单元测试:全部用内存 fake(Snapshot / AttemptHandle 按
 // niceeval/results 的读取契约手工构造),专门覆盖 docs/reports.md 点名的坑 ——
 // 两级聚合 vs 平铺、pass@k、examScore 空真、skipped 稀释、scoreboard 固定分母与
-// 最长前缀、scatter/delta 的 null 语义、快照键对比、param 维度与轴、
+// 最长前缀、scatter/delta 的 null 语义、快照键对比、flag 维度与轴、
 // cases 的 redact/truncated、身份键去重、Selection warnings 随行。
 
 import { describe, expect, it } from "vitest";
@@ -10,7 +10,7 @@ import type { AssertionResult, EvalResult, ResultOutcome, RunSummary } from "../
 import type { AttemptHandle, RunDir, Selection, SelectionWarning, Snapshot } from "../results/index.ts";
 import type { Dimension, MetricCell } from "./types.ts";
 import { costUSD, defineMetric, durationMs, examScore, passRate, tokens } from "./metrics.ts";
-import { param } from "./param.ts";
+import { flag } from "./flag.ts";
 import { formatMetricValue } from "./format.ts";
 import {
   CaseList,
@@ -465,22 +465,22 @@ describe("MetricScatter.data", () => {
   });
 });
 
-// ───────────────────────── param():维度与轴 ─────────────────────────
+// ───────────────────────── flag():维度与轴 ─────────────────────────
 
-describe("param()", () => {
-  const withParams = (id: string, params: Record<string, unknown> | undefined, outcome: ResultOutcome) =>
+describe("flag()", () => {
+  const withFlags = (id: string, flags: Record<string, unknown> | undefined, outcome: ResultOutcome) =>
     snap({
       experimentId: id,
-      results: [res("A", outcome, { experimentId: id, experiment: { id, params } })],
+      results: [res("A", outcome, { experimentId: id, experiment: { id, flags } })],
     });
 
-  it("MetricLine.data:x 收 param、按 experiment 聚合;未声明的作轴 x=null 报数", async () => {
-    const s1 = withParams("ultra/lat-100", { latencyMs: 100, agents: 1 }, "passed");
-    const s2 = withParams("ultra/lat-300", { latencyMs: 300, agents: 1 }, "failed");
-    const legacy = withParams("ultra/legacy", undefined, "passed");
+  it("MetricLine.data:x 收 flag、按 experiment 聚合;未声明的作轴 x=null 报数", async () => {
+    const s1 = withFlags("ultra/lat-100", { latencyMs: 100, agents: 1 }, "passed");
+    const s2 = withFlags("ultra/lat-300", { latencyMs: 300, agents: 1 }, "failed");
+    const legacy = withFlags("ultra/legacy", undefined, "passed");
     const data = await MetricLine.data([s1, s2, legacy], {
-      x: param("latencyMs", { label: "Simulated latency", unit: "ms" }),
-      series: param("agents", { label: (v) => `${v} agents` }),
+      x: flag("latencyMs", { label: "Simulated latency", unit: "ms" }),
+      series: flag("agents", { label: (v) => `${v} agents` }),
       y: passRate,
     });
     expect(data.x).toEqual({ key: "latencyMs", label: "Simulated latency", unit: "ms" });
@@ -493,18 +493,18 @@ describe("param()", () => {
     expect(p100.series).toBe("1 agents");
     expect(p100.y.value).toBe(1);
 
-    // 未声明 param 的 experiment 不猜:作轴 x=null(组件不画、注脚报数),分组归 (unset)
+    // 未声明 flag 的 experiment 不猜:作轴 x=null(组件不画、注脚报数),分组归 (unset)
     const legacyRow = data.rows.find((r) => r.key === "ultra/legacy")!;
     expect(legacyRow.x).toBeNull();
     expect(legacyRow.xDisplay).toBe("");
     expect(legacyRow.series).toBe("(unset)");
   });
 
-  it("param 当维度用:按声明值分组,label 函数折组名", async () => {
-    const s1 = withParams("exp/a", { agents: 1 }, "passed");
-    const s2 = withParams("exp/b", { agents: 16 }, "failed");
+  it("flag 当维度用:按声明值分组,label 函数折组名", async () => {
+    const s1 = withFlags("exp/a", { agents: 1 }, "passed");
+    const s2 = withFlags("exp/b", { agents: 16 }, "failed");
     const data = await MetricTable.data([s1, s2], {
-      rows: param("agents", { label: (v) => `${v} agents` }),
+      rows: flag("agents", { label: (v) => `${v} agents` }),
       columns: [passRate],
     });
     expect(data.dimension).toBe("agents");

package/src/report/types.ts

@@ -1,4 +1,4 @@
-// niceeval/report 的公开类型:指标(Metric)、维度(Dimension / param())与计算函数
+// niceeval/report 的公开类型:指标(Metric)、维度(Dimension / flag())与计算函数
 // 产物(即组件的 data props)。数据契约照 docs/reports.md「计算函数与数据契约」;
 // 这些不是持久化格式,没有 format / schemaVersion 信封,兼容性跟随 npm 版本。
 
@@ -66,20 +66,20 @@ export type Dimension =
   | { name: string; of: (attempt: AttemptHandle) => string };
 
 /**
- * param() 的产物:把 experiment 声明的 params 当维度(series / rows / columns / points
+ * flag() 的产物:把 experiment 声明的 flags 当维度(series / rows / columns / points
  * 槽,按声明值分组)或轴(MetricLine 的 x 槽,要求数值并驱动刻度)。
- * 未声明该 param 的 experiment 不猜:分组如实归「(unset)」,作轴不画点、注脚报数。
+ * 未声明该 flag 的 experiment 不猜:分组如实归「(unset)」,作轴不画点、注脚报数。
  */
-export interface ParamRef {
-  readonly kind: "param";
+export interface FlagRef {
+  readonly kind: "flag";
   readonly name: string;
   /** 组标签 / 轴标签;函数形态把声明值折成组名(如 `(v) => \`${v} agents\``)。 */
   readonly label?: string | ((value: string | number | boolean) => string);
   readonly unit?: string;
 }
 
-/** 维度槽的输入:内置/自定义维度,或 experiment 声明的 param。 */
-export type DimensionInput = Dimension | ParamRef;
+/** 维度槽的输入:内置/自定义维度,或 experiment 声明的 flag。 */
+export type DimensionInput = Dimension | FlagRef;
 
 // ───────────────────────── 计算产物(组件 data props)─────────────────────────
 
@@ -174,9 +174,9 @@ export interface ScatterData {
   }[];
 }
 
-/** MetricLine 的 x 轴:experiment 声明的 param,数值驱动刻度。 */
+/** MetricLine 的 x 轴:experiment 声明的 flag,数值驱动刻度。 */
 export interface LineAxis {
-  /** param 名。 */
+  /** flag 名。 */
   key: string;
   label: string;
   unit?: string;
@@ -184,14 +184,14 @@ export interface LineAxis {
 
 export interface LineData {
   x: LineAxis;
-  /** 系列维度名(param 或普通维度)。 */
+  /** 系列维度名(flag 或普通维度)。 */
   series?: string;
   y: MetricColumn;
   rows: {
     /** 点的键(experiment id):每个点 = 一个 experiment 的聚合。 */
     key: string;
     series?: string;
-    /** param 声明值;未声明或非数值 → null,点不画、注脚报数。 */
+    /** flag 声明值;未声明或非数值 → null,点不画、注脚报数。 */
     x: number | null;
     /** 已格式化的 x("300 ms");x 为 null 时为空串。 */
     xDisplay: string;

package/src/results/results.test.ts

@@ -600,7 +600,7 @@ describe("Artifacts reporter(writer 薄壳)", () => {
     const fresh: EvalResult = {
       id: "algebra/q1",
       experimentId: "compare/bub",
-      experiment: { id: "compare/bub", params: { style: "concise" } },
+      experiment: { id: "compare/bub", flags: { style: "concise" } },
       agent: "bub",
       model: "gpt-5.4",
       outcome: "passed",
@@ -707,7 +707,7 @@ describe("Artifacts reporter(writer 薄壳)", () => {
       "experimentId": "compare/bub",
       "experiment": {
         "id": "compare/bub",
-        "params": {
+        "flags": {
           "style": "concise"
         }
       },

package/src/runner/attempt.ts

@@ -228,7 +228,7 @@ async function runAttemptBody(
     signal,
     model: run.model,
     reasoningEffort: run.reasoningEffort,
-    params: run.params,
+    flags: run.flags,
     sandbox,
     session: createAgentSession(),
     telemetry,
@@ -270,7 +270,7 @@ async function runAttemptBody(
       sandbox,
       model: run.model,
       reasoningEffort: run.reasoningEffort,
-      params: run.params,
+      flags: run.flags,
       signal,
       log,
       judge,
@@ -442,7 +442,7 @@ async function collectSources(
 function experimentRunInfo(run: AgentRun): EvalResult["experiment"] {
   return {
     id: run.experimentId,
-    params: run.params,
+    flags: run.flags,
     runs: run.runs,
     earlyExit: run.earlyExit,
     sandbox: run.sandbox === undefined ? undefined : sandboxLabel(run.sandbox),

package/src/runner/fingerprint.ts

@@ -38,7 +38,7 @@ export async function computeFingerprint(
       experimentId: run.experimentId,
       agent: run.agent.name,
       model: run.model,
-      params: run.params,
+      flags: run.flags,
       sandbox: run.sandbox === undefined ? undefined : sandboxLabel(run.sandbox),
       timeoutMs: run.timeoutMs,
       strict: run.strict,

package/src/runner/reporters/braintrust.test.ts

@@ -85,7 +85,7 @@ describe("toBraintrustEvent", () => {
         model: "gpt-5.2",
         attempt: 1,
         outcome: "failed",
-        experiment: { id: "compare/codex", params: { tape: true } },
+        experiment: { id: "compare/codex", flags: { tape: true } },
         assertions: [{ name: "compiles", severity: "gate", score: 0, passed: false, detail: "tsc failed" }],
       }),
     );
@@ -96,7 +96,7 @@ describe("toBraintrustEvent", () => {
       outcome: "failed",
       model: "gpt-5.2",
       experiment: "compare/codex",
-      params: { tape: true },
+      flags: { tape: true },
       failedAssertions: [{ name: "compiles", detail: "tsc failed" }],
     });
     expect(event.id).toBe("compare/codex|algebra/quadratic|codex|gpt-5.2|a1");

package/src/runner/reporters/braintrust.ts

@@ -113,7 +113,7 @@ export function Braintrust(config: BraintrustConfig = {}): Reporter {
  * - scores:soft 断言按名字记分,gate 断言记在 `gate:` 前缀下 —— 实验 diff 里
  *   gate 回归和 soft 分数回归用同一套机制看。重名断言追加 `#n` 消歧,不静默覆盖。
  * - metrics:start/end(Braintrust 由此算时长)+ token 用量 + 估算成本;缺就不写,不编 0。
- * - metadata:身份维度(agent / model / experiment / attempt / params)+ 失败断言明细。
+ * - metadata:身份维度(agent / model / experiment / attempt / flags)+ 失败断言明细。
  */
 export function toBraintrustEvent(result: EvalResult): BraintrustLogEvent {
   const scores: Record<string, number> = {};
@@ -150,8 +150,8 @@ export function toBraintrustEvent(result: EvalResult): BraintrustLogEvent {
   };
   if (result.model !== undefined) metadata.model = result.model;
   if (result.experimentId !== undefined) metadata.experiment = result.experimentId;
-  if (result.experiment?.params && Object.keys(result.experiment.params).length > 0) {
-    metadata.params = result.experiment.params;
+  if (result.experiment?.flags && Object.keys(result.experiment.flags).length > 0) {
+    metadata.flags = result.experiment.flags;
   }
   if (result.skipReason !== undefined) metadata.skipReason = result.skipReason;
   const failed = result.assertions

package/src/runner/run.ts

@@ -104,7 +104,7 @@ export async function runEvals(opts: RunOptions): Promise<RunSummary> {
         if (run.experimentId && priorRunKeys.has(`${run.experimentId}|${evalDef.id}`)) continue;
         // key 标识「同一个运行配置下的同一条 eval」,earlyExit 的跳过/abort 只应作用于
         // 同 key 的重试轮。experimentId 必须进 key:两个实验可以同 agent 同 model、只差
-        // params(feature A/B 正是这种形状),漏掉它会让先过的实验把其它实验的同名 eval
+        // flags(feature A/B 正是这种形状),漏掉它会让先过的实验把其它实验的同名 eval
         // 整个跳掉——花了钱还丢结果。
         const key = `${run.experimentId ?? ""}|${run.agent.name}|${run.model ?? ""}|${evalDef.id}`;
         attempts.push({

package/src/runner/types.ts

@@ -12,7 +12,7 @@ import type { TestContext } from "../context/types.ts";
 
 export interface ExperimentRunInfo {
   id?: string;
-  params?: Record<string, unknown>;
+  flags?: Record<string, unknown>;
   runs?: number;
   earlyExit?: boolean;
   sandbox?: string;
@@ -61,7 +61,7 @@ export interface EvalResult {
 /** `summary.json` 的格式标记;把 niceeval 报告和其它工具的同名文件区分开。 */
 export const RESULTS_FORMAT = "niceeval.results";
 /** 结果格式版本,只在破坏兼容读取时递增;读取器只认相同版本,缺失按 1。见 docs/results-format.md。 */
-export const RESULTS_SCHEMA_VERSION = 2;
+export const RESULTS_SCHEMA_VERSION = 3;
 
 export interface RunSummary {
   /** 恒为 "niceeval.results";和 schemaVersion、producer 一起构成持久化契约,永不移动或改名。 */
@@ -95,11 +95,11 @@ export interface RunSummary {
   snapshots?: Record<string, { startedAt?: string; knownEvalIds?: string[] }>;
 }
 
-/** onRunStart 的运行规模:去重后 eval 数 × 配置(agent×model×params)数 → 总运行(attempt)数。 */
+/** onRunStart 的运行规模:去重后 eval 数 × 配置(agent×model×flags)数 → 总运行(attempt)数。 */
 export interface RunShape {
   /** 去重后实际要跑的 eval 数(= evals.length)。 */
   evals: number;
-  /** (agent, model, params) 配置组合数;compare 多 agent 时 > 1。 */
+  /** (agent, model, flags) 配置组合数;compare 多 agent 时 > 1。 */
   configs: number;
   /** 总 attempt 数(evals × configs × runs);逐行输出与汇总计数都按它。 */
   totalRuns: number;
@@ -174,8 +174,8 @@ export interface ExperimentDef {
   model?: string;
   /** 模型推理努力程度(如 "low"/"medium"/"high",取值由具体模型/adapter 决定);省略=用 agent 原生默认。经 ctx.reasoningEffort 透给 adapter 与 eval。 */
   reasoningEffort?: string;
-  /** 传给每次 attempt 的 params,经 t.params 暴露给 eval;与 CLI flag 合并(CLI 优先)。 */
-  params?: Record<string, unknown>;
+  /** 实验条件(A/B 里的 feature flag),由实验文件声明;经 ctx.flags 透传给 adapter、t.flags 暴露给 eval。 */
+  flags?: Record<string, unknown>;
   /** 同一 eval 重复跑几次(结果各计一条 attempt);省略/CLI `--runs` 覆盖时默认 1。 */
   runs?: number;
   /** 一次重复(runs > 1)里某次 attempt 失败后是否跳过剩余重复;省略默认 true(提前退出省钱)。 */
@@ -267,12 +267,12 @@ export function runWho(run: Pick<AgentRun, "agent" | "model" | "experimentId">):
   return run.model ? `${run.agent.name}/${run.model}` : run.agent.name;
 }
 
-/** 一个 (agent, model, params) 的运行配置 —— 由 CLI / 实验展开。 */
+/** 一个 (agent, model, flags) 的运行配置 —— 由 CLI / 实验展开。 */
 export interface AgentRun {
   agent: Agent;
   model?: string;
   reasoningEffort?: string;
-  params: Record<string, unknown>;
+  flags: Record<string, unknown>;
   runs: number;
   earlyExit: boolean;
   sandbox?: SandboxOption;

package/src/view/app/css.d.ts

@@ -0,0 +1,3 @@
+// TS7 默认开启 noUncheckedSideEffectImports,CSS 副作用导入(main.tsx 引 styles.css,
+// 由 Vite 处理)需要显式模块声明才能通过 typecheck。
+declare module "*.css";

package/src/view/app/i18n.ts

@@ -58,7 +58,7 @@ export type MessageKey =
   | "detail.rawSample"
   | "detail.rawNote"
   | "config.experiment"
-  | "config.paramsNone"
+  | "config.flagsNone"
   | "config.default"
   | "config.none"
   | "config.notApplicable"
@@ -177,7 +177,7 @@ const dictionaries: Record<Locale, Dictionary> = {
     "detail.rawSample": "Raw sample result",
     "detail.rawNote": "debug JSON, defaults to first error/failure when available",
     "config.experiment": "experiment",
-    "config.paramsNone": "none",
+    "config.flagsNone": "none",
     "config.default": "default",
     "config.none": "none",
     "config.notApplicable": "n/a",
@@ -293,7 +293,7 @@ const dictionaries: Record<Locale, Dictionary> = {
     "detail.rawSample": "原始样例结果",
     "detail.rawNote": "调试 JSON，默认选择第一条错误/失败",
     "config.experiment": "实验",
-    "config.paramsNone": "无",
+    "config.flagsNone": "无",
     "config.default": "默认",
     "config.none": "无",
     "config.notApplicable": "不适用",

package/src/view/app/lib/rows.ts

@@ -127,9 +127,9 @@ export function valueFor(row: ViewRow, key: SortKey): string | number | null {
 
 export function configChips(row: ViewRow, t: T): [string, ReactNode][] {
   const exp = row.experiment || {};
-  const params = exp.params && Object.keys(exp.params).length
-    ? Object.entries(exp.params).map(([k, v]) => k + "=" + formatConfigValue(v)).join(", ")
-    : t("config.paramsNone");
+  const flags = exp.flags && Object.keys(exp.flags).length
+    ? Object.entries(exp.flags).map(([k, v]) => k + "=" + formatConfigValue(v)).join(", ")
+    : t("config.flagsNone");
   return [
     [t("config.experiment"), row.synthetic ? row.label : row.experimentId],
     [t("table.model"), row.model || t("config.default")],
@@ -138,6 +138,6 @@ export function configChips(row: ViewRow, t: T): [string, ReactNode][] {
     ["earlyExit", exp.earlyExit === undefined ? t("config.notApplicable") : String(exp.earlyExit)],
     ["sandbox", exp.sandbox || t("config.default")],
     ["budget", exp.budget === undefined ? t("config.none") : "$" + exp.budget],
-    ["params", params],
+    ["flags", flags],
   ];
 }