niceeval 0.12.1 → 0.12.2-canary.31

package/docs-site/zh/tutorials/custom-reports.mdx

@@ -1,390 +1,116 @@
 ---
 title: "编写自定义报告"
-description: "用普通 TypeScript 函数计算结果，并同时生成终端与网页报告。"
+description: "声明 RecordProjection，把投影结果组织成 Calculation、页面和一次固定的 ReportExecution。"
 ---
 
-自定义报告接收宿主选好的 Sample，返回组件树：
+自定义 Report 不接收 Record 路径，也不在页面 render 时临时查数据。先声明所需的 `RecordProjection`，再定义 Calculation、Page、PageFamily 或 Download：
 
 ```text
-Sample
-  → 普通 TypeScript 函数
-  → 可序列化结果值
-  → 组件
-  → text / web
+AnalysisSample
+        ↓
+official opaque projector → ProjectedSample
+        ↓
+Report → immutable ReportExecution
+          ↙       ↓       ↘
+        show     view    export
 ```
 
-计算发生在 page render 中。
-组件只显示 `rows`、`points`、`items`、`nodes` 或 `attempt` 等具体值。
+## 先选择官方 projector
 
-## 创建第一份报告
-
-新建 `reports/quality.tsx`：
-
-```tsx
-import {
-  Page,
-  Scatter,
-  Table,
-  agent,
-  aggregate,
-  costUSD,
-  defineReport,
-  passRate,
-} from "niceeval/report";
-
-export default defineReport(async (sample) => {
-  const performance = await aggregate(sample, {
-    by: { agent },
-    values: { passRate, costUSD },
-  });
-
-  return (
-    <Col>
-      <Scatter
-        points={performance}
-        x="costUSD"
-        y="passRate"
-        point="agent"
-      />
-      <Table rows={performance} />
-    </Col>
-  );
-});
-```
-
-运行：
-
-```bash
-niceeval show --report ./reports/quality.tsx
-niceeval view --report ./reports/quality.tsx
-```
-
-两个宿主执行同一个 page render。
-同一棵结果树分别交给 text 和 web renderer。
-
-## 设成项目默认
-
-在 `niceeval.config.ts` 中直接导入定义：
+NiceEval 内部负责把运行事实写入 Record，并提供形成 typed view 的官方 opaque projector。
+Report 作者只选择这些 projector，不能定义 raw Attachment family 或读取 payload。
 
 ```ts
-import { defineConfig } from "niceeval";
-import quality from "./reports/quality";
+const verdicts = attemptSlotProjection(verdictProjector);
+const assertions = attemptSlotProjection(assertionsProjector);
 
-export default defineConfig({
-  report: quality,
-});
+const inputs = reportInputs({ verdicts, assertions });
 ```
 
-以后直接运行 `niceeval show` 或 `niceeval view`。
-临时切回内建报告时使用 `--report standard`。
-
-## 收窄 Sample
-
-宿主先处理 `--record`、`--exp`、评估位置参数和 `--fresh`，
-再把 Sample 交给报告。
-
-报告内继续使用 Sample 方法：
-
-```ts
-const security = sample.scope({ evals: "security/" });
+每个 projection 都有明确 owner 和访问方式。`attemptSlotProjection` 保留 Sample 的每个 slot；`selectedRunProjection` 只对 selected Run 读取；`attemptOriginRunProjection` 为每个 slot 读取其 Attempt 的 origin Run。
 
-const reliable = security.filter((attempt) =>
-  attempt.result.verdict !== "errored"
-);
-```
+Report 不在 callback 中打开 Record，也不能通过 pure `AnalysisSample` 恢复 I/O。
 
-`scope()` 改变比较总体和 coverage 分母。
-`filter()` 删除不可信或不适用的观测。
+## 定义计算
 
-一组图共享范围时，先生成一个具名 Sample：
+Calculation 使用静态声明的 inputs。它返回领域值，而不是让 host 推导通过率或分母。
 
 ```ts
-const production = sample
-  .scope({ experiments: "production/" })
-  .filter(isReliableAttempt);
-```
-
-然后把同一个 `production` 传给每次计算。
-
-## 使用 `aggregate()`
-
-`aggregate()` 接收分组函数和 Calculation：
-
-```tsx
-const rows = await aggregate(sample, {
-  by: {
-    experiment,
-    agent,
-  },
-  values: {
-    passRate,
-    costUSD,
-  },
+const passRate = defineCalculation({
+  id: Either.getOrThrow(reportComponentId("pass-rate")),
+  inputs,
+  completeness: "allow-partial",
+  calculate: ({ sample, inputs }) =>
+    calculatePassRate(sample, inputs.verdicts, inputs.assertions),
 });
 ```
 
