# SL5 आभा का समस्या निवारण

## त्वरित निदान

हमेशा यहां से प्रारंभ करें:

__CODE_ब्लॉक_0__

---

## समस्या: आभा प्रारंभ नहीं होती

**लक्षण:** कोई स्टार्टअप ध्वनि नहीं, `pgrep` में कोई प्रक्रिया दिखाई नहीं देती।

**लॉग जांचें:**
__CODE_ब्लॉक_1__

**सामान्य कारणों में:**

| लॉग में त्रुटि | ठीक करें |
|---|---|
| `ModuleNotFoundError` | सेटअप स्क्रिप्ट फिर से चलाएँ: `बैश सेटअप/manjaro_arch_setup.sh` |
| `'ऑब्जग्राफ' नाम का कोई मॉड्यूल नहीं` | `.venv` को पुनः बनाया गया - पुनः स्थापित करें: `pip install -r require.txt` |
| `पता पहले से ही उपयोग में है` | पुरानी प्रक्रिया को खत्म करें: `pkill -9 -f aura_engine` |
| `मॉडल नहीं मिला` | लापता मॉडल डाउनलोड करने के लिए सेटअप पुनः चलाएँ |
| `पाइगेम.मिक्सर उपलब्ध नहीं है` | नीचे "नो साउंड ऑन स्टार्टअप" देखें |

---

## समस्या: स्टार्टअप पर कोई आवाज़ नहीं (pygame.mixer)

**लक्षण:** `pygame.mixer` के बारे में चेतावनी या त्रुटि उपलब्ध नहीं है। आभा प्रारंभ होती है
लेकिन कोई आवाज नहीं बजाता.

**कारण:** आपके सिस्टम के पायगेम बिल्ड में ऑडियो सपोर्ट या SDL2 शामिल नहीं है
ऑडियो लाइब्रेरी गायब हैं.

**आर्क/मंज़रो पर सुधार:**
__CODE_ब्लॉक_2__

**उबंटू/डेबियन पर सुधार:**
__CODE_ब्लॉक_3__

आभा बिना ध्वनि के काम करती रहेगी - यह कोई घातक त्रुटि नहीं है।

---

## समस्या: प्रथम श्रुतलेख के बाद आभा नष्ट हो जाती है

**लक्षण:** एक बार काम करता है, फिर चुपचाप मर जाता है।

**स्टडर जांचें:**
__CODE_ब्लॉक_4__

**यदि आपको `सेगमेंटेशन फॉल्ट` या `डबल फ्री` दिखाई देता है:**

यह glibc 2.43+ (CachyOS, नया आर्क) वाले सिस्टम पर एक ज्ञात समस्या है।

__कोड_ब्लॉक_5__

स्थापित होने पर mimalloc स्वचालित रूप से स्टार्ट स्क्रिप्ट द्वारा उपयोग किया जाता है। पुष्टि करें कि यह सक्रिय है - आपको इसे स्टार्टअप पर देखना चाहिए:
__कोड_ब्लॉक_6__

---

## समस्या: ट्रिगर कुंजी कुछ नहीं करती

**लक्षण:** आप हॉटकी दबाते हैं लेकिन कुछ नहीं होता - कोई ध्वनि नहीं, कोई पाठ नहीं।

**जांचें कि फ़ाइल वॉचर चल रहा है या नहीं:**
__CODE_ब्लॉक_7__

यदि कुछ भी दिखाई नहीं देता है, तो ऑरा को पुनः आरंभ करें:
__CODE_ब्लॉक_8__

**जांचें कि क्या ट्रिगर फ़ाइल बनाई जा रही है:**
__CODE_ब्लॉक_9__

यदि फ़ाइल कभी नहीं बनी है, तो आपकी हॉटकी काम नहीं कर रही है - नीचे देखें।

---

## समस्या: वेलैंड पर हॉटकी काम नहीं कर रही है

**लक्षण:** CopyQ स्थापित और कॉन्फ़िगर किया गया है, लेकिन हॉटकी दबाने पर ऐसा होता है
वेलैंड सत्र पर कुछ भी नहीं।

**कारण:** CopyQ वैश्विक हॉटकीज़ बिना वेलैंड पर विश्वसनीय रूप से काम नहीं करती हैं
अतिरिक्त विन्यास. यह केडीई प्लाज्मा, गनोम और अन्य को प्रभावित करता है
वेलैंड कंपोजिटर।

### विकल्प 1: केडीई सिस्टम सेटिंग्स (केडीई प्लाज्मा के लिए अनुशंसित)

1. खोलें **सिस्टम सेटिंग्स → शॉर्टकट → कस्टम शॉर्टकट**
2. **कमांड/यूआरएल** प्रकार का एक नया शॉर्टकट बनाएं
3. कमांड को इस पर सेट करें:
__CODE_ब्लॉक_10__
4. अपना पसंदीदा कुंजी संयोजन निर्दिष्ट करें (जैसे `F9` या `Ctrl+Alt+Space`)

### विकल्प 2: डॉटूल (किसी भी वेलैंड कंपोजिटर पर काम करता है)

