CLI

运行评估使用 niceeval exp。NiceEval 提供三条读取路径：给 AI、脚本和 CI 的 niceeval query，给终端中人读的 niceeval show，以及在浏览器中审阅的 niceeval view。三者都经固定 Inspection operation 读取一个 PublicationCutoff 内的已发布事实；origin Run 仍为 active 的 Attempt 也可见。

`niceeval query`

niceeval query discover
niceeval query explain [--record <file>] --request <file|->
niceeval query run [--record <file>] --request <file|->

query 是 versioned niceeval.query/v1 JSON operation protocol。成功和协议级领域失败都会向 stdout 写入恰好一个 canonical document。命令用法错误和无法形成 document 的进程失败只写 stderr。

discover 返回静态、紧凑的 operation ID catalog。它不接受 --record，也不读取 Record；它不会返回 request schema。
explain 验证完整 request，说明将运行的 operation 与合法的后续请求。
run 执行 request，并返回该 operation 的闭合结果。

先调用 discover 确认当前版本有哪些 operation，再按本页或查看结果中的最小 request 构造请求，并用 explain 校验。不要猜字段，也不要用 SQL、JSON path 或公式拼出另一种查询语言。 continuation token 绑定 operation、canonical request、source identity 和 PublicationCutoff。任一绑定变化都会得到 restart correction。

`niceeval show`

niceeval show [--record <file>]
niceeval show --run <run-id>... [--record <file>]
niceeval show --experiment <experiment-id>... [--record <file>]
niceeval show @<locator> [--record <file>]
niceeval show @<locator> --source [--record <file>]
niceeval show @<locator> --execution [--expand <stable-id>] [--record <file>]
niceeval show @<locator> --timing [--record <file>]
niceeval show @<locator> --usage [--record <file>]
niceeval show @<locator> --diff [--record <file>]

show 是固定的终端排版入口。省略 selector 时显示默认 overview。--run <run-id> 显示一个精确 Run，可重复传入。--experiment <experiment-id> 显示一个精确 Experiment，也可重复传入。通过制显示 Verdicts 与 Pass rate；纯计分制显示 Outcomes 与 Score，完成评分的 Attempt 标作 scored，不会把内部完成状态误写成 passed 或通过率。混合范围只在适用的行显示通过率。 @<locator> 选择一个 Attempt。它不能与 --run 或 --experiment 一起使用，后两者也不能一起使用。一个命令最多只能给出一个 Attempt locator。在 Attempt 上，--source 显示已捕获的 source facts 和 Assertion sites。--execution 显示有界 execution outline，--timing 显示 timing activities。 --usage 显示 usage totals 和 observations，--diff 显示 file-change windows。这五个选项互斥，且都要求一个 Attempt locator。 --expand <stable-id> 只可与 --execution 一起使用。stable ID 必须是 outline 返回的 itemId、toolOccurrenceId 或 commandId，不能使用位置序号或旧式 execution handle。

`niceeval view`

niceeval view [--run <run-id>...] [--no-open] [--port <port>] [--json]

view 是固定的第一方本地 Insight。省略 --run 时打开默认 overview；重复 --run 可预选多个 exact Run。它不接受位置参数，也不装载项目页面、主题、组件或 renderer。 --no-open 不请求操作系统打开浏览器。--port 选择 127.0.0.1 listener 的端口。SPA assets、本机授权 session 与 generation-bound Inspection endpoint 就绪后，命令向 stdout 写出一次可打开的 loopback URL。传入 --json 时改为输出 niceeval.view/v1 NDJSON 的 ready 与 closed lifecycle event。启动或运行失败通过退出码与 stderr 反馈。 View 只读取项目 canonical .niceeval/record.sqlite。新 publication 出现后，页面提示 refresh；用户确认后才切换到新的 cutoff。它不提供 --record、SQL、部署、分享、Report、Page、theme、renderer、route 或 operation 参数。

选择读取方式

