Befehlskatalog für den Betrieb

Unterstützte Befehle mit Voraussetzungen, Nebenwirkungen und Ausgabeorten.

Auf dieser Seite

Führe diese Befehle im Voice-Studio-Arbeitsverzeichnis aus. Die Anforderungen an Node.js, Bash und .NET stehen in der Haupt-README.

Befehl	Zweck und Voraussetzungen	Schreibzugriffe / Ausgabe
`npm start`	Lokales Studio und Beispielwebsite bauen und starten	Generierte Builds und privater lokaler Sitzungszustand
`npm run pairing-code`	Lokalen Kopplungscode der laufenden Installation abrufen	Gibt den Kopplungscode aus, niemals das Bearer-Token
`npm run build`	Beide Libraries, Angular-Frontend und .NET-Backend bauen	`dist/`, `bin/`, `obj/`
`npm run build:frontend:staged`	Frontend bauen, ohne die aktuell ausgelieferten Dateien zu ersetzen	`frontend/dist/voice-studio-next/`
`npm run frontend:publish-local`	Ein bereits fertig gebautes Frontend aus dem Bereitstellungsordner kopieren; die Einstiegsdatei zuletzt	Ersetzt das lokal ausgelieferte Frontend; kein Backend-Neustart und keine entfernte Veröffentlichung
`npm run website:build`	Zweisprachige Produktseiten, Library-Demo und gestaltete technische HTML-Leitfäden bauen	`website/dist/voice/`; keine Veröffentlichung
`npm run website:preview`	Vorschau der öffentlichen Website bauen und auf Loopback-Port 5187 bereitstellen	Dieselbe statische Ausgabe und ein lokaler Prozess
`npm run website:verify-artifact`	Statisches Veröffentlichungsinventar, Quelltexthashes, Git-Revision, Routen und Grenzen der öffentlichen Browserfunktionen validieren; erfordert einen sauberen committeten Build	Nur lesend; `-- --allow-dirty` ist auf lokale Vorbereitungen beschränkt
`npm run website:verify-deployment`	Das festgelegte öffentliche Voice-Ziel mit dem exakten lokalen Artefakt vergleichen; Routen, Inhaltstypen und Hosting-Grenzen prüfen	Nur lesende öffentliche Anfragen; Bericht unter `test-results/voice-deployment/`
`npm run test:source-provenance -- --help`	Konfigurierbare Prüfung von Quelltext, Hash und Git sowie optional der Aufgabenherkunft an einem laufenden lokalen Studio	Kompakter Bericht unter dem ignorierten `test-results/`; keine Quelltextänderung und kein Modellaufruf
`npm run docs:dossier:check -- --repository .`	Gepflegten VL-W1-Abschnitt mit dem Dossier in diesem Checkout vergleichen	Keine Schreibzugriffe; Exit-Code ungleich null, wenn eine Synchronisierung erforderlich ist
`npm run docs:dossier:sync -- --repository .`	Gepflegten Dossierinhalt und Darstellung synchronisieren, dabei Lebenszyklusfelder erhalten	Explizite Schreibzugriffe auf die Dossierdateien dieses Checkouts; keine Git-Operation
`npm run test:dossier`	Bereitgestelltes Dossier sowie Desktop- und Mobil-Layout prüfen	`test-results/dossier-integration/`; keine API-Änderungen
`npm run test:evidence`	Alle ausgewählten Nachweismanifeste, zulässige Pfadgrenzen und Dateihashes prüfen	Nur lesend; führt historische Tests nicht erneut aus
`npm run test:holistic-schema`	Vorgeschlagene JSON-Beispiele, Verweise und Hashes validieren; fehlerhafte Varianten ablehnen	Nur offline; kein Repository- oder Website-Review und kein Modell
`npm run build:writing-rules`	Lokalen Schreibregelkatalog, Prompt-Komposition und API für sprachliche Oberflächensignale bauen	ESM-Dateien, JSON und Typdeklarationen unter `packages/writing-rules/dist/`
`npm run test:writing-rules`	Übereinstimmung von Regeln und Quellen, Prompt-Grenzen, Signale und typisierte Paketnutzer prüfen	Offline-Testfälle; kein Modellaufruf
`npm run test:json-viewer`	JSON-Dialoge mit einem isolierten Loopback-Testaufbau prüfen	Browserbericht unter `test-results/voice-website/`; kein Studio-Zugriff
`npm run test:writing-patterns`	Veröffentlichten Schreibregelkatalog, englische und deutsche Filter, Beispiele und das Fehlen ausführbarer Schreibwerkzeuge prüfen	Browserbericht; standardmäßig lokale Vorschau oder das unten festgelegte öffentliche Ziel
`npm run test:website`	Routen, Englisch und Deutsch, mobiles Layout und das bereitgestellte HTML-Annotationsbeispiel im Browser prüfen	Ignorierte Screenshots und Bericht; standardmäßig lokale Vorschau oder das unten festgelegte öffentliche Ziel
`npm run test:website-seo`	48 statische englische und deutsche Routen, Sprachabdeckung und SEO-Metadaten prüfen	Nur lesende Anfragen an die lokale Vorschau oder das festgelegte öffentliche Ziel; Bericht unter dem ignorierten `test-results/`
`npm run test:research`	Zweisprachige Forschungsdatensätze, Quellen- und API-Links sowie JSON-Dialoge prüfen	Ignorierter Browserbericht; standardmäßig lokale Vorschau oder das unten festgelegte öffentliche Ziel
`npm run test:library-types`	Isolierte TypeScript- und JavaScript-Paketnutzer kompilieren sowie tatsächliche IntelliSense-Vervollständigungen und Hover-Dokumentation prüfen	Offline-Pakettestfälle; keine UI-Automatisierung von VS Code
`npm run test:session`	Backend-Verträge für Browservertrauen, Ablauf, Neustart und Widerruf prüfen	Isolierter temporärer Sitzungszustand; kein laufendes Backend
`npm run test:session-ui`	Wiederaufnahme-, 401- und Nebenläufigkeitsregressionen in den tatsächlichen UI-Methoden prüfen	Nur simuliertes HTTP
`npm run test:browser-session`	Schließen und Wiederöffnen von Chrome, Neuladen, neue Tabs, Abmeldung und temporäre Sitzungen prüfen	Isoliertes Browserprofil und Sitzungsvertrauen; keine Projekt-, Quelltext- oder Modellschreibzugriffe
`npm run test:selection-ui`	Regressionen bei verzögerten HTTP-Anfragen und Zustandsänderungen für Beibehalten, Alternativen, Wiederholungen und Abbruch prüfen	Nur simuliertes HTTP
`npm run test:selection-workflow`	Quelltext-, Beibehalten- und Vorschlagsablauf im echten Browser mit eigenen temporären Testdaten prüfen	Registriert und bearbeitet ausschließlich die eigenen Testdaten und entfernt sie anschließend samt Registrierung; kein Modell
`npm run test:navigation`	Sprache, kompakte und Fokusnavigation sowie Overlay-Szenarien im Browser prüfen	Browserlokale Einstellungen und ignorierte Nachweise; erfordert Studio und die konfigurierte Pilotwebsite
`npm run test:loading-overlay`	Verzögertes Laden ohne Layoutsprünge prüfen; erfordert ein laufendes Studio mit den Projekten `quality-website` und `markdown-handbook` sowie Chrome	Nur lesende Projekt-API-Aufrufe und temporäre Testsitzungskopplung; ignorierte Screenshots und Bericht unter `test-results/loading-overlay/`
`npm run test:wiki-i18n`	Übersetzungsabdeckung des Wikis und Erhalt von Quelltextzitaten prüfen	Nur offline