__CODE_ब्लॉक_11__

फिर चलाने के लिए अपने डेस्कटॉप के शॉर्टकट मैनेजर का उपयोग करें:
__CODE_ब्लॉक_12__

### विकल्प 3: ydotool

__CODE_ब्लॉक_13__

फिर चलाने के लिए अपना शॉर्टकट कॉन्फ़िगर करें:
__CODE_ब्लॉक_14__

### विकल्प 4: गनोम (dconf/GNOME सेटिंग्स का उपयोग करके)

1. खोलें **सेटिंग्स → कीबोर्ड → कस्टम शॉर्टकट**
2. कमांड के साथ एक नया शॉर्टकट जोड़ें:
__CODE_ब्लॉक_15__
3. एक कुंजी संयोजन निर्दिष्ट करें

### विकल्प 5: वेलैंड फिक्स के साथ कॉपीक्यू

कुछ वेलैंड कंपोजिटर CopyQ को काम करने की अनुमति देते हैं यदि इन्हें इसके साथ शुरू किया जाए:
__कोड_ब्लॉक_16__

यह CopyQ को XWayland का उपयोग करने के लिए बाध्य करता है, जो वैश्विक हॉटकी का समर्थन करता है।

---

## समस्या: पाठ प्रकट होता है लेकिन सुधार के बिना

**लक्षण:** श्रुतलेख काम करता है लेकिन सब कुछ छोटे अक्षरों में रहता है, कोई व्याकरण ठीक नहीं होता।

**जांचें कि क्या लैंग्वेजटूल चल रहा है:**
__कोड_ब्लॉक_17__

यदि यह कोई त्रुटि देता है, तो लैंग्वेजटूल नहीं चल रहा है। आभा को इसकी शुरुआत करनी चाहिए
स्वचालित रूप से - लैंग्वेजटूल से संबंधित त्रुटियों के लिए लॉग की जाँच करें:

__CODE_ब्लॉक_18__

**लैंग्वेजटूल लॉग जांचें:**
__CODE_ब्लॉक_19__

---

## समस्या: आभा DEV_MODE में रुकी हुई है

**लक्षण:** `DEV_MODE = 1` के साथ, ऑरा पहले ट्रिगर के बाद रुक जाता है और रुक जाता है
जवाब दे रहा हूँ.

**कारण:** एकाधिक थ्रेड से उच्च लॉग वॉल्यूम लॉगिंग सिस्टम को ओवरलोड करता है।

**ठीक करें:** `config/filters/settings_local_log_filter.py` में एक लॉग फ़िल्टर जोड़ें:

__CODE_ब्लॉक_20__

फ़ाइल सहेजें - ऑरा स्वचालित रूप से फ़िल्टर को पुनः लोड करता है। पुनरारंभ की आवश्यकता नहीं है.

---

## समस्या: प्लगइन्स.ज़िप अंतहीन / उच्च सीपीयू बढ़ता है

**लक्षण:** 100% सीपीयू, पंखे पूरी गति से, `प्लगइन्स.ज़िप` बिना रुके बढ़ता है।

**कारण:** सुरक्षित पैकर अनंत लूप में फ़ाइलों को दोबारा पैक कर रहा है।

**ठीक करें:** सुनिश्चित करें कि `.blob` और `.zip` फ़ाइलें टाइमस्टैम्प स्कैन से बाहर रखी गई हैं।
पंक्ति 86 के आसपास `scripts/py/func/secure_packer_lib.py` जांचें:

__CODE_ब्लॉक_21__

यदि यह पंक्ति गायब है तो इसे जोड़ें।

---

## समस्या: गोली चलाने के नियम नहीं

**लक्षण:** आप एक ट्रिगर वाक्यांश निर्देशित करते हैं लेकिन नियम कुछ नहीं करता।

**चेकलिस्ट:**

1. क्या नियम सही फ़ाइल में है? (`FUZZY_MAP_pre.py` = लैंग्वेजटूल से पहले,
`FUZZY_MAP.py` = बाद)
2. क्या मानचित्र फ़ाइल सहेजी गई है? सेव करने पर ऑरा पुनः लोड होता है - लॉग की जाँच करें
`सफलतापूर्वक पुनः लोड किया गया`।
3. क्या पैटर्न उस चीज़ से मेल खाता है जिसे वोस्क ने वास्तव में प्रतिलेखित किया है? के लिए लॉग की जाँच करें
कच्चा प्रतिलेखन:
__CODE_ब्लॉक_22__
4. क्या `only_in_windows` सेट है और गलत विंडो सक्रिय है?
5. क्या अधिक सामान्य नियम पहले मेल खाता है? नियमों को ऊपर से नीचे तक संसाधित किया जाता है -
सामान्य नियमों से पहले विशिष्ट नियम रखें।

---

## बग रिपोर्ट के लिए लॉग एकत्रित करना

किसी समस्या की रिपोर्ट करते समय, कृपया इसमें शामिल करें:

__CODE_ब्लॉक_23__

यहां पोस्ट करें: [GitHub Issues](https://github.com/sl5net/SL5-aura-service/issues)