-对象键就是结果字段名。
-每个读数字段是 MetricValue，包含 value、unit、samples、total、basis 与 refs。
-
-结果是普通数组，可以继续使用 JavaScript：
-
-```ts
-const ranked = rows
-  .toSorted((a, b) =>
-    (b.passRate.value ?? -Infinity) -
-    (a.passRate.value ?? -Infinity)
-  )
-  .slice(0, 10);
-```
-
-不要把聚合结果再次传给 `aggregate()`。
-需要增加读数时，回到同一份 Sample，把 Calculation 加进原来的 `values`。
-
-## 定义自己的 Calculation
+选择 `allow-partial` 时，callback 能看到 `ProjectedSample`、coverage 和 issues。结果必须保留自己的业务分母与完整度。选择 `require-complete` 时，只要必需数据不完整，callback 不会执行。
 
-`rollup()` 把单 Attempt 取值函数变成 Calculation：
+## 定义页面和 Report
 
 ```ts
-import {
-  mean,
-  min,
-  rollup,
-} from "niceeval/report";
-
-export const changedLines = rollup(
-  async (attempt) => {
-    if (attempt.result.verdict !== "passed") {
-      return null;
-    }
-
-    const diff = await attempt.diff();
-    return diff ? countChangedLines(diff) : null;
-  },
-  {
-    withinEval: min,
-    acrossEvals: mean,
-    unit: "lines",
-    better: "lower",
-  },
-);
-```
-
-官方 Calculation 和用户 Calculation 使用同一个 `rollup()`。
-空集合保持 `null`，不会被伪装成零。
-
-## 显示实体列表
-
-Sample 已经提供物化后的 `attempts`：
-
-```tsx
-export default defineReport((sample) => {
-  const failures = sample
-    .filter((attempt) =>
-      attempt.result.verdict === "failed" ||
-      attempt.result.verdict === "errored"
-    )
-    .attempts
-    .toSorted((a, b) =>
-      (attemptCostUSD(b.result) ?? 0) -
-      (attemptCostUSD(a.result) ?? 0)
-    )
-    .slice(0, 50);
-
-  return <AttemptList attempts={failures} />;
+const overview = definePage({
+  id: Either.getOrThrow(reportComponentId("overview")),
+  route: Either.getOrThrow(reportRoute("/")),
+  calculations: { passRate },
+  render: ({ calculations }) =>
+    reportDocument({
+      title: "Summary",
+      children: [
+        reportMetric({
+          label: "Pass rate",
+          value:
+            calculations.passRate.state === "available"
+              ? calculations.passRate.value.rate
+              : null,
+        }),
+      ],
+    }),
 });
-```
 
-需要通用表格时先立即转换：
-
-```tsx
-const rows = toAttemptRows(failures);
-return <Table rows={rows} />;
-```
-
-## 复用动态区块
-
-复用就是普通函数：
-
-```tsx
-export async function overview(sample: Sample) {
-  const performance = await aggregate(sample, {
-    by: { agent },
-    values: { passRate, costUSD },
-  });
-
-  return (
-    <>
-      <Scatter
-        points={performance}
-        x="costUSD"
-        y="passRate"
-        point="agent"
-      />
-      <Table rows={performance} />
-    </>
-  );
-}
-```
-
-在 page render 中直接调用：
-
-```tsx
-render: async (sample) => (
-  <Col>
-    {await overview(sample)}
-  </Col>
-)
-```
-
-多个独立计算使用普通 `Promise.all()`。
-
-## 创建多页报告
-
-```tsx
 export default defineReport({
-  title: "Team evals",
-  pages: [
-    {
-      id: "overview",
-      title: "Overview",
-      render: async (sample) => (
-        <Col>
-          {await overview(sample)}
-        </Col>
-      ),
-    },
-    {
-      id: "failures",
-      title: "Failures",
-      render: failuresPage,
-    },
-    standardAttemptPage,
-  ],
-});
-```
-
-`pages` 的数组顺序就是导航顺序。
-宿主只执行当前请求的 page。
-`standardAttemptPage` 提供官方 Attempt 详情与 locator 下钻；`standardExperimentPage` 同样可以放进来，散点上的实验点就能点开实验详情。
-
-## 自定义 Attempt 详情
-
-复用官方页的参数与装载，只换 `render`：
-
-```tsx
-{
-  ...standardAttemptPage,
-  render: async (attempt) => {
-    const [turns, files] = await Promise.all([
-      toConversationTurns(attempt),
-      toDiffFiles(attempt),
-    ]);
-
-    return (
-      <Col>
-        <Conversation turns={turns} />
-        <DiffView files={files} />
-      </Col>
-    );
-  },
-}
-```
-
-Attempt 详情页的 id 是 `attempt`。
-报告里没有这张 page 时，locator 只显示为文本。
-
-## 接入外部业务快照
-
-先把外部数据写成冻结快照模块：
-
-```tsx
-// budget-snapshot.ts —— 运行前由脚本生成，随报告进版本库
-export const budgets = {
-  checkout: { monthlyUSD: 40 },
-  search: { monthlyUSD: 25 },
-};
-```
-
-报告文件直接 import：
-
-```tsx
-import { budgets } from "./budget-snapshot";
-
-export default defineReport(async (sample) => {
-  const performance = await aggregate(sample, {
-    by: { experiment },
-    values: { passRate, costUSD },
-  });
-
-  return <Table rows={joinBudgets(performance, budgets)} />;
+  id: Either.getOrThrow(reportId("quality")),
+  calculations: { passRate },
+  pages: [overview],
 });
 ```
 
