Integracja z wierszem poleceń (CMD) (Windows)

Aby ułatwić interakcję z interfejsem CLI STT (przetwarzanie mowy na tekst) z poziomu wiersza poleceń systemu Windows, możesz utworzyć plik wsadowy s.bat i umieścić go w ścieżce PATH. Dzięki temu możesz po prostu wpisać „twoje pytanie” w dowolnym oknie CMD.

Uwaga: CMD (cmd.exe) to starsza powłoka systemu Windows, która ma znaczne ograniczenia w porównaniu z powłokami PowerShell i Unix. Aby uzyskać bogatsze wrażenia, rozważ zamiast tego użycie PowerShell Integration lub WSL Integration.

Instrukcje konfiguracji

1. Utwórz katalog na swoje osobiste skrypty (jeśli jeszcze tego nie zrobiłeś)

KOD_BLOKU_0

2. Dodaj ten katalog do swojej PATH (jednorazowa konfiguracja)

Otwórz Właściwości systemu → Zmienne środowiskowe i dodaj %USERPROFILE%\bin do zmiennej PATH użytkownika.

Alternatywnie uruchom to w wierszu polecenia CMD z podwyższonym poziomem uprawnień (obowiązuje po ponownym otwarciu CMD):

KOD_BLOKU_1

3. Utwórz plik wsadowy

Otwórz Notatnik lub dowolny edytor tekstu i zapisz następujące dane jako %USERPROFILE%\bin\s.bat:

KOD_BLOKU_2

4. Przetestuj

Otwórz nowe okno CMD (aby załadowana została zaktualizowana PATH) i wpisz:

KOD_BLOKU_3

Uwagi specyficzne dla CMD

  • Brak natywnego limitu czasu procesu: CMD nie ma odpowiednika uniksowego limitu czasu. Ten skrypt deleguje logikę limitu czasu do funkcji „WaitForExit” programu PowerShell. PowerShell musi być dostępny (jest we wszystkich nowoczesnych systemach Windows).

  • SL5NET_AURA_PROJECT_ROOT: Ustaw tę opcję jako stałą zmienną środowiskową użytkownika poprzez Właściwości systemu lub zakoduj na stałe ścieżkę w pliku .bat.

  • Skrypty pomocnicze: update_github_ip.bat i start_service.bat muszą istnieć w PATH lub w %USERPROFILE%\bin. Są to odpowiedniki CMD funkcji powłoki update_github_ip i start_service.

  • bash dla skryptu Kiwix: Jeśli zainstalowany jest WSL, bash jest dostępny w CMD i skrypt .sh zostanie uruchomiony bezpośrednio. W przeciwnym razie dostosuj kiwix-docker-start-if-not-running.sh do odpowiednika .bat.

  • Obsługa ofert: CMD ma rygorystyczne i niestabilne zasady dotyczące kwotowań. Jeśli zapytanie zawiera znaki specjalne (&, |, >, <), umieść całe zapytanie w cudzysłowie: s "Twoje i pytanie".

  • ograniczenie set /p: set /p czyta tylko pierwszą linię pliku. W przypadku wyjścia wielowierszowego użyj type, aby bezpośrednio wydrukować plik (tak jak zrobiono to w gałęzi o długim czasie oczekiwania).

Cechy

  • Ścieżki dynamiczne: Automatycznie rozpoznaje ścieżki poprzez zmienną środowiskową SL5NET_AURA_PROJECT_ROOT.

  • Auto-Restart: Jeśli backend nie działa, wywołuje start_service.bat i próbuje uruchomić lokalne usługi Wikipedii.

  • Inteligentne limity czasu: Najpierw próbuje uzyskać szybką reakcję w ciągu 2 sekund, a następnie powraca do trybu głębokiego przetwarzania trwającego 70 sekund.