whisper-windows-mcp 2.2.2 → 2.3.0

package/PRIVACY.vi.md

@@ -1,135 +1,192 @@
-# Kiến trúc quyền riêng tư — whisper-windows-mcp
-
-Tài liệu này mô tả dữ liệu nào ở lại máy của bạn, dữ liệu nào rời khỏi máy và cách cấu hình công cụ cho nội dung được quản lý hoặc nhạy cảm.
-
----
-
-## Đảm bảo cốt lõi
-
-whisper-windows-mcp được xây dựng trên kiến trúc ưu tiên cục bộ. **Tệp âm thanh và video không bao giờ rời khỏi máy của bạn.** Phiên âm chạy hoàn toàn trên phần cứng của bạn bằng whisper.cpp — không có dịch vụ đám mây, không cần kết nối internet, không có lệnh gọi API nào liên quan đến bản thân việc phiên âm.
-
-Đảm bảo này áp dụng vô điều kiện cho tệp phương tiện.
-
----
-
-## Dữ liệu luôn ở lại cục bộ
-
-| Dữ liệu | Rời khỏi máy? |
-|---|---|
-| Tệp âm thanh | ❌ Không bao giờ |
-| Tệp video | ❌ Không bao giờ |
-| Tệp mô hình Whisper | ❌ Không bao giờ |
-| Tệp WAV chuyển đổi tạm thời | ❌ Không bao giờ (xóa sau khi phiên âm) |
-| Tệp trạng thái đợt và tác vụ | ❌ Không bao giờ |
-| Tệp phiên âm `.txt` / `.srt` trên đĩa | ❌ Không bao giờ |
-
----
-
-## Dữ liệu có thể rời khỏi máy (hành vi mặc định)
-
-Khi phản hồi công cụ bao gồm văn bản phiên âm, văn bản đó được trả về cho Claude Desktop và được xử lý bởi API của Anthropic. Đây là hành vi MCP tiêu chuẩn — văn bản di chuyển từ máy chủ MCP cục bộ đến mô hình của Claude qua mạng.
-
-| Dữ liệu | Rời khỏi máy? |
-|---|---|
-| Văn bản phiên âm trả về trong phản hồi công cụ | ✅ Có, theo mặc định |
-| Văn bản phiên âm tải lên trực tiếp cho Claude dưới dạng tệp | ✅ Có (ngoài MCP) |
-
-Khoảng cách này tồn tại giữa đảm bảo "không có dữ liệu nào rời khỏi máy" của công cụ và hành vi thực tế khi bạn yêu cầu Claude đọc, tóm tắt hoặc phân tích bản phiên âm. Hầu hết người dùng — những người phiên âm nội dung công khai như video YouTube, podcast hoặc bản ghi phát trực tuyến — không bị ảnh hưởng bởi sự phân biệt này.
-
-Đối với người dùng xử lý bản ghi riêng tư, bí mật hoặc được quản lý, sự phân biệt này quan trọng.
-
----
-
-## Chế độ quyền riêng tư (đang lên kế hoạch — chưa được triển khai)
-
-Biến môi trường `WHISPER_PRIVACY_MODE` đang được lên kế hoạch cho một bản phát hành tương lai. Khi được bật:
-
-- Tất cả phản hồi công cụ chỉ trả về siêu dữ liệu: tên tệp, thời lượng, số từ, trạng thái hoàn thành
-- Không có văn bản phiên âm nào được bao gồm trong bất kỳ phản hồi công cụ nào
-- Claude không thể đọc, phân tích hoặc chuyển tiếp nội dung phiên âm dưới bất kỳ hình thức nào
-- Bản phiên âm chỉ tồn tại dưới dạng tệp `.txt` cục bộ trên đĩa
-
-Chế độ này được thiết kế cho triển khai pháp lý, y tế, tài chính và doanh nghiệp nơi nội dung phiên âm không được rời khỏi môi trường cục bộ trong bất kỳ trường hợp nào.
-
-**Cấu hình đã lên kế hoạch:**
-
-```json
-{
-  "mcpServers": {
-    "whisper": {
-      "command": "npx",
-      "args": ["-y", "whisper-windows-mcp"],
-      "env": {
-        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
-        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
-        "WHISPER_PRIVACY_MODE": "true"
-      }
-    }
-  }
-}
-```
-
-Cho đến khi tính năng này ra mắt: nếu bạn cần phân tích nội dung phiên âm mà không truyền đến API của Claude, hãy mở tệp `.txt` trực tiếp trong trình soạn thảo văn bản hoặc công cụ xử lý cục bộ.
-
----
-
-## Hướng dẫn cho ngành được quản lý
-
-Thông tin dưới đây chỉ mang tính chất thông tin chung. Tác giả của công cụ này không phải là luật sư. Người dùng chịu trách nhiệm duy nhất về việc tuân thủ các luật và quy định hiện hành. Khi có nghi ngờ, hãy tham khảo ý kiến luật sư có trình độ trước khi phiên âm nội dung được quản lý.
-
-### HIPAA (Hoa Kỳ — chăm sóc sức khỏe)
-Các nhà cung cấp dịch vụ y tế, công ty bảo hiểm và các cộng sự kinh doanh của họ bị cấm truyền Thông tin Sức khỏe Được Bảo vệ (PHI) cho các bên thứ ba không được phép mà không có Thỏa thuận Cộng tác Kinh doanh (BAA). Anthropic không cung cấp HIPAA BAA cho việc sử dụng API người tiêu dùng Claude.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Tư vấn bệnh nhân, ghi chú lâm sàng, buổi trị liệu, cuộc gọi yêu cầu bảo hiểm, bản ghi hành chính bệnh viện.
-
-**Khuyến nghị hiện tại:** Không phiên âm âm thanh bệnh nhân rồi yêu cầu Claude tóm tắt hoặc phân tích bản phiên âm trừ khi tổ chức của bạn đã thiết lập thỏa thuận xử lý tuân thủ. Sử dụng `WHISPER_PRIVACY_MODE` khi có sẵn.
-
-### GDPR (EU/EEA)
-Dữ liệu cá nhân của cư dân EU không thể được chuyển cho các bộ xử lý bên thứ ba mà không có sự đồng ý rõ ràng và cơ sở pháp lý để xử lý. Văn bản phiên âm chứa tên, địa điểm hoặc bất kỳ thông tin nhận dạng nào cấu thành dữ liệu cá nhân theo GDPR.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Phỏng vấn, cuộc họp, bản ghi trung tâm cuộc gọi, thủ tục tòa án liên quan đến cư dân EU.
-
-**Khuyến nghị hiện tại:** Hãy lưu ý rằng việc tải lên bản phiên âm chứa dữ liệu cá nhân cư dân EU lên Claude có thể có tác động GDPR tùy thuộc vào vai trò và mục đích xử lý của bạn.
-
-### Đặc quyền luật sư-khách hàng (Hoa Kỳ, Anh, Úc và hầu hết các thẩm quyền thông luật)
-Thông tin liên lạc giữa luật sư và khách hàng được bảo vệ pháp lý. Tiết lộ cho bên thứ ba không được phép có thể làm mất đặc quyền. Không có tiền lệ pháp lý được thiết lập bảo vệ thông tin liên lạc luật sư-khách hàng khi được xử lý bởi API AI thương mại.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Lời khai pháp lý, tư vấn khách hàng, bản ghi chiến lược nội bộ, phỏng vấn nhân chứng.
-
-**Khuyến nghị hiện tại:** Luật sư phiên âm thông tin liên lạc có đặc quyền không nên tải những bản phiên âm đó lên Claude để phân tích mà không có đánh giá pháp lý độc lập về tác động đặc quyền.
-
-### FERPA (Hoa Kỳ — giáo dục)
-Hồ sơ giáo dục của học sinh được bảo vệ. Các trường học và đại học không thể tiết lộ thông tin học sinh có thể nhận dạng cho bên thứ ba mà không có sự đồng ý.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Bài giảng được ghi lại, buổi tư vấn học sinh, phiên điều trần học thuật, cuộc họp IEP.
-
-### SOX (Hoa Kỳ — công ty đại chúng)
-Thông tin liên lạc tài chính của các công ty đại chúng phải tuân theo các yêu cầu lưu giữ hồ sơ và bảo mật. Thông tin quan trọng không công khai (MNPI) không thể được tiết lộ có chọn lọc.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Bản ghi cuộc họp kết quả kinh doanh, biên bản cuộc họp hội đồng quản trị, thông tin liên lạc với nhà đầu tư, thảo luận chiến lược tài chính nội bộ.
-
-### PCI-DSS
-Dữ liệu thẻ thanh toán không thể được lưu trữ hoặc truyền trong môi trường không an toàn. Bản ghi âm thanh số thẻ trong giao dịch nằm trong phạm vi.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Bản ghi trung tâm cuộc gọi, cuộc gọi dịch vụ khách hàng liên quan đến xử lý thanh toán.
-
-### Bảo mật bí mật thương mại / NDA
-Thông tin kinh doanh bí mật, công thức độc quyền, chi tiết sản phẩm chưa phát hành và thông tin nhân sự có thể được bảo vệ theo hợp đồng hoặc pháp luật.
-
-**Các trường hợp sử dụng bị ảnh hưởng:** Cuộc họp chiến lược doanh nghiệp, thảo luận R&D, cuộc gọi thẩm định M&A, thủ tục nhân sự.
-
----
-
-## Tải tệp phiên âm trực tiếp lên Claude
-
-Khi bạn tải tệp `.txt` phiên âm trực tiếp lên Claude dưới dạng tệp đính kèm — hoàn toàn bên ngoài công cụ MCP — máy chủ MCP không có khả năng hiển thị và không thể áp dụng bất kỳ kiểm soát quyền riêng tư nào.
-
-Tải bản phiên âm trực tiếp lên Claude tương đương với việc gửi nội dung âm thanh cho Anthropic. Không có chế độ quyền riêng tư hay bảo vệ cấp MCP tương lai nào áp dụng cho việc tải tệp trực tiếp.
-
-Người dùng xử lý nội dung được quản lý không được tải bản phiên âm trực tiếp lên Claude. Con đường phân tích an toàn duy nhất cho nội dung được quản lý là các công cụ xử lý cục bộ không truyền nội dung ra ngoài.
-
----
-
-## Báo cáo lo ngại về quyền riêng tư
-
-Nếu bạn xác định vấn đề quyền riêng tư hoặc khoảng cách kiến trúc không được đề cập ở đây, vui lòng sử dụng báo cáo lỗ hổng riêng tư của GitHub thay vì mở issue công khai. Xem [SECURITY.md](SECURITY.md) để biết hướng dẫn báo cáo.
+# Kiến trúc quyền riêng tư — whisper-windows-mcp
+
+Tài liệu này mô tả dữ liệu nào ở lại máy của bạn, dữ liệu nào rời khỏi máy và cách cấu hình công cụ cho nội dung được quản lý hoặc nhạy cảm.
+
+---
+
+## Đảm bảo cốt lõi
+
+whisper-windows-mcp được xây dựng trên kiến trúc ưu tiên cục bộ. **Tệp âm thanh và video không bao giờ rời khỏi máy của bạn.** Phiên âm chạy hoàn toàn trên phần cứng của bạn bằng whisper.cpp — không có dịch vụ đám mây, không cần kết nối internet, không có lệnh gọi API nào liên quan đến bản thân việc phiên âm.
+
+Đảm bảo này áp dụng vô điều kiện cho tệp phương tiện.
+
+---
+
+## Dữ liệu luôn ở lại cục bộ
+
+| Dữ liệu | Rời khỏi máy? |
+|---|---|
+| Tệp âm thanh | ❌ Không bao giờ |
+| Tệp video | ❌ Không bao giờ |
+| Tệp mô hình Whisper | ❌ Không bao giờ |
+| Tệp WAV chuyển đổi tạm thời | ❌ Không bao giờ (xóa sau khi phiên âm) |
+| Tệp trạng thái đợt và tác vụ | ❌ Không bao giờ |
+| Tệp phiên âm `.txt` / `.srt` / `.vtt` trên đĩa | ❌ Không bao giờ |
+
+---
+
+## Dữ liệu có thể rời khỏi máy (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 trả về cho Claude Desktop và được xử lý bởi API của Anthropic. Đây là hành vi MCP tiêu chuẩn — văn bản di chuyển từ máy chủ MCP cục bộ đến mô hình của Claude qua mạng.
+
+| Dữ liệu | Rời khỏi máy? |
+|---|---|
+| Văn bản phiên âm trả về nội tuyến trong phản hồi công cụ | ✅ Có, ở chế độ tiêu chuẩn |
+| Văn bản phiên âm tải lên trực tiếp cho Claude dưới dạng tệp | ✅ Có (ngoài MCP — không áp dụng kiểm soát quyền riêng tư) |
+
+Khoảng cách này tồn tại giữa đảm bảo "không có dữ liệu nào rời khỏi máy" của công cụ và hành vi thực tế khi bạn yêu cầu Claude đọc, tóm tắt hoặc phân tích bản phiên âm. Hầu hết người dùng — những người phiên âm nội dung công khai như video YouTube, podcast hoặc bản ghi phát trực tuyến — không bị ảnh hưởng bởi sự phân biệt này.
+
+Đối với người dùng xử lý bản ghi riêng tư, bí mật hoặc được quản lý, sự phân biệt này quan trọng.
+
+---
+
+## Chế độ quyền riêng tư
+
+`WHISPER_PRIVACY_MODE` giới hạn tất cả phản hồi công cụ chỉ có siêu dữ liệu. Khi được bật:
+
+- Tất cả phản hồi công cụ chỉ trả về: tên tệp, số từ, đường dẫn lưu, trạng thái hoàn thành
+- Không có văn bản phiên âm nào được bao gồm trong bất kỳ phản hồi công cụ nào
+- Claude không thể đọc, phân tích hoặc chuyển tiếp nội dung phiên âm dưới bất kỳ hình thức nào
+- Bản phiên âm chỉ tồn tại dưới dạng tệp cục bộ trên đĩa
+
+Chế độ này được thiết kế cho triển khai pháp lý, y tế, tài chính và doanh nghiệp nơi nội dung phiên âm không được rời khỏi môi trường cục bộ trong bất kỳ trường hợp nào.
+
+### Bật toàn cục (biến môi trường)
+
+Đặt trong `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "npx",
+      "args": ["-y", "whisper-windows-mcp"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
+        "WHISPER_PRIVACY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+Yêu cầu khởi động lại Claude Desktop để có hiệu lực.
+
+### Bật theo từng lệnh gọi (không cần khởi động lại)
+
+Truyền `privacy_mode=true` trực tiếp vào bất kỳ công cụ phiên âm nào:
+
+- *"Phiên âm tệp này ở chế độ quyền riêng tư"*
+- *"Bắt đầu đợt trên thư mục này, privacy_mode=true"*
+- *"Kiểm tra tiến trình job_123, privacy_mode=true"*
+
+Tham số theo từng lệnh gọi ghi đè biến môi trường toàn cục theo cả hai hướng. Truyền `privacy_mode=false` để tắt cho một lệnh gọi duy nhất ngay cả khi `WHISPER_PRIVACY_MODE=true` được đặt toàn cục.
+
+### Hành vi 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 được hiển thị **trước mỗi thao tác**. Điều này là có chủ ý — tuân thủ quy định yêu cầu sự đồng ý có hiểu biết trước mỗi sự kiện xử lý, không chỉ một lần mỗi phiên.
+
+Văn bản công khai giống nhau mỗi lần theo thiết kế. Sự lặp lại mới là điểm mấu chốt: nếu bạn đang xử lý nội dung nhạy cảm, bạn phải xác nhận rõ ràng từng thao tác.
+
+Đối với `start_batch` với chế độ quyền riêng tư: cần một xác nhận trước khi đợt bắt đầu. Tất cả tệp sau đó được xử lý không giám sát. Không có văn bản phiên âm nào được trả về ở bất kỳ thời điểm nào — chỉ có siêu dữ liệu tiến trình đợt.
+
+---
+
+## Cổng đồng ý (chế độ tiêu chuẩn)
+
+Khi chế độ quyền riêng tư không hoạt động, 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 của Claude lần đầu tiên trong một phiên.
+
+Công khai bao gồm:
+- Rằng văn bản phiên âm sẽ được truyền đến API của Anthropic
+- Các khung quy định có thể áp dụng cho nội dung của bạn
+- Cách bật chế độ quyền riêng tư nếu cần
+- Cách bỏ qua vĩnh viễn cổng cho nội dung không nhạy cảm
+
+Sau khi bạn xác nhận, cổng không kích hoạt lại cho phần còn lại của phiên. Khởi động lại Claude Desktop đặt lại phiên và cổng kích hoạt lại vào lần gọi trả về phiên âm tiếp theo.
+
+**Đối với tác vụ nền:** Cổng đồng ý kích hoạt khi hoàn thành `check_progress`, không phải khi gọi `transcribe_audio`. Tại thời điểm gọi, chưa có văn bản phiên âm nào tồn tại — cổng kích hoạt ngay khi văn bản phiên âm lần đầu tiên được trả về cho API.
+
+### Bỏ qua cổng vĩnh viễn
+
+Nếu bạn thường xuyên phiên âm nội dung không nhạy cảm và không cần nhắc nhở nữa, hãy đặt trong cấu hình của bạn:
+
+```json
+"WHISPER_CONSENT_ACKNOWLEDGED": "true"
+```
+
+Không có hiệu lực khi chế độ quyền riêng tư đang hoạt động. Chế độ quyền riêng tư sử dụng cổng theo từng thao tác riêng của nó luôn kích hoạt bất kể cài đặt này.
+
+---
+
+## Tóm tắt luồng dữ liệu
+
+| Chế độ | Âm thanh | Văn bản phiên âm | Cần xác nhận |
+|---|---|---|---|
+| Tiêu chuẩn | Chỉ cục bộ | Gửi đến Anthropic API | Một lần mỗi phiên (cổng đồng ý) |
+| Chế độ quyền riêng tư (biến môi trường) | Chỉ cục bộ | Không bao giờ truyền | Trước mỗi thao tác |
+| Chế độ quyền riêng tư (theo lệnh gọi) | Chỉ cục bộ | Không truyền cho lệnh gọi này | Trước thao tác này |
+| `WHISPER_CONSENT_ACKNOWLEDGED=true` | Chỉ cục bộ | Gửi đến Anthropic API | Không bao giờ (bỏ qua) |
+
+---
+
+## Tải tệp phiên âm trực tiếp lên Claude
+
+Khi bạn tải tệp `.txt` phiên âm trực tiếp lên Claude dưới dạng tệp đính kèm — hoàn toàn bên ngoài công cụ MCP — máy chủ MCP không có khả năng hiển thị và không thể áp dụng bất kỳ kiểm soát quyền riêng tư nào.
+
+Tải bản phiên âm trực tiếp lên Claude tương đương với việc gửi nội dung âm thanh cho Anthropic. Chế độ quyền riêng tư và tất cả bảo vệ cấp MCP bị bỏ qua hoàn toàn bởi việc tải tệp trực tiếp.
+
+Người dùng xử lý nội dung được quản lý không được tải bản phiên âm trực tiếp lên Claude. Con đường phân tích an toàn duy nhất cho nội dung được quản lý là các công cụ xử lý cục bộ không truyền nội dung ra ngoài.
+
+---
+
+## Hướng dẫn cho ngành được quản lý
+
+Thông tin dưới đây chỉ mang tính chất thông tin chung. Tác giả của công cụ này không phải là luật sư. Người dùng chịu trách nhiệm duy nhất về việc tuân thủ các luật và quy định hiện hành. Khi có nghi ngờ, hãy tham khảo ý kiến luật sư có trình độ trước khi phiên âm nội dung được quản lý.
+
+### HIPAA (Hoa Kỳ — chăm sóc sức khỏe)
+Các nhà cung cấp dịch vụ y tế, công ty bảo hiểm và các cộng sự kinh doanh của họ bị cấm truyền Thông tin Sức khỏe Được Bảo vệ (PHI) cho các bên thứ ba không được phép mà không có Thỏa thuận Cộng tác Kinh doanh (BAA). Anthropic không cung cấp HIPAA BAA cho việc sử dụng API người tiêu dùng Claude.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Tư vấn bệnh nhân, ghi chú lâm sàng, buổi trị liệu, cuộc gọi yêu cầu bảo hiểm, bản ghi hành chính bệnh viện.
+
+**Khuyến nghị:** Bật `WHISPER_PRIVACY_MODE=true` trước khi phiên âm bất kỳ âm thanh bệnh nhân nào. Không tắt nó giữa phiên.
+
+### GDPR (EU/EEA)
+Dữ liệu cá nhân của cư dân EU không thể được chuyển cho các bộ xử lý bên thứ ba mà không có sự đồng ý rõ ràng và cơ sở pháp lý để xử lý. Văn bản phiên âm chứa tên, địa điểm hoặc bất kỳ thông tin nhận dạng nào cấu thành dữ liệu cá nhân theo GDPR.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Phỏng vấn, cuộc họp, bản ghi trung tâm cuộc gọi, thủ tục tòa án liên quan đến cư dân EU.
+
+**Khuyến nghị:** Bật chế độ quyền riêng tư cho bất kỳ bản ghi nào có thể chứa dữ liệu cá nhân của cư dân EU/EEA.
+
+### Đặc quyền luật sư-khách hàng (Hoa Kỳ, Anh, Úc và hầu hết các thẩm quyền thông luật)
+Thông tin liên lạc giữa luật sư và khách hàng được bảo vệ pháp lý. Tiết lộ cho bên thứ ba không được phép có thể làm mất đặc quyền. Không có tiền lệ pháp lý được thiết lập bảo vệ thông tin liên lạc luật sư-khách hàng khi được xử lý bởi API AI thương mại.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Lời khai pháp lý, tư vấn khách hàng, bản ghi chiến lược nội bộ, phỏng vấn nhân chứng.
+
+**Khuyến nghị:** Luật sư phiên âm thông tin liên lạc có đặc quyền nên bật chế độ quyền riêng tư. Không tắt nó để phân tích — hãy sử dụng trình soạn thảo văn bản hoặc công cụ xử lý cục bộ cho nội dung có đặc quyền.
+
+### FERPA (Hoa Kỳ — giáo dục)
+Hồ sơ giáo dục của học sinh được bảo vệ. Các trường học và đại học không thể tiết lộ thông tin học sinh có thể nhận dạng cho bên thứ ba mà không có sự đồng ý.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Bài giảng được ghi lại, buổi tư vấn học sinh, phiên điều trần học thuật, cuộc họp IEP.
+
+### SOX (Hoa Kỳ — công ty đại chúng)
+Thông tin liên lạc tài chính của các công ty đại chúng phải tuân theo các yêu cầu lưu giữ hồ sơ và bảo mật. Thông tin quan trọng không công khai (MNPI) không thể được tiết lộ có chọn lọc.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Bản ghi cuộc họp kết quả kinh doanh, biên bản cuộc họp hội đồng quản trị, thông tin liên lạc với nhà đầu tư, thảo luận chiến lược tài chính nội bộ.
+
+### PCI-DSS
+Dữ liệu thẻ thanh toán không thể được lưu trữ hoặc truyền trong môi trường không an toàn. Bản ghi âm thanh số thẻ trong giao dịch nằm trong phạm vi.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Bản ghi trung tâm cuộc gọi, cuộc gọi dịch vụ khách hàng liên quan đến xử lý thanh toán.
+
+### Bảo mật bí mật thương mại / NDA
+Thông tin kinh doanh bí mật, công thức độc quyền, chi tiết sản phẩm chưa phát hành và thông tin nhân sự có thể được bảo vệ theo hợp đồng hoặc pháp luật.
+
+**Các trường hợp sử dụng bị ảnh hưởng:** Cuộc họp chiến lược doanh nghiệp, thảo luận R&D, cuộc gọi thẩm định M&A, thủ tục nhân sự.
+
+---
+
+## Báo cáo lo ngại về quyền riêng tư
+
+Nếu bạn xác định vấn đề quyền riêng tư hoặc khoảng cách kiến trúc không được đề cập ở đây, vui lòng sử dụng báo cáo lỗ hổng riêng tư của GitHub thay vì mở issue công khai. Xem [SECURITY.md](SECURITY.md) để biết hướng dẫn báo cáo.

package/README.es.md

@@ -17,6 +17,7 @@ Después de instalar, simplemente habla en Claude Desktop:
 - *"Inicia la transcripción por lotes de todos los archivos en esta carpeta"*
 - *"¿Cuánto tiempo tardará en transcribir estos archivos?"*
 - *"Verifica si la aceleración por GPU está funcionando"*
+- *"Transcribe este archivo en modo de privacidad"*
 
 ---
 
@@ -163,50 +164,54 @@ Transcribe un único archivo. Soporta modo de bloqueo (predeterminado) o en segu
 |---|---|
 | `file_path` | Ruta absoluta al archivo (obligatorio) |
 | `language` | Código de idioma (`es`, `en`, `ja` etc.) o `auto` para detección automática. Predeterminado: `en` |
-| `output_format` | `text` (predeterminado), `timestamps`, `json` o `srt` |
+| `output_format` | `timestamps` (predeterminado), `text`, `json`, `srt`, `vtt`, `lrc` o `csv` |
 | `save_to_file` | Guarda la transcripción como .txt junto al archivo de origen |
 | `background` | Ejecuta como tarea separada — devuelve ID de tarea inmediatamente. Usa `check_progress` para monitorear. Recomendado para archivos de más de 10 minutos. |
+| `privacy_mode` | Anula el modo de privacidad para esta llamada. `true` = solo metadatos, sin texto de transcripción transmitido. `false` = devuelve texto incluso si `WHISPER_PRIVACY_MODE=true` globalmente. Omite para usar la configuración global. |
 | `threads` | Anula el número de hilos de CPU |
-| `temperature` | Temperatura de muestreo 0,0–1,0. Predeterminado 0,0 (determinista). Valores más altos reducen alucinaciones en audio ruidoso. |
-| `prompt` | Cadena de contexto previo — mejora la precisión para vocabulario específico de dominio o nombres de hablantes. Ej.: `"Nombres: Keemstar, DramaAlert."` |
+| `temperature` | Temperatura de muestreo 0,0–1,0. Predeterminado 0,0 (determinista). |
+| `prompt` | Cadena de contexto previo — mejora la precisión para vocabulario de dominio específico o nombres de hablantes. Ej.: `"Nombres: Keemstar, DramaAlert."` |
 | `condition_on_prev_text` | Reactiva el condicionamiento de contexto entre segmentos. Predeterminado false. |
-| `beam_size` | Ancho de búsqueda beam. Mayor = más preciso, más lento. Predeterminado 5. |
-| `best_of` | Número de secuencias candidatas evaluadas. Predeterminado 5. |
+| `beam_size` | Anchura de búsqueda en haz. Mayor = más preciso, más lento. Predeterminado 5. |
+| `best_of` | Secuencias candidatas evaluadas. Predeterminado 5. |
 | `gpu_device` | Índice de dispositivo GPU para sistemas multi-GPU. Predeterminado 0. |
-| `processors` | Número de procesadores paralelos. Predeterminado 1. |
+| `processors` | Recuento de procesadores paralelos. Predeterminado 1. |
 | `word_timestamps` | Una palabra por segmento con marca de tiempo. Útil para alineación de clips. |
-| `max_segment_length` | Longitud máxima del segmento en caracteres. |
+| `max_segment_length` | Longitud máxima de segmento en caracteres. |
 | `diarize` | Diarización de hablantes estéreo — requiere audio estéreo con hablantes en canales separados. |
-| `vad_model` | Ruta al archivo .bin del modelo Silero VAD. Elimina silencio antes de transcribir — reduce alucinaciones en archivos ruidosos. |
+| `vad_model` | Ruta al archivo .bin del modelo Silero VAD. Elimina silencios antes de transcribir — reduce alucinaciones en archivos ruidosos. |
 | `offset_t` | Desplazamiento de inicio en milisegundos. |
-| `duration` | Duración a procesar en milisegundos desde el desplazamiento. |
+| `duration` | Duración a procesar desde el desplazamiento en milisegundos. |
 
 ---
 
 ### `check_progress`
 Monitorea una tarea de transcripción en segundo plano iniciada con `transcribe_audio` (background=true).
 
-Devuelve el tiempo transcurrido, la última marca de tiempo procesada, el porcentaje y la transcripción completa al terminar.
+Devuelve el tiempo transcurrido, la última marca de tiempo procesada y la transcripción completa al finalizar.
 
 | Parámetro | Descripción |
 |---|---|
 | `job_id` | ID de tarea devuelto por `transcribe_audio` |
+| `privacy_mode` | Anula el modo de privacidad para esta llamada. |
 
 ---
 
 ### `start_batch`
-Transcribe automáticamente y en secuencia todos los archivos aún no transcritos en una carpeta. Ordena por duración (más cortos primero), procesa uno por uno como tareas en segundo plano y valida cada salida.
+Transcribe automáticamente en secuencia todos los archivos no transcritos en una carpeta. Ordena cronológicamente (los más cortos primero), procesa uno a uno como tarea en segundo plano y valida cada salida.
 
 | Parámetro | Descripción |
 |---|---|
 | `folder_path` | Ruta a la carpeta (obligatorio) |
 | `language` | Código de idioma. Predeterminado: `en` |
+| `output_format` | `timestamps` (predeterminado), `text`, `srt`, `vtt`, `lrc`, `csv` |
+| `privacy_mode` | Anula el modo de privacidad para este lote. |
 | `threads` | Anula el número de hilos de CPU |
 
 ---
 
 ### `check_batch_progress`
-Monitorea un lote en ejecución. Avanza automáticamente al siguiente archivo cuando el actual termina. Devuelve el progreso general, el archivo actual con marca de tiempo, el ETA y los archivos con error.
+Monitorea un lote en ejecución. Avanza automáticamente al siguiente archivo cuando el actual se completa. Devuelve el progreso general, el archivo actual con marca de tiempo, ETA y archivos fallidos.
 
 | Parámetro | Descripción |
 |---|---|
@@ -215,32 +220,34 @@ Monitorea un lote en ejecución. Avanza automáticamente al siguiente archivo cu
 ---
 
 ### `transcribe_batch` (interactivo)
-Procesa archivos uno por uno con vista previa y confirmación antes de cada uno. Útil cuando quieres revisar a medida que avanzas.
+Procesa archivos uno a uno con vista previa y confirmación antes de cada archivo. Útil cuando quieres revisar sobre la marcha.
 
 | Parámetro | Descripción |
 |---|---|
 | `folder_path` | Ruta a la carpeta (obligatorio) |
-| `file_index` | Qué archivo procesar (comienza en 1). Omite para listar los archivos primero. |
+| `file_index` | Archivo a procesar (empieza en 1). Omite para listar archivos primero. |
 | `language` | Código de idioma. Predeterminado: `en` |
 | `recursive` | Incluir subcarpetas |
 
 ---
 
 ### `generate_subtitles`
-Genera archivos de subtítulos SRT. Soporta detección automática de idioma y salida de traducción al inglés.
+Genera archivos de subtítulos. Soporta detección automática de idioma y salida de traducción al inglés.
 
 | Parámetro | Descripción |
 |---|---|
 | `file_path` | Ruta al archivo (obligatorio) |
 | `language` | Código de idioma o `auto` para detección automática. Predeterminado: `en` |
-| `translate_to_english` | También genera `.en.srt` con traducción al inglés. Solo aplica cuando el origen no es inglés. |
+| `output_format` | `srt` (predeterminado) o `vtt` |
+| `translate_to_english` | También genera un archivo de subtítulos con traducción al inglés. Solo aplica cuando el origen no es inglés. |
+| `background` | Ejecuta como tarea en segundo plano separada. Devuelve un ID de tarea para `check_progress`. |
 | `threads` | Anula el número de hilos de CPU |
 
 Cuando ambos son solicitados, dos archivos se guardan junto al origen:
 - `archivo.es.srt` — idioma original
 - `archivo.en.srt` — traducción al inglés
 
-> La traducción integrada de Whisper solo traduce **al inglés**. Para otros idiomas de destino, procesa el contenido del archivo .srt por separado.
+> La traducción integrada de Whisper solo traduce **al inglés**. Para otros idiomas de destino, procesa el contenido del archivo `.srt` por separado.
 
 ---
 
@@ -265,7 +272,7 @@ Lista todos los archivos de modelo Whisper instalados en tu directorio de modelo
 ---
 
 ### `download_model`
-Descarga un modelo Whisper directamente desde Hugging Face a tu directorio de modelos. Acepta el nombre del modelo (ej.: `large-v3-turbo`, `medium.en-q5_0`) y gestiona la descarga automáticamente. Solo descarga desde espacios de nombres de Hugging Face de confianza. Después de descargar, usa `switch_model` para activar.
+Descarga un modelo Whisper directamente desde Hugging Face a tu directorio de modelos. Solo descarga desde espacios de nombres de Hugging Face de confianza. Después de descargar, usa `switch_model` para activar.
 
 | Parámetro | Descripción |
 |---|---|
@@ -301,14 +308,16 @@ Detecta el hardware GPU y confirma si la aceleración Vulkan está disponible. R
 
 El release Vulkan precompilado activa la aceleración por GPU automáticamente. Probado en AMD Radeon RX Vega 56 (GCN 5ª generación). Cualquier GPU con soporte Vulkan 1.0+ debería funcionar, incluyendo NVIDIA e Intel Arc.
 
-**Comparación de rendimiento (modelo medium.en, archivo de audio ~5 minutos):**
+**Comparación de rendimiento (modelo large-v3, archivo de audio ~14 minutos):**
 
 | Hardware | Tiempo |
 |---|---|
-| Solo CPU (Ryzen 7 2700x, 8 hilos) | 8–12 minutos |
-| GPU (Vega 56 via Vulkan) | 20–40 segundos |
+| Solo CPU (Ryzen 7 2700x, 8 hilos) | ~22 minutos (estimado) |
+| GPU (Vega 56 via Vulkan) | ~3 min 22 seg |
 
-La utilización de GPU durante la transcripción es típicamente del 15–20%, volviendo al estado inactivo entre archivos. La CPU se mantiene alrededor del 15%.
+La utilización de GPU durante la transcripción es típicamente del 15–20%, volviendo al estado inactivo entre archivos.
+
+Compatible con Windows 10 y Windows 11. No se requiere configuración específica para Windows 11 — la herramienta no realiza llamadas directas a la API Win32 y funciona en ambos sistemas operativos.
 
 ---
 
@@ -320,9 +329,25 @@ Para la mejor precisión multilingüe, usa el modelo `large-v3`. Los modelos sol
 
 **Ejemplo — video en idioma extranjero con subtítulos:**
 1. Pide a Claude generar subtítulos con `language=auto` y `translate_to_english=true`
-2. Whisper detecta el idioma y genera el SRT en el idioma original
-3. Un segundo pase genera el SRT con traducción al inglés
-4. Carga cualquiera de los archivos en VLC via Subtítulos → Agregar Archivo de Subtítulos
+2. Whisper detecta el idioma y genera el SRT o VTT en el idioma original
+3. Un segundo pase genera la traducción al inglés
+4. Carga el SRT en VLC via Subtítulos → Agregar Archivo de Subtítulos, o usa el VTT en cualquier reproductor web
+
+---
+
+## Privacidad y cumplimiento
+
+whisper-windows-mcp incluye una arquitectura de privacidad integrada para contenido sensible y regulado.
+
+**El audio y video nunca salen de tu máquina.** Esta garantía es incondicional.
+
+**El texto de transcripción** es diferente — cuando se devuelve en línea en una respuesta de herramienta, es procesado por la API de Claude. Para la mayoría de los usuarios esto es el comportamiento esperado. Para contenido regulado (médico, jurídico, financiero, corporativo), el modo de privacidad lo previene.
+
+**El modo de privacidad** restringe todas las respuestas de herramientas solo a metadatos (nombre de archivo, conteo de palabras, ruta de guardado). Ningún texto de transcripción es transmitido a la API de Claude bajo ninguna circunstancia. Actívalo por llamada con `privacy_mode=true` en cualquier herramienta de transcripción, o globalmente via `WHISPER_PRIVACY_MODE=true` en tu configuración.
+
+**Puerta de consentimiento** — en el primer uso por sesión en modo estándar, se muestra una divulgación de privacidad completa antes de que se devuelva cualquier texto de transcripción. Debes confirmar explícitamente antes de continuar. Establece `WHISPER_CONSENT_ACKNOWLEDGED=true` en tu configuración para omitir esto en contenido no sensible.
+
+Ver [PRIVACY.md](PRIVACY.md) para orientación de cumplimiento completa (HIPAA, GDPR, privilegio abogado-cliente, FERPA, SOX, PCI-DSS).
 
 ---
 
@@ -340,33 +365,20 @@ Esta herramienta fue creada para minimizar las interacciones con la API de Claud
 | `WHISPER_MODEL` | Ruta al archivo de modelo .bin (obligatorio) |
 | `WHISPER_THREADS` | Anula el número de hilos de CPU |
 | `FFMPEG_PATH` | Ruta a ffmpeg si no está en el PATH del sistema |
-| `WHISPER_PRIVACY_MODE` | **Planificado.** Cuando se establece en `true`, las respuestas de herramientas solo devuelven metadatos — ningún texto de transcripción es devuelto a Claude. Para contenido regulado o confidencial. Ver [PRIVACY.md](PRIVACY.md). |
-
----
-
-## Solución de problemas
-
-Ver [TROUBLESHOOTING.md](TROUBLESHOOTING.md) para soluciones detalladas. Ver [PRIVACY.md](PRIVACY.md) si manejas contenido regulado.
-
-Lista de verificación rápida:
-- Las rutas en la configuración usan **barras invertidas dobles** (`C:\\whisper\\...`)
-- `whisper-cli.exe` existe en la ruta configurada
-- El archivo de modelo `.bin` existe en la ruta configurada
-- FFmpeg instalado y en el PATH (`ffmpeg -version` funciona)
-- Claude Desktop fue **completamente reiniciado** después de editar la configuración
-- Whisper aparece como **en ejecución** (insignia verde) en Configuración → Desarrollador
+| `WHISPER_PRIVACY_MODE` | Establece en `true` para que todas las respuestas de herramientas devuelvan solo metadatos — ningún texto de transcripción devuelto a Claude. Para contenido regulado o confidencial. Puede anularse por llamada con el parámetro `privacy_mode`. Ver [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_CONSENT_ACKNOWLEDGED` | Establece en `true` para omitir la divulgación de consentimiento única por sesión que se muestra antes de devolver texto de transcripción. Establécelo cuando entiendas los límites de privacidad y ya no necesites el recordatorio. Sin efecto cuando el modo de privacidad está activo. |
 
 ---
 
