VoiceInk Custom Commands: gửi bản đọc chính tả của bạn vào một script thay vì dán
Bài viết: Ryleigh Newman · Đăng ngày
Custom Command (lệnh tùy chỉnh) là một trong các chế độ đầu ra của VoiceInk. Thay vì dán, VoiceInk đưa văn bản hoàn chỉnh của một lần đọc chính tả cho một lệnh shell do bạn viết, và lệnh đó quyết định chuyện gì xảy ra tiếp theo: ghi nó vào một ghi chú, mở một lượt tìm kiếm, gọi script của riêng bạn, hoặc gửi nó đến một dịch vụ bạn tự chạy. Đây là cách linh hoạt nhất mà VoiceInk xử lý văn bản, và nó có vài giới hạn cứng nên biết trước khi bạn xây dựng thêm trên đó.
Tôi phát triển YapToText, một ứng dụng đọc chính tả khác dành cho máy Mac, nên hãy đọc những gì tôi nói về VoiceInk với điều đó trong đầu. Mọi thông tin về VoiceInk ở đây lấy từ tài liệu của chính họ, đọc vào ngày 10 tháng 10 năm 2026.
Tải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.
Hướng dẫn này bằng ngôn ngữ khác: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, 简体中文, 繁體中文
Trong trang này: 11 phần
Lệnh nhận được gì
VoiceInk gửi cùng một văn bản cuối cùng theo hai cách: qua đầu vào chuẩn, và trong biến $VOICEINK_TRANSCRIPT. Văn bản ở dạng UTF-8, và tài liệu yêu cầu bạn đặt biến trong dấu ngoặc kép để khoảng trắng, dấu câu và ngắt dòng được giữ nguyên.
- AI Enhancement (cải thiện bằng AI) tắt. Bản chép lời sau khi VoiceInk định dạng và thay từ.
- AI Enhancement bật và hoạt động. Văn bản đã được cải thiện.
- AI Enhancement bị bỏ qua hoặc thất bại. Bản chép lời cuối cùng ở dạng thuần.
Lệnh không bao giờ nhận trực tiếp âm thanh, prompt, hay văn bản được chọn, trong bảng nhớ tạm hoặc trên màn hình. Nếu bạn muốn ngữ cảnh định hình kết quả, tài liệu bảo hãy dùng một prompt và Context Awareness (nhận biết ngữ cảnh), để nó đã nằm sẵn trong văn bản cuối cùng.
Nó chạy thế nào
Theo tài liệu của VoiceInk, mục Custom Commands, đọc vào ngày 10 tháng 10 năm 2026.
| Chi tiết | Hành vi |
|---|---|
| Shell | /bin/zsh -lc |
| Thời hạn | 10 giây, sau đó VoiceInk dừng lệnh |
| Quyền | Cùng quyền người dùng macOS với VoiceInk |
| Trình ghi âm | Được đóng trước khi lệnh bắt đầu |
| Thành công | Mã thoát 0. Bất cứ gì khác đều tính là thất bại |
| Đầu ra | Đầu ra chuẩn và lỗi được giữ lại để chẩn đoán, không bao giờ được dán vào ứng dụng |
| Không tìm thấy lệnh | VoiceInk thử PATH của shell bạn. Nếu thất bại, hãy dùng đường dẫn đầy đủ như /opt/homebrew/bin/tool |
Những giới hạn hay làm người ta vấp
- Không có gì được dán giúp bạn. Nếu bạn vẫn muốn văn bản nằm trong ứng dụng, lệnh của bạn phải tự sao chép hoặc dán nó.
- Mười giây, không có câu hỏi. Lệnh không thể chờ nhập liệu. Với việc lâu hơn, hãy tự khởi chạy một tiến trình nền rồi thoát nhanh.
- Nó không thay đổi bản chép lời đã lưu. Những gì lệnh in ra sẽ không được ghi ngược lại.
- Không có Auto Send. Auto Send chỉ hoạt động với đầu ra Paste (dán), không với Custom Command.
- Chỉ với đọc chính tả trực tiếp. Các tệp trong hàng đợi Transcribe file (chép lời tệp) được lưu mà không chạy lệnh đầu ra.
- Không có lệnh trống. Một Mode (chế độ) có lệnh trống không thể được lưu.
Các mẫu có sẵn
Theo tài liệu của VoiceInk, mục Custom Commands, đọc vào ngày 10 tháng 10 năm 2026.
| Mẫu | Nó làm gì |
|---|---|
| Paste and Press Tab | Sao chép văn bản, dán nó, rồi nhấn Tab |
| Lowercase and Paste | Chuyển văn bản thành chữ thường, sao chép rồi dán |
| Remove Trailing Period and Paste | Bỏ một dấu chấm ở cuối trước khi dán |
| Append to Journal | Thêm văn bản vào ~/Documents/VoiceInk/journal.md |
| Search Web | Mở một lượt tìm kiếm web cho văn bản |
Tài liệu gợi ý bắt đầu từ một mẫu rồi chỉnh sửa. Hai ví dụ đơn giản nhất của họ là sao chép văn bản và ghi nối nó vào một ghi chú:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Kiểm tra xem nó có chạy được không
VoiceInk không hiện thông báo thành công hay thất bại sau một Custom Command. Tài liệu đưa ra một lệnh Terminal hiển thị nhật ký chuyển giao trong 10 phút gần nhất, gồm cả việc lệnh thành công, thất bại hay chạy quá 10 giây:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Tài liệu cảnh báo rằng các nhật ký này có thể chứa văn bản bạn đã đọc. Và nếu lệnh của bạn gửi văn bản đến một dịch vụ web thì dịch vụ đó nhận được nó: VoiceInk chỉ chạy những gì bạn đã cấu hình.
YapToText đứng ở đâu
VoiceInk lấy từ tài liệu của họ, đọc vào ngày 10 tháng 10 năm 2026. YapToText lấy từ cài đặt của chính nó.
| VoiceInk | YapToText | |
|---|---|---|
| Chạy một lệnh shell với văn bản | Có, đầu ra Custom Command | Không |
| Dán tại con trỏ | Đầu ra Paste | Paste, là mặc định |
| Gõ thay vì dán | Trang này không mô tả | Type character by character (gõ từng ký tự) |
| Chỉ vào bảng nhớ tạm | Với một lệnh như pbcopy | Copy to clipboard only |
| Nhấn một phím sau đó | Mẫu Paste and Press Tab | Return hoặc Command Return cho từng ứng dụng |
| Xem lại trước khi văn bản vào | Trang này không mô tả | Review before inserting, mặc định tắt |
Nếu bạn muốn việc đọc chính tả điều khiển các script của riêng mình thì Custom Command của VoiceInk làm được điều mà YapToText không làm. Nếu bạn muốn văn bản nằm ở con trỏ, khớp với những từ xung quanh, thì YapToText làm điều đó theo mặc định và không cần script. Trang VoiceInk Modes nói về nơi đặt các chế độ đầu ra, còn VoiceInk so với superwhisper so sánh nó với một ứng dụng khác xây dựng quanh các chế độ.
Tải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.
Tóm tắt nhanh
- Nó là gì. Một chế độ đầu ra chạy lệnh shell của bạn với văn bản cuối cùng.
- Văn bản. Trên đầu vào chuẩn và trong $VOICEINK_TRANSCRIPT.
- Giới hạn. 10 giây, không nhập liệu, không tự động dán, chỉ với đọc chính tả trực tiếp.
- Gỡ lỗi. Không có thông báo trong ứng dụng. Hãy đọc nhật ký bằng lệnh Terminal ở trên.
- Bắt đầu từ đây. Chỉnh sửa một trong năm mẫu.
Nếu VoiceInk thay đổi cách Custom Commands hoạt động, hãy mở một issue trên GitHub và tôi sẽ cập nhật trang này. Tôi đọc tất cả.
Tải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.
Hướng dẫn
Hướng dẫn khác, bằng tiếng Anh
Nguồn
- https://tryvoiceink.com/docs/custom-commands (kiểm tra ngày 10/10/2026)
- https://tryvoiceink.com/docs/mode-settings (kiểm tra ngày 10/10/2026)
- https://github.com/ryleighnewman/YapToText (kiểm tra ngày 10/10/2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kiểm tra ngày 10/10/2026)
Câu hỏi
Custom Command trong VoiceInk là gì?
Là một chế độ đầu ra. Thay vì dán, VoiceInk chạy một lệnh shell do bạn viết và đưa cho nó văn bản cuối cùng của lần đọc chính tả.
Custom Command của VoiceInk nhận văn bản bằng cách nào?
Qua đầu vào chuẩn và trong biến $VOICEINK_TRANSCRIPT, ở dạng UTF-8. Hãy đặt biến trong dấu ngoặc kép để giữ khoảng trắng và ngắt dòng.
Vì sao Custom Command của VoiceInk không dán gì cả?
Đầu ra Custom Command không tự dán. Lệnh của bạn phải tự sao chép hoặc dán văn bản, như mẫu Paste and Press Tab làm.
Một Custom Command của VoiceInk được chạy trong bao lâu?
10 giây. Sau đó VoiceInk dừng nó. Hãy khởi chạy một tiến trình nền cho việc lâu hơn.
YapToText có lệnh tùy chỉnh như VoiceInk không?
Nó không chạy lệnh shell sau một lần đọc chính tả. Nó dán hoặc gõ tại con trỏ, có thể chỉ sao chép vào bảng nhớ tạm, và có thể nhấn Return sau khi văn bản vào.