whisper-windows-mcp 2.2.2 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/{LICENSE-COMMERCIAL.md → COMMERCIAL-LICENSE.md} +58 -58
  2. package/LICENSE +40 -40
  3. package/PRIVACY.es.md +192 -135
  4. package/PRIVACY.id.md +192 -135
  5. package/PRIVACY.ja.md +192 -135
  6. package/PRIVACY.ko.md +192 -135
  7. package/PRIVACY.md +192 -135
  8. package/PRIVACY.pl.md +192 -135
  9. package/PRIVACY.pt-BR.md +192 -135
  10. package/PRIVACY.ro.md +192 -135
  11. package/PRIVACY.uk.md +192 -135
  12. package/PRIVACY.vi.md +192 -135
  13. package/README.es.md +74 -48
  14. package/README.id.md +77 -40
  15. package/README.ja.md +100 -72
  16. package/README.ko.md +63 -37
  17. package/README.md +76 -39
  18. package/README.pl.md +77 -40
  19. package/README.pt-BR.md +71 -45
  20. package/README.ro.md +78 -41
  21. package/README.uk.md +77 -40
  22. package/README.vi.md +67 -41
  23. package/ROADMAP.es.md +110 -48
  24. package/ROADMAP.id.md +77 -104
  25. package/ROADMAP.ja.md +84 -123
  26. package/ROADMAP.ko.md +73 -97
  27. package/ROADMAP.pl.md +104 -44
  28. package/ROADMAP.pt-BR.md +78 -102
  29. package/ROADMAP.ro.md +102 -44
  30. package/ROADMAP.uk.md +65 -97
  31. package/ROADMAP.vi.md +78 -102
  32. package/SECURITY.es.md +64 -47
  33. package/SECURITY.id.md +64 -47
  34. package/SECURITY.ja.md +64 -47
  35. package/SECURITY.ko.md +64 -47
  36. package/SECURITY.md +21 -4
  37. package/SECURITY.pl.md +64 -47
  38. package/SECURITY.pt-BR.md +64 -47
  39. package/SECURITY.ro.md +64 -47
  40. package/SECURITY.uk.md +64 -47
  41. package/SECURITY.vi.md +64 -47
  42. package/TROUBLESHOOTING.es.md +309 -323
  43. package/TROUBLESHOOTING.id.md +333 -323
  44. package/TROUBLESHOOTING.ja.md +399 -286
  45. package/TROUBLESHOOTING.ko.md +309 -323
  46. package/TROUBLESHOOTING.pl.md +355 -323
  47. package/TROUBLESHOOTING.pt-BR.md +309 -323
  48. package/TROUBLESHOOTING.ro.md +355 -323
  49. package/TROUBLESHOOTING.uk.md +369 -323
  50. package/TROUBLESHOOTING.vi.md +309 -323
  51. package/dist/index.js +591 -216
  52. package/package.json +45 -45
  53. package/patch_roadmaps.py +0 -72
package/README.pl.md CHANGED
@@ -17,6 +17,7 @@ Po instalacji możesz po prostu powiedzieć w Claude Desktop:
17
17
  - *"Rozpocznij wsadową transkrypcję wszystkich plików w tym folderze"*
18
18
  - *"Ile czasu zajmie transkrypcja tych plików?"*
19
19
  - *"Sprawdź, czy akceleracja GPU działa"*
20
+ - *"Transkrybuj ten plik w trybie prywatności"*
20
21
 
21
22
  ---
22
23
 
@@ -163,12 +164,13 @@ Transkrybuje pojedynczy plik. Obsługuje tryb blokujący (domyślny) lub działa
163
164
  |---|---|
164
165
  | `file_path` | Bezwzględna ścieżka do pliku (wymagana) |
165
166
  | `language` | Kod języka (`pl`, `en`, `ja` itp.) lub `auto` do automatycznego wykrywania. Domyślnie: `en` |
166
- | `output_format` | `text` (domyślnie), `timestamps`, `json` lub `srt` |
167
+ | `output_format` | `timestamps` (domyślnie), `text`, `json`, `srt`, `vtt`, `lrc` lub `csv` |
167
168
  | `save_to_file` | Zapisz transkrypcję jako .txt obok pliku źródłowego |
168
169
  | `background` | Uruchom jako osobne zadanie — natychmiast zwraca ID zadania. Używaj `check_progress` do monitorowania. Zalecane dla plików dłuższych niż 10 minut. |
170
+ | `privacy_mode` | Zastąp tryb prywatności dla tego wywołania. `true` = tylko metadane, żaden tekst transkrypcji nie jest przesyłany. `false` = zwróć tekst nawet gdy `WHISPER_PRIVACY_MODE=true` globalnie. Pomiń, aby użyć globalnego ustawienia. |
169
171
  | `threads` | Zastąp liczbę wątków CPU |
170
- | `temperature` | Temperatura próbkowania 0,0–1,0. Domyślnie 0,0 (deterministyczny). Wyższe wartości redukują halucynacje w hałaśliwym audio. |
171
- | `prompt` | Ciąg kontekstu poprzedniego — poprawia dokładność dla słownictwa dziedzinowego lub imion mówców. Np.: `"Nazwy: Keemstar, DramaAlert."` |
172
+ | `temperature` | Temperatura próbkowania 0,0–1,0. Domyślnie 0,0 (deterministyczny). |
173
+ | `prompt` | Ciąg kontekstu poprzedniego — poprawia dokładność dla słownictwa dziedzinowego lub imion mówców. |
172
174
  | `condition_on_prev_text` | Ponownie włącz warunkowanie kontekstem między segmentami. Domyślnie false. |
