# उन्नत परिणाम कैशिंग (राज्य-जागरूक)

## अवलोकन
ऑरा में निरर्थक प्रसंस्करण को खत्म करने के लिए डिज़ाइन किया गया एक सतत, संदर्भ-जागरूक परिणाम कैश है। जब एक वॉयस कमांड पहचाना जाता है और एक नियम से मेल खाता है, तो ऑरा जांच करता है कि क्या समान परिस्थितियों में पहले भी वही परिणाम उत्पन्न हुआ है। यदि कोई मिलान पाया जाता है, तो ऑरा **लैंग्वेजटूल व्याकरण जांच** या **ओलामा एलएलएम जेनरेशन** जैसे महंगे ऑपरेशनों को दरकिनार कर देता है, जिससे परिणाम लगभग शून्य विलंबता के साथ मिलता है।

## प्रमुख विशेषताऐं
- **संदर्भ-जागरूक:** कैश सक्रिय विंडो शीर्षक के लिए विशिष्ट है। "लिब्रेऑफ़िस" में कहे गए एक कमांड का "टर्मिनल" में समान कमांड से भिन्न कैश्ड परिणाम हो सकता है।
- **स्व-उपचार (स्वतः-अमान्यता):** यदि आप अंतर्निहित नियम फ़ाइल (`.py` मानचित्र) को संशोधित करते हैं तो कैश स्वचालित रूप से समाप्त हो जाता है।
- **गोपनीयता पहले:** सभी कैश्ड परिणाम स्थानीय SQLite डेटाबेस (`data/_aura_result_cache.db`) में संग्रहीत होते हैं।
- **शून्य रखरखाव:** अधिकांश उपयोगकर्ताओं के लिए, यह बिना कॉन्फ़िगरेशन के पूरी तरह से पृष्ठभूमि में काम करता है।

## यह काम किस प्रकार करता है
सिस्टम तीन चरों के आधार पर एक अद्वितीय `cache_id` उत्पन्न करता है:
1. **नियम आउटपुट:** मानचित्र द्वारा उत्पन्न पाठ।
2. **भाषा:** वर्तमान सक्रिय भाषा कोड (जैसे, `डी-डीई`)।
3. **सक्रिय विंडो:** वर्तमान में फोकस में विंडो का शीर्षक।

### वैधता तर्क
कैश यह सुनिश्चित करता है कि आपको कभी भी "बासी" जानकारी प्राप्त न हो। यह दो प्रकार की वैधता जांच का उपयोग करता है:

| प्रकार | नाम | तर्क | केस का प्रयोग करें |
| :--- | :--- | :--- | :--- |
| **टाइप 0** | **फ़ाइल ऑटो-सिंक** | मानचित्र फ़ाइल के संशोधन समय (`mtime`) का उपयोग करता है। | **मानक।** यदि आप अपना सैंडबॉक्स या मानचित्र संपादित करते हैं, तो सभी संबद्ध कैश प्रविष्टियाँ तुरंत अमान्य हो जाती हैं। |
| **टाइप 1** | **मैन्युअल टाइमस्टैम्प** | नियम विशेषताओं में दिए गए एक निश्चित `टाइमस्टैम्प` का उपयोग करता है। | **डेवलपर।** किसी विशिष्ट परिणाम स्थिति को लागू करने या बनाए रखने के लिए संस्करण/टाइमस्टैम्प को हार्डकोड करें। |

## नियम कॉन्फ़िगरेशन उदाहरण

आप कैशिंग व्यवहार को सीधे अपनी `FUZZY_MAP_pre.py` या `FUZZY_MAP.py` फ़ाइलों में नियंत्रित कर सकते हैं।

### 1. डिफ़ॉल्ट व्यवहार (स्वचालित कैशिंग)
डिफ़ॉल्ट रूप से, कैशिंग सक्षम है और फ़ाइल के संशोधन समय का उपयोग करता है।
__CODE_ब्लॉक_0__

### 2. कैश को अक्षम करना
यदि कोई कमांड गतिशील डेटा (जैसे वर्तमान समय या यादृच्छिक मजाक) उत्पन्न करता है, तो आपको कैश को अक्षम करना चाहिए।
__CODE_ब्लॉक_1__

### 3. मैनुअल टाइमस्टैम्प (निश्चित संस्करण)
यदि आप चाहते हैं कि फ़ाइल संपादन के बावजूद कैश बना रहे (जब तक कि आप संस्करण नहीं बदलते), मैन्युअल टाइमस्टैम्प का उपयोग करें।
__CODE_ब्लॉक_2__

## प्रदर्शन प्रभाव
- **कैश मिस:** मानक प्रसंस्करण (एलएलएम उपयोग के आधार पर 0.05s - 5.0s)।
- **कैश हिट:** त्वरित प्रसंस्करण।

यह तंत्र कमांड या सही टाइपो को सीपीयू पर दबाव डाले बिना तुरंत वापस कर दिया जाता है।