VoiceInk Custom Commands: trimiteți dictarea unui script în loc să o lipiți
Text: Ryleigh Newman · Publicat la
Custom Command este unul dintre modurile de ieșire ale VoiceInk. În loc să lipească textul, VoiceInk dă textul final al unei dictări unei comenzi shell scrise de dvs., iar acea comandă decide ce se întâmplă: îl adaugă la o notiță, deschide o căutare, apelează propriul script sau îl postează către un serviciu pe care îl rulați. Este cel mai flexibil lucru pe care îl face VoiceInk cu textul și are câteva limite stricte care merită cunoscute înainte să construiți pe el.
Am creat YapToText, o altă aplicație de dictare pentru Mac, așa că citiți ce spun despre VoiceInk ținând cont de asta. Fiecare fapt despre VoiceInk de aici vine din propria documentație, citită pe 10 octombrie 2026.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Acest ghid în alte limbi: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Pe această pagină: 11 secțiuni
Ce primește comanda
VoiceInk trimite același text final în două moduri: la intrarea standard și în variabila $VOICEINK_TRANSCRIPT. Textul este UTF-8, iar documentația cere să puneți variabila între ghilimele, ca spațiile, punctuația și sfârșiturile de rând să se păstreze.
- AI Enhancement dezactivat. Transcrierea de după formatarea VoiceInk și înlocuirile de cuvinte.
- AI Enhancement activat și funcțional. Textul îmbunătățit.
- AI Enhancement omis sau eșuat. Transcrierea finală simplă.
Comanda nu primește niciodată direct sunetul, promptul sau textul selectat, din clipboard ori de pe ecran. Dacă vreți ca un context să influențeze rezultatul, documentația spune să folosiți un prompt și Context Awareness, astfel încât contextul să fie deja în textul final.
Cum rulează
Din documentația VoiceInk, Custom Commands, citită pe 10 octombrie 2026.
| Detaliu | Comportament |
|---|---|
| Shell | /bin/zsh -lc |
| Timp limită | 10 secunde, apoi VoiceInk oprește comanda |
| Permisiuni | Aceleași permisiuni de utilizator macOS ca ale VoiceInk |
| Recorderul | Este închis înainte de pornirea comenzii |
| Succes | Cod de ieșire 0. Orice altceva se socotește eșec |
| Ieșirea | Ieșirea standard și erorile se păstrează pentru diagnosticare și nu sunt lipite niciodată în aplicație |
| Comenzi negăsite | VoiceInk încearcă PATH-ul shell-ului dvs. Dacă nu merge, folosiți o cale completă, precum /opt/homebrew/bin/tool |
Limitele care îi surprind pe oameni
- Nimic nu se lipește de la sine. Dacă tot vreți textul în aplicație, comanda dvs. trebuie să îl copieze sau să îl lipească ea însăși.
- Zece secunde, fără întrebări. Comanda nu poate aștepta introducere de date. Pentru lucruri mai lungi, porniți propriul proces în fundal și ieșiți repede.
- Nu schimbă transcrierea salvată. Ce afișează comanda nu se scrie înapoi.
- Fără Auto Send. Auto Send funcționează doar cu ieșirea Paste, nu cu Custom Command.
- Doar dictare în direct. Fișierele din coada Transcribe file se salvează fără să ruleze comenzile de ieșire.
- Fără comandă goală. Un Mode cu comanda goală nu poate fi salvat.
Șabloanele încorporate
Din documentația VoiceInk, Custom Commands, citită pe 10 octombrie 2026.
| Șablon | Ce face |
|---|---|
| Paste and Press Tab | Copiază textul, îl lipește, apoi apasă Tab |
| Lowercase and Paste | Trece textul în litere mici, îl copiază, apoi îl lipește |
| Remove Trailing Period and Paste | Elimină un punct final înainte de lipire |
| Append to Journal | Adaugă textul în ~/Documents/VoiceInk/journal.md |
| Search Web | Deschide o căutare web pentru text |
Documentația sugerează să porniți de la un șablon și să îl editați. Două dintre cele mai simple exemple ale lor, copierea textului și adăugarea lui la o notiță:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Verificarea că a mers
VoiceInk nu afișează niciun mesaj de succes sau de eșec după un Custom Command. Documentația dă o comandă Terminal care arată ultimele 10 minute de jurnale de livrare, inclusiv dacă comanda a reușit, a eșuat sau a depășit 10 secunde:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Documentația avertizează că aceste jurnale pot conține text dictat. Iar dacă comanda dvs. trimite text către un serviciu web, acel serviciu îl primește: VoiceInk rulează doar ce ați configurat.
Unde se situează YapToText
VoiceInk din documentația lui, citită pe 10 octombrie 2026. YapToText din propriile setări.
| VoiceInk | YapToText | |
|---|---|---|
| Rulează o comandă shell cu textul | Da, ieșirea Custom Command | Nu |
| Lipește la cursor | Ieșirea Paste | Paste, cea implicită |
| Îl tastează în loc să îl lipească | Nu este descris pe această pagină | Type character by character (tastare caracter cu caracter) |
| Doar în clipboard | Cu o comandă precum pbcopy | Copy to clipboard only (doar copiere în clipboard) |
| Apasă o tastă după | Șablonul Paste and Press Tab | Return sau Command Return, pentru fiecare aplicație |
| Verificare înainte de inserare | Nu este descris pe această pagină | Review before inserting (verificare înainte de inserare), dezactivată implicit |
Dacă vreți ca dictarea să vă comande propriile scripturi, Custom Command din VoiceInk face ceva ce YapToText nu face. Dacă vreți text la cursor, adaptat cuvintelor din jur, YapToText face asta implicit și nu cere niciun script. Pagina despre VoiceInk Modes arată unde se setează modurile de ieșire, iar VoiceInk față de superwhisper îl compară cu o altă aplicație construită în jurul modurilor.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Pe scurt
- Ce este. Un mod de ieșire care rulează comanda dvs. shell cu textul final.
- Textul. La intrarea standard și în $VOICEINK_TRANSCRIPT.
- Limite. 10 secunde, fără introducere de date, fără lipire automată, doar dictare în direct.
- Depanare. Niciun mesaj în aplicație. Citiți jurnalul cu comanda Terminal de mai sus.
- Începeți de aici. Editați unul dintre cele cinci șabloane.
Dacă VoiceInk schimbă modul în care funcționează Custom Commands, deschideți un issue pe GitHub și voi actualiza această pagină. Le citesc pe toate.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Ghiduri
Alte ghiduri, în engleză
Surse
- https://tryvoiceink.com/docs/custom-commands (verificat la 10.10.2026)
- https://tryvoiceink.com/docs/mode-settings (verificat la 10.10.2026)
- https://github.com/ryleighnewman/YapToText (verificat la 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (verificat la 10.10.2026)
Întrebări
Ce este un Custom Command în VoiceInk?
Un mod de ieșire. În loc să lipească textul, VoiceInk rulează o comandă shell scrisă de dvs. și îi dă textul final al dictării.
Cum primește un Custom Command din VoiceInk textul?
La intrarea standard și în variabila $VOICEINK_TRANSCRIPT, în UTF-8. Puneți variabila între ghilimele ca să păstrați spațiile și sfârșiturile de rând.
De ce nu a lipit nimic Custom Command-ul meu din VoiceInk?
Ieșirea Custom Command nu lipește de la sine. Comanda dvs. trebuie să copieze sau să lipească textul ea însăși, cum face șablonul Paste and Press Tab.
Cât timp poate rula un Custom Command din VoiceInk?
10 secunde. După aceea VoiceInk îl oprește. Pentru lucruri mai lungi, porniți un proces în fundal.
Are YapToText comenzi personalizate ca VoiceInk?
Nu rulează comenzi shell după o dictare. Lipește sau tastează la cursor, poate copia doar în clipboard și poate apăsa Return după ce textul ajunge.