niceeval 0.9.0 → 0.9.1

package/dist/i18n/zh-CN.d.ts

@@ -54,7 +54,7 @@ export declare const zhCN: {
     readonly "cli.show.noResults": "{{root}} 下没有结果。先 `niceeval exp` 跑一轮,再 `niceeval show`。\n";
     readonly "cli.show.runDirMissing": "Results directory not found: {{dir}}\n";
     readonly "cli.show.noEvalMatch": "No results matched: {{patterns}}. Evals with results: {{evals}}\n";
-    readonly "cli.show.noExperimentMatch": "No experiment matched --experiment {{arg}}. Experiments with results: {{experiments}}\n";
+    readonly "cli.show.noExperimentMatch": "No experiment matched --exp {{arg}}. Experiments with results: {{experiments}}\n";
     readonly "cli.show.historyReportConflict": "`--history` and `--report` are mutually exclusive: both take over the main output. --history is the host's per-attempt execution timeline; for snapshot-level trends, compose exp.snapshots inside your report file instead.\n";
     readonly "cli.show.evidenceNeedsEval": "--source / --execution / --diff show one attempt's evidence, but the selection matched {{matched}} evals. Pick an attempt locator from the index below:\n{{index}}\n";
     readonly "cli.show.locatorMalformed": "{{message}}\n";

package/dist/report/report.js

@@ -334,10 +334,10 @@ export function reportTitleText(definition, scope, locale) {
 function quoteArg(value) {
     return /^[A-Za-z0-9._/@-]+$/.test(value) ? value : `'${value.replaceAll("'", `'"'"'`)}'`;
 }
-/** 按上下文拼组索引的可复制命令:`niceeval show <patterns> --experiment <id> [--results/--report/--page]`。 */
+/** 按上下文拼组索引的可复制命令:`niceeval show <patterns> --exp <id> [--results/--report/--page]`。 */
 function experimentCommandFor(ctx) {
     return (prefix) => {
-        const parts = ["niceeval show", ...ctx.patterns.map(quoteArg), `--experiment ${quoteArg(prefix)}`];
+        const parts = ["niceeval show", ...ctx.patterns.map(quoteArg), `--exp ${quoteArg(prefix)}`];
         if (ctx.results !== undefined)
             parts.push(`--results ${quoteArg(ctx.results)}`);
         if (ctx.report !== undefined)

package/dist/report/tree.d.ts

@@ -38,7 +38,7 @@ export interface TextContext {
     attemptCommand(locator: AttemptLocator): string;
     /**
      * 组索引一类「按实验收窄」命令的生成;宿主注入以携带完整上下文(--results / --report /
-     * --page 与位置参数),默认 `niceeval show --experiment <id>`。非契约字段,官方组件内部用。
+     * --page 与位置参数),默认 `niceeval show --exp <id>`。非契约字段,官方组件内部用。
      */
     experimentCommand(experimentIdPrefix: string): string;
 }

package/dist/report/tree.js

@@ -351,7 +351,7 @@ export function createTextContext(options) {
     // 默认下钻命令:AttemptLocator 是 `@` 前缀的不透明短串,`niceeval show @<locator>` 是
     // show 已实现的真实 CLI 语法,不需要反查 eval id 再拼一条近似命令。
     const attemptCommand = options?.attemptCommand ?? ((locator) => `niceeval show ${locator}`);
-    const experimentCommand = options?.experimentCommand ?? ((prefix) => `niceeval show --experiment ${shellQuote(prefix)}`);
+    const experimentCommand = options?.experimentCommand ?? ((prefix) => `niceeval show --exp ${shellQuote(prefix)}`);
     const make = (w) => ({
         width: w,
         locale,

package/dist/results/select.d.ts

@@ -11,7 +11,7 @@ export declare function selectLatest(results: Pick<Results, "experiments" | "ski
 }): Scope;
 /** selectCurrentResults 的范围输入:experiment id 前缀与 eval id 前缀,都可缺省。 */
 export interface ResultScope {
-    /** experiment id 前缀(--experiment),分段匹配语义同 filterExperiments。 */
+    /** experiment id 前缀(--exp),分段匹配语义同 filterExperiments。 */
     experiment?: string | string[];
     /** eval id 前缀(位置参数),收窄 Scope 覆盖的 eval;覆盖警告分母同步收窄到范围内。 */
     patterns?: string[];
@@ -68,7 +68,7 @@ export declare function dedupeAttempts(attempts: AttemptHandle[]): {
 };
 /** 快照新旧比较:startedAt 优先,同刻按快照目录名(时间戳 + 随机后缀,字典序即时序)。 */
 export declare function isNewerSnapshot(a: Snapshot, b: Snapshot): boolean;
-/** experiment id 分段前缀过滤(--experiment / latest({ experiments }) 同一语义);包内使用,不进公共 barrel。 */
+/** experiment id 分段前缀过滤(--exp / latest({ experiments }) 同一语义);包内使用,不进公共 barrel。 */
 export declare function filterExperiments(experiments: Experiment[], filter?: string | string[]): Experiment[];
 /**
  * stale 警告的人话时距:选粒度最大的单位,四舍五入。结构化形态是单源——message 的英文时距

package/dist/results/select.js

@@ -312,7 +312,7 @@ export function isNewerSnapshot(a, b) {
         return byStart > 0;
     return a.dir.localeCompare(b.dir) > 0;
 }
-/** experiment id 分段前缀过滤(--experiment / latest({ experiments }) 同一语义);包内使用,不进公共 barrel。 */
+/** experiment id 分段前缀过滤(--exp / latest({ experiments }) 同一语义);包内使用,不进公共 barrel。 */
 export function filterExperiments(experiments, filter) {
     if (filter === undefined)
         return experiments;

package/dist/shared/aggregate.d.ts

@@ -18,7 +18,7 @@ export declare function experimentGroupOf(experimentId: string): string | undefi
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/show.md「打开与收窄」):
  * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——"algebra" 命中 "algebra"、"algebra/..."
- * 也命中 "algebra2",多命中正是它的用途(与 `--experiment` 的按路径段匹配有意不同)。
+ * 也命中 "algebra2",多命中正是它的用途(与 `--exp` 的按路径段匹配有意不同)。
  */
 export declare function evalPrefixPredicate(evals?: string | string[]): (id: string) => boolean;
 /** 无 experimentId 时的兜底标签。 */

package/dist/shared/aggregate.js

@@ -38,7 +38,7 @@ export function experimentGroupOf(experimentId) {
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/show.md「打开与收窄」):
  * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——"algebra" 命中 "algebra"、"algebra/..."
- * 也命中 "algebra2",多命中正是它的用途(与 `--experiment` 的按路径段匹配有意不同)。
+ * 也命中 "algebra2",多命中正是它的用途(与 `--exp` 的按路径段匹配有意不同)。
  */
 export function evalPrefixPredicate(evals) {
     if (evals === undefined)

package/docs-site/zh/how-to/custom-reports.mdx

@@ -81,7 +81,7 @@ niceeval view --report reports/exam.tsx    # 网页：同一棵树走网页面
 
 挑选提醒（覆盖不全、快照过期、有没跑完的运行、读不出来的快照）由选择警告（`ScopeWarnings`）组件显示：提醒按实验归组，组头列出实验名、问题标签和一条可复制的重跑命令，每条提醒的原文收在组内可展开的折叠块里（提醒少时默认展开），读不出来的快照单独归成一组。默认报告每一页都摆了它；自己的报告想显示提醒，就在页首摆一个 `<ScopeWarnings />`——不摆就不显示，数字是否附带完整性提醒由你对读者负责。
 
-命令行的范围先作用在挑选上，报告拿到的就是收窄到这个范围后的 `selection`：位置参数的 eval id 前缀收窄 Selection 覆盖的 eval（覆盖提醒的分母同样收窄到范围内），`--results` 把结果根换成指定目录，`--experiment` 让 Selection 只留该实验。`--history` 与 `--report` 互斥——趋势在报告里用 `exp.snapshots` 自己摆；证据切面（`--eval` / `--execution` / `--diff`）只看证据，不渲染报告。
+命令行的范围先作用在挑选上，报告拿到的就是收窄到这个范围后的 `selection`：位置参数的 eval id 前缀收窄 Selection 覆盖的 eval（覆盖提醒的分母同样收窄到范围内），`--results` 把结果根换成指定目录，`--exp` 让 Selection 只留该实验。`--history` 与 `--report` 互斥——趋势在报告里用 `exp.snapshots` 自己摆；证据切面（`--eval` / `--execution` / `--diff`）只看证据，不渲染报告。
 
 页面里的每个组件都是**双面**的：网页面是 React 渲染，终端面是字符渲染，两面吃同一份算好的数据。实体列表按 experiment → Eval → Attempt 展示事实；指标表、矩阵、条形图、成绩单、散点图、趋势图和差异表展示聚合值。完整清单见[报告组件](/zh/reference/report-components)。网页面的实体、格子和点深链到 Attempt 详情，终端面印出对应的 `niceeval show <eval id>` 下钻命令。
 

package/docs-site/zh/how-to/experiments.mdx

@@ -68,11 +68,11 @@ api-validation   claude-code             pass@3 = 1/3 (33%)    mean 41s
 除了 pass rate，还应该看平均耗时、token、成本和失败类型。
 
 ```bash
-npx niceeval show --experiment compare-models
+npx niceeval show --exp compare-models
 npx niceeval view
 ```
 
-`show --experiment` 按路径段匹配 id 前缀，所以组名会选中组内所有配置，但不会误中名字只是在字符串上相似的另一个组。`view` 默认加载完整结果，直接在页面里选组；`--experiment` 对它只是可选的启动时收窄。
+`show --exp` 按路径段匹配 id 前缀，所以组名会选中组内所有配置，但不会误中名字只是在字符串上相似的另一个组。`view` 默认加载完整结果，直接在页面里选组；`--exp` 对它只是可选的启动时收窄。
 
 ## 设计 experiment 的建议
 

package/docs-site/zh/how-to/publish-report.mdx

@@ -31,6 +31,12 @@ await copySnapshots(results.latest(), output, {
 npx niceeval view --results report-data --out site
 ```
 
+只发布一部分实验时,把收窄直接交给导出命令,页面和证据都只含收窄后的范围(见[查看结果 · 导出与静态托管](/zh/how-to/viewing-results#导出与静态托管)):
+
+```bash
+npx niceeval view --results report-data --exp compare --out site
+```
+
 `view` 对零可读结果直接报错、非零退出,不会导出一张空报告——`report-data/` checkout 坏掉,或所有落盘与当前 niceeval 的 schemaVersion 不兼容被整批跳过时,构建失败,Vercel / GitHub Pages 保留上一次部署。错误逐条列出被跳过的快照目录与原因,schemaVersion 场景还给出能直接查看旧落盘的 `npx niceeval@<版本> view` 命令。
 
 ## 发布自定义报告

package/docs-site/zh/how-to/viewing-results.mdx

@@ -66,7 +66,7 @@ Sandbox 创建、setup 或 teardown 错误不依赖 trace。`result.json` 保存
 
 同一个实验多次跑会留下多份结果，不带 `@<locator>` 的默认视图只回答一个问题——「现在整体怎样」：每个 experiment × eval 取时间上最新的那份判定，同一个 experiment 跨多次运行拼出来。按前缀只重跑了部分 eval 时，其余 eval 的判定从更早的运行补齐，报告永远是全局最新，不会因为一次局部重跑变残缺。合成是有标注的：每份判定都带上它产生的时间，能看出报告是从哪几次运行拼出来的。合成结果可能混着不同版本的被测代码——所以收工判定以 `--force` 全量重跑为准，迭代途中的 `show` 负责快、收尾的全量跑负责真。
 
-单个 eval 视图里，多 experiment、多 Attempt 时的断言明细块默认挑最新一次失败的 Attempt 展开；没有失败就挑最新一次。这只是一个默认展开的启发式，不是精确选择——需要精确看某一次 Attempt，复制那一行的 `@<locator>` 直接 `show` 它即可。`--experiment compare` 按路径段前缀把 Selection 收窄到整个 `compare` 组，`--experiment compare/bub` 只留一个 experiment；`--results <目录>` 换结果根，`--snapshot <snapshot.json>` 只看某一次落盘的快照，`--history` 看跨 run 趋势。`--report <文件>` 同时替换 `show` / `view` 的默认报告。位置前缀、`--results`、`--experiment` 对自定义报告同样生效；`--history` 与 `--report` 互斥。
+单个 eval 视图里，多 experiment、多 Attempt 时的断言明细块默认挑最新一次失败的 Attempt 展开；没有失败就挑最新一次。这只是一个默认展开的启发式，不是精确选择——需要精确看某一次 Attempt，复制那一行的 `@<locator>` 直接 `show` 它即可。`--exp compare` 按路径段前缀把 Selection 收窄到整个 `compare` 组，`--exp compare/bub` 只留一个 experiment；`--results <目录>` 换结果根，`--snapshot <snapshot.json>` 只看某一次落盘的快照，`--history` 看跨 run 趋势。`--report <文件>` 同时替换 `show` / `view` 的默认报告。位置前缀、`--results`、`--exp` 对自定义报告同样生效；`--history` 与 `--report` 互斥。
 
 `niceeval view` 的每个视图都有 CLI 对应物：
 
@@ -83,7 +83,7 @@ Sandbox 创建、setup 或 teardown 错误不依赖 trace。`result.json` 保存
 
 ### 默认分组比较报告
 
-不带 flag 的 `niceeval show` 如果命中多个可比组，只列组索引和可直接执行的 `niceeval show --experiment <group>` 命令；Selection 只剩一个组时才输出该组的成本 × 端到端成功率图和实验列表。组的边界来自 experiment id 的完整父目录：`compare/*` 与 `dev-e2b/*` 不共享坐标系、连线、排序或汇总数字；顶层 experiment 各自形成单例组。
+不带 flag 的 `niceeval show` 如果命中多个可比组，只列组索引和可直接执行的 `niceeval show --exp <group>` 命令；Selection 只剩一个组时才输出该组的成本 × 端到端成功率图和实验列表。组的边界来自 experiment id 的完整父目录：`compare/*` 与 `dev-e2b/*` 不共享坐标系、连线、排序或汇总数字；顶层 experiment 各自形成单例组。
 
 组内实验列表先给固定列汇总，再按 experiment → Eval → Attempt 展开。locator 只保留 `@<id>`，失败原因优先显示期望值/实际值或命令退出码；完整断言和 evidence 留在 `niceeval show @<locator>`。某组只有一个 experiment 时散点仍显示单点，不出现“至少两个实验才能比较”的空态。快照未完成、过旧或覆盖不全的 warning 位于组索引前，同一条 warning 只显示一次。
 
@@ -329,7 +329,7 @@ compare/codex-gpt-5.4 · 5 runs · passed 2/5
 npx niceeval view
 ```
 
-这会打开本地结果查看器。它的首页报告和 `niceeval show` 选结果的规则一模一样：对每个 experiment 的每道 eval，取时间上最新的那份判定，同一个 experiment 跨多次运行拼出来；收窄范围（eval ID 前缀、`--experiment`）时按同一条规则收窄。你可以浏览 eval、查看 agent 的对话与工具调用、读 diff、检查断言结果。数据不会上传到外部服务。
+这会打开本地结果查看器。它的首页报告和 `niceeval show` 选结果的规则一模一样：对每个 experiment 的每道 eval，取时间上最新的那份判定，同一个 experiment 跨多次运行拼出来；收窄范围（eval ID 前缀、`--exp`）时按同一条规则收窄。你可以浏览 eval、查看 agent 的对话与工具调用、读 diff、检查断言结果。数据不会上传到外部服务。
 
 <Tip>
   失败后立刻运行 `npx niceeval view`，可以直接打开刚刚那次运行的 artifacts。
@@ -349,7 +349,16 @@ npx niceeval view
 npx niceeval view --out site
 ```
 
-NiceEval 写入 `<dir>/index.html`，并把查看器要读取的 artifact（`sources.json`、`events.json`、`trace.json`）复制到 `<dir>/artifact/` 下。把整个目录交给任何静态托管（Vercel、GitHub Pages 或 `python3 -m http.server`），代码视图、transcript 和 trace 瀑布图都和本地 `niceeval view` 一致；表格排序、过滤和图表悬停也照常可用——所需脚本已内联进页面，浏览器禁用 JS 时页面仍完整可读，只是少这些浏览操作。
+NiceEval 写入 `<dir>/index.html`，并把查看器要读取的 artifact（`sources.json`、`events.json`、`trace.json`，有 `diff.json` 也带上）复制到 `<dir>/artifact/` 下。把整个目录交给任何静态托管（Vercel、GitHub Pages 或 `python3 -m http.server`），代码视图、transcript 和 trace 瀑布图都和本地 `niceeval view` 一致；表格排序、过滤和图表悬停也照常可用——所需脚本已内联进页面，浏览器禁用 JS 时页面仍完整可读，只是少这些浏览操作。
+
+只想发布一部分结果时，把本地查看用的收窄直接交给导出：
+
+```bash
+npx niceeval view --exp compare --out site   # 只发布 compare 可比组
+npx niceeval view weather --out site                # 只发布 weather 开头的 eval
+```
+
+出站的就是收窄到的：页面和 `artifact/` 证据都只含收窄后的范围，被滤掉实验的 transcript、源码和 trace 不会跟着出站。不收窄就是整站导出完整结果。
 
 `--out` 只接受目录。没有单文件导出：代码视图、transcript 和 trace 依赖 artifact 文件，单个 HTML 装不下完整证据。要把结果发给别人，托管整站发链接即可。
 
@@ -357,7 +366,7 @@ NiceEval 写入 `<dir>/index.html`，并把查看器要读取的 artifact（`sou
 
 两点限制：
 
-- `diff.json` 和 `o11y.json` 不会被复制。查看器不读取它们，且 diff 可能达到上百 MB。
+- `o11y.json` 不会被复制——报告数字已经算进页面，查看器不读取它。
 - 用 `file://` 直接打开 `index.html` 时浏览器不允许 fetch artifact，代码视图会提示源码不可用。本地预览用 http 服务打开。
 
 最简单的流程是在跑过 eval 的机器上导出，把产物目录直接部署，不需要额外步骤。要让站点随 push 自动更新，先用 `copySnapshots` 生成经过单文件预算检查的发布结果根，把它提交进仓库，再让 CI 对这个目录运行 `view --results <目录> --out`——workflow 与平台接线见[通过 CI 发布报告](/zh/how-to/publish-report)。

package/docs-site/zh/reference/cli.mdx

@@ -93,7 +93,7 @@ npx niceeval exp compare-models weather
 | `--timing` | boolean | `show` 命令专用:整个 Attempt 的统一时间树;裸 `--timing` 给有界诊断投影,`--timing=full` 逐节点展开全部 runner/已关联 OTel 节点。 |
 | `--diff` | boolean | `show` 命令专用:sandbox 里的文件改动摘要;`--diff=<文件路径>` 看单个文件的完整改动(路径必须 `=` 连写)。 |
 | `--history` | boolean | `show` 命令专用:执行时间轴——对匹配的每个 experiment × eval 分节,逐 attempt 列时间 / verdict / 摘要 / 耗时 / 成本 / locator;与 `--report` 互斥。 |
-| `--experiment` | string | `show` / `view` 命令专用:按路径段前缀收窄 experiment;组名会选中组内全部配置。 |
+| `--exp` | string | `show` / `view` 命令专用:按路径段前缀收窄 experiment(与 `niceeval exp` 位置参数同一套匹配);组名会选中组内全部配置。`view --out` 时同一收窄决定出站内容。 |
 | `--results` | string | `show` / `view` / `sandbox enter\|list\|stop` 共用:结果根目录(`.niceeval` 之外的另一个根,如 `copySnapshots` 产出的发布根)。 |
 | `--snapshot` | string | `view` 命令专用:只打开这一份快照文件(`snapshot.json`);文件不可读时命令失败(扫描模式只跳过)。 |
 | `--report` | string | `show` / `view` 命令专用:用文件默认导出的 `defineReport(...)` 替换两者共用的默认报告。 |
@@ -151,7 +151,7 @@ npx niceeval exp compare --output ci --strict --json .niceeval/ci-summary.json -
 npx niceeval view
 ```
 
-打开本地结果查看器。它和 `show` 共用同一份默认报告和同一套默认选择——对每个 experiment、每个 eval，取历次运行里最新的那份判定；只补跑部分 eval 时，其余 eval 从更早的运行补齐。默认报告按 experiment id 的父目录分组，只在同组内比较。`show` 输出终端文本，`view` 输出网页并提供可交互的证据浏览；eval ID 前缀、`--experiment`、`--results` 对两者的收窄一致。完整说明见[查看结果](/zh/how-to/viewing-results)。
+打开本地结果查看器。它和 `show` 共用同一份默认报告和同一套默认选择——对每个 experiment、每个 eval，取历次运行里最新的那份判定；只补跑部分 eval 时，其余 eval 从更早的运行补齐。默认报告按 experiment id 的父目录分组，只在同组内比较。`show` 输出终端文本，`view` 输出网页并提供可交互的证据浏览；eval ID 前缀、`--exp`、`--results` 对两者的收窄一致。完整说明见[查看结果](/zh/how-to/viewing-results)。
 
 ## `show [id-prefix...]`
 

package/docs-site/zh/troubleshooting/debugging.mdx

@@ -173,8 +173,8 @@ niceeval sandbox stop --all
 **按实验回看当前水位。** 不记得定位符时，从实验入手：
 
 ```bash
-niceeval show --experiment compare/bub        # 这个实验每道题现在的判定
-niceeval show memory/swelancer --experiment compare/bub   # 收窄到某道题
+niceeval show --exp compare/bub        # 这个实验每道题现在的判定
+niceeval show memory/swelancer --exp compare/bub   # 收窄到某道题
 ```
 
 列表里每道题、每次 Attempt 都带定位符，接着往深处钻就回到上面的场景一 / 场景二。
@@ -208,5 +208,5 @@ niceeval view --results site-data/run
 | 装依赖失败、CLI 起不来、跑一半超时 | 重跑该 eval 加 `--keep-sandbox` → `niceeval sandbox enter <id>` |
 | 想看文件实际内容（agent 没改的、起始材料、`$HOME`） | 重跑加 `--keep-sandbox`（failed 也留）→ `sandbox enter` 进 workdir 看 |
 | 留了哪些沙箱、清理 | `sandbox list` → `sandbox stop <id>` / `--all` |
-| 复盘上周那次失败 | 翻出旧定位符 → `show @loc`；不记得就 `show --experiment <实验>` |
+| 复盘上周那次失败 | 翻出旧定位符 → `show @loc`；不记得就 `show --exp <实验>` |
 | 一批失败一起看 | `niceeval view` → Attempt 详情 → Copy fix prompt |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niceeval",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Agent-native eval tool — eval agents, services, functions, and coding-agent fixtures",
   "type": "module",
   "license": "MIT",

package/src/cli.ts

@@ -170,8 +170,8 @@ const FLAG_OPTIONS = {
   diff: { type: "boolean" },
   /** `show` 命令专用:执行时间轴——对匹配的每个 experiment × eval 分节,逐 attempt 列时间 / verdict / 摘要 / 耗时 / 成本 / locator;与 `--report` 互斥。 */
   history: { type: "boolean" },
-  /** `show` / `view` 命令专用:按路径段前缀收窄 experiment;组名会选中组内全部配置。 */
-  experiment: { type: "string" },
+  /** `show` / `view` 命令专用:按路径段前缀收窄 experiment(与 `niceeval exp` 位置参数同一套匹配);组名会选中组内全部配置。`view --out` 时同一收窄决定出站内容。 */
+  exp: { type: "string" },
   /** `show` / `view` / `sandbox enter|list|stop` 共用:结果根目录(`.niceeval` 之外的另一个根,如 `copySnapshots` 产出的发布根)。 */
   results: { type: "string" },
   /** `view` 命令专用:只打开这一份快照文件(`snapshot.json`);文件不可读时命令失败(扫描模式只跳过)。 */
@@ -308,7 +308,7 @@ function parseArgs(argv: string[]): { command: string; positionals: string[]; fl
     sandboxPath: values.path as string | undefined,
     leaveRunning: values["leave-running"] === true,
     history: values.history === true,
-    experiment: values.experiment as string | undefined,
+    experiment: values.exp as string | undefined,
     results: values.results as string | undefined,
     snapshot: values.snapshot as string | undefined,
     report: values.report as string | undefined,
@@ -320,7 +320,7 @@ function parseArgs(argv: string[]): { command: string; positionals: string[]; fl
 /**
  * exp 只接受两类输入:位置参数选「跑哪些 eval」+ 调度/输出/机器出口 flag 选「对着哪个 agent、
  * 怎么跑」。show / view 专属的证据切面(`--source`/`--execution`/`--diff`)、时间轴(`--history`)、
- * Scope 收窄(`--experiment`/`--results`)、报告装载(`--report`/`--page`)、查看器
+ * Scope 收窄(`--exp`/`--results`)、报告装载(`--report`/`--page`)、查看器
  * (`--snapshot`/`--out`/`--port`/`--open`)不能被 exp 静默忽略(见 docs/feature/experiments/
  * cli.md「用法错误」)。返回第一个被误用的 flag 及其归属命令(用于报错),没有误用返回 undefined。
  */
@@ -333,7 +333,7 @@ function firstViewerOnlyFlag(flags: Flags): { flag: string; command: string } |
   if (flags.timing !== undefined) return { flag: "--timing", command: SHOW };
   if (flags.diff || flags.diffPath !== undefined) return { flag: "--diff", command: SHOW };
   if (flags.history) return { flag: "--history", command: SHOW };
-  if (flags.experiment !== undefined) return { flag: "--experiment", command: BOTH };
+  if (flags.experiment !== undefined) return { flag: "--exp", command: BOTH };
   if (flags.results !== undefined) return { flag: "--results", command: BOTH };
   if (flags.report !== undefined) return { flag: "--report", command: BOTH };
   if (flags.page !== undefined) return { flag: "--page", command: BOTH };
@@ -566,11 +566,10 @@ async function main(): Promise<void> {
   }
 
   if (command === "view") {
-    // 位置参数只有一种含义:eval id 前缀(收窄报告槽 Scope)。结果根经 --results 递入,
+    // 位置参数只有一种含义:eval id 前缀(收窄有效根)。结果根经 --results 递入,
     // 单开一份快照经 --snapshot 递入;--report 整槽替换报告槽(与 show --report 吃同一个文件),
     // --page 定初始页。文件与目录都不进位置参数(docs/feature/reports/view.md「打开与收窄」)。
-    // --out 与位置参数 / --experiment 的互斥在 buildView 内校验(单点,报错文案含 copySnapshots
-    // + filter 的下一步),经 exitOnViewUserError 按用法错误退出。
+    // --out 接受同一收窄:出站内容即收窄后的有效根(docs/feature/reports/view.md「静态导出」)。
     let viewInput: { input?: string; patterns: string[] };
     try {
       viewInput = resolveViewInput(cwd, positionals, {

package/src/i18n/en.ts

@@ -84,7 +84,7 @@ export const en = {
     "      --timing      unified timing tree for the attempt (phases + hooks/commands/turns + per-turn OTel)\n" +
     "      --diff[=file] sandbox workspace file-change summary; =file expands one file\n" +
     "      --history   per experiment × eval execution timeline (mutually exclusive with --report)\n" +
-    "      --results <dir>   pin a results root    --experiment <id>   one experiment\n" +
+    "      --results <dir>   pin a results root    --exp <id>   one experiment\n" +
     "      --report <file>   custom report    --page <id>   pick the initial page (multi-page\n" +
     "        reports render it, then list the rest as a page index with copyable commands)\n" +
     "  niceeval list                                       list discovered evals\n" +
@@ -92,7 +92,7 @@ export const en = {
     "      report pages + evidence rooms; --report <file> swaps in your report\n" +
     "      (same file as show); --page <id> picks the initial page;\n" +
     "      --results <dir> pins a results root; --snapshot <file> opens exactly\n" +
-    "      one snapshot; --experiment <id> one experiment\n" +
+    "      one snapshot; --exp <id> one experiment\n" +
     "      --out <dir> exports a static site: index.html plus the viewer\n" +
     "      artifacts, ready for any static host\n" +
     "  niceeval sandbox list|enter|history|diff|stop  inspect & destroy sandboxes kept by --keep-sandbox\n" +
@@ -109,7 +109,7 @@ export const en = {
   "cli.show.noResults": "No results found under {{root}}. Run `niceeval exp` first, then `niceeval show`.\n",
   "cli.show.runDirMissing": "Results directory not found: {{dir}}\n",
   "cli.show.noEvalMatch": "No results matched: {{patterns}}. Evals with results: {{evals}}\n",
-  "cli.show.noExperimentMatch": "No experiment matched --experiment {{arg}}. Experiments with results: {{experiments}}\n",
+  "cli.show.noExperimentMatch": "No experiment matched --exp {{arg}}. Experiments with results: {{experiments}}\n",
   "cli.show.historyReportConflict":
     "`--history` and `--report` are mutually exclusive: both take over the main output. --history is the host's per-attempt execution timeline; for snapshot-level trends, compose exp.snapshots inside your report file instead.\n",
   "cli.show.evidenceNeedsEval":

package/src/i18n/zh-CN.ts

@@ -80,14 +80,14 @@ export const zhCN = {
     "      --timing      整个 attempt 的统一时间树(阶段 + hook/命令/turn + 轮内 OTel)\n" +
     "      --diff[=文件] agent 归因的文件改动摘要;=文件 按窗口展开单个文件\n" +
     "      --history   逐 experiment × eval 的执行时间轴(与 --report 互斥)\n" +
-    "      --results <目录> 钉死结果根   --experiment <id> 只看该实验\n" +
+    "      --results <目录> 钉死结果根   --exp <id> 只看该实验\n" +
     "      --report <文件> 自定义报告   --page <id> 定初始页(多页报告渲染该页,\n" +
     "        尾部再附其余页索引)\n" +
     "  niceeval list                            列出发现到的 eval\n" +
     "  niceeval view [eval-id 前缀…] [--out 目录] [--port n] [--no-open]\n" +
     "      报告页 + 证据室;--report <文件> 整槽换成自定义报告(与 show 同一文件)\n" +
     "      --page <id> 定初始页   --results <目录> 钉死结果根\n" +
-    "      --snapshot <文件> 只打开这一份快照   --experiment <id> 只看该实验\n" +
+    "      --snapshot <文件> 只打开这一份快照   --exp <id> 只看该实验\n" +
     "      --out <目录> 静态导出:index.html 连同查看器 artifact,可直接静态托管\n" +
     "  niceeval sandbox list|enter|history|diff|stop  查看与销毁 --keep-sandbox 留下的现场\n" +
     "  niceeval clean                           删除 .niceeval/ 历史 artifact\n" +
@@ -104,7 +104,7 @@ export const zhCN = {
   "cli.show.noResults": "{{root}} 下没有结果。先 `niceeval exp` 跑一轮,再 `niceeval show`。\n",
   "cli.show.runDirMissing": "Results directory not found: {{dir}}\n",
   "cli.show.noEvalMatch": "No results matched: {{patterns}}. Evals with results: {{evals}}\n",
-  "cli.show.noExperimentMatch": "No experiment matched --experiment {{arg}}. Experiments with results: {{experiments}}\n",
+  "cli.show.noExperimentMatch": "No experiment matched --exp {{arg}}. Experiments with results: {{experiments}}\n",
   "cli.show.historyReportConflict":
     "`--history` and `--report` are mutually exclusive: both take over the main output. --history is the host's per-attempt execution timeline; for snapshot-level trends, compose exp.snapshots inside your report file instead.\n",
   "cli.show.evidenceNeedsEval":

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

@@ -899,8 +899,8 @@ describe("内建报告", () => {
     // Hero text 面:标题行(回退链终点)+ 最后运行 meta 行在页首
     expect(multi.split("\n")[0]).toBe("Eval Results");
     expect(multi).toContain("Last run");
-    expect(multi).toContain("niceeval show --experiment compare");
-    expect(multi).toContain("niceeval show --experiment dev");
+    expect(multi).toContain("niceeval show --exp compare");
+    expect(multi).toContain("niceeval show --exp dev");
     expect(multi).not.toContain("Eval / Attempt"); // 不倾倒组内 experiment 明细
 
     const priced = snap({

package/src/report/react/styles.css

@@ -516,20 +516,26 @@ table.nre,
 }
 
 /* ---- Hero / PoweredBy(站点标题区与品牌行) ---- */
-.nre-hero { margin: 0 0 18px; }
+/* 居中大标题:hero 是页首的门面块,整块占满内容列宽、文本水平居中,标题随视口 clamp 放大,
+   meta 与品牌行居中跟随。不设 max-width——窄框居中在宽内容列里会读成左偏,占满列宽才真居中。 */
+.nre-hero {
+  text-align: center;
+  margin: 0 0 clamp(28px, 5vw, 44px);
+}
 .nre-hero .nre-hero-title {
   margin: 0;
-  font-size: 24px;
-  font-weight: 700;
+  font-size: clamp(38px, 5vw, 60px);
+  line-height: 0.98;
+  font-weight: 760;
   letter-spacing: -0.01em;
 }
 .nre-hero .nre-hero-meta {
-  margin: 4px 0 0;
+  margin: 14px 0 0;
   color: var(--muted);
-  font-size: 13px;
+  font-size: 14px;
 }
 .nre-powered-by {
-  margin: 6px 0 0;
+  margin: 10px 0 0;
   font-size: 12px;
 }
 .nre-powered-by a {

package/src/report/report.ts

@@ -576,10 +576,10 @@ function quoteArg(value: string): string {
   return /^[A-Za-z0-9._/@-]+$/.test(value) ? value : `'${value.replaceAll("'", `'"'"'`)}'`;
 }
 
-/** 按上下文拼组索引的可复制命令:`niceeval show <patterns> --experiment <id> [--results/--report/--page]`。 */
+/** 按上下文拼组索引的可复制命令:`niceeval show <patterns> --exp <id> [--results/--report/--page]`。 */
 function experimentCommandFor(ctx: HostCommandContext): (experimentIdPrefix: string) => string {
   return (prefix) => {
-    const parts = ["niceeval show", ...ctx.patterns.map(quoteArg), `--experiment ${quoteArg(prefix)}`];
+    const parts = ["niceeval show", ...ctx.patterns.map(quoteArg), `--exp ${quoteArg(prefix)}`];
     if (ctx.results !== undefined) parts.push(`--results ${quoteArg(ctx.results)}`);
     if (ctx.report !== undefined) parts.push(`--report ${quoteArg(ctx.report)}`);
     if (ctx.page !== undefined) parts.push(`--page ${quoteArg(ctx.page)}`);

package/src/report/tree.ts

@@ -71,7 +71,7 @@ export interface TextContext {
   attemptCommand(locator: AttemptLocator): string;
   /**
    * 组索引一类「按实验收窄」命令的生成;宿主注入以携带完整上下文(--results / --report /
-   * --page 与位置参数),默认 `niceeval show --experiment <id>`。非契约字段,官方组件内部用。
+   * --page 与位置参数),默认 `niceeval show --exp <id>`。非契约字段,官方组件内部用。
    */
   experimentCommand(experimentIdPrefix: string): string;
 }
@@ -532,7 +532,7 @@ export function createTextContext(options?: TextRenderOptions): TextContext {
   // show 已实现的真实 CLI 语法,不需要反查 eval id 再拼一条近似命令。
   const attemptCommand = options?.attemptCommand ?? ((locator: AttemptLocator) => `niceeval show ${locator}`);
   const experimentCommand =
-    options?.experimentCommand ?? ((prefix: string) => `niceeval show --experiment ${shellQuote(prefix)}`);
+    options?.experimentCommand ?? ((prefix: string) => `niceeval show --exp ${shellQuote(prefix)}`);
   const make = (w: number): TextContext => ({
     width: w,
     locale,

package/src/results/host-equivalence.test.ts

@@ -329,7 +329,7 @@ describe("selectCurrentResults · 现刻水位结构化身份", () => {
     expect(algebra.warnings).toEqual([]);
   });
 
-  it("场景8 --experiment 分段前缀过滤:只留匹配段,不误配同前缀实验", async () => {
+  it("场景8 --exp 分段前缀过滤:只留匹配段,不误配同前缀实验", async () => {
     const root = await makeRoot();
     await writeSnapshot(root, "2026-07-01T08-00-00-000Z", { experimentId: "compare/bub", startedAt: "2026-07-01T08:00:00.000Z" }, [res("q1", "passed")]);
     await writeSnapshot(root, "2026-07-01T09-00-00-000Z", { experimentId: "compare/codex", agent: "codex", startedAt: "2026-07-01T09:00:00.000Z" }, [res("q1", "passed")]);

package/src/results/select.ts

@@ -81,7 +81,7 @@ export function selectLatest(
 
 /** selectCurrentResults 的范围输入:experiment id 前缀与 eval id 前缀,都可缺省。 */
 export interface ResultScope {
-  /** experiment id 前缀(--experiment),分段匹配语义同 filterExperiments。 */
+  /** experiment id 前缀(--exp),分段匹配语义同 filterExperiments。 */
   experiment?: string | string[];
   /** eval id 前缀(位置参数),收窄 Scope 覆盖的 eval;覆盖警告分母同步收窄到范围内。 */
   patterns?: string[];
@@ -368,7 +368,7 @@ export function isNewerSnapshot(a: Snapshot, b: Snapshot): boolean {
   return a.dir.localeCompare(b.dir) > 0;
 }
 
-/** experiment id 分段前缀过滤(--experiment / latest({ experiments }) 同一语义);包内使用,不进公共 barrel。 */
+/** experiment id 分段前缀过滤(--exp / latest({ experiments }) 同一语义);包内使用,不进公共 barrel。 */
 export function filterExperiments(experiments: Experiment[], filter?: string | string[]): Experiment[] {
   if (filter === undefined) return experiments;
   // 允许 "compare/" 这种带尾斜杠的写法,与 "compare" 等价;分段匹配不误配 "compare2"。

package/src/shared/aggregate.ts

@@ -47,7 +47,7 @@ export function experimentGroupOf(experimentId: string): string | undefined {
 /**
  * eval id 前缀过滤,同 CLI 位置参数语义(docs/feature/reports/show.md「打开与收窄」):
  * eval 位置参数是收窄过滤,按**裸前缀宽松匹配**——"algebra" 命中 "algebra"、"algebra/..."
- * 也命中 "algebra2",多命中正是它的用途(与 `--experiment` 的按路径段匹配有意不同)。
+ * 也命中 "algebra2",多命中正是它的用途(与 `--exp` 的按路径段匹配有意不同)。
  */
 export function evalPrefixPredicate(evals?: string | string[]): (id: string) => boolean {
   if (evals === undefined) return () => true;

package/src/show/index.ts

@@ -7,9 +7,9 @@
 //   @<locator>        精确 attempt:无证据 flag → 紧凑全景;带 flag → 对应证据切面
 //   --source / --execution / --diff[=路径]   证据切面(宿主本体):出现即走证据室,不渲染报告槽
 //   --history        执行时间轴(逐 experimentId + evalId 分节),与 --report 互斥
-//   --report <文件>  整槽换成用户报告;位置前缀 / --results / --experiment 先收窄 Scope 再注入
+//   --report <文件>  整槽换成用户报告;位置前缀 / --results / --exp 先收窄 Scope 再注入
 //   --page <id>      多页报告选页;未命中列出可用页 id 按用法错误退出
-//   --results <目录>  结果根换成该目录;--experiment 让 Scope 只留该实验
+//   --results <目录>  结果根换成该目录;--exp 让 Scope 只留该实验
 //
 // 数据全部走 niceeval/results 的读取面(openResults + 合成 Scope + loadAttemptEvidence),
 // 不自己爬目录;证据可用性只由 loadAttemptEvidence 在单 Attempt 页面计算。

package/src/show/render.ts

@@ -113,7 +113,7 @@ export function attemptsOfEval(snapshots: Snapshot[], evalId: string): AttemptHa
 /**
  * 详情块 / eval-id 前缀证据切面默认挑最新一次失败的 attempt;没有失败挑最新一次。
  * 精确选某一次 attempt 走 `@<locator>`(`resolveLocator`),不再有数字 `--attempt`——
- * --experiment 已在 Selection 合成时收窄。
+ * --exp 已在 Selection 合成时收窄。
  */
 export function pickDetailAttempt(attempts: AttemptHandle[]): AttemptHandle | undefined {
   if (attempts.length === 0) return undefined;

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

@@ -197,9 +197,9 @@ describe("其余页索引与索引命令上下文", () => {
     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

@@ -320,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

@@ -592,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,

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

@@ -25,8 +25,8 @@ function dataWithShell(report: ViewData["report"]): ViewData {
   return { composedRuns: 1, snapshots: [], ...(report !== undefined ? { report } : {}) };
 }
 
-describe("外壳:宿主无品牌位与 hero,导航只有报告页", () => {
-  it("宿主导航壳 DOM 无品牌节点、无 hero 区:品牌与 hero 是页内组件,不归宿主", () => {
+describe("外壳:宿主恒有 NiceEval 品牌位、无 hero,导航只有报告页", () => {
+  it("宿主页头有恒定品牌字标、无 hero 区:hero 是页内组件不归宿主,品牌归宿主", () => {
     const html = renderToStaticMarkup(
       <App
         data={dataWithShell({
@@ -38,11 +38,12 @@ describe("外壳:宿主无品牌位与 hero,导航只有报告页", () => {
         reportPages={reportPages}
       />,
     );
-    // 宿主 DOM 无品牌节点:没有字标、没有 Powered by、没有任何官网品牌链接。
-    expect(html).not.toContain('class="brand"');
-    expect(html).not.toContain("NiceEval");
+    // 宿主页头恒有 NiceEval 品牌字标,外链官网;报告定义不能覆盖或移除。
+    expect(html).toContain('class="brand"');
+    expect(html).toContain("NiceEval");
+    expect(html).toContain("niceeval.com");
+    // 品牌位是页头字标,不是 hero 的 Powered by 行——后者是页内组件,不落宿主壳。
     expect(html).not.toContain("Powered by");
-    expect(html).not.toContain("niceeval.com");
     // 宿主无 hero 区:标题只落浏览器 <title>(useEffect,静态渲染不执行),不落任何宿主节点。
     expect(html).not.toContain('class="hero"');
     expect(html).not.toContain("<h1");