Skip to content
palmoni5 edited this page Nov 5, 2026 · 3 revisions

מערכת החיפוש

דף זה מתאר את החיפוש המילולי בקוד הפיתוח. להוראות שימוש ראה חיפוש בתוכן הספרים. החיפוש לפי עניין מתואר בנפרד בחיפוש חכם — מימוש.

גבולות המערכת

יש להבחין בין ארבעה מסלולים:

מסלול מקור הנתונים רכיב מרכזי
חיפוש ספר לפי שם או מחבר קטלוג הספרייה DataRepository.findBooks ועובד חיפוש הספרים
איתור מקום ידוע שמות ספרים, תוכן עניינים ומראי מקום FindRefRepository
חיפוש מילים בתוכן אינדקס מנוע החיפוש, ובמידת הצורך טקסט מהמסד המקורי SearchRepository
חיפוש לפי עניין מודל מקומי ונתוני וקטורים המתאימים לספרייה SemanticSearchRepository

חיפוש מקומי בתוך ספר פתוח משתמש בחלק מממשק ההגדרות המשותף, אך אינו זהה בכל יכולותיו לחיפוש באינדקס. לדוגמה, אפשרויות התאמת ניקוד וטעמים מוצגות רק במסלולים הנתמכים.

רכיבים ואחריות

רכיב אחריות
SearchDialog הזנת שאילתה, מצב, היקף ואפשרויות; חסימת חיפוש התלוי באינדקס חסר או לא תואם
SearchConfiguration המצב והפרמטרים השמורים בכרטיסיית החיפוש
SearchQueryBuilder תרגום בחירות הממשק לבקשה למנוע, לרבות הרחבות וחלופות
SearchRepository ממשק החיפוש, ספירות, עימוד ופתרון זהות ספרים
SearchEngineGateway גבול הקריאה למנוע הילידי ולפעולות הביטול שלו
SearchBloc ניהול בקשות, תוצאות, מסננים, טעינת המשך ומצב שגיאה
TantivySearchResults תוצאות, תצוגה מקדימה, איחוד, טעינת המשך ופתיחת מקור
LibraryLineSource אספקת תוכן עדכני מהספרייה עבור רשומות אינדקס המפנות למקור

עיבוד השאילתה והתאמת המילים נשענים על מנוע החיפוש. אין לשחזר ב־Dart מנרמל או מפרק מילים חלופי שאינו תואם ל־tokenizer של המנוע.

מצבים ואפשרויות

SearchMode כולל exact, advanced ו־fuzzy. האפשרות „חיפוש חכם” בממשק אינה ערך נוסף באותו enum; היא פותחת מסלול ותצורת תוצאות נפרדים.

Exact: חיפוש לפי המילים והסדר, עם אפשרות למרווח ולהרחבות משותפות לכל המילים. כאשר מופעלות אפשרויות הדורשות זאת, הבקשה מתורגמת למסלול מתקדם במנוע. לכן אין להניח שכל בקשה שהגיעה ממצב „מדויק” היא חיפוש רצף מילולי ללא הרחבות.

Advanced: אפשרויות גלובליות או לפי מילה, חלופות, מרווח לכל מעבר, החרגות, תחום ההתאמה וכמות המילים הנדרשת. SearchMatchPolicy מפריד בין „כל המילים”, „לפחות אחת”, „רוב” וסף מפורש. תחום ההתאמה יכול להיות מרווח מילים, אותה פסקה או אותה כותרת.

Fuzzy: מרחק עריכה של עד שתי פעולות ברמת המילה. הוא אינו מדד לקרבה בין מילים בטקסט ואינו חיפוש סמנטי. אפשרויות המילה של החיפוש המתקדם אינן מועתקות אליו אוטומטית.

יש להבחין בין:

  • אפשרות חיפוש שמרחיבה את המילים, כגון כתיב מלא/חסר, תחיליות או חלופות.
  • דרישה להתאמת סימנים שהוקלדו, כגון ניקוד.
  • הגדרת תצוגה של הקורא, כגון הסתרת ניקוד, שאינה משנה כשלעצמה את תוכן המקור או את האינדקס.

מצב ואפשרויות נשמרים בזיכרון העבודה, וניתן לקבוע במפורש ברירת מחדל להפעלות הבאות. עריכת כרטיסייה קיימת משתמשת בתצורת הכרטיסייה.

