Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

verdi-performance

/verdi-performance

Podpowiada, jak przyspieszyć zapytania i renderowanie w Verdi przy dużych plikach FSDB, wybierając GUI lub NPI.

Repozytorium
verdimcp ↗
Licencja
MIT
Ostatnia zmiana repozytorium
29.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 29.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Podpowiada, jak przyspieszyć zapytania i renderowanie w Verdi przy dużych plikach FSDB, wybierając GUI lub NPI.

Oryginalny opis (EN)

Use when a Verdi query or render is slow, when the FSDB is large, or when deciding between GUI and NPI for a big view. Covers the measured cost model, the hard render bounds, and which performance questions have no tool behind them.

Jak działa

  1. Scope
  2. Measured cost model (903 MB FSDB, 128 signals, 5 ms window, 2000 bins)
  3. Practical thresholds
  4. Why the render bound is not arbitrary
  5. Cone capture cost
  6. Memory
  7. Degradation
  8. Answering "why is it slow"
Sekcje z nagłówków SKILL.md, w oryginale · 70 linii, 536 słów
Podgląd SKILL.md
---
name: verdi-performance
description: Use when a Verdi query or render is slow, when the FSDB is large, or when deciding between GUI and NPI for a big view. Covers the measured cost model, the hard render bounds, and which performance questions have no tool behind them.
---

# Performance, cost model, and bounds

## Scope

**In:** "this is slow", "the FSDB is 3 GB", "why did my render take 30 s", choosing an engine.
**Out of scope:** throughput, latency, outstanding-transaction, bottleneck attribution, CDC and
coverage. **No MCP tool implements those.** If asked, say so; do not derive them from raw change counts.

## Measured cost model (903 MB FSDB, 128 signals, 5 ms window, 2000 bins)

| Path | Stage | Time |
|---|---|---:|
| NPI | `npisys.init` | 4.04 s |
| NPI | open | 0.01 s |
| NPI | read (128 × 2000 = 256 k samples) | 18.15 s |
| NPI | SVG | 0.11 s |
| NPI | SVG→PNG (ImageMagick) | 8.28 s |
| NPI | **total** | **30.6 s**, RSS 8.0 GB |
| GUI | create + open + add + zoom + screenshot | 27.0 s, RSS 8.4 GB |
| GUI | same window, capture again | **9.7 s** |

Resident NPI reader (default) removes the 3–4 s init after the first call: hot queries measured
0.6–1.3 s. One-shot mode costs ~3.1 s per call.

Read the rule off that table: **NPI wins on targeted reads, loses on wide renders.** ~14 k samples/s for
reads; the PNG conversion is a flat cost proportional to image complexity.

## Practical thresholds

- ≤16 signals and ≤1000 bins → `verdi_waveform_render` (the tool enforces the bound; ~1 s of reads).
- More signals than that, or "show me what the engineer sees" → GUI capture
  (`verdi_capture_annotate` / `verdi_window_screenshot`).
- Very wide time ranges → sample with `verdi_window_scan` / aggregate with `verdi_change_stats` first,
  then narrow before reading transitions.
- `engine.auto` is the right default. `switch_hint` fires only past 15 s and only when the other engine is
  usable — it is the tool telling you the cost model disagrees with the auto choice.

## Why the render bound is not arbitrary

256,000 samples ≈ 18 s. The bound of 16×1000 = 16 000 samples ≈ 1.1 s, which keeps a "show me" call
interactive. Raising the bound is possible; it is a product decision, not a technical one.

## Cone capture cost

`verdi_cone_capture` takes 10–35 s per call: nSchema elaborates, traces, then `schCapture` writes a
full-window PNG. Do not loop over 20 signals. One cone per question.

## Memory

Both paths sat at ~8 GB RSS on the 903 MB FSDB — FSDB indexing dominates, and headless does **not** save
memory. On a shared host that is the number that gets you killed by a colleague, not the wall time.

## Degradation

- NPI unavailable → GUI sampling: `verdi_xz_scan` caps at 20 signals and a `max*2` query budget, sets
  `degraded: true`. Results are candidates, not a scan.
- GUI unavailable → NPI only: no capture, no annotation, no cone.
- Neither → report the blocker; do not approximate a waveform from logs.

## Answering "why is it slow"

Quote the stage breakdown, not a single number:

```
30.6 s = 4.0 init + 18.1 read (256k samples) + 0.1 svg + 8.3 png
fix: cut signals/bins (read is linear), or use a GUI capture (9.7 s same-window)
caveat: resident reader removes init, not read
```

Wersje

W bazie nie ma innych skilli o nazwie verdi-performance.

Migawka bazy z 13.11.2026 · wersja paczki 4c248ad7dcf6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100verdi
    Kieruje sprawy z Synopsys Verdi, nWave i FSDB do właściwych narzędzi i przypomina zasady bezpiecznej pracy.
  • 100verdi-waveform
    Otwiera i przegląda przebiegi w Verdi: dodaje i usuwa sygnały, czyta wartości i renderuje mały wycinek.
  • 100x-npi
    Pomaga pisać skrypty Pythona z użyciem pynpi do analizy plików FSDB, protokołów magistral i baz pokrycia.
  • 90performance-patterns
    Wskazuje antywzorce wydajności, takie jak zapytania N+1, nadmiar wywołań API i ciężkie renderowanie, oraz podpowiada poprawki.
  • 100performance
    Diagnozuje i przyspiesza wolne elementy: zapytania, ładowanie stron, renderowanie, buildy, wysokie zużycie pamięci i timeouty, z pominięciem błędów poprawności.
  • 95performance
    Poprawia wydajność aplikacji Flows: ponowne renderowanie, zapytania, stronicowanie, paczki kodu, wycieki pamięci i koszt LLM, mierząc wynik.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.