173
175
  | `beam_size` | Szerokość wyszukiwania wiązką. Wyższa = dokładniejsza, wolniejsza. Domyślnie 5. |
174
176
  | `best_of` | Liczba ocenianych sekwencji kandydatów. Domyślnie 5. |
@@ -181,32 +183,44 @@ Transkrybuje pojedynczy plik. Obsługuje tryb blokujący (domyślny) lub działa
181
183
  | `offset_t` | Przesunięcie początkowe w milisekundach. |
182
184
  | `duration` | Czas przetwarzania w milisekundach od przesunięcia. |
183
185
 
186
+ **Formaty wyjściowe:**
187
+ - `timestamps` — segmenty ze znacznikami czasu, np. `[00:00:01.230 --> 00:00:04.560] Witaj` (domyślnie)
188
+ - `text` — czysty tekst bez kodów czasowych
189
+ - `json` — strukturalny JSON (tylko tryb blokujący)
190
+ - `srt` — plik napisów SubRip zapisany obok źródła
191
+ - `vtt` — plik napisów WebVTT zapisany obok źródła
192
+ - `lrc` — format LRC tekstu/karaoke zapisany obok źródła
193
+ - `csv` — CSV ze znacznikami czasu zapisany obok źródła
194
+
184
195
  ---
185
196
 
186
197
  ### `check_progress`
187
198
  Monitoruje zadanie transkrypcji w tle uruchomione przez `transcribe_audio` (background=true).
188
199
 
189
- Zwraca czas, który upłynął, ostatni przetworzony znacznik czasu, procent i kompletną transkrypcję po zakończeniu.
200
+ Zwraca czas, który upłynął, ostatni przetworzony znacznik czasu i kompletną transkrypcję po zakończeniu.
190
201
 
191
202
  | Parametr | Opis |
192
203
  |---|---|
193
204
  | `job_id` | ID zadania zwrócone przez `transcribe_audio` |
205
+ | `privacy_mode` | Zastąp tryb prywatności dla tego sprawdzenia. `true` = tylko metadane, niezależnie od sposobu uruchomienia zadania. |
194
206
 
195
207
  ---
196
208
 
197
209
  ### `start_batch`
198
- Automatycznie i sekwencyjnie transkrybuje wszystkie jeszcze nieprzetranstrybuowane pliki w folderze. Sortuje według czasu trwania (najkrótsze pierwsze), przetwarza jeden po drugim jako zadania w tle i weryfikuje każdy wynik.
210
+ Automatycznie i sekwencyjnie transkrybuje wszystkie jeszcze niestranstrybuowane pliki w folderze. Sortuje według czasu trwania (najkrótsze pierwsze), przetwarza jeden po drugim jako zadania w tle i weryfikuje każdy wynik. Partia samodzielnie przesuwa się po zakończeniu każdego pliku — odpytywanie nie jest wymagane.
199
211
 
200
212
  | Parametr | Opis |
201
213
  |---|---|
202
214
  | `folder_path` | Ścieżka do folderu (wymagana) |
203
215
  | `language` | Kod języka. Domyślnie: `en` |
204
216
  | `threads` | Zastąp liczbę wątków CPU |
217
+ | `output_format` | `timestamps` (domyślnie) lub `text` |
218
+ | `privacy_mode` | Zastąp tryb prywatności. Przed rozpoczęciem partii wymagane jest jedno potwierdzenie; następnie wszystkie pliki są przetwarzane bez nadzoru. Tekst transkrypcji nie jest zwracany. |
205
219
 
206
220
  ---
207
221
 
208
222
  ### `check_batch_progress`
209
- Monitoruje uruchomioną partię. Automatycznie przechodzi do następnego pliku po zakończeniu bieżącego. Zwraca ogólny postęp, bieżący plik ze znacznikiem czasu, ETA i pliki z błędami.
223
+ Monitoruje uruchomioną partię. Automatycznie przechodzi do następnego pliku po zakończeniu bieżącego. Zwraca ogólny postęp, bieżący plik ze znacznikiem czasu i pliki z błędami.
210
224
 
211
225
  | Parametr | Opis |
212
226
  |---|---|
@@ -223,17 +237,21 @@ Przetwarza pliki jeden po jednym z podglądem i potwierdzeniem przed każdym. Pr
223
237
  | `file_index` | Który plik przetworzyć (numeracja od 1). Pomiń, aby najpierw wyświetlić listę plików. |
224
238
  | `language` | Kod języka. Domyślnie: `en` |
225
239
  | `recursive` | Uwzględnij podfoldery |
240
+ | `output_format` | `timestamps` (domyślnie) lub `text` |
241
+ | `privacy_mode` | Zastąp tryb prywatności. Potwierdzenie wymagane przed każdym plikiem; zwracane są tylko metadane. |
226
242
 
227
243
  ---
228
244
 
229
245
  ### `generate_subtitles`
230
- Generuje pliki napisów SRT. Obsługuje automatyczne wykrywanie języka i wyjście z tłumaczeniem na angielski.
246
+ Generuje pliki napisów. Obsługuje automatyczne wykrywanie języka i wyjście z tłumaczeniem na angielski. Generuje SRT (największa kompatybilność) lub WebVTT (web i HTML5 wideo).
231
247
 
232
248
  | Parametr | Opis |
233
249
  |---|---|
234
250
  | `file_path` | Ścieżka do pliku (wymagana) |
235
251
  | `language` | Kod języka lub `auto` do automatycznego wykrywania. Domyślnie: `en` |