היקף וסינון

היקף הספרים מתורגם ל־facets על פי זהות הספרים והקטגוריות. אין להשתמש בכותרת הספר כמזהה יחיד: שמות זהים יכולים להגיע מהספרייה הרשמית, מקבצים אישיים וממסדים מצורפים.

תחביר שאילתה@ספר@קטגוריה מפוענח ב־CategoryQueryParser. כשהוא קיים, הוא מחליף את בחירת הספרים והקטגוריות הידנית. מסננים מממד אחר, כגון מחבר ותקופה, עדיין מצורפים אליו.

ממדי הסינון כוללים בין היתר /base, /era/ ו־/author/. כמה בחירות באותו ממד מצורפות כחלופות; ממדים שונים מצמצמים זה את זה. שינוי היקף חייב לעדכן גם את התוצאות וגם את הספירות, בלי לפרסם ספירה ששייכת לבקשה קודמת.

ביטויים רגולריים

UserRegexQuery מזהה שאילתה שלמה המוקפת /…/, ומבקש מהמנוע לפרש אותה. ביטוי תקין מקבל תוכנית חיפוש ומנגנון התאמה משלו; הוא אינו עובר הרחבות רגילות כאילו היה רצף מילים.

דגשים למימוש:

  • זיהוי תלוי בתחביר תקין, לא רק בנוכחות לוכסן.
  • שאילתה שאינה מזוהה כביטוי תקין חוזרת למסלול טקסט רגיל.
  • @ בתוך ביטוי תקין אינו מפריד היקף.
  • חיפוש ביטוי הכולל רווחים עשוי לדרוש בדיקת תוכן השורה. אין להניח התאמה על פני שורות עצמאיות.
  • עוגני תחילה וסוף מתייחסים לשורה במסלול המתאים.
  • תחביר המנוע הוא הסמכות; אין להבטיח תמיכה בכל תחביר של RegExp ב־Dart.

בקשות, עימוד וביטול

SearchBloc משייך מזהה לבקשת חיפוש ומשתמש בביטול הילידי. תשובה שהגיעה לאחר שבקשה חדשה החליפה אותה אינה אמורה לעדכן את המסך. גם ספירות ה־facets נבדקות מול תמונת מצב של השאילתה וההיקף.

המסלול המשולב יכול לקבל תוצאות וספירות מאותה הרצה ולהציג תוצאות באצוות. עימוד מוסיף לתוצאות הקיימות; חיפוש חדש מחליף אותן. סינון מקומי של רשימה קודמת מתאים רק כשהרשימה מלאה והתצורה תואמת — רשימה שנחתכה או נטענה חלקית אינה בסיס לספירה מלאה.

הממשק מבחין בין שגיאת חיפוש, אפס תוצאות וחיפוש רחב מדי. אין להמיר את שלושתם לרשימה ריקה מוצלחת.

תוכן התוצאה ופתיחת הספר

אינדקס עשוי לשמור הפניה לשורת מקור במקום עותק מלא של הטקסט. LibraryLineSource ופתרון הזהות מחברים את התוצאה למקור המתאים. לכן קובץ ספרייה לא זמין, ספר ששונה ואינדקס ישן הם מצבים שיש לטפל בהם גם כשמנוע החיפוש הצליח למצוא מזהה.

SearchResultOpener מאמת את הספר מול המזהה והכותרת שנשמרו בתוצאה. IndexFreshnessWarner יכול להזהיר כשהתוכן השתנה. אין לפתוח ספר אחר בעל אותו שם כתחליף שקט.

איחוד לפי סעיף או טקסט זהה שומר מידע על מופעים נוספים. מספר קבוצות, מספר תוצאות ומספר מופעים הם נתונים שונים. מצב תצוגה מקדימה משנה גם את פעולת הלחיצה: בחלונית רחבה לחיצה יחידה יכולה לבחור תצוגה מקדימה, ולחיצה כפולה פותחת את הספר.

תוספים יכולים לספק תוצאות חיצוניות באותו מסך. מקור התוצאה, מצב הטעינה ומגבלותיו נשארים נפרדים מהתוצאות המקומיות; ראה תוספים.

מקורות בקוד

אינדוקס · שכבת הנתונים · חיפוש חכם

Clone this wiki locally