Quipu

YARA नियम लिखने, सत्यापित करने, संकलित करने और परीक्षण करने के लिए एक डेस्कटॉप वर्कबेंच।

Quipu (उच्चारण “KEE-poo”) एक प्रोजेक्ट एक्सप्लोरर, YARA-सजग एडिटर, YARA-X कंपाइलर, और केंद्रित स्कैन परिणामों को एक ही स्थानीय एप्लिकेशन में लाता है। यह YARA-X और उसके भाषा सर्वर दोनों को एम्बेड करता है, इसलिए आपको अलग से YARA इंस्टॉलेशन की आवश्यकता नहीं है।

[!IMPORTANT] Quipu MVP चरण में है। बिल्ड Linux और Windows x86-64 के लिए लक्षित हैं। Windows डेस्कटॉप सत्यापन Windows 11 24H2 को कवर करता है; देखें सत्यापन रिकॉर्ड। प्रयोगात्मक macOS बिल्ड में CI कवरेज और उपयोगकर्ता-पुष्ट बिल्ड सत्यापन है; देखें सत्यापन रिकॉर्ड।

विशेषताएँ

• .yar और .yara फ़ाइलों के फ़ोल्डर को वर्कस्पेस के रूप में खोलें, या स्क्रैच नियम से शुरू करें।
• अनुमानित या कॉन्फ़िगर किए गए एंट्रीपॉइंट, नेस्टेड इन्क्लूड, बाहरी इन्क्लूड, और प्रोजेक्ट समस्याओं का अन्वेषण करें।
• Monaco सिंटैक्स हाइलाइटिंग, कम्प्लीशन, हॉवर डॉक्यूमेंटेशन, और लाइव YARA-X डायग्नोस्टिक्स के साथ संपादित करें।
• एक पूर्ण वर्कस्पेस संकलित करें, फिर टाइप किए गए टेक्स्ट या चयनित फ़ाइल को स्कैन करें।
• मिलते हुए नियमों, पैटर्न, ऑफ़सेट, बाइट लंबाई, और हेक्स व्यूअर में हाइलाइट किए गए बाइट्स का निरीक्षण करें।
• डायग्नोस्टिक्स और मैचों से सीधे उनकी स्रोत परिभाषाओं पर जाएँ।
• एक सीमित स्थानीय कैश से अपरिवर्तित संकलित नियमसेट पुनर्स्थापित करें।
• एप्लिकेशन के साथ शामिल छोटे, स्व-निहित उदाहरण प्रोजेक्ट्स के एक सेट से काम करें।

नियम और स्कैन लक्ष्य स्थानीय रूप से संसाधित होते हैं। Quipu उनकी सामग्री किसी रिमोट सेवा को नहीं भेजता है।

Linux पर इंस्टॉल करें

Linux x86-64 पैकेज GitHub Releases पृष्ठ पर प्रकाशित होते हैं:

पैकेज	किसके लिए सर्वोत्तम	इंस्टॉल या चलाएँ
AppImage	समर्थित वितरणों पर पोर्टेबल उपयोग	chmod +x Quipu_*.AppImage && ./Quipu_*.AppImage
.deb	Ubuntu 22.04+ और Debian 12+	sudo apt install ./Quipu_*.deb
.rpm	हाल के Fedora रिलीज़	sudo dnf install ./Quipu-*.rpm

.deb और .rpm पैकेज सिस्टम WebKitGTK रनटाइम का उपयोग करते हैं। यदि आपका वितरण उस निर्भरता को पूरा नहीं कर सकता, तो AppImage का उपयोग करें।

डेवलपमेंट पैकेज सफल CI रन से quipu-linux-x86_64 आर्टिफ़ैक्ट के रूप में उपलब्ध हैं। CI और Release दोनों एक ही Linux वर्कफ़्लो को कॉल करते हैं, जिसमें पैकेज सत्यापन और नेटिव मेनू स्मोक टेस्ट शामिल हैं। संयुक्त SHA256SUMS फ़ाइल Release द्वारा प्रदान की जाती है, व्यक्तिगत CI आर्टिफ़ैक्ट द्वारा नहीं।

Quipu पैकेज वर्तमान में हस्ताक्षरित नहीं हैं। प्रत्येक रिलीज़ में एक SHA256SUMS फ़ाइल शामिल होती है; इसे पैकेजों के साथ डाउनलोड करें और जिन फ़ाइलों को आपने डाउनलोड किया है उन्हें इससे सत्यापित करें:

sha256sum --ignore-missing --check SHA256SUMS

चेकसम आकस्मिक भ्रष्टाचार का पता लगाते हैं लेकिन ये प्रमाणित हस्ताक्षर नहीं हैं।

Windows पर इंस्टॉल करें

Windows x86-64 पैकेज (v0.3.0 और बाद के) के लिए, GitHub Releases से एक इंस्टॉलर डाउनलोड करें। डेवलपमेंट बिल्ड भी quipu-windows-x86_64 और quipu-windows-offline-x86_64 आर्टिफैक्ट के रूप में सफल CI रन से उपलब्ध हैं।