Backend-Tests (test:backend, test:runner, test:tasks, test:checks, test:selection, test:session) und Library- beziehungsweise UI-Tests prüfen ihre jeweiligen Verträge. Runner-Tests verwenden simulierte Implementierungen. Verwende einen isolierten .NET-Artefaktpfad, wenn eine laufende API sonst ihre Build-Dateien sperren könnte.

session.mjs ist ein internes Hilfsskript zum Lesen des privaten Sitzungszustands und kein Nachweisexporter. publish-built-frontend.mjs stellt das Frontend lokal bereit; es veröffentlicht nicht die öffentliche Ökosystem-Website.

Browserprüfungen der öffentlichen Website#

Diese Befehle verwenden das festgelegte öffentliche Veröffentlichungsziel anstelle der lokalen Vorschau:

VOICE_WEBSITE_URL=https://agent-orchestrator.dev/voice/ npm run test:website
VOICE_WEBSITE_URL=https://agent-orchestrator.dev/voice/ npm run test:research
VOICE_WEBSITE_URL=https://agent-orchestrator.dev/voice/ npm run test:writing-patterns

Das zulässige Ziel ist ausdrücklich festgelegt. Öffentliche Berichte werden getrennt von lokalen Vorschauberichten gespeichert. Die Prüfungen verwenden keine Studio-Sitzung und senden keine Modellanfragen.

