मार्कडाउन दस्तावेज़ीकरण (docs/AHK_SCRIPTS.md)¶
SL5-ऑरा-सर्विस के लिए ऑटोहॉटकी इन्फ्रास्ट्रक्चर¶
क्योंकि विंडोज़ लिनक्स की तुलना में फ़ाइल लॉक और सिस्टम हॉटकी को अलग तरह से संभालता है, यह प्रोजेक्ट पायथन एसटीटी इंजन और विंडोज यूजर इंटरफेस के बीच अंतर को पाटने के लिए ऑटोहॉटकी (v2) स्क्रिप्ट के एक सेट का उपयोग करता है।
लिपियों का अवलोकन¶
1. trigger-hotkeys.ahk¶
उद्देश्य: सेवा को नियंत्रित करने के लिए मुख्य उपयोगकर्ता इंटरफ़ेस।
प्रमुख विशेषताऐं:
डिक्टेशन शुरू/बंद करने के लिए F10 और F11 को इंटरसेप्ट करें।
डिफ़ॉल्ट विंडोज सिस्टम व्यवहार को ओवरराइड करने के लिए
कीबोर्ड हुकका उपयोग करता है (उदाहरण के लिए, मेनू बार को सक्रिय करने वाला F10)।परिनियोजन: विंडोज टास्क शेड्यूलर के माध्यम से “उच्चतम विशेषाधिकार” के साथ पंजीकृत होने के लिए डिज़ाइन किया गया है ताकि यह तब भी हॉटकी कैप्चर कर सके जब उपयोगकर्ता प्रशासक-स्तरीय एप्लिकेशन में काम कर रहा हो।
2. type_watcher.ahk¶
उद्देश्य: एसटीटी पाइपलाइन में “उपभोक्ता” के रूप में कार्य करता है।
प्रमुख विशेषताऐं:
पायथन इंजन द्वारा उत्पन्न आने वाली
.txtफ़ाइलों के लिए एक अस्थायी निर्देशिका देखता है।स्टेट मशीन (ज़ोंबी मैप): यह सुनिश्चित करने के लिए मेमोरी-आधारित मैप लागू करता है कि प्रत्येक फ़ाइल ठीक एक बार टाइप की गई है। यह अनावश्यक Windows फ़ाइल-सिस्टम ईवेंट (जोड़ा/संशोधित) के कारण होने वाली “डबल-टाइपिंग” को रोकता है।
सुरक्षित टाइपिंग: यह सुनिश्चित करने के लिए
SendTextका उपयोग करता है कि किसी भी सक्रिय संपादक में विशेष वर्ण सही ढंग से प्रबंधित किए जाते हैं।विश्वसनीय सफाई: विंडोज़ फ़ाइल-एक्सेस लॉक को संभालने के लिए पुनः प्रयास-तर्क के साथ फ़ाइल हटाने का प्रबंधन करता है।
3. scripts/ahk/sync_editor.ahk¶
प्रमुख विशेषताऐं:
सेव-ऑन-डिमांड: इंजन द्वारा फ़ाइल को पढ़ने से पहले संपादक में
Ctrl+Sको बाध्य करने के लिए पायथन द्वारा ट्रिगर किया जा सकता है।डायलॉग ऑटोमेटर: स्वचालित रूप से “किसी अन्य प्रोग्राम द्वारा संशोधित फ़ाइल” पुनः लोड संवाद का पता लगाता है और पुष्टि करता है, जिससे एक तरल वास्तविक समय अद्यतन अनुभव बनता है।
विज़ुअल फीडबैक: उपयोगकर्ता को सूचित करने के लिए अल्पकालिक अधिसूचना बॉक्स प्रदान करता है कि सुधार लागू किए जा रहे हैं।
4. स्क्रिप्ट/नोटिफिकेशन_वॉचर.आहक¶
उद्देश्य: पृष्ठभूमि प्रक्रियाओं के लिए यूआई फीडबैक प्रदान करता है।
प्रमुख विशेषताऐं:
उपयोगकर्ता को सूचनाएं प्रदर्शित करने के लिए विशिष्ट स्थिति फ़ाइलों या घटनाओं पर नज़र रखता है।
किसी संदेश (पायथन) की “गणना” करने के तर्क को उसे “प्रदर्शित” करने (एएचके) से अलग करता है, यह सुनिश्चित करता है कि मुख्य एसटीटी इंजन यूआई इंटरैक्शन द्वारा अवरुद्ध नहीं है।
गैर-व्यवस्थापक फ़ॉलबैक¶
यदि एप्लिकेशन प्रशासकीय विशेषाधिकारों के बिना चलाया जाता है:
कार्यक्षमता: सेवा पूरी तरह कार्यात्मक बनी हुई है।
हॉटकी सीमाएँ: सिस्टम-आरक्षित कुंजियाँ जैसे F10 अभी भी विंडोज़ मेनू को ट्रिगर कर सकती हैं। इस मामले में, हॉटकीज़ को गैर-सिस्टम कुंजियों (उदाहरण के लिए,
F9याइन्सर्ट) में बदलने की अनुशंसा की जाती है।कार्य शेड्यूलर: यदि “AuraDictation_Hotkeys” कार्य एडमिन-इंस्टॉल के दौरान बनाया गया था, तो स्क्रिप्ट एक मानक उपयोगकर्ता के लिए भी उच्च विशेषाधिकारों के साथ चलेगी। यदि नहीं, तो
start_dictation.batचुपचाप एक स्थानीय उपयोगकर्ता-स्तरीय उदाहरण लॉन्च करेगा।
3. एएचके-कोड को रोकने के लिए “नर्वेज मेल्डुंगेन” का उपयोग करें¶
उम सिचेरज़ुस्टेलन, दास दास स्क्रिप्ट सेल्बस्ट नेमल्स डेन न्यूट्ज़र मिट पॉपअप स्टोर्ट, फ़्यूगे डाइस “साइलेंट-फ्लैग्स” ओबेन इन डेइन .एएचके डेटियन एइन:
CODE_ब्लॉक_0
4. हॉटकीज़ के लिए रणनीति (F10 वैकल्पिक)¶
F10 पर एडमिन-रेचटे विंडोज फास्ट अनमॉग्लिच सॉबर एब्ज़ुफैन्गेन आईएसटी, ट्रिगर-हॉटकीज़.एएचके में एक सप्ताह से अधिक समय तक कनेक्ट करें:
CODE_ब्लॉक_1
ज़ुसामेनफ़ासुंग डेर वर्बेसेरुंगेन:¶
बैच-दिनांक:
प्रारंभ ""/बी, एक वर्ष से अधिक समय पहले, और एक प्रुफ़्ट वोरहर, एडमिन-टास्क शॉन लॉफ्ट के साथ।पारदर्शिता: दस्तावेज़ में स्पष्ट रूप से कहा गया है: “क्या व्यवस्थापक? कोई समस्या, निम ईनफैच ईन एंडरे स्वाद एल्स एफ10”।
एएचके-स्क्रिप्ट:
#सिंगलइंस्टेंस फोर्सके अलावा, “एक पुराना इंस्टेंस चल रहा है”-डायलॉग ज़ू अनटरड्रुकन।
पेशेवर पेशेवर (“स्मूथ”) के साथ काम करना शुरू करें, हिंटरग्रंड शुरू होने से पहले, एक वर्ष से अधिक समय से तकनीकी विवरण प्राप्त करें या अपने फ्रंटियर कनेक्शन को बेहतर बनाएं। Xस्पेसब्रेकX Xस्पेसब्रेकX¶
यह दस्तावेज़ीकरण क्यों महत्वपूर्ण है:¶
“ज़ॉम्बी मैप” और “टास्क शेड्यूलर/एडमिन” आवश्यकता का दस्तावेजीकरण करके, आप अन्य डेवलपर्स (और अपने भविष्य के स्वयं) को समझाते हैं कि कोड एक साधारण लिनक्स स्क्रिप्ट से अधिक जटिल क्यों है। यह “अजीब वर्कअराउंड” को “विंडोज़ सीमाओं के लिए इंजीनियर्ड समाधान” में बदल देता है।
(एस,29.1.’26 11:02 गुरु)