236
- | `translate_to_english` | Generuj też `.en.srt` z tłumaczeniem na angielski. Dotyczy tylko gdy źródło nie jest po angielsku. |
252
+ | `output_format` | `srt` (domyślnie) lub `vtt` |
253
+ | `translate_to_english` | Generuj też plik napisów z tłumaczeniem na angielski. Dotyczy tylko gdy źródło nie jest po angielsku. |
254
+ | `background` | Uruchom jako zadanie w tle. Zwraca ID zadania dla `check_progress`. |
237
255
  | `threads` | Zastąp liczbę wątków CPU |
238
256
 
239
257
  Gdy oba są żądane, dwa pliki są zapisywane obok źródła:
@@ -245,7 +263,7 @@ Gdy oba są żądane, dwa pliki są zapisywane obok źródła:
245
263
  ---
246
264
 
247
265
  ### `analyze_media`
248
- Analizuje plik przed transkrypcją. Zwraca czas trwania, rozmiar, kodek i szacowany czas transkrypcji na CPU i GPU. Dla folderów wyświetla wszystkie pliki w sortowalnej tabeli ze statusem transkrypcji.
266
+ Analizuje pliki przed transkrypcją. Zwraca czas trwania, rozmiar, kodek i szacowany czas transkrypcji na CPU i GPU. Dla folderów wyświetla wszystkie pliki w sortowalnej tabeli ze statusem transkrypcji.
249
267
 
250
268
  | Parametr | Opis |
251
269
  |---|---|
@@ -265,7 +283,7 @@ Wyświetla wszystkie zainstalowane pliki modeli Whisper w katalogu modeli. Pokaz
265
283
  ---
266
284
 
267
285
  ### `download_model`
268
- Pobiera model Whisper bezpośrednio z Hugging Face do katalogu modeli. Przyjmuje nazwę modelu (np. `large-v3-turbo`, `medium.en-q5_0`) i automatycznie obsługuje pobieranie. Pobiera tylko z zaufanych przestrzeni nazw Hugging Face. Po pobraniu aktywuj przez `switch_model`.
286
+ Pobiera model Whisper bezpośrednio z Hugging Face do katalogu modeli. Pobiera tylko z zaufanych przestrzeni nazw Hugging Face. Po pobraniu aktywuj przez `switch_model`.
269
287
 
270
288
  | Parametr | Opis |
271
289
  |---|---|
@@ -301,14 +319,16 @@ Wykrywa sprzęt GPU i potwierdza dostępność akceleracji Vulkan. Raportuje naz
301
319
 
302
320
  Gotowa kompilacja Vulkan automatycznie włącza akcelerację GPU. Przetestowano na AMD Radeon RX Vega 56 (GCN 5. generacji). Każdy GPU z obsługą Vulkan 1.0+ powinien działać, w tym NVIDIA i Intel Arc.
303
321
 
304
- **Porównanie wydajności (model medium.en, plik audio ~5 minut):**
322
+ **Porównanie wydajności (model large-v3, plik audio ~14 minut):**
305
323
 
306
324
  | Sprzęt | Czas |
307
325
  |---|---|
308
- | Tylko CPU (Ryzen 7 2700x, 8 wątków) | 8–12 minut |
309
- | GPU (Vega 56 przez Vulkan) | 20–40 sekund |
326
+ | Tylko CPU (Ryzen 7 2700x, 8 wątków) | ~22 minuty (szacunkowo) |
327
+ | GPU (Vega 56 przez Vulkan) | ~3min 22s |
328
+
329
+ Wykorzystanie GPU podczas transkrypcji wynosi zazwyczaj 15–20% i wraca do stanu bezczynności między plikami.
310
330
 
311
- Wykorzystanie GPU podczas transkrypcji wynosi zazwyczaj 15–20% i wraca do stanu bezczynności między plikami. CPU utrzymuje się na poziomie około 15%.
331
+ Obsługuje Windows 10 i Windows 11.
312
332
 
313
333
  ---
314
334
 
@@ -320,9 +340,25 @@ Dla najlepszej dokładności wielojęzycznej używaj modelu `large-v3`. Modele t
320
340
 
321
341
  **Przykład — obcojęzyczne wideo z napisami:**
322
342
  1. Poproś Claude o wygenerowanie napisów z `language=auto` i `translate_to_english=true`
323
- 2. Whisper wykrywa język i generuje SRT w oryginalnym języku
324
- 3. Drugi przebieg generuje SRT z tłumaczeniem na angielski
325
- 4. Wczytaj dowolny plik w VLC przez Napisy → Dodaj plik napisów
343
+ 2. Whisper wykrywa język i generuje SRT lub VTT w oryginalnym języku
344
+ 3. Drugi przebieg generuje tłumaczenie na angielski
345
+ 4. Wczytaj SRT w VLC przez Napisy → Dodaj plik napisów, lub użyj VTT w dowolnym odtwarzaczu webowym
346
+
347
+ ---
348
+
349
+ ## Prywatność i zgodność
350
+
351
+ whisper-windows-mcp zawiera wbudowaną architekturę prywatności dla wrażliwych i regulowanych treści.
352
+
353
+ **Audio i wideo nigdy nie opuszczają twojego komputera.** Ta gwarancja jest bezwarunkowa.
354
+
355
+ **Tekst transkrypcji** jest inną kwestią — gdy jest zwracany inline w odpowiedzi narzędzia, jest przetwarzany przez API Claude. Dla większości użytkowników jest to oczekiwane zachowanie. Dla treści regulowanych (medycznych, prawnych, finansowych, korporacyjnych) tryb prywatności temu zapobiega.
356
+
357
+ **Tryb prywatności** ogranicza wszystkie odpowiedzi narzędzi tylko do metadanych (nazwa pliku, liczba słów, ścieżka zapisu). Żaden tekst transkrypcji nie jest przesyłany do API Claude w żadnych okolicznościach. Włącz per wywołanie przez `privacy_mode=true` w dowolnym narzędziu transkrypcji, lub globalnie przez `WHISPER_PRIVACY_MODE=true` w konfiguracji.
358
+
359
+ **Brama zgody** — przy pierwszym użyciu w sesji w trybie standardowym, przed zwróceniem jakiegokolwiek tekstu transkrypcji wyświetlane jest pełne ujawnienie prywatności. Musisz jawnie potwierdzić przed kontynuowaniem. Ustaw `WHISPER_CONSENT_ACKNOWLEDGED=true` w konfiguracji, aby pominąć to dla treści niepoufnych.
360
+
361
+ Zobacz [PRIVACY.md](PRIVACY.md) dla pełnego przewodnika zgodności (HIPAA, RODO, tajemnica adwokacka, FERPA, SOX, PCI-DSS).
326
362
 
