Zum Inhalt springen
VelinStyle v1.4.0
⌂ Home

Docs for VelinStyle 1.4.x · verified against 1.4.0

CLI-Befehl schlägt fehl oder meldet zu viel 1.4.0

Nutze die paketqualifizierte CLI und begrenze Prüfungen auf das passende Profil oder die passende Schwere. English

Diagnose starten

Problem

Befehle liefern 404, hängen an großen Bäumen oder überfluten das Terminal mit Befunden.

Erste Prüfung

Führe zuerst die allgemeine Diagnose im Projektverzeichnis aus.

npx @birdapi/velinstyle doctor

Tiefer prüfen

npx @birdapi/velinstyle check . --profile app --json
npx @birdapi/velinstyle scan ./src --severity error

Schnellcheck

  • Im richtigen Projektverzeichnis ausführen.
  • Nur dokumentierte Profile und Flags verwenden.
  • Nach jeder Änderung erneut prüfen.

Das CLI-Paket wird nicht gefunden

Ursache: Nacktes npx velinstyle löst das falsche Paket auf und liefert oft 404.

  1. Lösung 1: Rufe immer npx @birdapi/velinstyle <command> auf.
  2. Lösung 2: Starte mit npx @birdapi/velinstyle doctor, um die lokale Installation zu bestätigen.
  3. Lösung 3: Erfinde keine Flags; nutze nur dokumentierte Befehle.
Erneut prüfen
npx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs

Ein Check liefert zu viele Befunde

Ursache: Profil oder Ziel sind breiter als die Seite, die du prüfen wolltest.

  1. Lösung 1: Wähle ein Profil: marketing, app, docs, fragment oder ecommerce.
  2. Lösung 2: Für Docs besser eine Datei: check ./index.html --profile docs.
  3. Lösung 3: Bei Scans die Schwelle mit --severity error und engem Pfad wie ./src anheben.
Erneut prüfen
npx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs

Scan-Befunde sind nicht alles Auto-Fixes

Ursache: scan liefert Diagnostics, Candidates und SAFE/REVIEW/BLOCKED/UNKNOWN — nur ein kleines SAFE-Set darf Apply.

  1. Lösung 1: REVIEW / CANDIDATE nur als Analyse — nie als Auto-Apply.
  2. Lösung 2: Apply nur bei SAFE laut Policy und fixable: true (fünf SAFE-Regeln; zuerst --fix-dry-run).
  3. Lösung 3: links/* bleibt Detect-only; BLOCKED/UNKNOWN nicht automatisiert umschreiben.
Erneut prüfen
npx @birdapi/velinstyle scan ./src --fix-dry-run
npx @birdapi/velinstyle scan ./src --json
npx @birdapi/velinstyle scan ./src --sarif

Human-Experience-Ausgabe kann einen Branding-Footer zeigen; --quiet, --json, SARIF, compact und markdown unterdrücken ihn. Details: CLI Experience · AI Resources.

Immer noch defekt?

Kopiere diese Vorlage in einen Support-Fall und ergänze die Ausgaben.

BirdAPI Forum · VelinStyle-Support