• वर्तमान-उपयोगकर्ता इंस्टॉलेशन के लिए NSIS .exe इंस्टॉलर का उपयोग करें।
• एक MSI .msi इंस्टॉलर भी उपलब्ध है।
• एयर-गैप्ड सिस्टम के लिए, -offline.exe या -offline.msi इंस्टॉलर चुनें (quipu-windows-offline-x86_64 CI आर्टिफैक्ट)। ये बड़े पैकेज पूर्ण Microsoft Edge WebView2 रनटाइम इंस्टॉलर शामिल करते हैं और इसे इंटरनेट एक्सेस के बिना इंस्टॉल कर सकते हैं।
• मानक इंस्टॉलर रनटाइम अनुपस्थित होने पर WebView2 डाउनलोड करते हैं, इसलिए इंस्टॉलेशन के लिए इंटरनेट एक्सेस की आवश्यकता हो सकती है।

इंस्टॉलर अहस्ताक्षरित हैं, इसलिए Windows एक अज्ञात-प्रकाशक या SmartScreen चेतावनी दिखा सकता है। आगे बढ़ने से पहले जाँच लें कि आपका डाउनलोड इस रिपॉज़िटरी के रिलीज़ या वर्कफ़्लो से आया है।

रिलीज़ पैकेज में एक संयुक्त SHA256SUMS फ़ाइल शामिल है। PowerShell में, अपने डाउनलोड किए गए इंस्टॉलर का हैश गणना करें (उदाहरण फ़ाइलनाम बदलें):

Get-FileHash -Algorithm SHA256 .\Quipu_VERSION_x64-setup.exe
Get-Content .\SHA256SUMS

उस सटीक फ़ाइलनाम की प्रविष्टि के साथ हैश की तुलना करें, अक्षर केस को अनदेखा करते हुए। व्यक्तिगत CI आर्टिफ़ैक्ट्स में संयुक्त रिलीज़ चेकसम फ़ाइल शामिल नहीं होती है।

यदि पुनः आरंभ करने के बाद कोई संकलित रूलसेट भूल जाता है, तो बंडल किए गए गाइड के Windows Defender समस्या निवारण को देखें। यह बताता है कि क्वारंटीन की पुष्टि कैसे करें और, यदि आवश्यक हो, तो केवल कैश निर्देशिका को बाहर कैसे रखें।

प्रयोगात्मक macOS बिल्ड

CI वर्कफ़्लो Apple Silicon और Intel के लिए ad-hoc हस्ताक्षरित DMG बनाता है, जो macOS 15 या नए को लक्षित करते हैं। इन्हें बनाने के लिए Apple Developer सदस्यता की आवश्यकता नहीं होती, लेकिन ये नोटराइज़्ड नहीं हैं और लॉन्च करने के लिए Gatekeeper ओवरराइड की आवश्यकता हो सकती है। CI आर्टिफ़ैक्ट्स, बिल्ड निर्देशों और वर्तमान सत्यापन स्थिति के लिए macOS विकास देखें।

त्वरित शुरुआत

1. Quipu प्रारंभ करें और File → Open Example… → Basic text match चुनें।
2. एडिटर में text_indicators.yar का अन्वेषण करें।
3. Rules → Compile Workspace चुनें या Ctrl+Shift+B दबाएँ।
4. Rules → Scan Target के साथ तैयार लक्ष्य को स्कैन करें या Ctrl+Shift+Enter दबाएँ।
5. किसी मैच का विस्तार करें और हाइलाइट किए गए बाइट्स का निरीक्षण करने के लिए उसे चुनें।

पूरी गाइड Quipu के साथ Help → Documentation के अंतर्गत बंडल की गई है। इसका स्रोत documentation/content में भी उपलब्ध है।

वर्कस्पेस और quipu.toml

कॉन्फ़िगरेशन के बिना, Quipu पुनरावर्ती रूप से रूल फ़ाइलों की खोज करता है और प्रत्येक ऐसी फ़ाइल से एक एंट्रीपॉइंट का अनुमान लगाता है जो किसी अन्य फ़ाइल द्वारा शामिल नहीं की गई है। जब आपको स्पष्ट एंट्रीपॉइंट, शामिल निर्देशिकाएँ, या बहिष्करण की आवश्यकता हो तो वर्कस्पेस रूट पर एक quipu.toml जोड़ें:

schema = 1
entrypoints = ["main.yar"]
include_dirs = ["rules", "../shared-rules"]
exclude = ["fixtures/**", "vendor/legacy/**"]

पूर्ण प्रोजेक्ट मॉडल और मैनिफ़ेस्ट संदर्भ के लिए वर्कस्पेस और प्रोजेक्ट्स देखें।

स्रोत से बिल्ड करें

सभी प्लेटफ़ॉर्म के लिए आवश्यक है:

• Rust 1.93 या नया
• Node.js 22.12 या नया
• Zola 0.23.6
• Git

Windows के लिए, MSVC बिल्ड टूल्स, Windows SDK, WebView2 रनटाइम, और PowerShell बिल्ड कमांड के लिए Windows विकास का पालन करें।