Szenarioskripte#

Der Pilot für die Agent-Studio-Website benötigt deren tatsächliches lokales Quellverzeichnis. Gib --website PATH an; die Skripte setzen nicht voraus, dass die Website neben diesem Checkout liegt. PATH muss die konfigurierte Angular-Website und deren voice.config.json enthalten.

npm run test:live -- --website PATH
node scripts/verify-website-revision.mjs --run --website PATH
node scripts/reconcile-website-review.mjs --website PATH --dry-run

Die ersten beiden Prüfungen benötigen eine laufende Pilotwebsite. test:live benötigt zusätzlich Studio und registriert den angegebenen Ordner. Der Abgleich benötigt die ursprünglichen Audit- und Importdatensätze sowie das passende Website-Verzeichnis. Sein Probelauf schreibt nur einen lokalen Plan. Die Anwendung dieses Plans bleibt ein separater Vorgang mit Prüfsummenprüfung.

Die vorhandenen Skripte pilot-*.mjs, import-website-review.mjs und reconcile-website-review.mjs bilden szenariospezifische Abläufe mit eigenen Quelltext- und Versionsannahmen ab. Manche erstellen ausdrücklich Aufgaben, rufen das konfigurierte Modell auf oder übernehmen Quelltextvorschläge. Sie sind keine allgemeinen Kurzprüfungen. Lies vor einem autorisierten Lauf das Skript und den zugehörigen Review-Datensatz. Ältere Dateien mit dem Muster verify-*.mjs können sich auf eine dokumentierte deutsche Pilotoberfläche beziehen. Die derzeit unterstützten Einstiegspunkte stehen oben und in package.json.

Die Dateizuständigkeiten und Aufbewahrung beschreiben versionierte Quellen, generierte Ausgaben und private Laufzeitdateien.

Messungen für Schreibreviews#

npm run benchmark:writing-review baut das Paket mit den Schreibregeln und führt benchmarks/writing-review/run.mjs für die gepflegten englischen und deutschen Testfälle aus. Der Lauf schreibt test-results/writing-review/report.json und sendet keine Anbieteranfragen.

Nach der Ergebnisprüfung validiert npm run benchmark:writing-review:retain die Eingabehashes und aktualisiert die Messübersicht der Website. Baue die Website neu, um die Übersicht anzuzeigen. Der aufbewahrte Datensatz unterscheidet Bytes von Tokens und Trefferkandidaten des lokalen Scanners von der Wirksamkeit eines Modells.

Git- und Quellbezug

Quelle dieser Seite: website/guides/de/commands.md. Inhaltshash und Git-Revision: Build-Nachweis.

Markdown-Quelle herunterladen

Weitere Verweise im Repository:

README.md
docs/reviews/

Nächster GuideDatierte Prüfnachweise →