327
363
  ---
328
364
 
@@ -340,33 +376,20 @@ To narzędzie zostało stworzone, aby zminimalizować interakcje z API Claude. C
340
376
  | `WHISPER_MODEL` | Ścieżka do pliku modelu .bin (wymagana) |
341
377
  | `WHISPER_THREADS` | Zastąp liczbę wątków CPU |
342
378
  | `FFMPEG_PATH` | Ścieżka do ffmpeg jeśli nie ma go w systemowym PATH |
343
- | `WHISPER_PRIVACY_MODE` | **Planowane.** Po ustawieniu na `true` odpowiedzi narzędzi zwracają tylko metadane — żaden tekst transkrypcji nie jest zwracany do Claude. Dla treści regulowanych lub poufnych. Zobacz [PRIVACY.md](PRIVACY.md). |
379
+ | `WHISPER_PRIVACY_MODE` | Gdy `true`, odpowiedzi narzędzi zwracają tylko metadane — żaden tekst transkrypcji nie jest przesyłany do Claude. Dla treści regulowanych lub poufnych. Może być zastąpione per wywołanie przez parametr `privacy_mode`. Zobacz [PRIVACY.md](PRIVACY.md). |
380
+ | `WHISPER_CONSENT_ACKNOWLEDGED` | Gdy `true`, pomija jednorazowe ujawnienie zgody dla sesji przed zwróceniem tekstu transkrypcji. Ustaw po zapoznaniu się z granicami prywatności, gdy przypomnienie nie jest już potrzebne. Nie ma efektu gdy tryb prywatności jest aktywny. |
344
381
 
345
382
  ---
346
383
 
347
- ## Rozwiązywanie problemów
348
-
349
- Zobacz [TROUBLESHOOTING.md](TROUBLESHOOTING.md) dla szczegółowych rozwiązań. Zobacz [PRIVACY.md](PRIVACY.md) jeśli obsługujesz treści regulowane.
384
+ ## Bezpieczeństwo
350
385
 
351
- Szybka lista kontrolna:
352
- - Ścieżki w konfiguracji używają **podwójnych ukośników odwrotnych** (`C:\\whisper\\...`)
353
- - `whisper-cli.exe` istnieje pod skonfigurowaną ścieżką
354
- - Plik modelu `.bin` istnieje pod skonfigurowaną ścieżką
355
- - FFmpeg zainstalowany i dostępny w PATH (`ffmpeg -version` działa)
356
- - Claude Desktop został **w pełni uruchomiony ponownie** po edycji konfiguracji
357
- - Whisper wyświetla się jako **uruchomiony** (zielony znaczek) w Ustawieniach → Deweloper
386
+ **Weryfikacja binarną.** Aby zweryfikować integralność binarium whisper-cli.exe w gotowym wydaniu, sprawdź jego skrót SHA256 w PowerShell:
358
387
 
359
- ---
360
-
361
- ## Bezpieczeństwo i prywatność
362
-
363
- whisper-windows-mcp został zaprojektowany z bezpieczeństwem jako podstawową zasadą.
364
-
365
- **Audio nigdy nie opuszcza twojego komputera.** Żadne pliki audio ani wideo, ścieżki plików ani dane telemetryczne nie są przesyłane na żaden serwer. Żadne API w chmurze nie są potrzebne do podstawowej funkcjonalności.
366
-
367
- **Tekst transkrypcji i granica API.** Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest przetwarzany przez API Claude — opuszcza twój lokalny komputer. Dla większości użytkowników (treści publiczne, podcasty, nagrania streamów) jest to oczekiwane zachowanie. Jeśli obsługujesz nagrania medyczne, prawne, finansowe lub inne regulowane, zobacz [PRIVACY.md](PRIVACY.md) dla wskazówek dotyczących zgodności i opcji konfiguracji.
388
+ ```powershell
389
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
390
+ ```
368
391
 
369
- Planowana jest zmienna środowiskowa `WHISPER_PRIVACY_MODE`, która ograniczy wszystkie odpowiedzi narzędzi tylko do metadanych (nazwa pliku, czas trwania, liczba słów) — żaden tekst transkrypcji nie będzie zwracany do Claude. Jest to prawidłowa konfiguracja dla treści regulowanych lub poufnych.
392
+ Oczekiwany skrót dla binarnego wydania jest udokumentowany na [stronie wydań](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0).
370
393
 
371
394
  **Walidacja danych wejściowych.** Wszystkie ścieżki plików są weryfikowane przed użyciem — ścieżki UNC (`\\server\share`) i sekwencje przechodzenia katalogów (`..`) są odrzucane. Pliki powyżej 10 GB są odrzucane, aby zapobiec wyczerpaniu zasobów.
372
395
 
@@ -376,7 +399,21 @@ Planowana jest zmienna środowiskowa `WHISPER_PRIVACY_MODE`, która ograniczy ws
376
399
 
