VoiceInk Custom Commands: στείλτε την υπαγόρευσή σας σε σενάριο αντί να την επικολλήσετε

Το Custom Command (προσαρμοσμένη εντολή) είναι ένας από τους τρόπους εξόδου του VoiceInk. Αντί να επικολλήσει, το VoiceInk δίνει το έτοιμο κείμενο μιας υπαγόρευσης σε μια εντολή shell που γράφετε εσείς, και η εντολή αποφασίζει τι θα γίνει: να προστεθεί σε μια σημείωση, να ανοίξει μια αναζήτηση, να καλέσει δικό σας σενάριο ή να σταλεί σε μια υπηρεσία που τρέχετε. Είναι το πιο ευέλικτο πράγμα που κάνει το VoiceInk με το κείμενο, και έχει μερικά αυστηρά όρια που αξίζει να γνωρίζετε πριν χτίσετε πάνω του.

Έφτιαξα το YapToText, μια διαφορετική εφαρμογή υπαγόρευσης για Mac, οπότε διαβάστε με αυτό κατά νου όσα λέω για το VoiceInk. Κάθε στοιχείο για το VoiceInk εδώ προέρχεται από τα δικά του έγγραφα, όπως τα διάβασα στις 10 Οκτωβρίου 2026.

Λήψη του YapToText από το Mac App StoreΔωρεάν λήψη. Χωρίς λογαριασμό και χωρίς κλειδωμένες λειτουργίες, για macOS 14 ή μεταγενέστερο σε Mac με επεξεργαστή Apple. Πηγαίος κώδικας στο GitHub.

Σε αυτή τη σελίδα: 11 ενότητες
  1. Τι λαμβάνει η εντολή
  2. Πώς τρέχει
  3. Τα όρια που πιάνουν τον κόσμο απροετοίμαστο
  4. Τα ενσωματωμένα πρότυπα
  5. Έλεγχος αν δούλεψε
  6. Πού βρίσκεται το YapToText
  7. Το συνοπτικό
  8. Οδηγοί
  9. Περισσότεροι οδηγοί, στα αγγλικά
  10. Πηγές
  11. Ερωτήσεις

Τι λαμβάνει η εντολή

Το VoiceInk στέλνει το ίδιο τελικό κείμενο με δύο τρόπους: στην τυπική είσοδο και στη μεταβλητή $VOICEINK_TRANSCRIPT. Το κείμενο είναι UTF-8, και τα έγγραφα ζητούν να βάζετε τη μεταβλητή σε εισαγωγικά, ώστε να διατηρούνται τα κενά, η στίξη και οι αλλαγές γραμμής.

  • AI Enhancement (βελτίωση με ΤΝ) απενεργοποιημένο. Η μεταγραφή μετά τη μορφοποίηση και τις αντικαταστάσεις λέξεων του VoiceInk.
  • AI Enhancement ενεργοποιημένο και σε λειτουργία. Το βελτιωμένο κείμενο.
  • AI Enhancement παραλείφθηκε ή απέτυχε. Η απλή τελική μεταγραφή.

Η εντολή δεν λαμβάνει ποτέ απευθείας τον ήχο, το prompt ή το επιλεγμένο κείμενο, το κείμενο του προχείρου ή της οθόνης. Αν θέλετε το περιβάλλον να διαμορφώσει το αποτέλεσμα, τα έγγραφα λένε να χρησιμοποιήσετε ένα prompt και το Context Awareness (επίγνωση περιβάλλοντος), ώστε να περιλαμβάνεται ήδη στο τελικό κείμενο.

Πώς τρέχει

Από τα έγγραφα του VoiceInk, ενότητα Custom Commands, όπως τα διάβασα στις 10 Οκτωβρίου 2026.

ΛεπτομέρειαΣυμπεριφορά
Shell/bin/zsh -lc
Χρονικό όριο10 δευτερόλεπτα, και μετά το VoiceInk σταματά την εντολή
ΔικαιώματαΤα ίδια δικαιώματα χρήστη macOS με το VoiceInk
ΕγγραφέαςΚλείνει πριν ξεκινήσει η εντολή
ΕπιτυχίαΚωδικός εξόδου 0. Οτιδήποτε άλλο θεωρείται αποτυχία
ΈξοδοςΗ τυπική έξοδος και τα σφάλματα φυλάσσονται για διαγνωστικούς σκοπούς και δεν επικολλούνται ποτέ στην εφαρμογή
Εντολές που δεν βρίσκονταιΤο VoiceInk δοκιμάζει το PATH του shell σας. Αν αποτύχει, χρησιμοποιήστε πλήρη διαδρομή, όπως /opt/homebrew/bin/tool

