whisper-windows-mcp 2.2.2 → 2.3.0

package/README.ro.md

@@ -17,6 +17,7 @@ După instalare, poți spune direct în Claude Desktop:
 - *"Începe transcrierea în lot a tuturor fișierelor din acest folder"*
 - *"Cât timp va dura să transcrii aceste fișiere?"*
 - *"Verifică dacă accelerarea GPU funcționează"*
+- *"Transcrie acest fișier în modul de confidențialitate"*
 
 ---
 
@@ -87,7 +88,7 @@ Folosește `download_model` în Claude Desktop pentru instalare directă. Pentru
 
 ## Pasul 3 — Instalarea FFmpeg
 
-FFmpeg este necesar pentru fișiere video și formate audio native.
+FFmpeg este necesar pentru fișiere video și formate audio non-native.
 
 Instalare via winget:
 ```
@@ -163,12 +164,13 @@ Transcrie un singur fișier. Suportă modul de blocare (implicit) sau în fundal
 |---|---|
 | `file_path` | Calea absolută către fișier (obligatoriu) |
 | `language` | Cod limbă (`ro`, `en`, `ja` etc.) sau `auto` pentru detectare automată. Implicit: `en` |
-| `output_format` | `text` (implicit), `timestamps`, `json` sau `srt` |
+| `output_format` | `timestamps` (implicit), `text`, `json`, `srt`, `vtt`, `lrc` sau `csv` |
 | `save_to_file` | Salvează transcrierea ca .txt lângă fișierul sursă |
 | `background` | Rulează ca sarcină separată — returnează imediat ID-ul sarcinii. Folosește `check_progress` pentru monitorizare. Recomandat pentru fișiere de peste 10 minute. |
+| `privacy_mode` | Suprascrie modul de confidențialitate pentru acest apel. `true` = doar metadate, niciun text de transcriere nu este transmis. `false` = returnează text chiar dacă `WHISPER_PRIVACY_MODE=true` global. Omite pentru a folosi setarea globală. |
 | `threads` | Suprascrie numărul de fire CPU |
-| `temperature` | Temperatura de eșantionare 0,0–1,0. Implicit 0,0 (determinist). Valori mai mari reduc halucinațiile în audio zgomotos. |
-| `prompt` | Șir de context anterior — îmbunătățește precizia pentru vocabular specific domeniului sau nume de vorbitori. Ex.: `"Nume: Keemstar, DramaAlert."` |
+| `temperature` | Temperatura de eșantionare 0,0–1,0. Implicit 0,0 (determinist). |
+| `prompt` | Șir de context anterior — îmbunătățește precizia pentru vocabular specific domeniului sau nume de vorbitori. |
 | `condition_on_prev_text` | Reactivează condiționarea contextului între segmente. Implicit false. |
 | `beam_size` | Lățimea de căutare beam. Mai mare = mai precis, mai lent. Implicit 5. |
 | `best_of` | Numărul de secvențe candidate evaluate. Implicit 5. |
@@ -181,32 +183,44 @@ Transcrie un singur fișier. Suportă modul de blocare (implicit) sau în fundal
 | `offset_t` | Decalajul de pornire în milisecunde. |
 | `duration` | Durata de procesat în milisecunde de la decalaj. |
 
+**Formate de ieșire:**
+- `timestamps` — segmente cu marcaje de timp, ex. `[00:00:01.230 --> 00:00:04.560]  Bună ziua` (implicit)
+- `text` — text simplu fără coduri de timp
+- `json` — JSON structurat (doar modul de blocare)
+- `srt` — fișier subtitrări SubRip salvat lângă sursă
+- `vtt` — fișier subtitrări WebVTT salvat lângă sursă
+- `lrc` — format LRC versuri/karaoke salvat lângă sursă
+- `csv` — CSV cu marcaje de timp salvat lângă sursă
+
 ---
 
 ### `check_progress`
 Monitorizează o sarcină de transcriere în fundal pornită cu `transcribe_audio` (background=true).
 
-Returnează timpul scurs, ultimul marcaj de timp procesat, procentul și transcrierea completă la finalizare.
+Returnează timpul scurs, ultimul marcaj de timp procesat și transcrierea completă la finalizare.
 
 | Parametru | Descriere |
 |---|---|
 | `job_id` | ID-ul sarcinii returnat de `transcribe_audio` |
+| `privacy_mode` | Suprascrie modul de confidențialitate pentru această verificare. `true` = doar metadate, indiferent de modul în care sarcina a fost pornită. |
 
 ---
 
 ### `start_batch`
-Transcrie automat și secvențial toate fișierele netranscrise dintr-un folder. Sortează după durată (cele mai scurte primele), procesează câte unul ca sarcini în fundal și validează fiecare ieșire.
+Transcrie automat și secvențial toate fișierele netranscrise dintr-un folder. Sortează după durată (cele mai scurte primele), procesează câte unul ca sarcini în fundal și validează fiecare ieșire. Lotul avansează automat după finalizarea fiecărui fișier — nu este necesară interogare.
 
 | Parametru | Descriere |
 |---|---|
 | `folder_path` | Calea către folder (obligatoriu) |
 | `language` | Cod limbă. Implicit: `en` |
 | `threads` | Suprascrie numărul de fire CPU |
+| `output_format` | `timestamps` (implicit) sau `text` |
+| `privacy_mode` | Suprascrie modul de confidențialitate. O confirmare este necesară înainte de începerea lotului; toate fișierele sunt apoi procesate nesupravegheate. Niciun text de transcriere nu este returnat. |
 
 ---
 
 ### `check_batch_progress`
-Monitorizează un lot în execuție. Avansează automat la fișierul următor când cel curent se termină. Returnează progresul general, fișierul curent cu marcaj de timp, ETA și fișierele cu erori.
+Monitorizează un lot în execuție. Avansează automat la fișierul următor când cel curent se termină. Returnează progresul general, fișierul curent cu marcaj de timp și fișierele cu erori.
 
 | Parametru | Descriere |
 |---|---|
@@ -223,17 +237,21 @@ Procesează fișierele unul câte unul cu previzualizare și confirmare înainte
 | `file_index` | Ce fișier să proceseze (începând de la 1). Omite pentru a lista fișierele mai întâi. |
 | `language` | Cod limbă. Implicit: `en` |
 | `recursive` | Include subdirectoare |
+| `output_format` | `timestamps` (implicit) sau `text` |
+| `privacy_mode` | Suprascrie modul de confidențialitate. Confirmare necesară înainte de fiecare fișier; sunt returnate doar metadate. |
 
 ---
 
 ### `generate_subtitles`
-Generează fișiere de subtitrări SRT. Suportă detectarea automată a limbii și ieșire cu traducere în engleză.
+Generează fișiere de subtitrări. Suportă detectarea automată a limbii și ieșire cu traducere în engleză. Generează SRT (compatibilitate maximă) sau WebVTT (web și video HTML5).
 
 | Parametru | Descriere |
 |---|---|
 | `file_path` | Calea către fișier (obligatoriu) |
 | `language` | Cod limbă sau `auto` pentru detectare automată. Implicit: `en` |
-| `translate_to_english` | Generează și `.en.srt` cu traducere în engleză. Se aplică doar când sursa nu este în engleză. |
+| `output_format` | `srt` (implicit) sau `vtt` |
+| `translate_to_english` | Generează și un fișier de subtitrări cu traducere în engleză. Se aplică doar când sursa nu este în engleză. |
+| `background` | Rulează ca sarcină în fundal. Returnează ID sarcină pentru `check_progress`. |
 | `threads` | Suprascrie numărul de fire CPU |
 
 Când ambele sunt solicitate, două fișiere sunt salvate lângă sursă:
@@ -245,7 +263,7 @@ Când ambele sunt solicitate, două fișiere sunt salvate lângă sursă:
 ---
 
 ### `analyze_media`
-Analizează un fișier înainte de transcriere. Returnează durata, dimensiunea, codecul și timpul estimat de transcriere pe CPU și GPU. Pentru foldere, afișează toate fișierele într-un tabel sortabil cu starea transcrierii.
+Analizează fișierele înainte de transcriere. Returnează durata, dimensiunea, codecul și timpul estimat de transcriere pe CPU și GPU. Pentru foldere, afișează toate fișierele într-un tabel sortabil cu starea transcrierii.
 
 | Parametru | Descriere |
 |---|---|
@@ -265,7 +283,7 @@ Listează toate fișierele model Whisper instalate în directorul tău de modele
 ---
 
 ### `download_model`
-Descarcă un model Whisper direct de la Hugging Face în directorul tău de modele. Acceptă numele modelului (ex.: `large-v3-turbo`, `medium.en-q5_0`) și gestionează automat descărcarea. Descarcă doar din spații de nume Hugging Face de încredere. După descărcare, folosește `switch_model` pentru activare.
+Descarcă un model Whisper direct de la Hugging Face în directorul tău de modele. Descarcă doar din spații de nume Hugging Face de încredere. După descărcare, folosește `switch_model` pentru activare.
 
 | Parametru | Descriere |
 |---|---|
@@ -301,14 +319,16 @@ Detectează hardware-ul GPU și confirmă dacă accelerarea Vulkan este disponib
 
 Versiunea Vulkan precompilată activează automat accelerarea GPU. Testat pe AMD Radeon RX Vega 56 (GCN generația 5). Orice GPU cu suport Vulkan 1.0+ ar trebui să funcționeze, inclusiv NVIDIA și Intel Arc.
 
-**Comparație performanță (model medium.en, fișier audio ~5 minute):**
+**Comparație performanță (model large-v3, fișier audio ~14 minute):**
 
 | Hardware | Timp |
 |---|---|
-| Numai CPU (Ryzen 7 2700x, 8 fire) | 8–12 minute |
-| GPU (Vega 56 prin Vulkan) | 20–40 secunde |
+| Numai CPU (Ryzen 7 2700x, 8 fire) | ~22 minute (estimat) |
+| GPU (Vega 56 prin Vulkan) | ~3min 22s |
+
+Utilizarea GPU în timpul transcrierii este de obicei 15–20%, revenind la inactiv între fișiere.
 
-Utilizarea GPU în timpul transcrierii este de obicei 15–20%, revenind la inactiv între fișiere. CPU-ul se menține la aproximativ 15%.
+Suportă Windows 10 și Windows 11.
 
 ---
 
@@ -320,9 +340,25 @@ Pentru cea mai bună precizie multilingvă, folosește modelul `large-v3`. Model
 
 **Exemplu — video în limbă străină cu subtitrări:**
 1. Cere lui Claude să genereze subtitrări cu `language=auto` și `translate_to_english=true`
-2. Whisper detectează limba și generează SRT în limba originală
-3. O a doua trecere generează SRT cu traducere în engleză
-4. Încarcă oricare fișier în VLC prin Subtitrări → Adaugă fișier de subtitrări
+2. Whisper detectează limba și generează SRT sau VTT în limba originală
+3. O a doua trecere generează traducerea în engleză
+4. Încarcă SRT în VLC prin Subtitrări → Adaugă fișier de subtitrări, sau folosește VTT în orice player web
+
+---
+
+## Confidențialitate și conformitate
+
+whisper-windows-mcp include o arhitectură de confidențialitate integrată pentru conținut sensibil și reglementat.
+
+**Audio și video nu părăsesc niciodată calculatorul tău.** Această garanție este necondiționată.
+
+**Textul de transcriere** este altceva — când este returnat inline într-un răspuns al instrumentului, este procesat de API-ul Claude. Pentru majoritatea utilizatorilor acesta este comportamentul așteptat. Pentru conținut reglementat (medical, juridic, financiar, corporativ) modul de confidențialitate previne aceasta.
+
+**Modul de confidențialitate** restricționează toate răspunsurile instrumentelor doar la metadate (numele fișierului, numărul de cuvinte, calea de salvare). Niciun text de transcriere nu este transmis la API-ul Claude în nicio circumstanță. Activează per apel prin `privacy_mode=true` în orice instrument de transcriere, sau global prin `WHISPER_PRIVACY_MODE=true` în configurație.
+
+**Poarta de consimțământ** — la prima utilizare per sesiune în modul standard, înainte de returnarea oricărui text de transcriere este afișată o dezvăluire completă de confidențialitate. Trebuie să confirmi explicit înainte de a continua. Setează `WHISPER_CONSENT_ACKNOWLEDGED=true` în configurație pentru a sări aceasta pentru conținut non-sensibil.
+
+Vezi [PRIVACY.md](PRIVACY.md) pentru ghidul complet de conformitate (HIPAA, GDPR, privilegiu avocat-client, FERPA, SOX, PCI-DSS).
 
 ---
 
@@ -340,43 +376,44 @@ Acest instrument a fost creat pentru a minimiza interacțiunile cu API-ul Claude
 | `WHISPER_MODEL` | Calea către fișierul model .bin (obligatoriu) |
 | `WHISPER_THREADS` | Suprascrie numărul de fire CPU |
 | `FFMPEG_PATH` | Calea către ffmpeg dacă nu este în PATH-ul sistemului |
-| `WHISPER_PRIVACY_MODE` | **Planificat.** Când este setat la `true`, răspunsurile instrumentelor returnează doar metadate — niciun text de transcriere nu este returnat lui Claude. Pentru conținut reglementat sau confidențial. Vezi [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_PRIVACY_MODE` | Când `true`, răspunsurile instrumentelor returnează doar metadate — niciun text de transcriere nu este transmis lui Claude. Pentru conținut reglementat sau confidențial. Poate fi suprascris per apel prin parametrul `privacy_mode`. Vezi [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_CONSENT_ACKNOWLEDGED` | Când `true`, suprimă dezvăluirea de consimțământ unică per sesiune înainte de returnarea textului de transcriere. Setează după ce ai revizuit limitele de confidențialitate când memento-ul nu mai este necesar. Nu are efect când modul de confidențialitate este activ. |
 
 ---
 
-## Depanare
+## Securitate
 
-Vezi [TROUBLESHOOTING.md](TROUBLESHOOTING.md) pentru soluții detaliate. Vezi [PRIVACY.md](PRIVACY.md) dacă gestionezi conținut reglementat.
+**Verificarea binarului.** Pentru a verifica integritatea binarului whisper-cli.exe din versiunea precompilată, verifică hash-ul său SHA256 în PowerShell:
 
-Listă de verificare rapidă:
-- Căile din configurație folosesc **bare oblice inverse duble** (`C:\\whisper\\...`)
-- `whisper-cli.exe` există la calea configurată
-- Fișierul model `.bin` există la calea configurată
-- FFmpeg instalat și în PATH (`ffmpeg -version` funcționează)
-- Claude Desktop a fost **repornit complet** după editarea configurației
-- Whisper apare ca **în execuție** (insignă verde) în Setări → Dezvoltator
-
----
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
 
-## Securitate și confidențialitate
+Hash-ul așteptat pentru binarul de versiune este documentat pe [pagina de versiuni](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0).
 
-whisper-windows-mcp a fost proiectat cu securitatea ca principiu central.
+**Validarea intrărilor.** Toate căile de fișiere sunt validate înainte de utilizare — căile UNC (`\\server\share`) și secvențele de traversare a directoarelor (`..`) sunt respinse. Fișierele peste 10 GB sunt respinse pentru a preveni epuizarea resurselor.
 
-**Audio-ul nu părăsește niciodată calculatorul tău.** Niciun fișier audio sau video, cale de fișier sau telemetrie nu este transmis vreunui server. Niciun API cloud nu este necesar pentru funcționalitatea de bază.
+**Conștientizarea injecției de transcriere.** Fișierele audio pot conține conținut vorbit care, atunci când este transcris, seamănă cu instrucțiuni. Apărările încorporate ale Claude gestionează acest lucru, dar serverul MCP în sine tratează conținutul de transcriere ca date — niciodată ca instrucțiuni.
 
-**Textul de transcriere și limita API.** Când un răspuns al instrumentului include text de transcriere, acel text este procesat de API-ul Claude — părăsește calculatorul tău local. Pentru majoritatea utilizatorilor (conținut public, podcasturi, înregistrări streaming) acesta este un comportament așteptat. Dacă gestionezi înregistrări medicale, juridice, financiare sau alte înregistrări reglementate, vezi [PRIVACY.md](PRIVACY.md) pentru îndrumări privind conformitatea și opțiuni de configurare.
+**Descărcările de modele sunt restricționate.** Instrumentul `download_model` descarcă doar din două spații de nume Hugging Face de încredere (`ggerganov/whisper.cpp` și `ggml-org`). URL-urile arbitrare sunt respinse. Redirecționările sunt validate față de o listă de permise înainte de a fi urmate.
 
-Variabila de mediu `WHISPER_PRIVACY_MODE` este planificată și va limita toate răspunsurile instrumentelor doar la metadate (numele fișierului, durata, numărul de cuvinte) — niciun text de transcriere nu va fi returnat lui Claude. Aceasta este configurația corectă pentru conținut reglementat sau confidențial.
+**Schimbarea modelelor este sandboxată.** `switch_model` acceptă doar fișiere `.bin` în directorul de modele configurat. Căile din afara acelui director sunt respinse.
 
-**Validarea intrărilor.** Toate căile de fișiere sunt validate înainte de utilizare — căile UNC (`\\server\share`) și secvențele de traversare a directoarelor (`..`) sunt respinse. Fișierele peste 10 GB sunt respinse pentru a preveni epuizarea resurselor.
+Vezi [SECURITY.md](SECURITY.md) pentru politica completă de securitate.
 
-**Conștientizarea injecției de transcriere.** Fișierele audio pot conține conținut vorbit care, atunci când este transcris, seamănă cu instrucțiuni. Apărările încorporate ale Claude gestionează acest lucru, dar merită să știi că serverul MCP în sine tratează conținutul de transcriere ca date — niciodată ca instrucțiuni.
+---
 
-**Descărcările de modele sunt restricționate.** Instrumentul `download_model` descarcă doar din două spații de nume Hugging Face de încredere (`ggerganov/whisper.cpp` și `ggml-org`). URL-urile arbitrare sunt respinse. Redirecționările sunt validate față de o listă de permise înainte de a fi urmate.
+## Depanare
 
-**Schimbarea modelelor este sandboxată.** `switch_model` acceptă doar fișiere `.bin` în directorul de modele configurat. Căile din afara acelui director sunt respinse.
+Vezi [TROUBLESHOOTING.md](TROUBLESHOOTING.md) pentru soluții detaliate. Vezi [PRIVACY.md](PRIVACY.md) dacă gestionezi conținut reglementat.
 
-**Fără dependențe noi de rețea.** Descărcările de modele folosesc `https`-ul integrat al Node.js — nicio bibliotecă HTTP externă nu este adăugată la pachet.
+Listă de verificare rapidă:
+- Căile din configurație folosesc **bare oblice inverse duble** (`C:\\whisper\\...`)
+- `whisper-cli.exe` există la calea configurată
+- Fișierul model `.bin` există la calea configurată
+- FFmpeg instalat și în PATH (`ffmpeg -version` funcționează)
+- Claude Desktop a fost **repornit complet** după editarea configurației
+- Whisper apare ca **în execuție** (insignă verde) în Setări → Dezvoltator
 
 ---
 
@@ -384,7 +421,7 @@ Variabila de mediu `WHISPER_PRIVACY_MODE` este planificată și va limita toate
 
 **Utilizare non-comercială:** MIT — gratuit pentru uz personal, educațional și non-comercial. Vezi [LICENSE](LICENSE).
 
-**Utilizare comercială:** Este necesar un acord de licență comercială separat pentru orice utilizare în afaceri, profesională sau generatoare de venituri. Vezi [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md) pentru termeni și informații de contact.
+**Utilizare comercială:** Este necesar un acord de licență comercială separat pentru orice utilizare în afaceri, profesională sau generatoare de venituri. Vezi [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) pentru termeni și informații de contact.
 
 ## Contribuții
 

package/README.uk.md

@@ -17,6 +17,7 @@
 - *"Почни пакетне транскрибування всіх файлів у цій теці"*
 - *"Скільки часу займе транскрибування цих файлів?"*
 - *"Перевір, чи працює прискорення GPU"*
+- *"Транскрибуй цей файл у режимі конфіденційності"*
 
 ---
 
@@ -163,16 +164,17 @@ npm install -g whisper-windows-mcp
 |---|---|
 | `file_path` | Абсолютний шлях до файлу (обов'язково) |
 | `language` | Код мови (`uk`, `en`, `ja` тощо) або `auto` для автовизначення. Типово: `en` |
-| `output_format` | `text` (типово), `timestamps`, `json` або `srt` |
+| `output_format` | `timestamps` (типово), `text`, `json`, `srt`, `vtt`, `lrc` або `csv` |
 | `save_to_file` | Зберегти транскрипцію як .txt поруч із вихідним файлом |
 | `background` | Запустити як окреме завдання — одразу повертає ID завдання. Використовуйте `check_progress` для стеження. Рекомендовано для файлів понад 10 хвилин. |
+| `privacy_mode` | Перевизначити режим конфіденційності для цього виклику. `true` = лише метадані, жоден текст транскрипції не передається. `false` = повертати текст навіть якщо `WHISPER_PRIVACY_MODE=true` глобально. Пропустіть для використання глобального налаштування. |
 | `threads` | Перевизначити кількість потоків CPU |
-| `temperature` | Температура вибірки 0.0–1.0. Типово 0.0 (детерміновано). Вищі значення зменшують галюцинації на шумному аудіо. |
+| `temperature` | Температура вибірки 0.0–1.0. Типово 0.0 (детерміновано). |
 | `prompt` | Рядок попереднього контексту — підвищує точність для галузевої лексики або імен доповідачів. Приклад: `"Імена: Keemstar, DramaAlert."` |
 | `condition_on_prev_text` | Повторно увімкнути контекстне обумовлення між сегментами. Типово false. |
 | `beam_size` | Ширина пошуку за промінем. Вище = точніше, повільніше. Типово 5. |
 | `best_of` | Кількість оцінюваних послідовностей-кандидатів. Типово 5. |
-| `gpu_device` | Індекс пристрою GPU для багатогеркових систем. Типово 0. |
+| `gpu_device` | Індекс пристрою GPU для багатогрупових систем. Типово 0. |
 | `processors` | Кількість паралельних процесорів. Типово 1. |
 | `word_timestamps` | Один рядок на слово з мітками часу. Корисно для вирівнювання кліпів. |
 | `max_segment_length` | Максимальна довжина сегмента в символах. |
@@ -181,32 +183,44 @@ npm install -g whisper-windows-mcp
 | `offset_t` | Зміщення початку в мілісекундах. |
 | `duration` | Тривалість опрацювання в мілісекундах від зміщення. |
 
+**Формати виводу:**
+- `timestamps` — сегменти з мітками часу, наприклад `[00:00:01.230 --> 00:00:04.560]  Привіт` (типово)
+- `text` — простий текст без часових кодів
+- `json` — структурований JSON (лише блокувальний режим)
+- `srt` — файл субтитрів SubRip, збережений поруч із джерелом
+- `vtt` — файл субтитрів WebVTT, збережений поруч із джерелом
+- `lrc` — формат LRC текстів/караоке, збережений поруч із джерелом
+- `csv` — CSV з мітками часу, збережений поруч із джерелом
+
 ---
 
 ### `check_progress`
 Стежить за фоновим завданням транскрипції, запущеним через `transcribe_audio` (background=true).
 
-Повертає минулий час, останню опрацьовану мітку часу, відсоток і повну транскрипцію після завершення.
+Повертає минулий час, останню опрацьовану мітку часу і повну транскрипцію після завершення.
 
 | Параметр | Опис |
 |---|---|
 | `job_id` | ID завдання, повернений `transcribe_audio` |
+| `privacy_mode` | Перевизначити режим конфіденційності для цієї перевірки. `true` = лише метадані, незалежно від способу запуску завдання. |
 
 ---
 
 ### `start_batch`
-Автоматично і послідовно транскрибує всі ще не транскрибовані файли в теці. Сортує за тривалістю (від найкоротших), опрацьовує по одному як фонові завдання, перевіряє кожен результат.
+Автоматично і послідовно транскрибує всі ще не транскрибовані файли в теці. Сортує за тривалістю (від найкоротших), опрацьовує по одному як фонові завдання, перевіряє кожен результат. Пакет самостійно просувається після завершення кожного файлу — опитування не потрібно.
 
 | Параметр | Опис |
 |---|---|
 | `folder_path` | Шлях до теки (обов'язково) |
 | `language` | Код мови. Типово: `en` |
 | `threads` | Перевизначити кількість потоків CPU |
+| `output_format` | `timestamps` (типово) або `text` |
+| `privacy_mode` | Перевизначити режим конфіденційності. Перед початком пакету потрібне одне підтвердження; далі всі файли опрацьовуються без нагляду. Текст транскрипції не повертається. |
 
 ---
 
 ### `check_batch_progress`
-Стежить за запущеним пакетом. Автоматично переходить до наступного файлу після завершення поточного. Повертає загальний прогрес, поточний файл з міткою часу, очікуваний час завершення і файли з помилками.
+Стежить за запущеним пакетом. Автоматично переходить до наступного файлу після завершення поточного. Повертає загальний прогрес, поточний файл з міткою часу і файли з помилками.
 
 | Параметр | Опис |
 |---|---|
@@ -223,17 +237,21 @@ npm install -g whisper-windows-mcp
 | `file_index` | Який файл опрацювати (нумерація з 1). Пропустіть, щоб спочатку показати список файлів. |
 | `language` | Код мови. Типово: `en` |
 | `recursive` | Включити підтеки |
+| `output_format` | `timestamps` (типово) або `text` |
+| `privacy_mode` | Перевизначити режим конфіденційності. Підтвердження потрібне перед кожним файлом; повертаються лише метадані. |
 
 ---
 
 ### `generate_subtitles`
-Створює файли субтитрів SRT. Підтримує автовизначення мови та вивід перекладу англійською.
+Створює файли субтитрів. Підтримує автовизначення мови та вивід перекладу англійською. Виводить SRT (найширша сумісність) або WebVTT (веб і HTML5 відео).
 
 | Параметр | Опис |
 |---|---|
 | `file_path` | Шлях до файлу (обов'язково) |
 | `language` | Код мови або `auto` для автовизначення. Типово: `en` |
-| `translate_to_english` | Також створити `.en.srt` з перекладом англійською. Застосовується лише якщо джерело — не англійська. |
+| `output_format` | `srt` (типово) або `vtt` |
+| `translate_to_english` | Також створити файл субтитрів з перекладом англійською. Застосовується лише якщо джерело — не англійська. |
+| `background` | Запустити як фонове завдання. Повертає ID завдання для `check_progress`. |
 | `threads` | Перевизначити кількість потоків CPU |
 
 Коли запитуються обидва варіанти, поруч із джерелом зберігаються два файли:
@@ -245,7 +263,7 @@ npm install -g whisper-windows-mcp
 ---
 
 ### `analyze_media`
-Аналізує файл перед транскрипцією. Повертає тривалість, розмір, кодек і орієнтовний час транскрипції на CPU та GPU. Для теки показує всі файли у таблиці з можливістю сортування й статусом транскрипції.
+Аналізує файли перед транскрипцією. Повертає тривалість, розмір, кодек і орієнтовний час транскрипції на CPU та GPU. Для теки показує всі файли у таблиці з можливістю сортування й статусом транскрипції.
 
 | Параметр | Опис |
 |---|---|
@@ -265,7 +283,7 @@ npm install -g whisper-windows-mcp
 ---
 
 ### `download_model`
-Завантажує модель Whisper безпосередньо з Hugging Face до вашої теки моделей. Приймає назву моделі (наприклад `large-v3-turbo`, `medium.en-q5_0`) і автоматично виконує завантаження. Завантажує лише з довірених просторів імен Hugging Face. Після завантаження активуйте через `switch_model`.
+Завантажує модель Whisper безпосередньо з Hugging Face до вашої теки моделей. Завантажує лише з довірених просторів імен Hugging Face. Після завантаження активуйте через `switch_model`.
 
 | Параметр | Опис |
 |---|---|
@@ -301,14 +319,16 @@ npm install -g whisper-windows-mcp
 
 Готовий Vulkan-реліз автоматично вмикає прискорення GPU. Протестовано на AMD Radeon RX Vega 56 (GCN 5-го покоління). Будь-який GPU з підтримкою Vulkan 1.0+ має працювати, включно з NVIDIA та Intel Arc.
 
-**Порівняння продуктивності (модель medium.en, аудіофайл ~5 хвилин):**
+**Порівняння продуктивності (модель large-v3, аудіофайл ~14 хвилин):**
 
 | Обладнання | Час |
 |---|---|
-| Лише CPU (Ryzen 7 2700x, 8 потоків) | 8–12 хвилин |
-| GPU (Vega 56 через Vulkan) | 20–40 секунд |
+| Лише CPU (Ryzen 7 2700x, 8 потоків) | ~22 хвилини (орієнтовно) |
+| GPU (Vega 56 через Vulkan) | ~3хв 22с |
+
+Навантаження GPU під час транскрипції зазвичай становить 15–20% і повертається до простою між файлами.
 
-Навантаження GPU під час транскрипції зазвичай становить 15–20% і повертається до простою між файлами. CPU зберігається близько 15%.
+Підтримує Windows 10 і Windows 11.
 
 ---
 
@@ -320,9 +340,25 @@ Whisper може автоматично визначати мову мовлен
 
 **Приклад — іноземне відео із субтитрами:**
 1. Попросіть Claude створити субтитри з `language=auto` і `translate_to_english=true`
-2. Whisper визначає мову і створює SRT рідною мовою
-3. Другий прохід створює SRT з перекладом англійською
-4. Завантажте будь-який файл у VLC через Субтитри → Додати файл субтитрів
+2. Whisper визначає мову і створює SRT або VTT рідною мовою
+3. Другий прохід створює переклад англійською
+4. Завантажте SRT у VLC через Субтитри → Додати файл субтитрів, або використовуйте VTT у будь-якому веб-плеєрі
+
+---
+
+## Конфіденційність і відповідність
+
+whisper-windows-mcp містить вбудовану архітектуру конфіденційності для чутливого і регульованого контенту.
+
+**Аудіо і відео ніколи не покидають ваш комп'ютер.** Ця гарантія є безумовною.
+
+**Текст транскрипції** — інша справа: коли він повертається у відповіді інструменту, він опрацьовується API Claude. Для більшості користувачів це очікувана поведінка. Для регульованого контенту (медичного, юридичного, фінансового, корпоративного) режим конфіденційності запобігає цьому.
+
+**Режим конфіденційності** обмежує всі відповіді інструментів лише метаданими (ім'я файлу, кількість слів, шлях збереження). Жоден текст транскрипції не передається API Claude за жодних обставин. Увімкніть для окремого виклику через `privacy_mode=true` у будь-якому інструменті транскрипції або глобально через `WHISPER_PRIVACY_MODE=true` у конфігурації.
+
+**Ворота згоди** — при першому використанні за сеанс у стандартному режимі перед поверненням будь-якого тексту транскрипції відображається повне розкриття конфіденційності. Ви маєте явно підтвердити перед продовженням. Встановіть `WHISPER_CONSENT_ACKNOWLEDGED=true` у конфігурації, щоб пропустити це для нечутливого контенту.
+
+Дивіться [PRIVACY.md](PRIVACY.md) для повного керівництва з відповідності (HIPAA, GDPR, адвокатська таємниця, FERPA, SOX, PCI-DSS).
 
 ---
 
@@ -340,43 +376,44 @@ Whisper може автоматично визначати мову мовлен
 | `WHISPER_MODEL` | Шлях до файлу моделі .bin (обов'язково) |
 | `WHISPER_THREADS` | Перевизначити кількість потоків CPU |
 | `FFMPEG_PATH` | Шлях до ffmpeg, якщо його немає в системному PATH |
-| `WHISPER_PRIVACY_MODE` | **Планується.** При значенні `true` відповіді інструментів повертають лише метадані — жодний текст транскрипції не передається Claude. Для регульованого або конфіденційного контенту. Дивіться [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_PRIVACY_MODE` | При значенні `true` всі відповіді інструментів повертають лише метадані — жоден текст транскрипції не передається Claude. Для регульованого або конфіденційного контенту. Може бути перевизначено для окремого виклику через параметр `privacy_mode`. Дивіться [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_CONSENT_ACKNOWLEDGED` | При значенні `true` пропускає одноразове розкриття згоди сеансу перед поверненням тексту транскрипції. Встановіть після ознайомлення з межами конфіденційності, коли нагадування більше не потрібне. Не має ефекту, коли режим конфіденційності активний. |
 
 ---
 
-## Усунення несправностей
+## Безпека
 
-Детальні рішення — у [TROUBLESHOOTING.md](TROUBLESHOOTING.md). Якщо ви працюєте з регульованим контентом, дивіться також [PRIVACY.md](PRIVACY.md).
+**Перевірка бінарника.** Щоб перевірити цілісність бінарника whisper-cli.exe у готовому релізі, перевірте його хеш SHA256 у PowerShell:
 
-Швидкий контрольний список:
-- Шляхи в конфігурації використовують **подвійний зворотній слеш** (`C:\\whisper\\...`)
-- `whisper-cli.exe` існує за налаштованим шляхом
-- Файл моделі `.bin` існує за налаштованим шляхом
-- FFmpeg встановлено і доступно в PATH (`ffmpeg -version` працює)
-- Claude Desktop **повністю перезапущено** після редагування конфігурації
-- Whisper відображається як **запущено** (зелений значок) у Налаштуваннях → Розробник
-
----
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
 
-## Безпека та конфіденційність
+Очікуваний хеш для релізного бінарника задокументовано на [сторінці релізів](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0).
 
-whisper-windows-mcp розроблено з безпекою як основним принципом.
+**Перевірка вхідних даних.** Усі шляхи до файлів перевіряються перед використанням — UNC-шляхи (`\\server\share`) і послідовності обходу теки (`..`) відхиляються. Файли понад 10 ГБ відхиляються для запобігання вичерпанню ресурсів.
 
-**Аудіо ніколи не покидає ваш комп'ютер.** Жодні аудіо- чи відеофайли, шляхи до файлів або телеметрія не передаються на жодний сервер. Для основних функцій хмарні API не потрібні.
+**Усвідомлення ін'єкції транскрипції.** Аудіофайли можуть містити вимовлений контент, який після транскрипції нагадує інструкції. Вбудований захист Claude впорається з цим, але варто знати, що сам MCP-сервер обробляє вміст транскрипції як дані — ніколи як інструкції.
 
-**Текст транскрипції та межа API.** Коли відповідь інструменту містить текст транскрипції, цей текст опрацьовується API Claude — він покидає ваш локальний комп'ютер. Для більшості користувачів (публічний контент, подкасти, записи стрімів) це очікувана поведінка. Якщо ви працюєте з медичними, юридичними, фінансовими чи іншими регульованими записами, дивіться [PRIVACY.md](PRIVACY.md) для отримання рекомендацій щодо відповідності та параметрів налаштування.
+**Завантаження моделей обмежено.** Інструмент `download_model` завантажує лише з двох довірених просторів імен Hugging Face (`ggerganov/whisper.cpp` і `ggml-org`). Довільні URL-адреси відхиляються. Переспрямування перевіряються за списком дозволених перед виконанням.
 
-Планується змінна середовища `WHISPER_PRIVACY_MODE`, яка обмежить усі відповіді інструментів лише метаданими (ім'я файлу, тривалість, кількість слів) — жодний текст транскрипції не повертатиметься Claude. Це правильне налаштування для регульованого або конфіденційного контенту.
+**Перемикання моделей у пісочниці.** `switch_model` приймає лише `.bin`-файли з налаштованої теки моделей. Шляхи за межами цієї теки відхиляються.
 
-**Перевірка вхідних даних.** Усі шляхи до файлів перевіряються перед використанням — UNC-шляхи (`\\server\share`) та послідовності обходу теки (`..`) відхиляються. Файли понад 10 ГБ відхиляються для запобігання вичерпанню ресурсів.
+Дивіться [SECURITY.md](SECURITY.md) для повної політики безпеки.
 
-**Усвідомлення ін'єкції транскрипції.** Аудіофайли можуть містити вимовлений контент, який після транскрипції нагадує інструкції. Вбудований захист Claude впорається з цим, але варто знати, що сам MCP-сервер обробляє вміст транскрипції як дані — ніколи як інструкції.
+---
 
-**Завантаження моделей обмежено.** Інструмент `download_model` завантажує лише з двох довірених просторів імен Hugging Face (`ggerganov/whisper.cpp` і `ggml-org`). Довільні URL-адреси відхиляються. Переспрямування перевіряються за списком дозволених перед виконанням.
+## Усунення несправностей
 
-**Перемикання моделей у пісочниці.** `switch_model` приймає лише `.bin`-файли з налаштованої теки моделей. Шляхи за межами цієї теки відхиляються.
+Детальні рішення — у [TROUBLESHOOTING.md](TROUBLESHOOTING.md). Якщо ви працюєте з регульованим контентом, дивіться також [PRIVACY.md](PRIVACY.md).
 
-**Жодних нових мережевих залежностей.** Завантаження моделей використовує вбудований `https` Node.js — жодні зовнішні HTTP-бібліотеки не додаються до пакету.
+Швидкий контрольний список:
+- Шляхи в конфігурації використовують **подвійний зворотній слеш** (`C:\\whisper\\...`)
+- `whisper-cli.exe` існує за налаштованим шляхом
+- Файл моделі `.bin` існує за налаштованим шляхом
+- FFmpeg встановлено і доступно в PATH (`ffmpeg -version` працює)
+- Claude Desktop **повністю перезапущено** після редагування конфігурації
+- Whisper відображається як **запущено** (зелений значок) у Налаштуваннях → Розробник
 
 ---
 
@@ -384,7 +421,7 @@ whisper-windows-mcp розроблено з безпекою як основни
 
 **Некомерційне використання:** MIT — безкоштовно для особистого, освітнього та некомерційного використання. Дивіться [LICENSE](LICENSE).
 
-**Комерційне використання:** Для будь-якого бізнес-, професійного або комерційного використання необхідна окрема комерційна ліцензійна угода. Умови та контактна інформація — у [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md).
+**Комерційне використання:** Для будь-якого бізнес-, професійного або комерційного використання необхідна окрема комерційна ліцензійна угода. Дивіться [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) для умов та контактної інформації.
 
 ## Внески