377
400
  **Przełączanie modeli jest piaskownicowane.** `switch_model` akceptuje tylko pliki `.bin` w skonfigurowanym katalogu modeli. Ścieżki poza tym katalogiem są odrzucane.
378
401
 
379
- **Brak nowych zależności sieciowych.** Pobieranie modeli używa wbudowanego `https` Node.js — żadne zewnętrzne biblioteki HTTP nie są dodawane do pakietu.
402
+ Zobacz [SECURITY.md](SECURITY.md) dla pełnej polityki bezpieczeństwa.
403
+
404
+ ---
405
+
406
+ ## Rozwiązywanie problemów
407
+
408
+ Zobacz [TROUBLESHOOTING.md](TROUBLESHOOTING.md) dla szczegółowych rozwiązań. Zobacz [PRIVACY.md](PRIVACY.md) jeśli obsługujesz treści regulowane.
409
+
410
+ Szybka lista kontrolna:
411
+ - Ścieżki w konfiguracji używają **podwójnych ukośników odwrotnych** (`C:\\whisper\\...`)
412
+ - `whisper-cli.exe` istnieje pod skonfigurowaną ścieżką
413
+ - Plik modelu `.bin` istnieje pod skonfigurowaną ścieżką
414
+ - FFmpeg zainstalowany i dostępny w PATH (`ffmpeg -version` działa)
415
+ - Claude Desktop został **w pełni uruchomiony ponownie** po edycji konfiguracji
416
+ - Whisper wyświetla się jako **uruchomiony** (zielony znaczek) w Ustawieniach → Deweloper
380
417
 
381
418
  ---
382
419
 
@@ -384,7 +421,7 @@ Planowana jest zmienna środowiskowa `WHISPER_PRIVACY_MODE`, która ograniczy ws
384
421
 
385
422
  **Użytek niekomercyjny:** MIT — bezpłatny do użytku osobistego, edukacyjnego i niekomercyjnego. Zobacz [LICENSE](LICENSE).
386
423
 
387
- **Użytek komercyjny:** Do użytku biznesowego, zawodowego lub generującego przychody wymagana jest osobna umowa licencji komercyjnej. Warunki i dane kontaktowe — w [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md).
424
+ **Użytek komercyjny:** Do użytku biznesowego, zawodowego lub generującego przychody wymagana jest osobna umowa licencji komercyjnej. Warunki i dane kontaktowe — w [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md).
388
425
 
389
426
  ## Wkład
390
427
 
package/README.pt-BR.md CHANGED
@@ -17,6 +17,7 @@ Após a instalação, basta falar diretamente no Claude Desktop:
17
17
  - *"Inicie a transcrição em lote de todos os arquivos nesta pasta"*
18
18
  - *"Quanto tempo vai levar para transcrever esses arquivos?"*
19
19
  - *"Verifique se a aceleração por GPU está funcionando"*
20
+ - *"Transcreva este arquivo no modo de privacidade"*
20
21
 
21
22
  ---
22
23
 
@@ -163,50 +164,54 @@ Transcreve um único arquivo. Suporta modo de bloqueio (padrão) ou em segundo p
163
164
  |---|---|
164
165
  | `file_path` | Caminho absoluto para o arquivo (obrigatório) |
165
166
  | `language` | Código do idioma (`pt`, `en`, `ja` etc.) ou `auto` para detecção automática. Padrão: `en` |
166
- | `output_format` | `text` (padrão), `timestamps`, `json` ou `srt` |
167
+ | `output_format` | `timestamps` (padrão), `text`, `json`, `srt`, `vtt`, `lrc` ou `csv` |
167
168
  | `save_to_file` | Salva a transcrição como .txt ao lado do arquivo de origem |
168
169
  | `background` | Executa como tarefa separada — retorna ID da tarefa imediatamente. Use `check_progress` para monitorar. Recomendado para arquivos com mais de 10 minutos. |
170
+ | `privacy_mode` | Substitui o modo de privacidade para esta chamada. `true` = apenas metadados, sem texto de transcrição transmitido. `false` = retorna texto mesmo se `WHISPER_PRIVACY_MODE=true` globalmente. Omita para usar a configuração global. |
169
171
  | `threads` | Substitui o número de threads da CPU |
170
- | `temperature` | Temperatura de amostragem 0,0–1,0. Padrão 0,0 (determinístico). Valores mais altos reduzem alucinações em áudio ruidoso. |
172
+ | `temperature` | Temperatura de amostragem 0,0–1,0. Padrão 0,0 (determinístico). |
171
173
  | `prompt` | String de contexto prévio — melhora a precisão para vocabulário específico de domínio ou nomes de falantes. Ex.: `"Nomes: Keemstar, DramaAlert."` |
172
174
  | `condition_on_prev_text` | Reativa o condicionamento de contexto entre segmentos. Padrão false. |
173
- | `beam_size` | Largura de busca beam. Maior = mais preciso, mais lento. Padrão 5. |
174
- | `best_of` | Número de sequências candidatas avaliadas. Padrão 5. |
175
+ | `beam_size` | Largura de busca em feixe. Maior = mais preciso, mais lento. Padrão 5. |
176
+ | `best_of` | Sequências candidatas avaliadas. Padrão 5. |
175
177
  | `gpu_device` | Índice do dispositivo GPU para sistemas multi-GPU. Padrão 0. |
176
- | `processors` | Número de processadores paralelos. Padrão 1. |
178
+ | `processors` | Contagem de processadores paralelos. Padrão 1. |
177
179
  | `word_timestamps` | Uma palavra por segmento com carimbo de tempo. Útil para alinhamento de clipes. |
178
180
  | `max_segment_length` | Comprimento máximo do segmento em caracteres. |
