4fcce5bff9
Add /version.json build identity, deploy 16e7930 release markers,
DNS/Named Tunnel prep docs, portable browser benchmark, and replay
stability probe. Keep Quick Tunnel until permanent domain cutover.
Co-authored-by: Cursor <cursoragent@cursor.com>
59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
# HARDWARE_BENCHMARK_RUNBOOK
|
||
|
||
## Server status (OwlPrime / coder)
|
||
|
||
```text
|
||
GPU devices: NVIDIA GTX 1080 ×2 present (/dev/nvidia*, /dev/dri)
|
||
DISPLAY: unset (unless xvfb)
|
||
Chromium WebGL in this env: SwiftShader / software
|
||
Hardware acceleration for demo metrics: BLOCKED_BY_DISPLAY_ENVIRONMENT
|
||
```
|
||
|
||
Do **not** install a display server or change NVIDIA drivers for benchmark.
|
||
|
||
## Portable benchmark (presentation laptop)
|
||
|
||
On the machine that will show the demo to the jury:
|
||
|
||
```bash
|
||
cd /path/to/app
|
||
npm ci
|
||
npm run build
|
||
npx vite preview --host 127.0.0.1 --port 3100
|
||
# or point at production / Quick Tunnel:
|
||
# export PLAYWRIGHT_BASE_URL=https://<working-url>/
|
||
|
||
npm run perf:browser
|
||
# writes agent/reports/browser-benchmark.json
|
||
# and docs/HARDWARE_BROWSER_BENCHMARK_LATEST.md (gitignored)
|
||
|
||
npm run perf:browser:export # same
|
||
```
|
||
|
||
Requirements:
|
||
|
||
* Real headed Chrome/Chromium (`DISPLAY` / macOS / Windows)
|
||
* **No** forced GPU flags (measures the jury machine as-is)
|
||
* Modes: low / medium / high / demo
|
||
* Includes playlist seeks + 3 replay cycles
|
||
|
||
### Manual export from UI
|
||
|
||
Open `/?perf=1` → button **Export benchmark** downloads JSON locally.
|
||
|
||
## Acceptance (Demo mode)
|
||
|
||
| Grade | Avg FPS | Min FPS | p95 |
|
||
| ----- | ------: | ------: | --: |
|
||
| Excellent | ≥55 | ≥40 | ≤20 ms |
|
||
| Acceptable | ≥30 | ≥24 | ≤33 ms |
|
||
| Not for live demo | <30 or p95 >40 ms |
|
||
|
||
Hardware run is valid only if renderer string does **not** contain SwiftShader / llvmpipe / Software.
|
||
|
||
## Server diagnostic (optional)
|
||
|
||
```bash
|
||
npm run perf:gpu # may re-exec under xvfb; labels software renderers
|
||
```
|