GroupDocs.Search for .NET 26.11 متاح الآن. هذا الإصدار يجعل عمليات البحث المتكررة والمتزامنة أسرع بكثير، يقلل الذاكرة المخصصة للفهرسة حتى 4.5 مرة وي يؤمن شبكة البحث باستخدام مصادقة العقد. الفهرسة في شبكة البحث أسرع من 5 إلى 20 مرة، وحزمة GroupDocs.Search NuGet الآن تتضمن إصدارات لـ .NET Framework 4.8، .NET 6.0، .NET 8.0 و .NET 10.0.
الفهارس التي تم إنشاؤها بالإصدار 26.10 تُفتح بدون تحويل. يحتوي الإصدار على 18 تغييرًا: 5 ميزات جديدة، 12 تحسينًا و 1 إصلاح.
أبرز الأداء
تصف ملاحظات الإصدار الكاملة إعداد الاختبار لكل رسم.
| ما | التحسين في 26.11 |
|---|---|
| بحث التعبير النمطي المتكرر | أسرع حتى 300 مرة |
| بحث تقريبي متكرر | أسرع من 4 إلى 30 مرة |
| عمليات البحث المتزامنة على فهرس | متوسط زمن 8 عمليات بحث متزامنة من 5.6 مللي ثانية إلى 0.18 مللي ثانية؛ 4 إلى 18٪ عمليات بحث أكثر في الثانية |
| بحث تقريبي بخطأ واحد | أسرع 1.8 مرة، أسرع 4.5 مرة مع 8 خيوط بحث |
| بحث نطاق التاريخ | أسرع حتى 10 مرات، أسرع حتى 59 مرة على شكل قطع؛ النطاقات الطويلة تُعيد نتائج كاملة |
| الذاكرة المخصصة للفهرسة | أقل حتى 4.5 مرة |
| الفهرسة مع نص المستند المخزن | أسرع حتى 2.2 مرة |
| استرجاع نص المستند المخزن | أسرع 3.5 مرة، أقل 11 مرة في الذاكرة |
| دمج الفهارس | أسرع 3.5 مرة، أقل تقريبًا 50 مرة في الذاكرة |
| الفهرسة في شبكة البحث | أسرع من 5 إلى 20 مرة، عدد أقسام الفهرس أقل بكثير في القطع |
| تسجيل 20,000 مستند على العقدة الرئيسية | من 27.1 ثانية إلى 0.12 ثانية، 0.8 ميغابايت مكتوبة على القرص بدلاً من 7.6 جيجابايت |
| مساحة القرص للفهرس | يمكن تقليلها على حساب سرعة التحميل |
ما الجديد في هذا الإصدار
| المفتاح | الملخص | الفئة |
|---|---|---|
| SEARCHNET-3729 | تنفيذ خيار لتقليل مساحة القرص التي يشغلها الفهرس على حساب سرعة التحميل | ميزة |
| SEARCHNET-3730 | تنفيذ مصادقة عقد شبكة البحث | ميزة |
| SEARCHNET-3731 | تنفيذ دعم OCR لاستخراج المستند في عملية منفصلة | ميزة |
| SEARCHNET-3732 | تنفيذ البحث على شكل قطع في مستودع الفهرس | ميزة |
| SEARCHNET-3733 | تنفيذ تمييز الكلمات التي ينتجها مقسم الكلمات المخصص | ميزة |
| SEARCHNET-3734 | تحسين البحث على شكل قطع | تحسين |
| SEARCHNET-3735 | تنفيذ مجموعة خيوط مشتركة للبحث المتزامن على فهرس | تحسين |
| SEARCHNET-3736 | تنفيذ إعادة استخدام الكلمات المتطابقة في عمليات البحث المتكررة | تحسين |
| SEARCHNET-3737 | تنفيذ واجهة IDisposable في فئة Cancellation | تحسين |
| SEARCHNET-3738 | توسيع الأبجدية الافتراضية بإضافات نصية إضافية | تحسين |
| SEARCHNET-3739 | تسريع بحث نطاق التاريخ وضمان نتائج كاملة للنطاقات الطويلة | تحسين |
| SEARCHNET-3740 | تقليل استهلاك الذاكرة للفهرسة والعمليات مع نصوص المستند المخزنة | تحسين |
| SEARCHNET-3741 | تسريع الفهرسة في شبكة البحث ذات عدد كبير من المستندات | تحسين |
| SEARCHNET-3742 | تنفيذ الفهرسة الدفعية والمعالجة المتوازية لطلبات القطع في شبكة البحث | تحسين |
| SEARCHNET-3743 | تنفيذ نمط التخلص في الفئات Index و IndexRepository و Cancellation و ExtractionHost و SearchNetworkNode | تحسين |
| SEARCHNET-3693 | تنفيذ استراتيجية حزم TFM-Split لحزمة GroupDocs.Search NuGet | تحسين |
| SEARCHNET-3747 | تنفيذ حزم NuGet لـ .NET Framework 4.8، .NET 6.0، .NET 8.0، .NET 10.0 | تحسين |
| SEARCHNET-3746 | تم إصلاح الانتظار غير المحدود لشبكة البحث للعقد المفقودة أو غير المستجيبة | إصلاح |
الميزات الرئيسية
بحث
- تُعيد عمليات البحث المتكررة باستخدام الأحرف العامة، التعبير النمطي، نطاق الأرقام والبحث التقريبي استخدام الكلمات التي وجدت في عمليات البحث السابقة بنفس الاستعلام حتى يتغير الفهرس. الكلمات المحفوظة تشغل حتى 8 ميغابايت من الذاكرة لكل فهرس.
- تشارك عمليات البحث المتزامنة على فهرس خيوط البحث الخاصة به (
IndexSettings.SearchThreads)، لذا لا تنتظر عمليات البحث القصيرة بعد الآن عمليات البحث الطويلة. - يقرأ بحث نطاق التاريخ كل يوم وشهر وسنة من الفهرس مرة واحدة بدلاً من البحث عن كل تاريخ في النطاق بشكل منفصل. لا يتم قطع النطاقات الطويلة بعد الآن عند حد التكرار، والنطاق الذي يشمل جميع التواريخ الممكنة، الذي كان يفشل سابقًا، يُبحث الآن في ثوانٍ.
- يستفيد البحث على شكل قطع من جميع هذه التحسينات، ويمكن الآن البحث على شكل قطع في مستودع الفهرس أيضًا:
IndexRepository.SearchNextيواصل البحث فهرسًا بعد فهرس. - يمكن للتمييز و
Index.GetDocumentTextتقسيم النص باستخدام مقسم الكلمات المخصص المستخدم في الفهرسة، بحيث تُبرز الكلمات التي ينتجها المقسم، على سبيل المثال كلمات نص بدون مسافات، أيضًا. - تشمل الأبجدية الافتراضية للفهارس الجديدة اللغة العبرية، الديفاناجاري، الجورجية، اللاتينية الموسعة، اليونانية وحروف الهانغول وعلامات الجمع. لا يتم بعد الآن تقسيم كلمات مثل “Việt” إلى أجزاء، وتُفهرس الكلمات الكورية والعبرية وتُعثر عليها بالكامل.
الفهرسة وتخزين الفهرس
- إعداد
IndexSettings.UseFastLoadingالجديد يسمح للفهرس على القرص بحذف البيانات الإضافية التي تجعل تحميله أسرع بضع مرات: يصبح الفهرس يشغل مساحة قرص أقل لكنه يُحمَّل لفترة أطول. يمكن تغيير الإعداد في أي وقت، حتى لفهرس يحتوي بالفعل على مستندات. - تخصص الفهرسة ما يصل إلى 4.5 مرة أقل من الذاكرة لكل مستند، ومع نص المستند المخزن، تعمل أسرع حتى 2.2 مرة. استرجاع النص المخزن أسرع 3.5 مرة مع استهلاك ذاكرة أقل 11 مرة، ودمج الفهارس أسرع 3.5 مرة مع استهلاك ذاكرة أقل تقريبًا 50 مرة.
- يمكن الآن التعرف على نص الصور في المستندات المستخرجة في عملية منفصلة:
ExtractionHost.OcrConnectorيحدد موصل OCR لعملية الاستخراج. إذا تم تمكين التعرف لكن عملية الاستخراج لا تحتوي على موصل OCR، فإن الفهرس يُبلغ عن ذلك عبر حدثErrorOccurred.
شبكة البحث
- تصادق العقد على بعضها البعض باستخدام مفتاح سري مشترك (
TcpSettings.NetworkKey)، وتُوقع كل رسالة: لا يمكن لجهاز بدون المفتاح إعطاء أوامر لعقدة أو الرد نيابةً عنها. لا يُرسل المفتاح أبدًا عبر الشبكة. يمكن للعقدة التابعة أيضًا تقييد العناوين التي تقبل منها العقدة الرئيسية (TcpSettings.AllowedMasterAddresses). - الفهرسة أسرع من 5 إلى 20 مرة وتُنشئ عددًا أقل بكثير من أقسام الفهرس: المستندات التي تصل بينما تكون القطعة مشغولة تُفهرس على دفعات تصل إلى 1,000 مستند أو 16 ميغابايت، وتُعالج قطع العقدة طلباتها بشكل متوازي.
- تسجيل المستندات المفهرسة على العقدة الرئيسية لم يعد يتباطأ مع زيادة عددها، وتُحفظ قائمة مستندات القطعة بأمان عندما يفشل كتابة أو يتعطل العملية.
- العقدة الرئيسية تكتشف العقد المفقودة وغير المستجيبة: العقدة التابعة تُرسل تقريرًا كل 5 ثوانٍ، ولا تنتظر المكالمات إلى الأبد عقدة مفقودة. يمكن أيضًا لـ
TcpSettings.ResponseTimeoutتحديد مدة انتظار العقدة الرئيسية للرد.
API والتعبئة
IndexوIndexRepositoryوCancellationوExtractionHostوSearchNetworkNodeتنفذ نمط التخلص القياسي في .NET، بحيث يمكن للفئات المشتقة تحرير مواردها الخاصة. التخلص منCancellationيُحرّر مؤقت الإلغاء المجدول بواسطةCancelAfter.- حزمة GroupDocs.Search NuGet الآن تتضمن إصدارات لـ .NET Framework 4.8، .NET 6.0، .NET 8.0 و .NET 10.0 بالإضافة إلى .NET Framework 4.6.2 و .NET Standard 2.1، وتختار الإصدار المناسب لإطار العمل المستهدف للمشروع تلقائيًا.
تغييرات API العامة
تمت إضافة الأعضاء التالية:
GroupDocs.Search.IndexSettings:Boolean UseFastLoading– يحتفظ بالبيانات الإضافية التي تجعل فهرس على القرص يُحمَّل أسرع بضع مرات. مفعَّل افتراضيًا؛ اضبطه علىfalseلتوفير مساحة القرص.
GroupDocs.Search.Scaling.Configuring.TcpSettings:String NetworkKey– المفتاح السري لشبكة البحث، لا يقل عن 16 حرفًا ويكون نفسه على جميع العقد.String[] AllowedMasterAddresses– عناوين IPv4 أو أسماء المضيف التي تقبل منها العقدة التابعة اتصال العقدة الرئيسية.Int32 ResponseTimeout– الوقت بالمللي ثانية الذي تنتظره العقدة الرئيسية لاستجابة عقدة لطلب. لا حد افتراضيًا.
GroupDocs.Search.ExtractionHost:IOcrConnector OcrConnector– موصل OCR للعملية المنفصلة للاستخراج.
GroupDocs.Search.IndexRepository:SearchResult SearchNext(ChunkSearchToken)وSearchResult SearchNext(ChunkSearchToken, Cancellation)– متابعة البحث على شكل قطع في مستودع الفهرس.
GroupDocs.Search.Options.TextOptions:IWordSplitter WordSplitter– مقسم الكلمات المستخدم في التمييز وIndex.GetDocumentText؛ يُورث بواسطةHighlightOptions.
GroupDocs.Search.Common.Cancellationالآن ينفذIDisposable:void Dispose()– يُحرّر مؤقت الإلغاء المجدول؛ الإلغاء المجدول لا يُطلب.
IndexوIndexRepositoryوCancellationوExtractionHostوSearchNetworkNode:protected virtual void Dispose(Boolean disposing)– طريقة نمط التخلص للفئات المشتقة.
التغييرات السلوكية التي قد تتطلب تعديلًا في الكود الخاص بك مُدرجة في ملاحظات الترقية أدناه.
أمثلة على الشيفرة
البحث في مستودع الفهرس على شكل قطع
المثال التالي يبحث في فهرسين من مستودع على شكل قطع، فهرسًا بعد الآخر.
string indexFolder1 = @"c:\MyIndex1\"; // Specify the path to the first index folder
string indexFolder2 = @"c:\MyIndex2\"; // Specify the path to the second index folder
string documentsFolder1 = @"c:\MyDocuments1\"; // Specify the path to a folder containing documents to index
string documentsFolder2 = @"c:\MyDocuments2\"; // Specify the path to another folder containing documents to index
using (IndexRepository repository = new IndexRepository()) // Creating an index repository
{
Index index1 = repository.Create(indexFolder1); // Creating the first index in the repository
index1.Add(documentsFolder1); // Indexing documents from the first folder
Index index2 = repository.Create(indexFolder2); // Creating the second index in the repository
index2.Add(documentsFolder2); // Indexing documents from the second folder
SearchOptions options = new SearchOptions();
options.IsChunkSearch = true; // Enabling search by chunks
SearchResult result = repository.Search("Einstein", options); // Getting the first chunk of the first index
Console.WriteLine("Documents: " + result.DocumentCount);
while (result.NextChunkSearchToken != null)
{
result = repository.SearchNext(result.NextChunkSearchToken); // Getting the next chunk, index by index
Console.WriteLine("Documents: " + result.DocumentCount);
}
}
حماية شبكة البحث بمفتاح مشترك
كل عقدة في شبكة البحث تحصل على نفس المفتاح السري. العقدة التابعة تقبل العقدة الرئيسية فقط من عنوانها، والعقدة الرئيسية تحد من الانتظار لاستجابات العقد.
string basePath = @"c:\SearchNetwork\"; // Specify the path to the folder of the search network
string networkKey = Environment.GetEnvironmentVariable("SEARCH_NETWORK_KEY"); // The same key of at least 16 characters on every node
// On the server of slave node 1: the connection of the master node is accepted from 10.0.0.5 only
TcpSettings slaveSettings = new TcpSettings(49101, 10000, 10000, 10000, 1000);
slaveSettings.NetworkKey = networkKey;
slaveSettings.AllowedMasterAddresses = new string[] { "10.0.0.5" };
SearchNetworkNode node1 = SearchNetworkNode.CreateSlaveNode(1, basePath + "Node1", slaveSettings);
node1.Start();
// On the server of the master node (10.0.0.5): the responses of the nodes are awaited no longer than 10 minutes
Configuration configuration = Configuration.Load(basePath + "Configuration.xml"); // Loading the search network configuration
TcpSettings masterSettings = new TcpSettings(49100, 10000, 10000, 10000, 1000);
masterSettings.NetworkKey = networkKey;
masterSettings.ResponseTimeout = 600000;
SearchNetworkNode node0 = SearchNetworkNode.CreateMasterNode(
0, basePath + "Node0", masterSettings, new FileLogger(basePath + "Log.txt", 4.0), configuration);
node0.ConfigureAllNodes();
node0.Start();
تقليل مساحة القرص للفهرس
المثال التالي ينشئ فهرسًا يشغل مساحة قرص أقل، ثم يجعله يُحمَّل بسرعة مرة أخرى.
string indexFolder = @"c:\MyIndex\"; // Specify the path to the index folder
string documentsFolder = @"c:\MyDocuments\"; // Specify the path to a folder containing documents to index
IndexSettings settings = new IndexSettings();
settings.UseFastLoading = false; // The index takes less disk space but loads longer
using (Index index = new Index(indexFolder, settings, true)) // Creating an index with the settings
{
index.Add(documentsFolder); // Indexing documents from the specified folder
}
using (Index index = new Index(indexFolder)) // Opening the existing index
{
index.IndexSettings.UseFastLoading = true; // The data is created the next time the index is loaded
}
ملاحظات الترقية
ضع التغييرات التالية في الاعتبار عند الترقية من نسخة سابقة:
- لا يمكن فتح الفهارس التي تم تعديلها بالإصدار 26.11 بواسطة الإصدارات السابقة. الإصدار 26.11 يفتح فهارس الإصدار 26.10 بدون تحويل، ولكن بمجرد أن ينشئ أو يغيّر فهرسًا (عن طريق الفهرسة، حذف المستندات، التحسين أو تغيير الإعدادات)، لا يمكن للإصدارات السابقة فتحه. قم بترقية جميع التطبيقات التي تشارك مجلد الفهرس في نفس الوقت، بما في ذلك عقد شبكة البحث.
- مشاريع .NET Framework تستخدم حزمة GroupDocs.Search. استبدل
GroupDocs.Search.NETFrameworkبـGroupDocs.Search، التي تتضمن الآن إصدارات .NET Framework 4.6.2 و 4.8 وتختار الإصدار المناسب تلقائيًا. لا يوجد إصدار 26.11 منGroupDocs.Search.NETFramework. - جميع عقد شبكة البحث تُرقى معًا. العقد ذات الإصدارات 26.10 و 26.11 لا تتصل. لحماية الشبكة، اضبط نفس
TcpSettings.NetworkKeyعلى كل عقدة: العقد ذات المفاتيح المختلفة، أو عقدة بمفتاح وعقدة بدون مفتاح، لا تتصل، وتكتب كل منها السبب في سجلاتها. العقدة بدون مفتاح تعمل كما كانت وتكتب تحذيرًا في سجلها. - رسائل شبكة البحث موقعة ولكن غير مشفرة. احتفظ بالعقد في شبكة موثوقة أو اربطها عبر نفق مشفر.
- يتم اكتشاف العقد المفقودة. العقدة التي لا ترسل شيئًا لمدة 15 ثانية، مثل عملية موقوفة في مصحح الأخطاء، تُعامل كفقدان: المكالمات التي تنتظرها تُطلق استثناء
SearchException، وتُرسل مستنداتها إلى عقد أخرى أو تُبلغ عنها عبر حدثErrorOccurred. بشكل افتراضي، العقدة الرئيسية تنتظر الردود بدون حد؛ اضبطTcpSettings.ResponseTimeoutلتحديد مدة الانتظار. IndexSettings.SearchThreadsمشتركة بين جميع عمليات البحث في فهرس. عملية بحث واحدة تستخدم نفس عدد الخيوط كما كان، لكن K عمليات بحث متزامنة الآن تُنفذ على max(K,SearchThreads) خيطًا بدلاً من K ×SearchThreads.- فقط الفهارس الجديدة تحصل على الأبجدية الموسعة. الفهارس في الإصدارات السابقة، بما في ذلك تلك التي تم تحديثها بواسطة
IndexUpdater، تقسم كلمات هذه النصوص كما كان من قبل، وIndex.Mergeيرفض دمج فهرس جديد مع أقدم. لدمجهما، صدّرAlphabetوTokenizationDictionaryللفهرس الأقدم باستخدامExportDictionaryواستوردها إلى الفهرس الجديد باستخدامClearوImportDictionaryقبل إضافة المستندات. - حدود التكرار تحسب أجزاء التواريخ مرة واحدة.
SearchOptions.MaxTotalOccurrenceCountوMaxOccurrenceCountPerTermتحسب كل تكرار ليوم أو شهر أو سنة مرة واحدة لكل بحث، أو مرة لكل قطعة، بدلاً من مرة لكل تاريخ في النطاق. قد يتم الآن العثور على جميع تواريخ نطاق تاريخ كان قد وصل إلى حد مسبقًا. - البحث على شكل قطع في مستودع الفهرس يتم فهرسًا فهرسًا.
IndexRepository.SearchمعIsChunkSearchتُعيد أول قطعة من الفهرس الأول. استمر باستخدامIndexRepository.SearchNextطالماSearchResult.NextChunkSearchTokenغير فارغ، أو ابحث بدون قطع للحصول على جميع المستندات في نتيجة واحدة. - OCR في عملية استخراج منفصلة يستخدم ExtractionHost.OcrConnector. اضبط الموصل في برنامج عملية الاستخراج وابنِ ذلك البرنامج بنفس نسخة GroupDocs.Search كما في التطبيق. موصل OCR لخيارات الفهرسة لا يُستخدم هناك.
- تقدم الفهرسة عبر الشبكة يُبلغ عنه لكل استجابة للقطعة.
NodeEventHub.IndexingProgressChangedيحدث مرة لكل استجابة من قطعة، والتي قد تُبلغ عن عدة مستندات، لذا يمكن أن يزيدProcessedDocumentsبأكثر من واحد.
كيفية الحصول على التحديث
NuGet
- NuGet – تثبيت أحدث حزمة. تعمل في مشاريع .NET و .NET Framework وتختار الإصدار المناسب لإطار العمل المستهدف تلقائيًا: .NET Framework 4.6.2 أو 4.8، .NET Standard 2.1، .NET 6.0، .NET 8.0 أو .NET 10.0.
# Package Manager
NuGet\Install-Package GroupDocs.Search -Version 26.11.0
# .NET CLI
dotnet add package GroupDocs.Search --version 26.11.0
التحميل المباشر
- Direct Download – تحميل التجميعات المترجمة لـ .NET و .NET Framework من صفحة الإصدار الرسمية:
https://releases.groupdocs.com/search/net/new-releases/groupdocs.search-for-.net-26.11-dlls-only/
https://releases.groupdocs.com/search/net/new-releases/groupdocs.search-for-.net-26.11/
الموارد
- ملاحظات الإصدار الكاملة – https://releases.groupdocs.com/search/net/release-notes/2026/groupdocs-search-for-net-26-11-release-notes/
- ملاحظات الترحيل – https://docs.groupdocs.com/search/net/migration-notes/#migrating-to-version-2611
- التوثيق – https://docs.groupdocs.com/search/net/
- أمثلة الشيفرة – https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/
- منتدى الدعم المجاني – https://forum.groupdocs.com/c/search/
- استخدامه من قبل وكلاء الذكاء الاصطناعي – the GroupDocs.Search MCP server runs this engine locally for Claude, Cursor and Copilot: https://docs.groupdocs.com/search/mcp/ · Do you need a vector database to ask questions about a folder of documents?