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.
- package/{LICENSE-COMMERCIAL.md → COMMERCIAL-LICENSE.md} +58 -58
- package/LICENSE +40 -40
- package/PRIVACY.es.md +192 -135
- package/PRIVACY.id.md +192 -135
- package/PRIVACY.ja.md +192 -135
- package/PRIVACY.ko.md +192 -135
- package/PRIVACY.md +192 -135
- package/PRIVACY.pl.md +192 -135
- package/PRIVACY.pt-BR.md +192 -135
- package/PRIVACY.ro.md +192 -135
- package/PRIVACY.uk.md +192 -135
- package/PRIVACY.vi.md +192 -135
- package/README.es.md +74 -48
- package/README.id.md +77 -40
- package/README.ja.md +100 -72
- package/README.ko.md +63 -37
- package/README.md +76 -39
- package/README.pl.md +77 -40
- package/README.pt-BR.md +71 -45
- package/README.ro.md +78 -41
- package/README.uk.md +77 -40
- package/README.vi.md +67 -41
- package/ROADMAP.es.md +110 -48
- package/ROADMAP.id.md +77 -104
- package/ROADMAP.ja.md +84 -123
- package/ROADMAP.ko.md +73 -97
- package/ROADMAP.pl.md +104 -44
- package/ROADMAP.pt-BR.md +78 -102
- package/ROADMAP.ro.md +102 -44
- package/ROADMAP.uk.md +65 -97
- package/ROADMAP.vi.md +78 -102
- package/SECURITY.es.md +64 -47
- package/SECURITY.id.md +64 -47
- package/SECURITY.ja.md +64 -47
- package/SECURITY.ko.md +64 -47
- package/SECURITY.md +21 -4
- package/SECURITY.pl.md +64 -47
- package/SECURITY.pt-BR.md +64 -47
- package/SECURITY.ro.md +64 -47
- package/SECURITY.uk.md +64 -47
- package/SECURITY.vi.md +64 -47
- package/TROUBLESHOOTING.es.md +309 -323
- package/TROUBLESHOOTING.id.md +333 -323
- package/TROUBLESHOOTING.ja.md +399 -286
- package/TROUBLESHOOTING.ko.md +309 -323
- package/TROUBLESHOOTING.pl.md +355 -323
- package/TROUBLESHOOTING.pt-BR.md +309 -323
- package/TROUBLESHOOTING.ro.md +355 -323
- package/TROUBLESHOOTING.uk.md +369 -323
- package/TROUBLESHOOTING.vi.md +309 -323
- package/dist/index.js +591 -216
- package/package.json +45 -45
- 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` | `
|
|
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).
|
|
171
|
-
| `prompt` | Ciąg kontekstu poprzedniego — poprawia dokładność dla słownictwa dziedzinowego lub imion mówców.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
| `
|
|
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
|
|
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.
|
|
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
|
|
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) |
|
|
309
|
-
| GPU (Vega 56 przez Vulkan) |
|
|
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
|
-
|
|
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
|
|
325
|
-
4. Wczytaj
|
|
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` |
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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` | `
|
|
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).
|
|
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
|
|
174
|
-
| `best_of` |
|
|
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` |
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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` |
|
|
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
|
|
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
|
-
| `
|
|
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
|
|
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.
|
|
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
|
|
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) |
|
|
309
|
-
| GPU (Vega 56 via Vulkan) |
|
|
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.
|
|
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
|
|
325
|
-
4. Carregue
|
|
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` |
|
|
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
|
|
362
|
-
|
|
363
|
-
O whisper-windows-mcp foi projetado com segurança como princípio central.
|
|
373
|
+
## Segurança
|
|
364
374
|
|
|
365
|
-
**
|
|
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
|
-
|
|
377
|
+
```powershell
|
|
378
|
+
Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
|
|
379
|
+
```
|
|
368
380
|
|
|
369
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|