-## Seguridad y privacidad
-
-whisper-windows-mcp fue diseñado con la seguridad como principio central.
+## Seguridad
 
-**El audio nunca sale de tu máquina.** Ningún archivo de audio o video, ruta de archivo o telemetría es transmitido a ningún servidor. No se necesita ninguna API de nube para la funcionalidad principal.
+**Verificación del binario.** Para verificar la integridad del binario whisper-cli.exe en el release precompilado, comprueba su hash SHA256 en PowerShell:
 
-**Texto de transcripción y el límite de la API.** Cuando una respuesta de herramienta incluye texto de transcripción, ese texto es procesado por la API de Claude — sale de tu máquina local. Para la mayoría de los usuarios (contenido público, podcasts, grabaciones de streaming) esto es un comportamiento esperado. Si manejas grabaciones médicas, legales, financieras u otras reguladas, ver [PRIVACY.md](PRIVACY.md) para orientación de cumplimiento y opciones de configuración.
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
 
-La variable de entorno `WHISPER_PRIVACY_MODE` está planificada y limitará todas las respuestas de herramientas solo a metadatos (nombre de archivo, duración, conteo de palabras) — ningún texto de transcripción será devuelto a Claude. Esta es la configuración correcta para contenido regulado o confidencial.
+El hash esperado está documentado en la [página de releases](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0).
 
 **Validación de entrada.** Todas las rutas de archivo son validadas antes de su uso — las rutas UNC (`\\server\share`) y las secuencias de traversal de directorio (`..`) son rechazadas. Los archivos de más de 10 GB son rechazados para prevenir el agotamiento de recursos.
 
