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/SECURITY.pl.md CHANGED
@@ -1,47 +1,64 @@
1
- # Polityka bezpieczeństwa
2
-
3
- ## Zakres
4
-
5
- whisper-windows-mcp jest narzędziem priorytetyzującym lokalność. Całe przetwarzanie audio odbywa się na twoim komputerze — żadne audio, pliki wideo ani dane osobowe nie są przesyłane na żaden serwer. Powierzchnia ataku jest ograniczona do:
6
-
7
- - Lokalnego systemu plików (ścieżki plików przekazywane do narzędzi)
8
- - Binarnego pliku whisper-cli.exe i jego zależności
9
- - Połączenia MCP Claude Desktop (tylko lokalny IPC)
10
- - Tekstu transkrypcji zwracanego w odpowiedziach narzędzi (patrz Architektura prywatności poniżej)
11
-
12
- ## Architektura prywatności
13
-
14
- **Pliki audio nigdy nie opuszczają twojego komputera.** Ta gwarancja jest bezwarunkowa.
15
-
16
- **Tekst transkrypcji może opuścić twój komputer.** Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest przetwarzany przez API Claude. Jest to standardowe zachowanie MCP, ale tworzy lukę między filozofią projektowania "priorytet lokalny" narzędzia a rzeczywistym przepływem danych dla użytkowników obsługujących treści regulowane lub poufne.
17
-
18
- Planowana jest zmienna środowiskowa `WHISPER_PRIVACY_MODE`, która ograniczy wszystkie odpowiedzi narzędzi tylko do metadanych — żaden tekst transkrypcji nie jest zwracany do API Claude. Jest to planowane rozwiązanie dla wdrożeń medycznych, prawnych, finansowych i korporacyjnych.
19
-
20
- Zobacz [PRIVACY.md](PRIVACY.md) dla pełnego opisu architektury prywatności, wskazówek dotyczących ram zgodności (HIPAA, RODO, tajemnica adwokacka, FERPA, SOX, PCI-DSS) i instrukcji konfiguracji.
21
-
22
- ## Obsługiwane wersje
23
-
24
- Poprawki bezpieczeństwa są stosowane tylko do najnowszej opublikowanej wersji.
25
-
26
- | Wersja | Obsługiwana |
27
- |---|---|
28
- | 2.x (najnowsza) | ✅ |
29
- | 1.x | ❌ |
30
-
31
- ## Zgłaszanie podatności
32
-
33
- **Nie otwieraj publicznych zgłoszeń dla podatności bezpieczeństwa.**
34
-
35
- Użyj prywatnego raportowania podatności GitHub:
36
- 1. Przejdź do [zakładki Security](https://github.com/eviscerations/whisper-windows-mcp/security)
37
- 2. Kliknij "Report a vulnerability"
38
- 3. Opisz problem z wystarczającymi szczegółami do odtworzenia
39
-
40
- Otrzymasz odpowiedź w ciągu 7 dni. Jeśli podatność zostanie potwierdzona, poprawka zostanie wydana tak szybko, jak to możliwe, a ty zostaniesz wymieniony w notatkach wydania, jeśli sobie życzysz.
41
-
42
- ## Znane decyzje projektowe
43
-
44
- - **Iniekcja ścieżki pliku:** Narzędzia akceptują bezwzględne ścieżki plików od Claude. Jest to celowy projekt — narzędzie jest przeznaczone do użytku z Claude Desktop przez właściciela komputera. Nie wystawiaj tego serwera MCP na niezaufany dostęp sieciowy.
45
- - **Brak piaskownicy:** whisper-cli.exe działa z tymi samymi uprawnieniami co Claude Desktop. Jest to standardowe dla lokalnych narzędzi MCP.
46
- - **Pliki tymczasowe:** Pośrednie pliki WAV są zapisywane w `%TEMP%\whisper_tmp_*.wav` i usuwane po transkrypcji. Pliki stanu zadań są zapisywane w `%TEMP%\whisper-mcp-jobs\` i pozostają do ręcznego wyczyszczenia lub do wydania planowanej funkcji automatycznego czyszczenia.
47
- - **Treść transkrypcji:** Tekst transkrypcji zwracany w odpowiedziach narzędzi jest przetwarzany przez API Claude. Jest to udokumentowane i będzie możliwe do rozwiązania przez `WHISPER_PRIVACY_MODE` w przyszłym wydaniu. Zobacz [PRIVACY.md](PRIVACY.md).
1
+ # Polityka bezpieczeństwa
2
+
3
+ ## Zakres
4
+
5
+ whisper-windows-mcp jest narzędziem priorytetyzującym lokalność. Całe przetwarzanie audio odbywa się na twoim komputerze — żadne audio, pliki wideo ani dane osobowe nie są przesyłane na żaden serwer. Powierzchnia ataku jest ograniczona do:
6
+
7
+ - Lokalnego systemu plików (ścieżki plików przekazywane do narzędzi)
8
+ - Binarnego pliku whisper-cli.exe i jego zależności
9
+ - Połączenia MCP Claude Desktop (tylko lokalny IPC)
10
+ - Tekstu transkrypcji zwracanego w odpowiedziach narzędzi (patrz Architektura prywatności poniżej)
11
+
12
+ ## Architektura prywatności
13
+
14
+ **Pliki audio nigdy nie opuszczają twojego komputera.** Ta gwarancja jest bezwarunkowa.
15
+
16
+ **Tekst transkrypcji może opuścić twój komputer** w trybie standardowym. Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest przetwarzany przez API Claude. Jest to standardowe zachowanie MCP, ale tworzy lukę między filozofią projektowania "priorytet lokalny" narzędzia a rzeczywistym przepływem danych dla użytkowników obsługujących treści regulowane lub poufne.
17
+
18
+ **Tryb prywatności** (`WHISPER_PRIVACY_MODE=true` lub `privacy_mode=true` dla pojedynczego wywołania) ogranicza wszystkie odpowiedzi narzędzi tylko do metadanych — żaden tekst transkrypcji nie jest zwracany do API Claude. Jest to właściwa konfiguracja dla wdrożeń medycznych, prawnych, finansowych i korporacyjnych.
19
+
20
+ **Brama trybu prywatności:** gdy tryb prywatności jest aktywny, przed każdą operacją transkrypcji wyświetlane jest wyraźne potwierdzenie ujawnienia. Jest to celowe i nie może być pominięte — zgodność z przepisami wymaga świadomej zgody przed każdą operacją.
21
+
22
+ **Brama zgody:** w trybie standardowym jednorazowe ujawnienie dla sesji jest wyświetlane przed pierwszym zwróceniem tekstu transkrypcji do API. Ustaw `WHISPER_CONSENT_ACKNOWLEDGED=true` w konfiguracji, aby pominąć to dla treści niepoufnych.
23
+
24
+ Zobacz [PRIVACY.md](PRIVACY.md) dla pełnego opisu architektury prywatności, wskazówek dotyczących ram zgodności (HIPAA, RODO, tajemnica adwokacka, FERPA, SOX, PCI-DSS) i instrukcji konfiguracji.
25
+
26
+ ## Weryfikacja binarną
27
+
28
+ Aby zweryfikować integralność binarium `whisper-cli.exe` w gotowym wydaniu, sprawdź jego skrót SHA256 w PowerShell:
29
+
30
+ ```powershell
31
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
32
+ ```
33
+
34
+ Oczekiwany skrót dla każdego binarnego wydania jest opublikowany na [stronie wydań](https://github.com/eviscerations/whisper-windows-mcp/releases). Nie używaj binarnego pliku, którego skrót nie odpowiada oczekiwanemu.
35
+
36
+ ## Obsługiwane wersje
37
+
38
+ Poprawki bezpieczeństwa są stosowane tylko do najnowszej opublikowanej wersji.
39
+
40
+ | Wersja | Obsługiwana |
41
+ |---|---|
42
+ | 2.x (najnowsza) | ✅ |
43
+ | 1.x | ❌ |
44
+
45
+ ## Zgłaszanie podatności
46
+
47
+ **Nie otwieraj publicznych zgłoszeń dla podatności bezpieczeństwa.**
48
+
49
+ Użyj prywatnego raportowania podatności GitHub:
50
+ 1. Przejdź do [zakładki Security](https://github.com/eviscerations/whisper-windows-mcp/security)
51
+ 2. Kliknij "Report a vulnerability"
52
+ 3. Opisz problem z wystarczającymi szczegółami do odtworzenia
53
+
54
+ Otrzymasz odpowiedź w ciągu 7 dni. Jeśli podatność zostanie potwierdzona, poprawka zostanie wydana tak szybko, jak to możliwe, a ty zostaniesz wymieniony w notatkach wydania, jeśli sobie życzysz.
55
+
56
+ ## Znane decyzje projektowe
57
+
58
+ - **Iniekcja ścieżki pliku:** Narzędzia akceptują bezwzględne ścieżki plików od Claude. Jest to celowy projekt — narzędzie jest przeznaczone do użytku z Claude Desktop przez właściciela komputera. Nie wystawiaj tego serwera MCP na niezaufany dostęp sieciowy.
59
+ - **Brak piaskownicy:** whisper-cli.exe działa z tymi samymi uprawnieniami co Claude Desktop. Jest to standardowe dla lokalnych narzędzi MCP.
60
+ - **Pliki tymczasowe:** Pośrednie pliki WAV są zapisywane w `%TEMP%\whisper_tmp_*.wav` i usuwane po transkrypcji. Pliki stanu zadań są zapisywane w `%TEMP%\whisper-mcp-jobs\` i automatycznie czyszczone po 7 dniach przy uruchomieniu serwera.
61
+ - **Treść transkrypcji:** Tekst transkrypcji zwracany w odpowiedziach narzędzi jest przetwarzany przez API Claude w trybie standardowym. Włącz `WHISPER_PRIVACY_MODE=true` lub przekaż `privacy_mode=true` dla pojedynczego wywołania, aby temu zapobiec. Zobacz [PRIVACY.md](PRIVACY.md).
62
+ - **Iniekcja transkrypcji:** Pliki audio mogą zawierać wypowiadaną treść, która po transkrypcji przypomina instrukcje. Wbudowane mechanizmy obronne Claude obsługują to. Sam serwer MCP oznacza całą treść transkrypcji jako niezaufane dane i nigdy nie interpretuje jej jako instrukcji.
63
+ - **Pobieranie modeli:** Narzędzie `download_model` pobiera tylko z dwóch zaufanych przestrzeni nazw Hugging Face (`ggerganov/whisper.cpp` i `ggml-org`). Przekierowania są weryfikowane względem listy dozwolonych przed wykonaniem. Dowolne URL są odrzucane na poziomie kodu.
64
+ - **Przełączanie modeli:** `switch_model` akceptuje tylko pliki `.bin` w skonfigurowanym katalogu modeli. Ścieżki poza tym katalogiem są odrzucane niezależnie od sposobu ich podania.
package/SECURITY.pt-BR.md CHANGED
@@ -1,47 +1,64 @@
1
- # Política de Segurança
2
-
3
- ## Escopo
4
-
5
- O whisper-windows-mcp é uma ferramenta que prioriza o local. Todo o processamento de áudio acontece na sua máquina — nenhum áudio, arquivo de vídeo ou dado pessoal é transmitido para qualquer servidor. A superfície de ataque está limitada a:
6
-
7
- - O sistema de arquivos local (caminhos de arquivo passados às ferramentas)
8
- - O binário whisper-cli.exe e suas dependências
9
- - A conexão MCP do Claude Desktop (apenas IPC local)
10
- - Texto de transcrição retornado nas respostas das ferramentas (veja Arquitetura de Privacidade abaixo)
11
-
12
- ## Arquitetura de Privacidade
13
-
14
- **Arquivos de áudio nunca saem da sua máquina.** Essa garantia é incondicional.
15
-
16
- **Texto de transcrição pode sair da sua máquina.** Quando uma resposta de ferramenta inclui texto de transcrição, esse texto é processado pela API do Claude. Este é o comportamento padrão do MCP, mas cria uma lacuna entre a filosofia de design "prioridade local" da ferramenta e o fluxo de dados real para usuários que lidam com conteúdo regulamentado ou confidencial.
17
-
18
- Uma variável de ambiente `WHISPER_PRIVACY_MODE` está planejada e restringirá todas as respostas das ferramentas apenas a metadados — nenhum texto de transcrição retornado à API do Claude. Esta é a solução pretendida para implantações médicas, jurídicas, financeiras e corporativas.
19
-
20
- Veja [PRIVACY.md](PRIVACY.md) para a descrição completa da arquitetura de privacidade, orientação sobre frameworks de conformidade (HIPAA, GDPR, privilégio advogado-cliente, FERPA, SOX, PCI-DSS) e instruções de configuração.
21
-
22
- ## Versões suportadas
23
-
24
- Correções de segurança são aplicadas apenas à versão publicada mais recente.
25
-
26
- | Versão | Suportada |
27
- |---|---|
28
- | 2.x (mais recente) | ✅ |
29
- | 1.x | ❌ |
30
-
31
- ## Reportando uma vulnerabilidade
32
-
33
- **Não abra uma issue pública para vulnerabilidades de segurança.**
34
-
35
- Use o relatório privado de vulnerabilidade do GitHub:
36
- 1. Vá para a [aba Security](https://github.com/eviscerations/whisper-windows-mcp/security)
37
- 2. Clique em "Report a vulnerability"
38
- 3. Descreva o problema com detalhes suficientes para reproduzi-lo
39
-
40
- Você receberá uma resposta em até 7 dias. Se a vulnerabilidade for confirmada, uma correção será lançada o mais rápido possível e você será creditado nas notas de release se desejar.
41
-
42
- ## Decisões de design conhecidas
43
-
44
- - **Injeção de caminho de arquivo:** As ferramentas aceitam caminhos absolutos de arquivo do Claude. Isso é por design — a ferramenta é destinada a ser usada com o Claude Desktop pelo proprietário da máquina. Não exponha este servidor MCP a acesso de rede não confiável.
45
- - **Sem sandbox:** O whisper-cli.exe é executado com as mesmas permissões que o Claude Desktop. Isso é padrão para ferramentas MCP locais.
46
- - **Arquivos temporários:** Arquivos WAV intermediários são gravados em `%TEMP%\whisper_tmp_*.wav` e excluídos após a transcrição. Arquivos de estado de tarefas são gravados em `%TEMP%\whisper-mcp-jobs\` e persistem até serem limpos manualmente ou até o recurso de limpeza automática planejado ser lançado.
47
- - **Conteúdo de transcrição:** O texto de transcrição retornado nas respostas das ferramentas é processado pela API do Claude. Isso está documentado e será endereçável via `WHISPER_PRIVACY_MODE` em um release futuro. Veja [PRIVACY.md](PRIVACY.md).
1
+ # Política de Segurança
2
+
3
+ ## Escopo
4
+
5
+ O whisper-windows-mcp é uma ferramenta que prioriza o local. Todo o processamento de áudio acontece na sua máquina — nenhum áudio, arquivo de vídeo ou dado pessoal é transmitido para qualquer servidor. A superfície de ataque está limitada a:
6
+
7
+ - O sistema de arquivos local (caminhos de arquivo passados às ferramentas)
8
+ - O binário whisper-cli.exe e suas dependências
9
+ - A conexão MCP do Claude Desktop (apenas IPC local)
10
+ - Texto de transcrição retornado nas respostas das ferramentas (veja Arquitetura de Privacidade abaixo)
11
+
12
+ ## Arquitetura de Privacidade
13
+
14
+ **Arquivos de áudio nunca saem da sua máquina.** Essa garantia é incondicional.
15
+
16
+ **Texto de transcrição pode sair da sua máquina no modo padrão.** Quando uma resposta de ferramenta inclui texto de transcrição, esse texto é processado pela API do Claude. Este é o comportamento padrão do MCP, mas cria uma lacuna entre a filosofia de design "prioridade local" da ferramenta e o fluxo de dados real para usuários que lidam com conteúdo regulamentado ou confidencial.
17
+
18
+ **O modo de privacidade** (`WHISPER_PRIVACY_MODE=true` ou `privacy_mode=true` por chamada) restringe todas as respostas das ferramentas apenas a metadados — nenhum texto de transcrição retornado à API do Claude. Esta é a configuração correta para implantações médicas, jurídicas, financeiras e corporativas.
19
+
20
+ **Porta do modo de privacidade:** Quando o modo de privacidade está ativo, uma confirmação de divulgação explícita é exibida antes de cada operação de transcrição. Isso é intencional e não pode ser contornado — a conformidade regulatória exige consentimento informado por operação.
21
+
22
+ **Porta de consentimento:** No modo padrão, uma divulgação única por sessão é exibida antes que o texto de transcrição seja retornado à API pela primeira vez em uma sessão. Defina `WHISPER_CONSENT_ACKNOWLEDGED=true` na sua configuração para suprimir isso para conteúdo não sensível.
23
+
24
+ Veja [PRIVACY.md](PRIVACY.md) para a descrição completa da arquitetura de privacidade, orientação sobre frameworks de conformidade (HIPAA, GDPR, privilégio advogado-cliente, FERPA, SOX, PCI-DSS) e instruções de configuração.
25
+
26
+ ## Verificação do binário
27
+
28
+ Para verificar a integridade do binário `whisper-cli.exe` no release pré-compilado, verifique o hash SHA256 no PowerShell:
29
+
30
+ ```powershell
31
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
32
+ ```
33
+
34
+ O hash esperado para cada binário de release é publicado na [página de releases](https://github.com/eviscerations/whisper-windows-mcp/releases). Não use um binário cujo hash não corresponda.
35
+
36
+ ## Versões suportadas
37
+
38
+ Correções de segurança são aplicadas apenas à versão publicada mais recente.
39
+
40
+ | Versão | Suportada |
41
+ |---|---|
42
+ | 2.x (mais recente) | ✅ |
43
+ | 1.x | ❌ |
44
+
45
+ ## Reportando uma vulnerabilidade
46
+
47
+ **Não abra uma issue pública para vulnerabilidades de segurança.**
48
+
49
+ Use o relatório privado de vulnerabilidade do GitHub:
50
+ 1. Vá para a [aba Security](https://github.com/eviscerations/whisper-windows-mcp/security)
51
+ 2. Clique em "Report a vulnerability"
52
+ 3. Descreva o problema com detalhes suficientes para reproduzi-lo
53
+
54
+ Você receberá uma resposta em até 7 dias. Se a vulnerabilidade for confirmada, uma correção será lançada o mais rápido possível e você será creditado nas notas de release se desejar.
55
+
56
+ ## Decisões de design conhecidas
57
+
58
+ - **Injeção de caminho de arquivo:** As ferramentas aceitam caminhos absolutos de arquivo do Claude. Isso é por design — a ferramenta é destinada a ser usada com o Claude Desktop pelo proprietário da máquina. Não exponha este servidor MCP a acesso de rede não confiável.
59
+ - **Sem sandbox:** O whisper-cli.exe é executado com as mesmas permissões que o Claude Desktop. Isso é padrão para ferramentas MCP locais.
60
+ - **Arquivos temporários:** Arquivos WAV intermediários são gravados em `%TEMP%\whisper_tmp_*.wav` e excluídos após a transcrição. Arquivos de estado de tarefas são gravados em `%TEMP%\whisper-mcp-jobs\` e são limpos automaticamente após 7 dias na inicialização do servidor.
61
+ - **Conteúdo de transcrição:** O texto de transcrição retornado nas respostas das ferramentas é processado pela API do Claude no modo padrão. Para evitar isso, ative `WHISPER_PRIVACY_MODE=true` ou passe `privacy_mode=true` por chamada. Veja [PRIVACY.md](PRIVACY.md).
62
+ - **Injeção de transcrição:** Arquivos de áudio podem conter conteúdo falado que, quando transcrito, se assemelha a instruções. As defesas integradas do Claude lidam com isso. O próprio servidor MCP marca todo o conteúdo de transcrição como dados não confiáveis e nunca o interpreta como instruções.
63
+ - **Downloads de modelos são restritos:** A ferramenta `download_model` só faz download de dois namespaces do Hugging Face confiáveis (`ggerganov/whisper.cpp` e `ggml-org`). Redirecionamentos são validados contra uma lista de permissões antes de serem seguidos. URLs arbitrários são rejeitados no nível do código.
64
+ - **A troca de modelos é sandboxed:** `switch_model` só aceita arquivos `.bin` dentro do diretório de modelos configurado. Caminhos fora desse diretório são rejeitados independentemente de como são especificados.
package/SECURITY.ro.md CHANGED
@@ -1,47 +1,64 @@
1
- # Politică de securitate
2
-
3
- ## Domeniu de aplicare
4
-
5
- whisper-windows-mcp este un instrument care prioritizează localul. Toată procesarea audio are loc pe calculatorul tău — niciun audio, fișier video sau date personale nu sunt transmise vreunui server. Suprafața de atac este limitată la:
6
-
7
- - Sistemul de fișiere local (căi de fișiere transmise instrumentelor)
8
- - Binarul whisper-cli.exe și dependențele sale
9
- - Conexiunea MCP Claude Desktop (doar IPC local)
10
- - Textul de transcriere returnat în răspunsurile instrumentelor (vezi Arhitectura de confidențialitate mai jos)
11
-
12
- ## Arhitectura de confidențialitate
13
-
14
- **Fișierele audio nu părăsesc niciodată calculatorul tău.** Această garanție este necondiționată.
15
-
16
- **Textul de transcriere poate părăsi calculatorul tău.** Când un răspuns al instrumentului include text de transcriere, acel text este procesat de API-ul Claude. Acesta este comportamentul standard MCP, dar creează un decalaj între filosofia de proiectare "local prioritar" a instrumentului și fluxul real de date pentru utilizatorii care gestionează conținut reglementat sau confidențial.
17
-
18
- O variabilă de mediu `WHISPER_PRIVACY_MODE` este planificată care va restricționa toate răspunsurile instrumentelor doar la metadate — niciun text de transcriere nu este returnat la API-ul Claude. Aceasta este soluția prevăzută pentru implementările medicale, juridice, financiare și corporative.
19
-
20
- Vezi [PRIVACY.md](PRIVACY.md) pentru descrierea completă a arhitecturii de confidențialitate, îndrumări privind cadrele de conformitate (HIPAA, GDPR, privilegiu avocat-client, FERPA, SOX, PCI-DSS) și instrucțiuni de configurare.
21
-
22
- ## Versiuni suportate
23
-
24
- Corecțiile de securitate sunt aplicate doar celei mai recente versiuni publicate.
25
-
26
- | Versiune | Suportată |
27
- |---|---|
28
- | 2.x (cea mai recentă) | ✅ |
29
- | 1.x | ❌ |
30
-
31
- ## Raportarea unei vulnerabilități
32
-
33
- **Nu deschide un issue public pentru vulnerabilități de securitate.**
34
-
35
- Folosește raportarea privată a vulnerabilităților GitHub:
36
- 1. Mergi la [fila Security](https://github.com/eviscerations/whisper-windows-mcp/security)
37
- 2. Fă clic pe "Report a vulnerability"
38
- 3. Descrie problema cu suficiente detalii pentru a o reproduce
39
-
40
- Vei primi un răspuns în 7 zile. Dacă vulnerabilitatea este confirmată, o corecție va fi lansată cât mai curând posibil și vei fi creditat în notele de lansare dacă dorești.
41
-
42
- ## Decizii de proiectare cunoscute
43
-
44
- - **Injecție de cale de fișier:** Instrumentele acceptă căi absolute de fișiere de la Claude. Acesta este un design intenționat — instrumentul este destinat utilizării cu Claude Desktop de către proprietarul calculatorului. Nu expune acest server MCP la acces de rețea neautorizat.
45
- - **Fără sandbox:** whisper-cli.exe rulează cu aceleași permisiuni ca Claude Desktop. Acesta este standard pentru instrumentele MCP locale.
46
- - **Fișiere temporare:** Fișierele WAV intermediare sunt scrise în `%TEMP%\whisper_tmp_*.wav` și șterse după transcriere. Fișierele de stare a sarcinilor sunt scrise în `%TEMP%\whisper-mcp-jobs\` și persistă până la ștergerea manuală sau până la lansarea funcției de curățare automată planificate.
47
- - **Conținut de transcriere:** Textul de transcriere returnat în răspunsurile instrumentelor este procesat de API-ul Claude. Acesta este documentat și va putea fi adresat prin `WHISPER_PRIVACY_MODE` într-o versiune viitoare. Vezi [PRIVACY.md](PRIVACY.md).
1
+ # Politică de securitate
2
+
3
+ ## Domeniu de aplicare
4
+
5
+ whisper-windows-mcp este un instrument care prioritizează localul. Toată procesarea audio are loc pe calculatorul tău — niciun audio, fișier video sau date personale nu sunt transmise vreunui server. Suprafața de atac este limitată la:
6
+
7
+ - Sistemul de fișiere local (căi de fișiere transmise instrumentelor)
8
+ - Binarul whisper-cli.exe și dependențele sale
9
+ - Conexiunea MCP Claude Desktop (doar IPC local)
10
+ - Textul de transcriere returnat în răspunsurile instrumentelor (vezi Arhitectura de confidențialitate mai jos)
11
+
12
+ ## Arhitectura de confidențialitate
13
+
14
+ **Fișierele audio nu părăsesc niciodată calculatorul tău.** Această garanție este necondiționată.
15
+
16
+ **Textul de transcriere poate părăsi calculatorul tău** în modul standard. Când un răspuns al instrumentului include text de transcriere, acel text este procesat de API-ul Claude. Acesta este comportamentul standard MCP, dar creează un decalaj între filosofia de proiectare "local prioritar" a instrumentului și fluxul real de date pentru utilizatorii care gestionează conținut reglementat sau confidențial.
17
+
18
+ **Modul de confidențialitate** (`WHISPER_PRIVACY_MODE=true` sau `privacy_mode=true` per apel) restricționează toate răspunsurile instrumentelor doar la metadate — niciun text de transcriere nu este returnat la API-ul Claude. Aceasta este configurația corectă pentru implementările medicale, juridice, financiare și corporative.
19
+
20
+ **Poarta modului de confidențialitate:** când modul de confidențialitate este activ, o dezvăluire de confirmare explicită este afișată înainte de fiecare operațiune de transcriere. Aceasta este intenționată și nu poate fi ocolită — conformitatea reglementară necesită consimțământ informat per operațiune.
21
+
22
+ **Poarta de consimțământ:** în modul standard, o dezvăluire unică per sesiune este afișată înainte ca orice text de transcriere să fie returnat la API pentru prima dată. Setează `WHISPER_CONSENT_ACKNOWLEDGED=true` în configurația ta pentru a suprima aceasta pentru conținut non-sensibil.
23
+
24
+ Vezi [PRIVACY.md](PRIVACY.md) pentru descrierea completă a arhitecturii de confidențialitate, îndrumări privind cadrele de conformitate (HIPAA, GDPR, privilegiu avocat-client, FERPA, SOX, PCI-DSS) și instrucțiuni de configurare.
25
+
26
+ ## Verificarea binarului
27
+
28
+ Pentru a verifica integritatea binarului `whisper-cli.exe` din versiunea precompilată, verifică hash-ul său SHA256 în PowerShell:
29
+
30
+ ```powershell
31
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
32
+ ```
33
+
34
+ Hash-ul așteptat pentru fiecare binar de versiune este publicat pe [pagina de versiuni](https://github.com/eviscerations/whisper-windows-mcp/releases). Nu folosi un binar al cărui hash nu corespunde.
35
+
36
+ ## Versiuni suportate
37
+
38
+ Corecțiile de securitate sunt aplicate doar celei mai recente versiuni publicate.
39
+
40
+ | Versiune | Suportată |
41
+ |---|---|
42
+ | 2.x (cea mai recentă) | ✅ |
43
+ | 1.x | ❌ |
44
+
45
+ ## Raportarea unei vulnerabilități
46
+
47
+ **Nu deschide un issue public pentru vulnerabilități de securitate.**
48
+
49
+ Folosește raportarea privată a vulnerabilităților GitHub:
50
+ 1. Mergi la [fila Security](https://github.com/eviscerations/whisper-windows-mcp/security)
51
+ 2. Fă clic pe "Report a vulnerability"
52
+ 3. Descrie problema cu suficiente detalii pentru a o reproduce
53
+
54
+ Vei primi un răspuns în 7 zile. Dacă vulnerabilitatea este confirmată, o corecție va fi lansată cât mai curând posibil și vei fi creditat în notele de lansare dacă dorești.
55
+
56
+ ## Decizii de proiectare cunoscute
57
+
58
+ - **Injecție de cale de fișier:** Instrumentele acceptă căi absolute de fișiere de la Claude. Acesta este un design intenționat — instrumentul este destinat utilizării cu Claude Desktop de către proprietarul calculatorului. Nu expune acest server MCP la acces de rețea neautorizat.
59
+ - **Fără sandbox:** whisper-cli.exe rulează cu aceleași permisiuni ca Claude Desktop. Acesta este standard pentru instrumentele MCP locale.
60
+ - **Fișiere temporare:** Fișierele WAV intermediare sunt scrise în `%TEMP%\whisper_tmp_*.wav` și șterse după transcriere. Fișierele de stare a sarcinilor sunt scrise în `%TEMP%\whisper-mcp-jobs\` și curățate automat după 7 zile la pornirea serverului.
61
+ - **Conținut de transcriere:** Textul de transcriere returnat în răspunsurile instrumentelor este procesat de API-ul Claude în modul standard. Activează `WHISPER_PRIVACY_MODE=true` sau transmite `privacy_mode=true` per apel pentru a preveni aceasta. Vezi [PRIVACY.md](PRIVACY.md).
62
+ - **Injecție 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. Serverul MCP în sine marchează tot conținutul de transcriere ca date neautorizate și nu le interpretează niciodată ca instrucțiuni.
63
+ - **Descărcări de modele:** Instrumentul `download_model` descarcă doar din două spații de nume Hugging Face de încredere (`ggerganov/whisper.cpp` și `ggml-org`). Redirecționările sunt validate față de o listă de permise înainte de a fi urmate. URL-urile arbitrare sunt respinse la nivel de cod.
64
+ - **Schimbarea modelelor:** `switch_model` acceptă doar fișiere `.bin` în directorul de modele configurat. Căile din afara acelui director sunt respinse indiferent de modul în care sunt specificate.
package/SECURITY.uk.md CHANGED
@@ -1,47 +1,64 @@
1
- # Політика безпеки
2
-
3
- ## Область охоплення
4
-
5
- whisper-windows-mcp — інструмент з пріоритетом локальності. Все аудіоопрацювання відбувається на вашому комп'ютері — жодні аудіо-, відеофайли чи персональні дані не передаються на жодний сервер. Поверхня атаки обмежена:
6
-
7
- - Локальна файлова система (шляхи до файлів, що передаються інструментам)
8
- - Бінарник whisper-cli.exe та його залежності
9
- - З'єднання Claude Desktop MCP (лише локальний IPC)
10
- - Текст транскрипції, що повертається у відповідях інструментів (дивіться Архітектуру конфіденційності нижче)
11
-
12
- ## Архітектура конфіденційності
13
-
14
- **Аудіофайли ніколи не покидають ваш комп'ютер.** Ця гарантія є безумовною.
15
-
16
- **Текст транскрипції може покидати ваш комп'ютер.** Коли відповідь інструменту містить текст транскрипції, цей текст опрацьовується API Claude. Це стандартна поведінка MCP, але вона створює розрив між філософією дизайну "локальний пріоритет" і фактичним потоком даних для користувачів, що працюють з регульованим або конфіденційним контентом.
17
-
18
- Планується змінна середовища `WHISPER_PRIVACY_MODE`, яка обмежить усі відповіді інструментів лише метаданими — жодний текст транскрипції не повертатиметься API Claude. Це передбачуване рішення для медичних, юридичних, фінансових і корпоративних розгортань.
19
-
20
- Повний опис архітектури конфіденційності, настанови щодо нормативних вимог (HIPAA, GDPR, адвокатська таємниця, FERPA, SOX, PCI-DSS) та інструкції з налаштування — у [PRIVACY.md](PRIVACY.md).
21
-
22
- ## Підтримувані версії
23
-
24
- Виправлення безпеки застосовуються лише до найновішої опублікованої версії.
25
-
26
- | Версія | Підтримується |
27
- |---|---|
28
- | 2.x (найновіша) | ✅ |
29
- | 1.x | ❌ |
30
-
31
- ## Повідомлення про вразливість
32
-
33
- **Не відкривайте публічний issue для вразливостей безпеки.**
34
-
35
- Використовуйте приватну звітність про вразливості GitHub:
36
- 1. Перейдіть до [вкладки Security](https://github.com/eviscerations/whisper-windows-mcp/security)
37
- 2. Натисніть "Report a vulnerability"
38
- 3. Опишіть проблему з достатніми деталями для відтворення
39
-
40
- Ви отримаєте відповідь протягом 7 днів. Якщо вразливість підтверджено, виправлення буде випущено якнайшвидше, і вас буде вказано в примітках до релізу за вашим бажанням.
41
-
42
- ## Відомі проєктні рішення
43
-
44
- - **Ін'єкція шляху до файлу:** Інструменти приймають абсолютні шляхи до файлів від Claude. Це навмисний дизайн — інструмент призначено для використання власником комп'ютера разом з Claude Desktop. Не відкривайте цей MCP-сервер для ненадійного мережевого доступу.
45
- - **Відсутність пісочниці:** whisper-cli.exe запускається з тими самими правами, що і Claude Desktop. Це стандарт для локальних MCP-інструментів.
46
- - **Тимчасові файли:** Проміжні WAV-файли записуються до `%TEMP%\whisper_tmp_*.wav` і видаляються після транскрипції. Файли стану завдань записуються до `%TEMP%\whisper-mcp-jobs\` і зберігаються до ручного очищення або до виходу запланованої функції автоочищення.
47
- - **Вміст транскрипції:** Текст транскрипції, що повертається у відповідях інструментів, опрацьовується API Claude. Це задокументовано і буде вирішено через `WHISPER_PRIVACY_MODE` у майбутньому релізі. Дивіться [PRIVACY.md](PRIVACY.md).
1
+ # Політика безпеки
2
+
3
+ ## Область охоплення
4
+
5
+ whisper-windows-mcp — інструмент з пріоритетом локальності. Все аудіоопрацювання відбувається на вашому комп'ютері — жодні аудіо-, відеофайли чи персональні дані не передаються на жодний сервер. Поверхня атаки обмежена:
6
+
7
+ - Локальна файлова система (шляхи до файлів, що передаються інструментам)
8
+ - Бінарник whisper-cli.exe та його залежності
9
+ - З'єднання Claude Desktop MCP (лише локальний IPC)
10
+ - Текст транскрипції, що повертається у відповідях інструментів (дивіться Архітектуру конфіденційності нижче)
11
+
12
+ ## Архітектура конфіденційності
13
+
14
+ **Аудіофайли ніколи не покидають ваш комп'ютер.** Ця гарантія є безумовною.
15
+
16
+ **Текст транскрипції може покидати ваш комп'ютер** у стандартному режимі. Коли відповідь інструменту містить текст транскрипції, цей текст опрацьовується API Claude. Це стандартна поведінка MCP, але вона створює розрив між філософією дизайну "локальний пріоритет" і фактичним потоком даних для користувачів, що працюють з регульованим або конфіденційним контентом.
17
+
18
+ **Режим конфіденційності** (`WHISPER_PRIVACY_MODE=true` або `privacy_mode=true` для окремого виклику) обмежує всі відповіді інструментів лише метаданими — жодний текст транскрипції не повертається API Claude. Це правильне налаштування для медичних, юридичних, фінансових і корпоративних розгортань.
19
+
20
+ **Ворота режиму конфіденційності:** коли режим конфіденційності активний, перед кожною операцією транскрипції відображається явне підтвердження розкриття. Це навмисно і не може бути обійдено — відповідність нормативним вимогам потребує поінформованої згоди перед кожною операцією.
21
+
22
+ **Ворота згоди:** у стандартному режимі одноразове розкриття для сеансу відображається перед першим поверненням тексту транскрипції до API. Встановіть `WHISPER_CONSENT_ACKNOWLEDGED=true` у конфігурації, щоб пропустити це для нечутливого контенту.
23
+
24
+ Повний опис архітектури конфіденційності, настанови щодо нормативних вимог (HIPAA, GDPR, адвокатська таємниця, FERPA, SOX, PCI-DSS) та інструкції з налаштування — у [PRIVACY.md](PRIVACY.md).
25
+
26
+ ## Перевірка бінарника
27
+
28
+ Щоб перевірити цілісність бінарника `whisper-cli.exe` у готовому релізі, перевірте його хеш SHA256 у PowerShell:
29
+
30
+ ```powershell
31
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
32
+ ```
33
+
34
+ Очікуваний хеш для кожного релізного бінарника опубліковано на [сторінці релізів](https://github.com/eviscerations/whisper-windows-mcp/releases). Не використовуйте бінарник, хеш якого не збігається.
35
+
36
+ ## Підтримувані версії
37
+
38
+ Виправлення безпеки застосовуються лише до найновішої опублікованої версії.
39
+
40
+ | Версія | Підтримується |
41
+ |---|---|
42
+ | 2.x (найновіша) | ✅ |
43
+ | 1.x | ❌ |
44
+
45
+ ## Повідомлення про вразливість
46
+
47
+ **Не відкривайте публічний issue для вразливостей безпеки.**
48
+
49
+ Використовуйте приватну звітність про вразливості GitHub:
50
+ 1. Перейдіть до [вкладки Security](https://github.com/eviscerations/whisper-windows-mcp/security)
51
+ 2. Натисніть "Report a vulnerability"
52
+ 3. Опишіть проблему з достатніми деталями для відтворення
53
+
54
+ Ви отримаєте відповідь протягом 7 днів. Якщо вразливість підтверджено, виправлення буде випущено якнайшвидше, і вас буде вказано в примітках до релізу за вашим бажанням.
55
+
56
+ ## Відомі проєктні рішення
57
+
58
+ - **Ін'єкція шляху до файлу:** Інструменти приймають абсолютні шляхи до файлів від Claude. Це навмисний дизайн — інструмент призначено для використання власником комп'ютера разом з Claude Desktop. Не відкривайте цей MCP-сервер для ненадійного мережевого доступу.
59
+ - **Відсутність пісочниці:** whisper-cli.exe запускається з тими самими правами, що і Claude Desktop. Це стандарт для локальних MCP-інструментів.
60
+ - **Тимчасові файли:** Проміжні WAV-файли записуються до `%TEMP%\whisper_tmp_*.wav` і видаляються після транскрипції. Файли стану завдань записуються до `%TEMP%\whisper-mcp-jobs\` і автоматично очищуються через 7 днів при запуску сервера.
61
+ - **Вміст транскрипції:** Текст транскрипції, що повертається у відповідях інструментів, опрацьовується API Claude у стандартному режимі. Увімкніть `WHISPER_PRIVACY_MODE=true` або передайте `privacy_mode=true` для окремого виклику, щоб запобігти цьому. Дивіться [PRIVACY.md](PRIVACY.md).
62
+ - **Ін'єкція транскрипції:** Аудіофайли можуть містити вимовлений контент, який після транскрипції нагадує інструкції. Вбудований захист Claude впорається з цим. Сам MCP-сервер позначає весь вміст транскрипції як ненадійні дані і ніколи не інтерпретує їх як інструкції.
63
+ - **Завантаження моделей:** Інструмент `download_model` завантажує лише з двох довірених просторів імен Hugging Face (`ggerganov/whisper.cpp` і `ggml-org`). Переспрямування перевіряються за списком дозволених перед виконанням. Довільні URL-адреси відхиляються на рівні коду.
64
+ - **Перемикання моделей:** `switch_model` приймає лише `.bin`-файли з налаштованої теки моделей. Шляхи за межами цієї теки відхиляються незалежно від способу їх вказівки.
package/SECURITY.vi.md CHANGED
@@ -1,47 +1,64 @@
1
- # Chính sách bảo mật
2
-
3
- ## Phạm vi
4
-
5
- whisper-windows-mcp là công cụ ưu tiên cục bộ. Tất cả xử lý âm thanh xảy ra trên máy của bạn — không có âm thanh, tệp video hay dữ liệu cá nhân nào được truyền đến bất kỳ máy chủ nào. Bề mặt tấn công được giới hạn ở:
6
-
7
- - Hệ thống tệp cục bộ (đường dẫn tệp được truyền cho công cụ)
8
- - Tệp nhị phân whisper-cli.exe và các phụ thuộc của nó
9
- - Kết nối Claude Desktop MCP (chỉ IPC cục bộ)
10
- - Văn bản phiên âm được trả về trong phản hồi công cụ (xem Kiến trúc quyền riêng tư bên dưới)
11
-
12
- ## Kiến trúc quyền riêng tư
13
-
14
- **Tệp âm thanh không bao giờ rời khỏi máy của bạn.** Đảm bảo này là vô điều kiện.
15
-
16
- **Văn bản phiên âm có thể rời khỏi máy của bạn.** Khi phản hồi công cụ bao gồm văn bản phiên âm, văn bản đó được xử lý bởi API của Claude. Đây là hành vi MCP tiêu chuẩn nhưng tạo ra khoảng cách giữa triết lý thiết kế "ưu tiên cục bộ" của công cụ và luồng dữ liệu thực tế đối với người dùng xử lý nội dung được quản lý hoặc bí mật.
17
-
18
- Biến môi trường `WHISPER_PRIVACY_MODE` đang được lên kế hoạch sẽ giới hạn tất cả phản hồi công cụ chỉ có siêu dữ liệu — không có văn bản phiên âm nào được trả về cho API của Claude. Đây là giải pháp dự kiến cho triển khai y tế, pháp lý, tài chính và doanh nghiệp.
19
-
20
- Xem [PRIVACY.md](PRIVACY.md) để biết mô tả kiến trúc quyền riêng tư đầy đủ, hướng dẫn khung tuân thủ (HIPAA, GDPR, đặc quyền luật sư-khách hàng, FERPA, SOX, PCI-DSS) và hướng dẫn cấu hình.
21
-
22
- ## Phiên bản được hỗ trợ
23
-
24
- Các bản sửa lỗi bảo mật chỉ được áp dụng cho phiên bản đã phát hành mới nhất.
25
-
26
- | Phiên bản | Được hỗ trợ |
27
- |---|---|
28
- | 2.x (mới nhất) | ✅ |
29
- | 1.x | ❌ |
30
-
31
- ## Báo cáo lỗ hổng
32
-
33
- **Không mở issue công khai cho lỗ hổng bảo mật.**
34
-
35
- Sử dụng báo cáo lỗ hổng riêng tư của GitHub:
36
- 1. Đi đến [tab Bảo mật](https://github.com/eviscerations/whisper-windows-mcp/security)
37
- 2. Nhấp vào "Report a vulnerability"
38
- 3. Mô tả vấn đề với đủ chi tiết để tái hiện
39
-
40
- Bạn sẽ nhận được phản hồi trong vòng 7 ngày. Nếu lỗ hổng được xác nhận, bản sửa lỗi sẽ được phát hành sớm nhất có thể và bạn sẽ được ghi nhận trong ghi chú phát hành nếu bạn muốn.
41
-
42
- ## Các quyết định thiết kế đã biết
43
-
44
- - **Tiêm nhiễm đường dẫn tệp:** Công cụ chấp nhận đường dẫn tệp tuyệt đối từ Claude. Đây là thiết kế có chủ ý — công cụ được thiết kế để được sử dụng với Claude Desktop bởi chủ sở hữu máy. Không để lộ máy chủ MCP này cho truy cập mạng không đáng tin cậy.
45
- - **Không có sandbox:** whisper-cli.exe chạy với cùng quyền hạn như Claude Desktop. Đây là hành vi tiêu chuẩn cho công cụ MCP cục bộ.
46
- - **Tệp tạm thời:** Tệp WAV trung gian được ghi vào `%TEMP%\whisper_tmp_*.wav` và xóa sau khi phiên âm. Tệp trạng thái tác vụ được ghi vào `%TEMP%\whisper-mcp-jobs\` và tồn tại cho đến khi xóa thủ công hoặc cho đến khi tính năng tự động dọn dẹp đã lên kế hoạch ra mắt.
47
- - **Nội dung phiên âm:** Văn bản phiên âm được trả về trong phản hồi công cụ được xử lý bởi API của Claude. Điều này được ghi lại và sẽ có thể giải quyết thông qua `WHISPER_PRIVACY_MODE` trong bản phát hành tương lai. Xem [PRIVACY.md](PRIVACY.md).
1
+ # Chính sách bảo mật
2
+
3
+ ## Phạm vi
4
+
5
+ whisper-windows-mcp là công cụ ưu tiên cục bộ. Tất cả xử lý âm thanh xảy ra trên máy của bạn — không có âm thanh, tệp video hay dữ liệu cá nhân nào được truyền đến bất kỳ máy chủ nào. Bề mặt tấn công được giới hạn ở:
6
+
7
+ - Hệ thống tệp cục bộ (đường dẫn tệp được truyền cho công cụ)
8
+ - Tệp nhị phân whisper-cli.exe và các phụ thuộc của nó
9
+ - Kết nối Claude Desktop MCP (chỉ IPC cục bộ)
10
+ - Văn bản phiên âm được trả về trong phản hồi công cụ (xem Kiến trúc quyền riêng tư bên dưới)
11
+
12
+ ## Kiến trúc quyền riêng tư
13
+
14
+ **Tệp âm thanh không bao giờ rời khỏi máy của bạn.** Đảm bảo này là vô điều kiện.
15
+
16
+ **Văn bản phiên âm có thể rời khỏi máy của bạn ở chế độ tiêu chuẩn.** Khi phản hồi công cụ bao gồm văn bản phiên âm, văn bản đó được xử lý bởi API của Claude. Đây là hành vi MCP tiêu chuẩn nhưng tạo ra khoảng cách giữa triết lý thiết kế "ưu tiên cục bộ" của công cụ và luồng dữ liệu thực tế đối với người dùng xử lý nội dung được quản lý hoặc bí mật.
17
+
18
+ **Chế độ quyền riêng tư** (`WHISPER_PRIVACY_MODE=true` hoặc `privacy_mode=true` theo từng lệnh gọi) giới hạn tất cả phản hồi công cụ chỉ có siêu dữ liệu — không có văn bản phiên âm nào được trả về cho API của Claude. Đây là cấu hình chính xác cho triển khai y tế, pháp lý, tài chính và doanh nghiệp.
19
+
20
+ **Cổng chế độ quyền riêng tư:** Khi chế độ quyền riêng tư đang hoạt động, một xác nhận công khai rõ ràng được hiển thị trước mỗi thao tác phiên âm. Điều này là có chủ ý và không thể bỏ qua — tuân thủ quy định yêu cầu sự đồng ý có hiểu biết theo từng thao tác.
21
+
22
+ **Cổng đồng ý:** Ở chế độ tiêu chuẩn, một công khai phiên một lần được hiển thị trước khi văn bản phiên âm được trả về cho API lần đầu tiên trong một phiên. Đặt `WHISPER_CONSENT_ACKNOWLEDGED=true` trong cấu hình của bạn để bỏ qua điều này cho nội dung không nhạy cảm.
23
+
24
+ Xem [PRIVACY.md](PRIVACY.md) để biết mô tả kiến trúc quyền riêng tư đầy đủ, hướng dẫn khung tuân thủ (HIPAA, GDPR, đặc quyền luật sư-khách hàng, FERPA, SOX, PCI-DSS) và hướng dẫn cấu hình.
25
+
26
+ ## Xác minh tệp nhị phân
27
+
28
+ Để xác minh tính toàn vẹn của tệp nhị phân `whisper-cli.exe` trong bản phát hành đã biên dịch sẵn, hãy kiểm tra hash SHA256 trong PowerShell:
29
+
30
+ ```powershell
31
+ Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
32
+ ```
33
+
34
+ Hash dự kiến cho mỗi tệp nhị phân phát hành được công bố trên [trang phát hành](https://github.com/eviscerations/whisper-windows-mcp/releases). Không sử dụng tệp nhị phân có hash không khớp.
35
+
36
+ ## Phiên bản được hỗ trợ
37
+
38
+ Các bản sửa lỗi bảo mật chỉ được áp dụng cho phiên bản đã phát hành mới nhất.
39
+
40
+ | Phiên bản | Được hỗ trợ |
41
+ |---|---|
42
+ | 2.x (mới nhất) | ✅ |
43
+ | 1.x | ❌ |
44
+
45
+ ## Báo cáo lỗ hổng
46
+
47
+ **Không mở issue công khai cho lỗ hổng bảo mật.**
48
+
49
+ Sử dụng báo cáo lỗ hổng riêng tư của GitHub:
50
+ 1. Đi đến [tab Bảo mật](https://github.com/eviscerations/whisper-windows-mcp/security)
51
+ 2. Nhấp vào "Report a vulnerability"
52
+ 3. Mô tả vấn đề với đủ chi tiết để tái hiện
53
+
54
+ Bạn sẽ nhận được phản hồi trong vòng 7 ngày. Nếu lỗ hổng được xác nhận, bản sửa lỗi sẽ được phát hành sớm nhất có thể và bạn sẽ được ghi nhận trong ghi chú phát hành nếu bạn muốn.
55
+
56
+ ## Các quyết định thiết kế đã biết
57
+
58
+ - **Tiêm nhiễm đường dẫn tệp:** Công cụ chấp nhận đường dẫn tệp tuyệt đối từ Claude. Đây là thiết kế có chủ ý — công cụ được thiết kế để được sử dụng với Claude Desktop bởi chủ sở hữu máy. Không để lộ máy chủ MCP này cho truy cập mạng không đáng tin cậy.
59
+ - **Không có sandbox:** whisper-cli.exe chạy với cùng quyền hạn như Claude Desktop. Đây là hành vi tiêu chuẩn cho công cụ MCP cục bộ.
60
+ - **Tệp tạm thời:** Tệp WAV trung gian được ghi vào `%TEMP%\whisper_tmp_*.wav` và xóa sau khi phiên âm. Tệp trạng thái tác vụ được ghi vào `%TEMP%\whisper-mcp-jobs\` và tự động dọn dẹp sau 7 ngày khi khởi động máy chủ.
61
+ - **Nội dung phiên âm:** Văn bản phiên âm được trả về trong phản hồi công cụ được xử lý bởi API của Claude ở chế độ tiêu chuẩn. Để ngăn điều này, hãy bật `WHISPER_PRIVACY_MODE=true` hoặc truyền `privacy_mode=true` theo từng lệnh gọi. Xem [PRIVACY.md](PRIVACY.md).
62
+ - **Tiêm nhiễm phiên âm:** Tệp âm thanh có thể chứa nội dung khi phiên âm trông giống như hướng dẫn. Các biện pháp phòng thủ tích hợp của Claude xử lý điều này. Chính máy chủ MCP đánh dấu tất cả nội dung phiên âm là dữ liệu không đáng tin cậy và không bao giờ diễn giải nó là hướng dẫn.
63
+ - **Tải xuống mô hình bị hạn chế:** Công cụ `download_model` chỉ tải xuống từ hai namespace Hugging Face đáng tin cậy (`ggerganov/whisper.cpp` và `ggml-org`). Chuyển hướng được xác thực dựa trên danh sách cho phép trước khi tuân theo. URL tùy ý bị từ chối ở cấp mã.
64
+ - **Chuyển đổi mô hình được sandbox hóa:** `switch_model` chỉ chấp nhận tệp `.bin` trong thư mục mô hình đã cấu hình. Đường dẫn ngoài thư mục đó bị từ chối bất kể cách chúng được chỉ định.