Τα όρια που πιάνουν τον κόσμο απροετοίμαστο

  • Τίποτα δεν επικολλάται για εσάς. Αν θέλετε το κείμενο στην εφαρμογή, η εντολή σας πρέπει να το αντιγράψει ή να το επικολλήσει η ίδια.
  • Δέκα δευτερόλεπτα, χωρίς ερωτήσεις. Η εντολή δεν μπορεί να περιμένει είσοδο. Για πιο μακρά δουλειά, ξεκινήστε δική σας διεργασία στο παρασκήνιο και βγείτε γρήγορα.
  • Δεν αλλάζει την αποθηκευμένη μεταγραφή. Ό,τι εκτυπώνει η εντολή δεν γράφεται πίσω.
  • Χωρίς Auto Send (αυτόματη αποστολή). Το Auto Send λειτουργεί μόνο με την έξοδο Paste (επικόλληση), όχι με το Custom Command.
  • Μόνο ζωντανή υπαγόρευση. Τα αρχεία στην ουρά Transcribe file (μεταγραφή αρχείου) αποθηκεύονται χωρίς να τρέξουν εντολές εξόδου.
  • Χωρίς κενή εντολή. Ένα Mode (λειτουργία) με κενή εντολή δεν μπορεί να αποθηκευτεί.

Τα ενσωματωμένα πρότυπα

Από τα έγγραφα του VoiceInk, ενότητα Custom Commands, όπως τα διάβασα στις 10 Οκτωβρίου 2026.

ΠρότυποΤι κάνει
Paste and Press TabΑντιγράφει το κείμενο, το επικολλά και μετά πατά Tab
Lowercase and PasteΜετατρέπει το κείμενο σε πεζά, το αντιγράφει και μετά το επικολλά
Remove Trailing Period and PasteΑφαιρεί μία τελική τελεία πριν από την επικόλληση
Append to JournalΠροσθέτει το κείμενο στο ~/Documents/VoiceInk/journal.md
Search WebΑνοίγει μια αναζήτηση στον ιστό για το κείμενο

Τα έγγραφα προτείνουν να ξεκινήσετε από ένα πρότυπο και να το επεξεργαστείτε. Δύο από τα πιο απλά παραδείγματά τους, η αντιγραφή του κειμένου και η προσθήκη του σε μια σημείωση:

printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopy
mkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"

Έλεγχος αν δούλεψε

Το VoiceInk δεν δείχνει μήνυμα επιτυχίας ή αποτυχίας μετά από ένα Custom Command. Τα έγγραφα δίνουν μια εντολή για το Terminal που δείχνει τα αρχεία καταγραφής παράδοσης των τελευταίων 10 λεπτών, μαζί με το αν η εντολή πέτυχε, απέτυχε ή ξεπέρασε τα 10 δευτερόλεπτα:

/usr/bin/log show --last 10m --style compact \
  --predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'

Τα έγγραφα προειδοποιούν ότι αυτά τα αρχεία καταγραφής μπορεί να περιέχουν υπαγορευμένο κείμενο. Και αν η εντολή σας στέλνει κείμενο σε μια υπηρεσία ιστού, η υπηρεσία το λαμβάνει: το VoiceInk τρέχει μόνο όσα έχετε ρυθμίσει.

Πού βρίσκεται το YapToText

Το VoiceInk από τα έγγραφά του, όπως τα διάβασα στις 10 Οκτωβρίου 2026. Το YapToText από τις δικές του ρυθμίσεις.

VoiceInkYapToText
Εκτέλεση εντολής shell με το κείμενοΝαι, έξοδος Custom CommandΌχι
Επικόλληση στον δρομέαΈξοδος PastePaste, η προεπιλογή
Πληκτρολόγηση αντί για επικόλλησηΔεν περιγράφεται σε αυτή τη σελίδαType character by character
Μόνο πρόχειροΜε εντολή όπως η pbcopyCopy to clipboard only
Πάτημα πλήκτρου μετάΠρότυπο Paste and Press TabReturn ή Command Return ανά εφαρμογή
Έλεγχος πριν εμφανιστείΔεν περιγράφεται σε αυτή τη σελίδαReview before inserting, απενεργοποιημένο από προεπιλογή