@@ -376,7 +388,21 @@ La variable de entorno `WHISPER_PRIVACY_MODE` está planificada y limitará toda
 
 **El cambio de modelos está en sandbox.** `switch_model` solo acepta archivos `.bin` dentro del directorio de modelos configurado. Las rutas fuera de ese directorio son rechazadas.
 
-**Sin nuevas dependencias de red.** Las descargas de modelos usan el `https` integrado de Node.js — no se agrega ninguna biblioteca HTTP externa al paquete.
+Ver [SECURITY.md](SECURITY.md) para la política de seguridad completa.
+
+---
+
+## Solución de problemas
+
+Ver [TROUBLESHOOTING.md](TROUBLESHOOTING.md) para soluciones detalladas. Ver [PRIVACY.md](PRIVACY.md) si manejas contenido regulado.
+
+Lista de verificación rápida:
+- Las rutas en la configuración usan **barras invertidas dobles** (`C:\\whisper\\...`)
+- `whisper-cli.exe` existe en la ruta configurada
+- El archivo de modelo `.bin` existe en la ruta configurada
+- FFmpeg instalado y en el PATH (`ffmpeg -version` funciona)
+- Claude Desktop fue **completamente reiniciado** después de editar la configuración
+- Whisper aparece como **en ejecución** (insignia verde) en Configuración → Desarrollador
 
 ---
 
@@ -384,7 +410,7 @@ La variable de entorno `WHISPER_PRIVACY_MODE` está planificada y limitará toda
 
 **Uso no comercial:** MIT — gratuito para uso personal, educativo y no comercial. Ver [LICENSE](LICENSE).
 
-**Uso comercial:** Se requiere un acuerdo de licencia comercial separado para cualquier uso empresarial, profesional o que genere ingresos. Ver [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md) para los términos e información de contacto.
+**Uso comercial:** Se requiere un acuerdo de licencia comercial separado para cualquier uso empresarial, profesional o que genere ingresos. Ver [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) para los términos e información de contacto.
 
 ## Contribuciones