目标	使用
让脚本、AI 或 CI 发现并取得稳定 JSON	`niceeval query discover`，再用 `explain` / `run`
在终端审阅 overview、Run、Experiment 或 Attempt 的固定摘要	`niceeval show`
在浏览器审阅 overview 或某个 Run	`niceeval view`
把同一份事实交给另一台兼容 runtime	复制 `.niceeval/record.sqlite`，再传入 `--record`

CLI flags

下表从各命令自己的 option schema 生成。表中没有出现的 flag 会作为未知参数拒绝。

Flag	命令	类型	说明
`--help`	`niceeval`	boolean	打印根命令索引。
`--version`	`niceeval`	boolean	打印当前安装的 NiceEval 版本。
`--tag`	`niceeval check`、`niceeval exp`、`niceeval exp list`	string	只选择带有该 tag 的评估用例。
`--help`	`niceeval check`、`niceeval exp`、`niceeval exp list`、`niceeval exp rename`、`niceeval exp --teardown`、`niceeval debug`、`niceeval accept`、`niceeval session`	boolean	打印该命令的帮助。
`--attempts`	`niceeval exp`	number	让每个选中的评估用例运行指定次数。
`--max-concurrency`	`niceeval exp`	number	限制同时执行的 Attempt 数量。
`--max-build-concurrency`	`niceeval exp`	number	限制同时准备 Sandbox build 的数量。
`--max-setup-prefix-concurrency`	`niceeval exp`	number	限制同时准备 Sandbox setup prefix 的数量。
`--sandbox-setup-cache`	`niceeval exp`	string	使用或绕过 Sandbox 准备缓存。
`--timeout`	`niceeval exp`	number	以毫秒设置每个 Attempt 的超时时间。
`--budget`	`niceeval exp`	number	以美元设置本次 Invocation 的预算。
`--junit`	`niceeval exp`	string	写出必需的 JUnit 报告。
`--json`	`niceeval exp`	boolean	写出该命令的机器文档或事件流。
`--dry`	`niceeval exp`	boolean	规划但不创建 Invocation。
`--rerun`（单独使用为 `failed`） / `--rerun=failed\|all` / `--rerun failed\|all`	`niceeval exp`	`failed` \| `all`	要求重新运行失败目标或全部目标。
`--keep-sandbox`（单独使用为 `failed`） / `--keep-sandbox=failed\|all`	`niceeval exp`	`failed` \| `all`	保留 failed 或全部已结束 Attempt 的 Sandbox。
`--early-exit` / `--no-early-exit`	`niceeval exp`	boolean	某次结果通过后停止该评估用例余下的 Attempt。
`--record`	`niceeval exp`、`niceeval accept`	string	使用指定的 NiceEval Record root。
`--json`	`niceeval exp list`	boolean	写出该命令的机器文档或事件流。
`--dry`	`niceeval exp rename`	boolean	预览显式 Experiment 重命名。
`--json`	`niceeval exp rename`	boolean	写出该命令的机器文档或事件流。
`--teardown`	`niceeval exp --teardown`	boolean	运行显式的 Experiment teardown 恢复。
`--json`	`niceeval exp --teardown`	boolean	写出该命令的机器文档或事件流。
`--recover-shared-state`	`niceeval exp --teardown`	string	指定要显式恢复的共享状态 key。
`--owner-token`	`niceeval exp --teardown`	string	提供准确的共享状态 owner token。
`--confirm-owner-terminated`	`niceeval exp --teardown`	boolean	确认记录的 owner 已终止。
`--confirm-remote-quiesced`	`niceeval exp --teardown`	boolean	确认远端共享状态已静止。
`--json`	`niceeval debug`	boolean	写出该命令的机器文档或事件流。
`--run`	`niceeval accept`	string[]	采用一个已发布的精确 Run；重复传入会被拒绝。
`--dry`	`niceeval accept`	boolean	完成整 Run 采用预检，但不发布新 Run。
`--all`	`niceeval session`	boolean	包含已经完成的 Invocation 状态条目。
`--json`	`niceeval session`	boolean	写出该命令的机器文档或事件流。
`--request`	`niceeval query`	string	从文件或标准输入读取一个 niceeval.query/v1 request。
`--record`	`niceeval query`、`niceeval show`	string	读取一个外部 canonical SQLite Record。
`--help`	`niceeval query`	boolean	打印该命令的帮助。
`--run`	`niceeval show`	string[]	显示一个已封口的 Run；可重复传入。
`--experiment`	`niceeval show`	string[]	显示一个精确的 Experiment；可重复传入。
`--all`	`niceeval show`	boolean	显示紧凑 Results 视图中隐藏的 Attempt。
`--source`	`niceeval show`	boolean	显示一个 Attempt 已捕获的 source facts。
`--execution`	`niceeval show`	boolean	显示一个 Attempt 的有界 execution outline。
`--timing`	`niceeval show`	boolean	显示一个 Attempt 已捕获的 timing activities。
`--usage`	`niceeval show`	boolean	显示一个 Attempt 已捕获的 usage totals。
`--diff`	`niceeval show`	boolean	显示一个 Attempt 已捕获的文件变更。
`--expand`	`niceeval show`	string	展开一个稳定的 execution identity。
`--help`	`niceeval show`	boolean	打印该命令的帮助。
`--run`	`niceeval view`	string[]	选择一个已封口的 Run；可重复传入。
`--no-open`	`niceeval view`	boolean	不请求操作系统打开浏览器。
`--port`	`niceeval view`	string	选择 loopback 监听端口；0 表示自动选择。
`--json`	`niceeval view`	boolean	输出 View lifecycle NDJSON，不输出 Inspection 结果。
`--help`	`niceeval view`	boolean	打印该命令的帮助。
`--all`	`niceeval state migrate`	boolean	迁移所有已注册的第一方 Service state module。
`--help`	`niceeval state migrate`	boolean	打印该命令的帮助。
`--help`	`niceeval init`	boolean	打印该命令的帮助。
`--json`	`niceeval docker profile list`、`niceeval docker profile doctor`、`niceeval docker cache inventory`、`niceeval docker cache gc`	boolean	写出该命令的机器文档或事件流。
`--domain`	`niceeval docker cache inventory`、`niceeval docker cache gc`	string	选择一个由 NiceEval 管理的 Docker 缓存域。
`--apply`	`niceeval docker cache gc`	string	应用先前签发的 Docker 缓存回收计划。
`--help`	`niceeval docker`	boolean	打印该命令的帮助。
`--all`	`niceeval sandbox stop`	boolean	销毁全部留存 Sandbox。
`--window`	`niceeval sandbox diff`	string	选择一个已记录的改动窗口。
`--path`	`niceeval sandbox diff`	string	选择 Sandbox diff 中的一个路径。
`--leave-running`	`niceeval sandbox enter`	boolean	离开 shell 后继续保留 Sandbox。
`--record`	`niceeval sandbox list`、`niceeval sandbox enter`、`niceeval sandbox history`、`niceeval sandbox diff`、`niceeval sandbox stop`、`niceeval sandbox prune`	string	使用指定的 NiceEval Record root。
`--orphans`	`niceeval sandbox list`	boolean	检查已终止运行遗留的未登记 Sandbox 实例。
`--force`	`niceeval sandbox prune`	boolean	同时清理未验证的孤儿候选项。
`--development`	`niceeval sandbox`	boolean	Diagnose the isolated Incus development domain instead of reference.
`--help`	`niceeval sandbox`	boolean	打印该命令的帮助。
`--tag`	`niceeval list`	string	只选择带有该 tag 的评估用例。
`--help`	`niceeval list`	boolean	打印该命令的帮助。

query、show 与 view 共享闭合的 Inspection operation 结果，但不共享 formatter、路由、组件、主题或呈现 schema。

API

适配器

CLI

`niceeval query`

`niceeval show`

`niceeval view`

选择读取方式

CLI flags

​niceeval query

​niceeval show

​niceeval view

​选择读取方式

​CLI flags

`niceeval query`

`niceeval show`

`niceeval view`

选择读取方式

CLI flags