179
181
  | `diarize` | Diarização de falantes estéreo — requer áudio estéreo com falantes em canais separados. |
180
182
  | `vad_model` | Caminho para o arquivo .bin do modelo Silero VAD. Remove silêncio antes de transcrever — reduz alucinações em arquivos ruidosos. |
181
183
  | `offset_t` | Deslocamento de início em milissegundos. |
182
- | `duration` | Duração a processar em milissegundos a partir do deslocamento. |
184
+ | `duration` | Duração a processar a partir do deslocamento em milissegundos. |
183
185
 
184
186
  ---
185
187
 
186
188
  ### `check_progress`
187
189
  Monitora uma tarefa de transcrição em segundo plano iniciada com `transcribe_audio` (background=true).
188
190
 
189
- Retorna o tempo decorrido, o último carimbo de tempo processado, a porcentagem e a transcrição completa ao terminar.
191
+ Retorna o tempo decorrido, o último carimbo de tempo processado e a transcrição completa ao concluir.
190
192
 
191
193
  | Parâmetro | Descrição |
192
194
  |---|---|
193
195
  | `job_id` | ID da tarefa retornado por `transcribe_audio` |
196
+ | `privacy_mode` | Substitui o modo de privacidade para esta chamada. |
194
197
 
195
198
  ---
196
199
 
197
200
  ### `start_batch`
198
- Transcreve automaticamente e em sequência todos os arquivos ainda não transcritos em uma pasta. Ordena por duração (mais curtos primeiro), processa um por um como tarefas em segundo plano e valida cada saída.
201
+ Transcreve automaticamente em sequência todos os arquivos não transcritos em uma pasta. Ordena cronologicamente (os mais curtos primeiro), processa um por um como tarefa em segundo plano e valida cada saída.
199
202
 
200
203
  | Parâmetro | Descrição |
201
204
  |---|---|
202
205
  | `folder_path` | Caminho para a pasta (obrigatório) |
203
206
  | `language` | Código do idioma. Padrão: `en` |
207
+ | `output_format` | `timestamps` (padrão), `text`, `srt`, `vtt`, `lrc`, `csv` |
208
+ | `privacy_mode` | Substitui o modo de privacidade para este lote. |
204
209
  | `threads` | Substitui o número de threads da CPU |
205
210
 
206
211
  ---
207
212
 
208
213
  ### `check_batch_progress`
209
- Monitora um lote em execução. Avança automaticamente para o próximo arquivo quando o atual termina. Retorna o progresso geral, o arquivo atual com carimbo de tempo, o ETA e os arquivos com falha.
214
+ Monitora um lote em execução. Avança automaticamente para o próximo arquivo quando o atual é concluído. Retorna o progresso geral, o arquivo atual com carimbo de tempo, ETA e arquivos com falha.
210
215
 
211
216
  | Parâmetro | Descrição |
212
217
  |---|---|
@@ -215,32 +220,34 @@ Monitora um lote em execução. Avança automaticamente para o próximo arquivo
215
220
  ---
216
221
 
217
222
  ### `transcribe_batch` (interativo)
218
- Processa arquivos um a um com visualização prévia e confirmação antes de cada um. Útil quando você quer revisar à medida que avança.
223
+ Processa arquivos um por um com visualização prévia e confirmação antes de cada arquivo. Útil quando você quer revisar durante o processo.
219
224
 
220
225
  | Parâmetro | Descrição |
221
226
  |---|---|
222
227
  | `folder_path` | Caminho para a pasta (obrigatório) |
223
- | `file_index` | Qual arquivo processar (começa em 1). Omita para listar os arquivos primeiro. |
228
+ | `file_index` | Arquivo a processar (começa em 1). Omita para listar arquivos primeiro. |
224
229
  | `language` | Código do idioma. Padrão: `en` |
225
230
  | `recursive` | Incluir subpastas |
226
231
 
227
232
  ---
228
233
 
229
234
  ### `generate_subtitles`
230
- Gera arquivos de legenda SRT. Suporta detecção automática de idioma e saída de tradução para inglês.
235
+ Gera arquivos de legenda. Suporta detecção automática de idioma e saída de tradução para inglês.
231
236
 
232
237
  | Parâmetro | Descrição |
233
238
  |---|---|
234
239
  | `file_path` | Caminho para o arquivo (obrigatório) |
235
240
  | `language` | Código do idioma ou `auto` para detecção automática. Padrão: `en` |
236
- | `translate_to_english` | Também gera `.en.srt` com tradução para inglês. Aplicável apenas quando a fonte não for inglês. |
241
+ | `output_format` | `srt` (padrão) ou `vtt` |
242
+ | `translate_to_english` | Também gera um arquivo de legenda com tradução para inglês. Aplicável apenas quando a fonte não for inglês. |
243
+ | `background` | Executa como tarefa em segundo plano separada. Retorna um ID de tarefa para `check_progress`. |
237
244
  | `threads` | Substitui o número de threads da CPU |
238
245
 
239
246
  Quando ambos são solicitados, dois arquivos são salvos ao lado da origem:
240
247
  - `arquivo.pt.srt` — idioma original
241
248
  - `arquivo.en.srt` — tradução para inglês
242
249
 
243
- > A tradução integrada do Whisper apenas traduz **para o inglês**. Para outros idiomas de destino, processe o conteúdo do arquivo .srt separadamente.
250
+ > A tradução integrada do Whisper traduz apenas **para o inglês**. Para outros idiomas de destino, processe o conteúdo do arquivo `.srt` separadamente.
244
251
 
245
252
  ---
246
253
 
@@ -265,7 +272,7 @@ Lista todos os arquivos de modelo Whisper instalados no seu diretório de modelo
265
272
  ---