Αν θέλετε η υπαγόρευση να οδηγεί δικά σας σενάρια, το Custom Command του VoiceInk κάνει κάτι που δεν κάνει το YapToText. Αν θέλετε κείμενο στον δρομέα, προσαρμοσμένο στις λέξεις γύρω του, το YapToText το κάνει από προεπιλογή και δεν χρειάζεται σενάριο. Η σελίδα για τα Modes του VoiceInk εξηγεί πού ορίζονται οι τρόποι εξόδου, και η σύγκριση VoiceInk και superwhisper το φέρνει απέναντι σε μια άλλη εφαρμογή χτισμένη γύρω από λειτουργίες.

Λήψη του YapToText από το Mac App StoreΔωρεάν λήψη. Χωρίς λογαριασμό και χωρίς κλειδωμένες λειτουργίες, για macOS 14 ή μεταγενέστερο σε Mac με επεξεργαστή Apple. Πηγαίος κώδικας στο GitHub.

Το συνοπτικό

  • Τι είναι. Ένας τρόπος εξόδου που τρέχει την εντολή shell σας με το τελικό κείμενο.
  • Το κείμενο. Στην τυπική είσοδο και στο $VOICEINK_TRANSCRIPT.
  • Όρια. 10 δευτερόλεπτα, καμία είσοδος, καμία αυτόματη επικόλληση, μόνο ζωντανή υπαγόρευση.
  • Αποσφαλμάτωση. Κανένα μήνυμα στην εφαρμογή. Διαβάστε το αρχείο καταγραφής με την εντολή Terminal παραπάνω.
  • Από πού να ξεκινήσετε. Επεξεργαστείτε ένα από τα πέντε πρότυπα.

Αν το VoiceInk αλλάξει τον τρόπο λειτουργίας των Custom Commands, ανοίξτε ένα issue στο GitHub και θα ενημερώσω τη σελίδα. Τα διαβάζω όλα.

Λήψη του YapToText από το Mac App StoreΔωρεάν λήψη. Χωρίς λογαριασμό και χωρίς κλειδωμένες λειτουργίες, για macOS 14 ή μεταγενέστερο σε Mac με επεξεργαστή Apple. Πηγαίος κώδικας στο GitHub.

Ποιος γράφει. Το όνομα είναι Ryleigh Newman. Αναπτύσσω λογισμικό, δυσκολεύομαι να πληκτρολογώ και υπαγορεύω κάθε μέρα με το YapToText, την εφαρμογή που περιγράφει αυτός ο ιστότοπος. Η σελίδα αυτή είναι μετάφραση από τα αγγλικά. Το περιβάλλον της εφαρμογής και ο υπόλοιπος ιστότοπος είναι στα αγγλικά. Περισσότερα για το έργο, στα αγγλικά.

Οδηγοί

Περισσότεροι οδηγοί, στα αγγλικά

Πηγές

Ερωτήσεις

Τι είναι το Custom Command στο VoiceInk;

Ένας τρόπος εξόδου. Αντί να επικολλήσει, το VoiceInk τρέχει μια εντολή shell που γράφετε εσείς και της περνά το τελικό κείμενο της υπαγόρευσης.

Πώς λαμβάνει το κείμενο ένα Custom Command του VoiceInk;

Στην τυπική είσοδο και στη μεταβλητή $VOICEINK_TRANSCRIPT, ως UTF-8. Βάλτε τη μεταβλητή σε εισαγωγικά για να κρατήσετε τα κενά και τις αλλαγές γραμμής.

Γιατί το Custom Command του VoiceInk δεν επικόλλησε τίποτα;

Η έξοδος Custom Command δεν επικολλά μόνη της. Η εντολή σας πρέπει να αντιγράψει ή να επικολλήσει το κείμενο η ίδια, όπως κάνει το πρότυπο Paste and Press Tab.

Πόση ώρα μπορεί να τρέχει ένα Custom Command του VoiceInk;

10 δευτερόλεπτα. Μετά το VoiceInk το σταματά. Για μακρύτερη δουλειά, ξεκινήστε μια διεργασία στο παρασκήνιο.

Έχει το YapToText προσαρμοσμένες εντολές όπως το VoiceInk;

Δεν τρέχει εντολές shell μετά από μια υπαγόρευση. Επικολλά ή πληκτρολογεί στον δρομέα, μπορεί να αντιγράφει μόνο στο πρόχειρο και μπορεί να πατά Return αφού μπει το κείμενο.