-page render 不请求网络，不读取环境变量、时钟或随机数。要更新数据，就重新生成快照模块。
-快照属于报告的 import 图，开发服务器会在它变化时重新构建报告。
+Page 返回闭合的语义 document，而不是 React、HTML 或文件路径。要为每个 Assertion、Turn 或 diagnostics category 增加详情页时，使用 `definePageFamily`。实例、route 和 document 只能从已经投影或计算出的内存值展开。
 
-## 编写新的显示形状
+## 设成项目默认
 
-现有组件组合不出目标显示时，使用扩展入口：
+在 `niceeval.config.ts` 中导入 Report。以后不带 `--report` 的 `show` 与 `view` 使用它：
 
-```tsx
-import { defineRenderer } from "niceeval/report/extension";
+```ts
+import { defineConfig } from "niceeval";
+import quality from "./reports/quality";
 
-const ConfusionMatrix = defineRenderer({
-  text(value, options, context) {
-    return renderTextMatrix(value, options, context);
-  },
-  web(value, options, context) {
-    return <WebMatrix value={value} options={options} />;
-  },
+export default defineConfig({
+  report: quality,
 });
 ```
 
-两个 renderer 都只接已经计算好的普通值。
-自定义计算继续写普通函数，不需要注册协议。
+## 处理不完整与失败
 
-## 钉住某个值的颜色
+recorded-data problem 不会改变 Sample 分母：
 
-在报告外壳的 `dimensionPins` 中按分组字段和完整值固定视觉身份。
-例如可以让同一个 Agent 在每一页都使用同一组颜色、线型和符号。
+- `unavailable` 表示 owner 没有请求的 Attachment；
+- `migration-required`、`migration-unavailable` 与 `unsupported` 表示历史 schema 不能按当前需要读取；
+- `invalid` 或 partial collection 表示记录的数据不完整。
 
-显示标签不是身份键。不要截 Experiment 路径末段，也不要按数组下标分配颜色。
-完整主题字段见[报告主题](/zh/tutorials/theming)。
+这些问题由内建 problems surface 显示。`allow-partial` consumer 可以展示可用值；`require-complete` consumer 形成 `data-unavailable`。
 
-## 让自己的组件跟随任何主题
+projector、Calculation 或页面 callback 抛错，以及非法 document 或 route conflict，属于 execution problem。`show` 与 `view` 显示问题并保留其它页面；静态导出不会发布这一份 execution。
 
-自定义 renderer 使用 `--niceeval-*` 主题令牌，
-不要把 Basalt 或 Chalk 的 hex 值复制进组件。
-状态使用 positive、negative、warning 等语义令牌，
-名义 series 使用运行时分配的视觉身份。
+## 运行和发布
 
-## 嵌入自己的 React 页面
-
-在服务端或构建进程中计算：
-
-```ts
-const points = await aggregate(sample, {
-  by: { agent },
-  values: { passRate, costUSD },
-});
+```sh
+npx niceeval show --run <run-id> --report ./reports/quality.ts
+npx niceeval view --run <run-id> --report ./reports/quality.ts --no-open
+npx niceeval view --run <run-id> --report ./reports/quality.ts --out ./quality-site
 ```
 
-在浏览器使用 `niceeval/report/react`：
-
-```tsx
-<Scatter
-  points={points}
-  x="costUSD"
-  y="passRate"
-  point="agent"
-/>
-```
-
-React 入口不读取 Record、Sample 或 artifact。
-记录根不在产品运行环境时，把 Result 在构建期写成 JSON。
-
-## 下一步
+`show`、`view` 与 `--out` 都选择 Sample、执行同一个 Report，并得到固定 `ReportExecution`。`view` 后续的成功 rebuild 会产生下一份 execution；失败时保留 last-good execution。
 
-- 查完整形状：[报告组件 API](/zh/reference/report-components)
-- 发布静态站：[发布报告](/zh/tutorials/publish-report)
-- 自定义外观：[报告主题](/zh/tutorials/theming)
+`--out` 必须指向不存在的目录。详情见[发布静态报告](/zh/tutorials/publish-report)和[报告 API](/zh/reference/report-components)。

package/docs-site/zh/tutorials/dataset-fanout.mdx

@@ -84,7 +84,7 @@ cases:
     sql: SELECT COUNT(*) FROM users;
 ```
 
-`loadYaml` / `loadJson` 必须接 decoder。未验证的动态值只出现在 decoder 入口；验证通过后，返回值就是可以直接使用的强类型数据。
+`loadYaml` / `loadJson` 必须接 decoder。未验证的动态值只出现在 decoder 入口。验证通过后，返回值就是可以直接使用的强类型数据。
 
 ## 过滤测试集评估用例
 

package/docs-site/zh/tutorials/deploy-report-site.mdx

@@ -1,157 +1,55 @@
 ---
-title: "把报告站发布上线"
-sidebarTitle: "报告站上线"
-description: "把 .niceeval 直接提交进仓库、配一份排除运行时状态的 .gitignore,再用不装整仓依赖的 CI 脚本和 Vercel CLI,在打 tag 时把报告站发布上线。"
+title: "部署静态报告站"
+sidebarTitle: "部署报告站"
+description: "将 view --out 生成的自包含目录部署到任意静态托管服务。"
 ---
 
-[通过 CI 发布报告](/zh/tutorials/publish-report)讲的是用 `publish()` 剪出一份经过单文件大小预检的瘦身目录,适合结果要脱离原始记录根、按需挑选证据的场景——它会挡住任何一个超过 50 MiB 的文件,包括极端情况下过大的 `events.json` / `trace.json`。这一页讲另一条更直接的路:把 `.niceeval` 原样提交进仓库(排除几类不该提交的运行时状态),用一份不依赖仓库自身 `node_modules` 的构建脚本,让 CI 只在你打 tag 时把它发布到 Vercel。这条路跳过了 `publish()` 的体积预检,适合单条 Attempt 的证据体积在实践中稳定可控的项目;不确定会不会撞见罕见的超大输出,或者想要一份和原始记录根解耦的瘦身目录,选前一条路。
+先用明确的 `niceeval view --out` 或 `niceeval view --run <id> --out` 生成报告站，再部署该目录。报告站已经含有页面、宿主数据、下载项、内建精确 runtime 和 manifest；托管平台无需读取源 Record，也无需执行 NiceEval。
 
-## `.niceeval/` 里,哪些是站点要的数据
-
-`.niceeval/` 下同时混着结果数据和几类运行时状态,只有第一类是报告站要读的东西:
-
-- **每个实验的 Run 目录**(`<实验>/<时间戳-后缀>/`)是评估结果本身——`run.json`、每条 Attempt 的 `result.json` 与证据文件。这是站点数据源。
-- **`.niceeval/locks/`** 是并发跑评估用例时的用例锁,一条 `(experiment, eval)` 一个心跳文件。持有者每 10 秒重写一次心跳,全部 Attempt 正常收尾后自己删掉锁,不需要手工清理。被 `kill -9` 或断电打断的运行不会释放锁——文件会留在磁盘上,但不是需要主动清理的垃圾:心跳落后 30 秒即视为过期,下一次运行会自动接管。它是进程运行时状态,不是评估结果,提交进仓库既没用也会造成误导(读到一份早已作废的心跳文件)。
-- **`.niceeval/sessions/`** 是一次 `niceeval exp` 调度留下的清单,只被 `niceeval session list` / `session show` 读取,回答"这批调度还在不在跑"。构建报告站的 `niceeval view` 不读它。
-
-`diff.json` 单独说体积。Agent 一次工具调用能产生任意大的输出,diff 归因逐窗口落盘、不做跨窗口压缩也不截断,单条 Attempt 的 `diff.json` 因此可能到上百 MB。它确实会被 `niceeval view` 用到——存在时,对应 Attempt 详情页的"文件差异"区块会显示它;但报告首页、实验对比这些聚合视图不需要它。缺失时"文件差异"区块如实显示证据未提供,不影响页面其余部分——为体积把它排除在提交范围之外是划算的取舍,不是功能损失。
-
-## 推荐的 `.gitignore`
-
-```gitignore
-# .niceeval/ 提交进仓库,是报告站的数据源。只排除运行时状态:
-.niceeval/**/diff.json   # 单条 Attempt 可达上百 MB,只服务 Attempt 详情页的文件差异区块
-.niceeval/locks/         # 用例锁,进程运行时状态;强杀后的残留文件靠心跳过期自动接管,不用清理
-.niceeval/sessions/      # niceeval exp 的调度清单,只被 session list 读取,站点不读它
+```sh
+npx niceeval view --experiment checkout \
+  --out ./report-site \
+  --no-open
 ```
 
-其余结果数据——`run.json`、`result.json`、`events.json`、`trace.json`、`sources.json`、`o11y.json`、`agent-setup.json`——原样提交。
+需要发布特定运行时，使用 receipt 中的 Run ID：
 
-## CI 构建:不装整仓依赖
+```sh
+npx niceeval view --run 01J9ZK3M6P4T7V9X2C5N8QW0RY \
+  --out ./report-site \
+  --no-open
+```
 
-评估用例相关的依赖(Docker / E2B SDK、各家 model provider)体积大且与报告构建无关,CI 没必要为了生成一个静态站跑一遍仓库自己的 `install`。做法是在临时目录单独装 `niceeval` 和它默认内建报告要用到的 `react`、`react-dom`,再把这份 `node_modules` 链接回仓库根:
+## CI 流程
 
-```bash
-#!/usr/bin/env bash
-# scripts/build-report.sh
-set -euo pipefail
+一个静态托管流程通常有三步：
 
-REPO="$PWD"
-BUILD_DIR=/tmp/niceeval-build
+1. 运行 Experiment，并保留最后的 receipt。
+2. 用当前项目结果或明确 Run 运行 `view --out`。
+3. 将输出目录交给静态托管服务。
 
-mkdir -p "$BUILD_DIR"
-cd "$BUILD_DIR"
-npm init -y >/dev/null
-npm i --no-audit --no-fund niceeval@latest react react-dom
+GitHub Actions 的构建任务示例：
 
-# Vercel 的 build cache 会把上一次部署的 node_modules 原样恢复到仓库根(里面是旧版
-# niceeval);ln -sfn 对已存在的目录会把链接建到目录内部而不是替换它,必须先清掉。
-# 本地跑这份脚本时不动真实 node_modules,直接拒绝,避免误删开发环境。
-if [ -e "$REPO/node_modules" ] && [ ! -L "$REPO/node_modules" ]; then
-  if [ "${VERCEL:-}" = "1" ]; then
-    rm -rf "$REPO/node_modules"
-  else
-    echo "refusing to replace real $REPO/node_modules; run in a clean clone" >&2
-    exit 1
-  fi
-fi
-ln -sfn "$BUILD_DIR/node_modules" "$REPO/node_modules"
+```yaml
+- name: 生成报告站
+  run: npx niceeval view --experiment checkout --out ./report-site --no-open
 
-cd "$REPO"
-node_modules/.bin/niceeval view --record .niceeval --out site
+- name: 上传静态站点目录
+  uses: actions/upload-pages-artifact@v3
+  with:
+    path: ./report-site
 ```
 
-链接回仓库根这一步不只是为了能在仓库根用相对路径 `node_modules/.bin/niceeval` 调用:后续如果传自定义 `--report reports/xxx.tsx`,`tsx` 会用仓库自己的 `tsconfig`(`jsx: "react-jsx"`)编译这个文件,文件里的 `import "niceeval/report"` 按文件位置解析——resolve 得从仓库根的 `node_modules` 找起。不管当下用不用自定义报告,这一步都值得做,省得以后加了自定义报告才发现构建脚本要重写。
+后续部署任务使用托管平台提供的发布步骤。无论使用 GitHub Pages、对象存储或其它静态托管服务，发布目标都是 `./report-site`，不是源 Record。
 
-`vercel.json` 指向这份脚本,并跳过 Vercel 默认的 install 步骤:
+## 发布前检查
 
-```json
-{
-  "installCommand": "echo 'skip: 报告构建自己装依赖,不用仓库的 node_modules'",
-  "buildCommand": "bash scripts/build-report.sh",
-  "outputDirectory": "site",
-  "git": {
-    "deploymentEnabled": false
-  }
-}
-```
-
-`git.deploymentEnabled: false` 关掉 Vercel 对这个仓库的自动部署——不设它,Vercel 的原生 Git 集成会在每次 push 时自动构建部署,和下一节"只在打 tag 时发布"的意图冲突。
-
-## 只在打 tag 时发布
+导出会列出所有页面、参数化页面、下载项与内建 runtime 文件，并写入 `StaticAssetManifest`。导出失败时不会发布半完成目录。`--out` 必须指向不存在的目录；更新内容时使用新的输出目录。
 
-`vercel.json` 关掉自动部署后,发布动作交给一条只在 push tag 时触发的 GitHub Actions workflow:
+部署后用浏览器检查首页、参数化页面和下载项。站点在断网条件下也应正常显示，因为所有引用都是目录内的相对路径。
 
-```yaml
-# .github/workflows/deploy-report.yml
-name: deploy-report
-
-on:
-  push:
-    tags:
-      - "v*"
-
-concurrency:
-  group: deploy-report
-  cancel-in-progress: false
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    env:
-      VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
-      VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
-    steps:
-      # push tags 事件默认检出 tag 指向的 commit,不需要额外指定 ref。
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - run: npm i -g vercel@latest
-
-      - run: vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
-      - run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
-      - run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}
-```
+## 更新站点
 
-<Warning>
-  不要用 Vercel 的 Deploy Hook 替代这条 workflow。Deploy Hook 部署的是"触发那一刻分支上的最新 commit",不是 tag 指向的 commit——打完 tag 后如果分支上又有新提交,Hook 部署的会是那条新提交,线上内容和你发布的版本号对不上。这条 workflow 用 Vercel CLI 的 prebuilt 流程(`pull` → `build --prod` → `deploy --prebuilt --prod`),在 checkout 到 tag 之后才构建,发布内容与 tag 精确对应。
-</Warning>
-
-<Steps>
-  <Step title="生成 VERCEL_ORG_ID 与 VERCEL_PROJECT_ID">
-    本地在项目根目录运行一次 `vercel link`,把项目关联到 Vercel;生成的 `.vercel/project.json` 里就是这两个值。
-  </Step>
-  <Step title="生成 VERCEL_TOKEN">
-    在 Vercel 账号的 Settings → Tokens 建一个新 token。
-  </Step>
-  <Step title="把三个值加进仓库 secrets">
-    `VERCEL_TOKEN`、`VERCEL_ORG_ID`、`VERCEL_PROJECT_ID` 三个都要配,workflow 里都用到了。
-  </Step>
-</Steps>
-
-日常发布流程是:结果数据更新后提交并 push;确认线上要跟着换版本时,打一个 tag 并 push 到远程——这一步才真正触发部署。
-
-```bash
-git tag v0.3.0
-git push origin v0.3.0
-```
+每次需要更新内容时，重新选择 Sample，导出到新的目录，再部署该目录。已发布目录表示那次导出时的固定 `ReportExecution`；它不会随着之后的 Record 编辑而变化。
 
-## 接着看
-
-<CardGroup cols={2}>
-  <Card title="通过 CI 发布报告" icon="rotate-right" href="/zh/tutorials/publish-report">
-    另一条路:用 publish() 剪出瘦身、经过大小预检的发布目录。
-  </Card>
-  <Card title="在 CI 中运行 NiceEval" icon="gear" href="/zh/tutorials/ci-integration">
-    把评估用例本身接进 GitHub Actions。
-  </Card>
-  <Card title="查看结果" icon="database" href="/zh/tutorials/viewing-results">
-    `niceeval view` 的本地用法与导出细节。
-  </Card>
-  <Card title="自定义报告" icon="flask" href="/zh/tutorials/custom-reports">
-    传给 `--report` 的报告文件怎么写。
-  </Card>
-</CardGroup>
+有关选择范围和导出内容，请阅读[发布静态报告](/zh/tutorials/publish-report)。