266
273
 
267
274
  ### `download_model`
268
- Baixa um modelo Whisper diretamente do Hugging Face para o seu diretório de modelos. Aceita o nome do modelo (ex.: `large-v3-turbo`, `medium.en-q5_0`) e gerencia o download automaticamente. Baixa apenas de namespaces confiáveis do Hugging Face. Após o download, use `switch_model` para ativar.
275
+ Baixa um modelo Whisper diretamente do Hugging Face para o seu diretório de modelos. Baixa apenas de namespaces confiáveis do Hugging Face. Após o download, use `switch_model` para ativar.
269
276
 
270
277
  | Parâmetro | Descrição |
271
278
  |---|---|
@@ -301,14 +308,16 @@ Detecta o hardware GPU e confirma se a aceleração Vulkan está disponível. Re
301
308
 
302
309
  O release Vulkan pré-compilado ativa a aceleração por GPU automaticamente. Testado em AMD Radeon RX Vega 56 (GCN 5ª geração). Qualquer GPU com suporte a Vulkan 1.0+ deve funcionar, incluindo NVIDIA e Intel Arc.
303
310
 
304
- **Comparação de desempenho (modelo medium.en, arquivo de áudio ~5 minutos):**
311
+ **Comparação de desempenho (modelo large-v3, arquivo de áudio ~14 minutos):**
305
312
 
306
313
  | Hardware | Tempo |
307
314
  |---|---|
308
- | Somente CPU (Ryzen 7 2700x, 8 threads) | 8–12 minutos |
309
- | GPU (Vega 56 via Vulkan) | 20–40 segundos |
315
+ | Somente CPU (Ryzen 7 2700x, 8 threads) | ~22 minutos (estimado) |
316
+ | GPU (Vega 56 via Vulkan) | ~3 min 22 seg |
310
317
 
311
- A utilização da GPU durante a transcrição é tipicamente de 15–20%, voltando ao estado ocioso entre os arquivos. A CPU fica em torno de 15%.
318
+ A utilização da GPU durante a transcrição é tipicamente de 15–20%, voltando ao estado ocioso entre os arquivos.
319
+
320
+ Compatível com Windows 10 e Windows 11. Nenhuma configuração específica para Windows 11 é necessária — a ferramenta não faz chamadas diretas à API Win32 e funciona em ambos os sistemas operacionais.
312
321
 
313
322
  ---
314
323
 
@@ -320,9 +329,25 @@ Para a melhor precisão multilíngue, use o modelo `large-v3`. Modelos somente i
320
329
 
321
330
  **Exemplo — vídeo em língua estrangeira com legendas:**
322
331
  1. Peça ao Claude para gerar legendas com `language=auto` e `translate_to_english=true`
323
- 2. O Whisper detecta o idioma e gera o SRT no idioma original
324
- 3. Uma segunda passagem gera o SRT com tradução para inglês
325
- 4. Carregue qualquer um dos arquivos no VLC via Legendas → Adicionar Arquivo de Legenda
332
+ 2. O Whisper detecta o idioma e gera o SRT ou VTT no idioma original
333
+ 3. Uma segunda passagem gera a tradução para inglês
334
+ 4. Carregue o SRT no VLC via Legendas → Adicionar Arquivo de Legenda, ou use o VTT em qualquer player web
335
+
336
+ ---
337
+
338
+ ## Privacidade e conformidade
339
+
340
+ O whisper-windows-mcp inclui uma arquitetura de privacidade integrada para conteúdo sensível e regulamentado.
341
+
342
+ **O áudio e vídeo nunca saem da sua máquina.** Essa garantia é incondicional.
343
+
344
+ **O texto de transcrição** é diferente — quando retornado inline em uma resposta de ferramenta, é processado pela API do Claude. Para a maioria dos usuários isso é o comportamento esperado. Para conteúdo regulamentado (médico, jurídico, financeiro, corporativo), o modo de privacidade previne isso.
345
+
346
+ **O modo de privacidade** restringe todas as respostas das ferramentas apenas a metadados (nome do arquivo, contagem de palavras, caminho de salvamento). Nenhum texto de transcrição é transmitido à API do Claude em nenhuma circunstância. Ative por chamada com `privacy_mode=true` em qualquer ferramenta de transcrição, ou globalmente via `WHISPER_PRIVACY_MODE=true` na sua configuração.
347
+
348
+ **Porta de consentimento** — no primeiro uso por sessão no modo padrão, uma divulgação de privacidade completa é exibida antes que qualquer texto de transcrição seja retornado. Você deve confirmar explicitamente antes de continuar. Defina `WHISPER_CONSENT_ACKNOWLEDGED=true` na sua configuração para ignorar isso para conteúdo não sensível.
349
+
350
+ Veja [PRIVACY.md](PRIVACY.md) para orientação de conformidade completa (HIPAA, GDPR, privilégio advogado-cliente, FERPA, SOX, PCI-DSS).
326
351
 
327
352
  ---
328
353
 
@@ -340,33 +365,20 @@ Esta ferramenta foi criada para minimizar as interações com a API do Claude. T
340
365
  | `WHISPER_MODEL` | Caminho para o arquivo de modelo .bin (obrigatório) |
341
366
  | `WHISPER_THREADS` | Substitui o número de threads da CPU |
342
367
  | `FFMPEG_PATH` | Caminho para o ffmpeg se não estiver no PATH do sistema |
