# पॉवरशेल इंटीग्रेशन (विंडोज़)

एसटीटी (स्पीच-टू-टेक्स्ट) सीएलआई के साथ इंटरैक्ट करना आसान बनाने के लिए, आप अपने पावरशेल प्रोफ़ाइल में एक शॉर्टकट फ़ंक्शन जोड़ सकते हैं। यह आपको किसी भी PowerShell विंडो में बस "आपका प्रश्न" टाइप करने की अनुमति देता है।

> **इन पर लागू होता है:** Windows PowerShell 5.1 और PowerShell 7+ (अनुशंसित)। PowerShell 7 को [Microsoft Store](https://aka.ms/powershell) से या `winget install Microsoft.PowerShell` के माध्यम से स्थापित किया जा सकता है।

## सेटअप निर्देश

### 1. स्क्रिप्ट निष्पादन की अनुमति दें (एक बार सेटअप)

PowerShell डिफ़ॉल्ट रूप से स्क्रिप्ट को ब्लॉक कर देता है। PowerShell को **प्रशासक के रूप में** खोलें और चलाएँ:

__CODE_ब्लॉक_0__

### 2. अपना पॉवरशेल प्रोफ़ाइल खोलें

__CODE_ब्लॉक_1__

यदि फ़ाइल अभी तक मौजूद नहीं है, तो पहले इसे बनाएं:

__CODE_ब्लॉक_2__

### 3. फ़ाइल के अंत में निम्नलिखित ब्लॉक चिपकाएँ

__CODE_ब्लॉक_3__

### 4. अपनी प्रोफ़ाइल पुनः लोड करें

__CODE_ब्लॉक_4__

## विंडोज़-विशिष्ट नोट्स

- **पायथन पथ**: विंडोज़ पर, वर्चुअल वातावरण बाइनरी `.venv/bin/python3` के बजाय `.venv\Scripts\python.exe` पर है। यदि आपका सेटअप भिन्न है तो `$PY_EXEC` समायोजित करें।
- **`SL5NET_AURA_PROJECT_ROOT` पर्यावरण चर**: इसे अपने सिस्टम पर्यावरण चर में सेट करें, या अपनी प्रोफ़ाइल में फ़ंक्शन के ऊपर निम्नलिखित पंक्ति जोड़ें:
__कोड_ब्लॉक_5__
- **`टाइमआउट` / `mktemp`**: ये यूनिक्स उपकरण मूल रूप से उपलब्ध नहीं हैं। उपरोक्त स्क्रिप्ट PowerShell-मूल समकक्षों (`WaitForExit` एक मिलीसेकंड टाइमआउट और `GetTempFileName()`) का उपयोग करती है।
- **`pgrep`**: `गेट-प्रोसेस -नाम "स्ट्रीमलिट"` से बदला गया।
- **`start_service` / `update_github_ip`**: इन्हें `s` फ़ंक्शन से पहले, उसी प्रोफ़ाइल फ़ाइल में PowerShell फ़ंक्शंस (`Start-Service-STT`, `Update-GithubIp`) के रूप में परिभाषित किया जाना चाहिए।
- **WSL Kiwix स्क्रिप्ट**: यदि `बैश` उपलब्ध है (WSL के माध्यम से), तो `.sh` सहायक स्क्रिप्ट वैसे ही चलेगी। अन्यथा, इसे `.ps1` या `.bat` समकक्ष में अनुकूलित करें।
- **एकाधिक पावरशेल संस्करण**: `$PROFILE` विंडोज पावरशेल 5.1 और पावरशेल 7 के लिए अलग-अलग फाइलों को इंगित करता है। यह जांचने के लिए कि कौन सी प्रोफ़ाइल फ़ाइल सक्रिय है, प्रत्येक संस्करण में `$PROFILE` चलाएं।

## विशेषताएँ

- **डायनामिक पथ**: `SL5NET_AURA_PROJECT_ROOT` पर्यावरण चर के माध्यम से स्वचालित रूप से प्रोजेक्ट रूट ढूंढता है।
- **ऑटो-रीस्टार्ट**: यदि बैकएंड डाउन है, तो यह `स्टार्ट-सर्विस-एसटीटी` और स्थानीय विकिपीडिया सेवाओं को चलाने का प्रयास करता है।
- **स्मार्ट टाइमआउट्स**: पहले 2-सेकंड की त्वरित प्रतिक्रिया का प्रयास करता है, फिर 70-सेकंड के डीप प्रोसेसिंग मोड पर वापस आ जाता है।