الكتابة بالصوت في VS Code على Mac

على خلاف Slack وNotion وGmail، لدى VS Code ميزة إملاء خاصة به: تنشر Microsoft إضافة اسمها VS Code Speech. وما إذا كان عليك استخدامها يتوقف على الوجهة التي يذهب إليها النص.

الخيار أ: VS Code Speech (الإضافة الرسمية)

1. افتح عرض الإضافات (Extensions) وثبّت VS Code Speech الذي تنشره Microsoft (معرّف الإضافة ms-vscode.vscode-speech).
2. ضع المؤشر في المحرر.
3. اضغط Option+Command+V لتشغيل «Voice: Start Dictation in Editor». ويوقفه الاختصار نفسه.
4. تشغّل الإضافة أيضًا الإدخال الصوتي في عرض المحادثة (Chat)، وهو المكان الذي يستخدمها فيه معظم الناس فعلًا.

القيد هو النطاق. فهي تملي داخل VS Code فقط ولا شيء غيره، فما إن تنتقل إلى المتصفح لكتابة وصف طلب السحب (pull request) حتى تعود إلى أداة مختلفة واختصار مختلف.

الخيار ب: الإملاء في macOS (يعمل في لوحة الطرفية أيضًا)

1. فعّل الإملاء مرة واحدة: إعدادات النظام ← لوحة المفاتيح ← الإملاء. الخطوات الكاملة في تفعيل الإملاء على macOS.
2. انقر داخل تعليق، أو docstring، أو مربع رسالة الإيداع في Source Control، أو الطرفية المدمجة.
3. ابدأ الإملاء وتحدّث، ثم أوقف الإملاء لتثبيت النص.

يصل إملاء النظام إلى الطرفية المدمجة وإلى مربع رسالة الإيداع في لوحة Source Control. وهذا يغطي المكانين اللذين يذهب إليهما معظم النص المُملى في المحرر فعليًا.

الفخ الخاص بـ VS Code: IntelliSense يعدّل جملتك

يعرض VS Code قائمة إكمال أثناء الكتابة، وبشكل افتراضي يمكن لحرف فاصل بين الكلمات أن يقبل الاقتراح المحدد. والنثر المُملى سلسلة من الكلمات والفواصل، فقد ينتهي التعليق بأن يحوي اسم متغير من الملف بدلًا من الكلمة التي قلتها. والعَرَض تعليق يُقرأ سليمًا لست كلمات ثم يحتوي في منتصف الجملة على شيء مثل useEffectHandler.

• اضبط "editor.acceptSuggestionOnCommitCharacter": false لمنع الفواصل من قبول الاقتراح.
• اضبط "editor.acceptSuggestionOnEnter": "off" حتى لا يختار سطر جديد منطوق أي إكمال.
• اضبط "editor.quickSuggestions": { "comments": false, "strings": false } حتى لا تُفتح القائمة في الأماكن التي تملي فيها.
• أملِ في مربع الإيداع في Source Control بدلًا من المحرر متى استطعت. فهو حقل نص عادي لا يرتبط به محرك إكمال.

ما يستحق الإملاء في المحرر

• متون رسائل الإيداع، حيث السبب نثر والفرق (diff) يقول بالفعل ما الذي تغيّر.
• الـ docstrings وتعليقات الدوال كمسودة أولى تُحرَّر بعد ذلك.
• بنود سجل التغييرات وملاحظات الإصدار.
• لا الشيفرة. فالمعرّفات وكثافة علامات الترقيم وحالة الأحرف تجعل الكلام أبطأ من لوحة المفاتيح.

إذا لم يُكتب شيء إطلاقًا

• إعدادات النظام ← الخصوصية والأمان ← الميكروفون ← اسمح لـ Visual Studio Code إذا كنت تستخدم إضافة VS Code Speech. أما إملاء النظام فيلتقطه macOS بدلًا من ذلك، فيحتاج إلى إذن أداة الإملاء.
• الإملاء متوقف في كل مكان، لا في VS Code وحده: الإملاء لا يعمل على Mac.

الخيار ج: اختصار واحد للمحرر وللمتصفح

معظم النص الذي يمليه المهندس ليس في المحرر أصلًا. بل في وصف طلب السحب، وفي تذكرة، وفي سلسلة محادثة على Slack، بهذا الترتيب. يربط Voice Type اختصار «اضغط وأملِ» واحدًا يعمل في كل هذه الأماكن، ويشغّل النموذج على جهاز Mac: الكتابة بالصوت على Mac.

تابع القراءة

• الإملاء في Cursor (لماذا لا تُثبَّت إضافة VS Code Speech هناك)
• إملاء أوصاف طلبات السحب على GitHub

المصادر

• VS Code Docs: Voice support (the VS Code Speech extension)
• VS Code Docs: IntelliSense
• Apple: Dictate messages and documents on Mac