343
- | `WHISPER_PRIVACY_MODE` | **Planejado.** Quando definido como `true`, as respostas das ferramentas retornam apenas metadados — nenhum texto de transcrição é retornado ao Claude. Para conteúdo regulamentado ou confidencial. Veja [PRIVACY.md](PRIVACY.md). |
344
-
345
- ---
346
-
347
- ## Solução de problemas
348
-
349
- Veja [TROUBLESHOOTING.md](TROUBLESHOOTING.md) para soluções detalhadas. Veja [PRIVACY.md](PRIVACY.md) se você lida com conteúdo regulamentado.
350
-
351
- Lista de verificação rápida:
352
- - Caminhos na configuração usam **barras invertidas duplas** (`C:\\whisper\\...`)
353
- - `whisper-cli.exe` existe no caminho configurado
354
- - O arquivo de modelo `.bin` existe no caminho configurado
355
- - FFmpeg instalado e no PATH (`ffmpeg -version` funciona)
356
- - Claude Desktop foi **completamente reiniciado** após editar a configuração
357
- - Whisper aparece como **em execução** (emblema verde) em Configurações → Desenvolvedor
368
+ | `WHISPER_PRIVACY_MODE` | Defina como `true` para que todas as respostas das ferramentas retornem apenas metadados — nenhum texto de transcrição retornado ao Claude. Para conteúdo regulamentado ou confidencial. Pode ser substituído por chamada com o parâmetro `privacy_mode`. Veja [PRIVACY.md](PRIVACY.md). |
369
+ | `WHISPER_CONSENT_ACKNOWLEDGED` | Defina como `true` para suprimir a divulgação de consentimento única por sessão exibida antes de retornar texto de transcrição. Defina quando você entende os limites de privacidade e não precisa mais do lembrete. Sem efeito quando o modo de privacidade está ativo. |
358
370
 
359
371
  ---
360
372
 
361
- ## Segurança e privacidade
362
-
363
- O whisper-windows-mcp foi projetado com segurança como princípio central.
373
+ ## Segurança
364
374
 
365
- **O áudio nunca sai da sua máquina.** Nenhum arquivo de áudio ou vídeo, caminho de arquivo ou telemetria é transmitido para qualquer servidor. Nenhuma API de nuvem é necessária para a funcionalidade principal.
375
+ **Verificação do binário.** Para verificar a integridade do binário whisper-cli.exe no release pré-compilado, verifique o hash SHA256 no PowerShell:
366
376
 
367
- **Texto de transcrição e o limite da API.** Quando uma resposta de ferramenta inclui texto de transcrição, esse texto é processado pela API do Claude — ele sai da sua máquina local. Para a maioria dos usuários (conteúdo público, podcasts, gravações de streaming) isso é um comportamento esperado. Se você lida com gravações médicas, jurídicas, financeiras ou outras regulamentadas, veja [PRIVACY.md](PRIVACY.md) para orientação de conformidade e opções de configuração.
377
+ ```powershell
378
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
379
+ ```
368
380
 
369
- A variável de ambiente `WHISPER_PRIVACY_MODE` está planejada e limitará todas as respostas das ferramentas apenas a metadados (nome do arquivo, duração, contagem de palavras) — nenhum texto de transcrição será retornado ao Claude. Esta é a configuração correta para conteúdo regulamentado ou confidencial.
381
+ O hash esperado está documentado na [página de releases](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0).
370
382
 
371
383
  **Validação de entrada.** Todos os caminhos de arquivo são validados antes do uso — caminhos UNC (`\\server\share`) e sequências de travessia de diretório (`..`) são rejeitados. Arquivos acima de 10 GB são rejeitados para evitar esgotamento de recursos.
372
384
 
@@ -376,7 +388,21 @@ A variável de ambiente `WHISPER_PRIVACY_MODE` está planejada e limitará todas
376
388
 
377
389
  **Troca de modelos é isolada em sandbox.** `switch_model` aceita apenas arquivos `.bin` dentro do diretório de modelos configurado. Caminhos fora desse diretório são rejeitados.
378
390
 
379
- **Sem novas dependências de rede.** Os downloads de modelos usam o `https` integrado do Node.js — nenhuma biblioteca HTTP externa é adicionada ao pacote.
391
+ Veja [SECURITY.md](SECURITY.md) para a política de segurança completa.
392
+
393
+ ---
394
+
395
+ ## Solução de problemas
396
+
397
+ Veja [TROUBLESHOOTING.md](TROUBLESHOOTING.md) para soluções detalhadas. Veja [PRIVACY.md](PRIVACY.md) se você lida com conteúdo regulamentado.
398
+
399
+ Lista de verificação rápida:
400
+ - Caminhos na configuração usam **barras invertidas duplas** (`C:\\whisper\\...`)
401
+ - `whisper-cli.exe` existe no caminho configurado
402
+ - O arquivo de modelo `.bin` existe no caminho configurado
403
+ - FFmpeg instalado e no PATH (`ffmpeg -version` funciona)
404
+ - Claude Desktop foi **completamente reiniciado** após editar a configuração
405
+ - Whisper aparece como **em execução** (emblema verde) em Configurações → Desenvolvedor
380
406
 
381
407
  ---
382
408
 
@@ -384,7 +410,7 @@ A variável de ambiente `WHISPER_PRIVACY_MODE` está planejada e limitará todas
384
410
 
385
411
  **Uso não comercial:** MIT — gratuito para uso pessoal, educacional e não comercial. Veja [LICENSE](LICENSE).
386
412
 
387
- **Uso comercial:** É necessário um contrato de licença comercial separado para qualquer uso empresarial, profissional ou que gere receita. Veja [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md) para os termos e informações de contato.
413
+ **Uso comercial:** É necessário um contrato de licença comercial separado para qualquer uso empresarial, profissional ou que gere receita. Veja [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) para os termos e informações de contato.
388
414
 
389
415
  ## Contribuições
390
416