Update script.js

script.js

@@ -258,12 +258,15 @@ async function updateSelectedBooksData() {
             searchResultsContainer.innerHTML = '<p>پس از انتخاب کتاب‌ها و وارد کردن سوال، نتایج اینجا نمایش داده می‌شوند.</p>';
          }
     } finally {
-        // این بخش نیازی به checkAndEnableSearchButton ندارد چون در بالا صدا زده می شود
+        // در نهایت، چه بارگذاری موفقیت آمیز باشد چه با خطا مواجه شود، دکمه جستجو وضعیت خود را بررسی می کند.
+        // checkAndEnableSearchButton() این کار را انجام می دهد.
+        // checkAndEnableSearchButton(); // در اینجا نیازی نیست، چون در هر دو شاخه موفقیت و خطا صدا زده می شود.
     }
 }
 
 
 // ****** تابع کمکی برای محاسبه شباهت کسینوسی بین دو بردار ******
+// این تابع همان تابع استاندارد محاسبه شباهت کسینوسی است.
 function cosineSimilarity(vecA, vecB) {
      // بررسی وجود و صحت بردارها قبل از شروع محاسبات
      if (!vecA || !vecB || vecA.length !== vecB.length || vecA.length === 0) {
@@ -299,6 +302,7 @@ function cosineSimilarity(vecA, vecB) {
 }
 
 // تابع کمکی برای حذف بخش کلمات کلیدی از متن Passage
+// این تابع بر اساس فرمتی که در generate_embeddings.py برای ترکیب متن و کلیدواژه ها استفاده شده، کار می کند.
 function cleanPassageTextForDisplay(passage) {
     if (!passage || typeof passage !== 'string') {
         console.warn("cleanPassageTextForDisplay received invalid input:", passage);
@@ -319,7 +323,7 @@ function cleanPassageTextForDisplay(passage) {
 
 
 // ****** تعریف کامل تابع async function searchMemoirs() { ... } ******
-// این تابع شامل منطق اصلی جستجو است.
+// این تابع شامل منطق اصلی جستجو است: دریافت بردار سوال، محاسبه شباهت، فیلتر، مرتب سازی، نمایش نتایج.
 async function searchMemoirs() {
     console.log("Search triggered."); // لاگ برای توسعه
     console.log(`Data loaded state (passages count): ${memoirsWithEmbeddings.length}`); // لاگ برای توسعه
@@ -363,6 +367,7 @@ async function searchMemoirs() {
     try {
         console.log("Requesting query embedding from Python server..."); // لاگ برای توسعه
 
+        // ارسال درخواست به سرور Backend برای دریافت بردار سوال
         const serverResponse = await fetch(EMBEDDING_SERVER_URL, {
             method: 'POST',
             headers: {
@@ -371,6 +376,7 @@ async function searchMemoirs() {
             body: JSON.stringify({ query: query })
         });
 
+        // بررسی موفقیت آمیز بودن پاسخ سرور (کد وضعیت 2xx)
         if (!serverResponse.ok) {
              const errorBody = await serverResponse.text(); // بخوان به صورت متن برای اطلاعات بیشتر
              console.error(`Server responded with status ${serverResponse.status}:`, errorBody); // لاگ خطا برای توسعه
@@ -394,9 +400,11 @@ async function searchMemoirs() {
 
         }
 
+        // دریافت داده های JSON از پاسخ سرور
         const serverData = await serverResponse.json();
         const queryEmbeddingArray = serverData.embedding;
 
+        // بررسی اینکه بردار embedding معتبر و غیر خالی است
         if (!queryEmbeddingArray || !Array.isArray(queryEmbeddingArray) || queryEmbeddingArray.length === 0) {
              console.error("Server returned an invalid or empty embedding:", serverData); // لاگ خطا برای توسعه
              updateStatus("جستجو با خطا مواجه شد.", true); // پیام اصلی برای کاربر
@@ -408,16 +416,16 @@ async function searchMemoirs() {
         console.log(`Query embedding dimensions: ${queryEmbeddingArray.length}`); // لاگ برای توسعه
         console.log("Calculating similarities in browser..."); // لاگ برای توسعه
 
+        // محاسبه شباهت بین بردار سوال و بردارهای تمام خاطرات بارگذاری شده
         const searchResults = [];
-        // محاسبه شباهت با تمام قطعات خاطره ای که از کتاب های انتخاب شده بارگذاری شده اند
-        for (const memoir of memoirsWithEmbeddings) { // memoirsWithEmbeddings حاوی book_title و book_file است
+        // memoirsWithEmbeddings حاوی خاطرات با بردارهای embedding و اطلاعات کتاب است.
+        for (const memoir of memoirsWithEmbeddings) {
             // اطمینان از وجود و صحت بردار embedding در آیتم خاطره
-            // همچنین اطمینان از این که بردار خاطره همان ابعاد بردار سوال را دارد
+            // و اینکه بردار خاطره همان ابعاد بردار سوال را دارد (خیلی مهم)
             if (memoir.embedding && Array.isArray(memoir.embedding) && memoir.embedding.length === queryEmbeddingArray.length) {
                  const similarity = cosineSimilarity(queryEmbeddingArray, memoir.embedding);
-                // اضافه کردن تمام فیلدهای اصلی خاطره و امتیاز شباهت به نتیجه
-                // استفاده از نام فیلد similarity برای امتیاز شباهت
-                searchResults.push({ ...memoir, similarity: similarity });
+                // اضافه کردن تمام فیلدهای اصلی خاطره و امتیاز شباهت به نتیجه جستجو
+                searchResults.push({ ...memoir, similarity: similarity }); // استفاده از نام فیلد similarity برای امتیاز شباهت
             } else {
                  // هشدار برای آیتم های بدون بردار یا با ابعاد نامعتبر (فقط در کنسول)
                  console.warn(`Skipping memoir due to missing or invalid embedding or dimension mismatch: ${memoir.book_title || memoir.book_file || 'Unknown Book'} - ${memoir.reference || 'Unknown Reference'}`);
@@ -426,95 +434,107 @@ async function searchMemoirs() {
         console.log(`Similarity calculation complete. Found ${searchResults.length} results with valid embeddings.`); // لاگ برای توسعه
 
 
-        // ****** خواندن آستانه شباهت از ورودی کاربر و فیلتر کردن ******
-        let currentSimilarityThreshold = DEFAULT_SIMILARITY_THRESHOLD; // از مقدار پیش فرض ثابت به عنوان fallback استفاده می کنیم
-        if (similarityThresholdInput) {
+        // ****** خواندن آستانه شباهت از ورودی کاربر و فیلتر کردن نتایج ******
+        let currentSimilarityThreshold = DEFAULT_SIMILARITY_THRESHOLD; // مقدار پیش فرض به عنوان fallback
+        if (similarityThresholdInput) { // اگر المان ورودی آستانه شباهت پیدا شد
             const inputValue = parseFloat(similarityThresholdInput.value);
             // چک می کنیم عدد معتبر باشد و در محدوده [0, 1] باشد
             if (!isNaN(inputValue) && inputValue >= 0.0 && inputValue <= 1.0) {
                 currentSimilarityThreshold = inputValue;
-                console.log("Using user-defined similarity threshold:", currentSimilarityThreshold); // لاگ برای توسعه
+                console.log("Using user-defined similarity threshold:", currentSimilarityThreshold); // لاگ
             } else {
-                 console.warn("Invalid similarity threshold input value, using default:", DEFAULT_SIMILARITY_THRESHOLD); // لاگ برای توسعه
+                 console.warn("Invalid similarity threshold input value, using default:", DEFAULT_SIMILARITY_THRESHOLD); // لاگ
                  updateSelectionError(`مقدار آستانه شباهت وارد شده (${similarityThresholdInput.value}) معتبر نیست. از مقدار پیش فرض ${DEFAULT_SIMILARITY_THRESHOLD.toFixed(2)} استفاده می‌شود.`); // پیام خطا برای کاربر
-                 currentSimilarityThreshold = DEFAULT_SIMILARITY_THRESHOLD; // بازگشت به مقدار پیش فرض ثابت
-                 // optional: set the input value back to the default if invalid
-                 // similarityThresholdInput.value = DEFAULT_SIMILARITY_THRESHOLD.toFixed(2); // این خط می تواند مقدار نمایش داده شده را هم به پیش فرض برگرداند
+                 currentSimilarityThreshold = DEFAULT_SIMILARITY_THRESHOLD; // بازگشت به مقدار پیش فرض
             }
         } else {
-            console.warn("Similarity threshold input element not found, using default threshold:", DEFAULT_SIMILARITY_THRESHOLD); // لاگ برای توسعه
+            console.warn("Similarity threshold input element not found, using default threshold:", DEFAULT_SIMILARITY_THRESHOLD); // لاگ
         }
 
-
+        // فیلتر کردن نتایج بر اساس آستانه شباهت
         const filteredResults = searchResults.filter(result => result.similarity >= currentSimilarityThreshold);
-        console.log(`Filtered results based on threshold ${currentSimilarityThreshold.toFixed(2)}: ${filteredResults.length} results remaining.`); // لاگ برای توسعه
+        console.log(`Filtered results based on threshold ${currentSimilarityThreshold.toFixed(2)}: ${filteredResults.length} results remaining.`); // لاگ
         // *************************************************************
 
 
-        console.log("Sorting results by similarity..."); // لاگ برای توسعه
-        // Sort the filtered results by similarity in descending order (highest similarity first)
+        console.log("Sorting results by similarity..."); // لاگ
+        // مرتب سازی نتایج فیلتر شده بر اساس امتیاز شباهت به صورت نزولی (بیشترین شباهت اول)
         filteredResults.sort((a, b) => b.similarity - a.similarity);
-        console.log("Filtered results sorted."); // لاگ برای توسعه
-
-        // ****** انتخاب تعداد نتایج برتر بر اساس انتخاب کاربر (از نتایج فیلتر شده) ******
-        let finalResultsPerPage = 10; // مقدار پیش فرض برای نتایج در صفحه
-        if (resultsPerPageSelect) {
-             const selectedValue = parseInt(resultsPerPageSelect.value, 10); // خواندن مقدار انتخاب شده و تبدیل به عدد صحیح
-             // اطمینان از اینکه selectedValue یک عدد معتبر و مثبت است
-             finalResultsPerPage = (!isNaN(selectedValue) && selectedValue > 0) ? selectedValue : 10; // مقدار پیش فرض 10 اگر نامعتبر باشد
+        console.log("Filtered results sorted."); // لاگ
+
+        // ****** انتخاب تعداد نتایج برتر بر اساس انتخاب کاربر ******
+        let finalResultsPerPage = 10; // مقدار پیش فرض
+        if (resultsPerPageSelect) { // اگر المان انتخاب تعداد نتایج پیدا شد
+             const selectedValue = parseInt(resultsPerPageSelect.value, 10); // خواندن مقدار انتخاب شده
+             // اطمینان از اینکه عدد معتبر و مثبت است
+             finalResultsPerPage = (!isNaN(selectedValue) && selectedValue > 0) ? selectedValue : 10; // مقدار پیش فرض 10
         } else {
-             console.warn("Results per page select element not found, using default:", finalResultsPerPage);
+             console.warn("Results per page select element not found, using default:", finalResultsPerPage); // لاگ
         }
 
-
-        const topResults = filteredResults.slice(0, finalResultsPerPage); // انتخاب فقط N نتیجه برتر از لیست فیلتر شده
+        // برش لیست نتایج برای نمایش فقط تعداد مورد نظر
+        const topResults = filteredResults.slice(0, finalResultsPerPage);
         console.log(`Displaying top ${topResults.length} results from filtered list based on user selection (${finalResultsPerPage} per page setting).`);
         // ********************************************
 
 
-        // ****** منطق نمایش نتایج و پیام ها ******
-        if (searchResultsContainer) { // استفاده از نام متغیر صحیح
+        // ****** منطق نمایش نتایج در HTML ******
+        if (searchResultsContainer) { // اگر کانتینر نمایش نتایج پیدا شد
              // نتایج قبلی در ابتدای تابع پاک شده اند.
 
              if (topResults.length === 0) { // اگر هیچ نتیجه ای یافت نشد
-                 // پیام به کاربر، شامل مقدار آستانه ای که استفاده شده است
+                 // پیام مناسب برای کاربر، شامل آستانه شباهت استفاده شده
                  searchResultsContainer.innerHTML = `<p>نتیجه مرتبطی با آستانه شباهت مورد نظر (${currentSimilarityThreshold.toFixed(2)}) یافت نشد. سعی کنید عبارت دیگری را جستجو کنید یا آستانه را کاهش دهید.</p>`;
-                 console.log("No relevant results found after filtering and slicing.");
+                 console.log("No relevant results found after filtering and slicing."); // لاگ
              } else { // اگر نتایجی یافت شد
                   console.log("Results found, updating DOM.");
 
-                 // ایجاد کانتینر برای لیست نتایج برای کنترل بهتر استایل دهی
+                 // ایجاد کانتینر برای لیست نتایج برای کنترل بهتر استایل دهی (اختیاری اما مفید)
                  const resultsList = document.createElement('div');
-                 resultsList.classList.add('results-list');
+                 resultsList.classList.add('results-list'); // می توانید استایل هایی برای این کلاس در CSS اضافه کنید.
 
 
                  topResults.forEach(result => {
                      // ایجاد المان برای هر آیتم نتیجه
                      const resultItem = document.createElement('div');
-                     resultItem.classList.add('result-item');
+                     resultItem.classList.add('result-item'); // کلاس اصلی هر نتیجه
+
+
+                     // ایجاد و اضافه کردن تمام بخش های یک نتیجه (امتیاز، نام کتاب، مرجع، متن خاطره، دکمه کپی)
 
                      // ****** نمایش امتیاز شباهت ******
-                     const similarityElement = document.createElement('p'); // استفاده از p مطابق با ساختار قبلی شما
+                     // استفاده از p مطابق با ساختار HTML و کلاس CSS شما
+                     const similarityElement = document.createElement('p');
                      similarityElement.classList.add('result-similarity');
                      // نمایش امتیاز با 4 رقم اعشار
-                     similarityElement.textContent = `شباهت: ${result.similarity.toFixed(4)}`;
+                     similarityElement.textContent = `شباهت: ${result.similarity !== undefined ? result.similarity.toFixed(4) : 'N/A'}`;
+                     resultItem.appendChild(similarityElement); // اضافه کردن به آیتم نتیجه
                      // ******************************
 
+
                      // نمایش نام کتاب
-                     const bookTitleElement = document.createElement('p'); // استفاده از p مطابق با ساختار قبلی شما
+                     // استفاده از p مطابق با ساختار HTML و کلاس CSS شما
+                     const bookTitleElement = document.createElement('p');
                      bookTitleElement.classList.add('result-book-title');
                      bookTitleElement.textContent = `از کتاب: ${result.book_title || 'نامشخص'}`;
+                     resultItem.appendChild(bookTitleElement); // اضافه کردن به آیتم نتیجه
+
 
                      // نمایش مرجع خاطره
-                     const referenceElement = document.createElement('p'); // استفاده از p مطابق با ساختار قبلی شما
+                     // استفاده از p مطابق با ساختار HTML و کلاس CSS شما
+                     const referenceElement = document.createElement('p');
                      referenceElement.classList.add('result-reference');
                      referenceElement.innerHTML = `<strong>مرجع:</strong> ${result.reference || 'نامشخص'}`; // استفاده از innerHTML برای bold کردن "مرجع:"
+                     resultItem.appendChild(referenceElement); // اضافه کردن به آیتم نتیجه
 
 
                      // نمایش متن خاطره (با حذف کلمات کلیدی)
-                     const passageElement = document.createElement('p'); // استفاده از p مطابق با ساختار قبلی شما
+                     // استفاده از p مطابق با ساختار HTML و کلاس CSS شما
+                     const passageElement = document.createElement('p');
                      passageElement.classList.add('result-passage');
                      passageElement.textContent = cleanPassageTextForDisplay(result.passage || ''); // استفاده از متن تمیز شده
+                     resultItem.appendChild(passageElement); // اضافه کردن به آیتم نتیجه
+
 
                      // ****** اضافه کردن دکمه کپی ******
                      const copyButton = document.createElement('button');
@@ -525,79 +545,40 @@ async function searchMemoirs() {
                      // این استایل ها برای کمک به ظاهر شدن دکمه اضافه شده اند.
                      // اگر با این استایل ها دکمه ظاهر شد، مشکل در فایل style.css یا اعمال آن است.
                      // پس از حل مشکل نمایش در style.css، این خطوط را حذف کنید.
-                     copyButton.style.display = 'block';
-                     copyButton.style.marginTop = '10px';
-                     copyButton.style.marginLeft = 'auto'; // برای راست چین کردن در RTL
+                     copyButton.style.display = 'block'; // نمایش به صورت بلوک جداگانه
+                     copyButton.style.marginTop = '10px'; // فاصله از بالا
+                     copyButton.style.marginLeft = 'auto'; // راست چین کردن در RTL با margin auto و margin-right 0
                      copyButton.style.marginRight = '0';
                      copyButton.style.backgroundColor = '#007bff'; // رنگ آبی
                      copyButton.style.color = 'white';
-                     copyButton.style.padding = '5px 5px'; // padding کمی کمتر
+                     copyButton.style.padding = '5px 5px'; // padding
                      copyButton.style.border = 'none';
-                     copyButton.style.borderRadius = '4px';
-                     copyButton.style.cursor = 'pointer';
-                     copyButton.style.fontSize = '0.8em'; // فونت کمی کوچکتر
-                     copyButton.style.fontFamily = "'Vazirmatn', sans-serif"; // اطمینان از اعمال فونت
+                     copyButton.style.borderRadius = '4px'; // گوشه گرد
+                     copyButton.style.cursor = 'pointer'; // نشانگر موس
+                     copyButton.style.fontSize = '0.8em'; // اندازه فونت
+                     copyButton.style.fontFamily = "'Vazirmatn', sans-serif"; // اعمال فونت
                      // *****************************************************************
 
 
-                     // Event listener برای دکمه کپی (همان کد قبلی)
-                     copyButton.addEventListener('click', async () => {
-                         // ****** ساخت متنی که باید کپی شود (متن خاطره، مرجع، نام کتاب، شباهت) ******
-                         const passageText = cleanPassageTextForDisplay(result.passage || ''); // متن تمیز شده خاطره
-                         const referenceText = result.reference || 'نامشخص'; // متن مرجع
-                         const bookTitleText = result.book_title || 'نامشخص'; // متن نام کتاب
-                         const similarityText = result.similarity !== undefined ? result.similarity.toFixed(4) : 'N/A'; // متن شباهت
-
-                         // ترکیب متن ها با فرمت دلخواه (مثلاً با خط جدید بین هر بخش)
-                         const textToCopy = `خاطره:\n${passageText}\n\nمرجع: ${referenceText}\nاز کتاب: ${bookTitleText}\nشباهت: ${similarityText}`; // اضافه کردن امتیاز شباهت به متن کپی شده
-                         // *****************************************************************
-
-                         try {
-                             // استفاده از Clipboard API برای کپی کردن متن
-                             await navigator.clipboard.writeText(textToCopy);
-                             copyButton.textContent = 'کپی شد!'; // پیام بازخورد کوتاه
-                             // برگرداندن متن دکمه به حالت اولیه بعد از 2 ثانیه
-                             setTimeout(() => {
-                                 copyButton.textContent = 'کپی متن';
-                             }, 2000);
-                             console.log("Passage, reference, book title, and similarity copied to clipboard."); // لاگ موفقیت
-                         } catch (err) {
-                             console.error('Failed to copy text: ', err); // لاگ خطا در کنسول
-                             copyButton.textContent = 'خطا در کپی'; // پیام بازخورد خطا
-                              setTimeout(() => {
-                                 copyButton.textContent = 'کپی متن';
-                             }, 2000);
-                         }
-                     });
-                     // ******************************
-
-
-                     // اضافه کردن عناصر به آیتم نتیجه با ترتیب دلخواه
-                     // ایجاد یک div یا span برای نگه داشتن مرجع، نام کتاب و شباهت برای کنترل بهتر استایل دهی (همانند CSS شما)
-                     const metaInfoDiv = document.createElement('div');
-                     // در HTML شما از p های جداگانه برای reference, book-title, similarity استفاده شده بود
-                     // و استایل هایی برای کلاس های result-reference, result-book-title, result-similarity داشتید.
-                     // بهتر است المان ها را جداگانه اضافه کنیم تا کلاس های CSS شما اعمال شوند.
-
-                     resultItem.appendChild(passageElement); // اول متن
-                     resultItem.appendChild(referenceElement); // بعد مرجع
-                     resultItem.appendChild(bookTitleElement); // بعد نام کتاب
-                     resultItem.appendChild(similarityElement); // بعد امتیاز شباهت (که با float در CSS سمت راست میرود)
+                     // Event listener برای دکمه کپی
+                     // این Listener در بلوک DOMContentLoaded به صورت Delegation اضافه می شود.
+                     // کد مربوط به Listener در انتهای بلوک DOMContentLoaded آورده شده است.
+                     // در اینجا فقط دکمه را به آیتم نتیجه اضافه می کنیم.
                      resultItem.appendChild(copyButton); // دکمه کپی در انتها
 
                      // **************************************************************************
 
 
-                     resultsList.appendChild(resultItem);
+                     resultsList.appendChild(resultItem); // اضافه کردن آیتم نتیجه به لیست نتایج
                  });
 
                  searchResultsContainer.appendChild(resultsList); // اضافه کردن لیست نتایج به کانتینر اصلی
                  console.log("DOM updated with results.");
 
-                 // لا�� کردن نتایج برای توسعه (شامل جزئیات بیشتر)
+                 // لاگ کردن نتایج برتر نمایش داده شده برای عیب یابی
                  console.log(`Top ${topResults.length} results displayed (reference, book, similarity, passage start):`);
                  topResults.forEach(result => {
-                     console.log(`  Book: ${result.book_title || 'Unknown'}, Ref: ${result.reference || 'N/A'}, Sim: ${result.similarity.toFixed(4)}, Passage: "${result.passage ? result.passage.substring(0, 50).replace(/\n/g, ' ') + '...' : 'N/A'}"`); // لاگ جزئیات بیشتر و جایگزینی خط جدید در لاگ
+                     console.log(`  Book: ${result.book_title || 'Unknown'}, Ref: ${result.reference || 'N/A'}, Sim: ${result.similarity !== undefined ? result.similarity.toFixed(4) : 'N/A'}, Passage: "${result.passage ? result.passage.substring(0, Math.min(result.passage.length, 50)).replace(/\n/g, ' ') + '...' : 'N/A'}"`); // لاگ جزئیات بیشتر و جایگزینی خط جدید
                  });
              }
 
@@ -610,7 +591,7 @@ async function searchMemoirs() {
 
 
         } else {
-            console.error("Could not find searchResultsContainer to display results.");
+            console.error("Could not find searchResultsContainer to display results."); // لاگ
              updateStatus("جستجو با خطا مواجه شد.", true); // پیام خطا (رنگ قرمز)
              updateSelectionError("المان نمایش نتایج پیدا نشد. لطفاً ساختار HTML را بررسی کنید."); // پیام خطا در بخش انتخاب
         }
@@ -618,17 +599,15 @@ async function searchMemoirs() {
 
     } catch (error) {
         // مدیریت خطا هنگام درخواست سرور یا پردازش پاسخ
-        console.error("Error during search:", error);
+        console.error("Error during search:", error); // لاگ
          if (searchResultsContainer) { // استفاده از نام متغیر صحیح
             searchResultsContainer.innerHTML = `<p style="color: red;">هنگام جستجو خطایی رخ داد: ${error.message || 'خطای نامشخص'}. جزئیات بیشتر در کنسول مرورگر موجود است.</p>`;
          }
         updateStatus("جستجو با خطا مواجه شد.", true); // پیام خطا (رنگ قرمز)
         updateSelectionError(`هنگام جستجو خطایی رخ داد: ${error.message || 'خطای نامشخص'}.`); // نمایش خطای اصلی در بخش خطای انتخاب
     } finally {
-        // در نهایت، چه جستجو موفقیت آمیز باشد چه با خطا مواجه شود، دکمه جستجو را فعال می کنیم.
-        // این اطمینان را می دهد که دکمه همیشه پس از پایان فرآیند جستجو قابل استفاده مجدد است (مگر اینکه داده ها بارگذاری نشده باشند).
-        // checkAndEnableSearchButton() این کار را انجام می دهد.
-        checkAndEnableSearchButton(); // فعال کردن مجدد دکمه جستجو
+        // در نهایت، چه جستجو موفقیت آمیز باشد چه با خطا مواجه شود، دکمه جستجو وضعیت خود را بررسی می کند.
+        checkAndEnableSearchButton(); // فعال کردن مجدد دکمه جستجو (اگر شرایط فراهم باشد)
     }
 }
 // پایان تعریف تابع async function searchMemoirs()
@@ -644,14 +623,14 @@ document.addEventListener('DOMContentLoaded', () => {
     userQuestionInput = document.getElementById('userQuestion');
     searchResultsContainer = document.getElementById('searchResults');
     loadingStatusElement = document.getElementById('loadingStatus');
-    selectionErrorElement = document.getElementById('selectionError');
+    selectionErrorElement = document.getElementById('selectionError'); // مطابق با ID در HTML شما
 
-    selectAllCheckbox = document.getElementById('select_all_books');
+    selectAllCheckbox = document.getElementById('select_all_books'); // مطابق با ID در HTML شما
     // getElementsByClassName برمی گرداند HTMLCollection زنده.
-    bookCheckboxes = document.getElementsByClassName('book-checkbox');
+    bookCheckboxes = document.getElementsByClassName('book-checkbox'); // مطابق با class در HTML شما
 
-    resultsPerPageSelect = document.getElementById('resultsPerPage');
-    similarityThresholdInput = document.getElementById('similarityThresholdInput');
+    resultsPerPageSelect = document.getElementById('resultsPerPage'); // مطابق با ID در HTML شما
+    similarityThresholdInput = document.getElementById('similarityThresholdInput'); // مطابق با ID در HTML شما
     // **********************************************************************************
 
 
@@ -676,4 +655,150 @@ document.addEventListener('DOMContentLoaded', () => {
                  // فقط اگ�� دکمه جستجو فعال است، کلیک را شبیه سازی کن
                  if (!searchButton.disabled) {
                     searchButton.click();
-                    console.log("Enter key pressed in search input, simulating search button click."); // La
+                    console.log("Enter key pressed in search input, simulating search button click."); // Log
+                 }
+            }
+        });
+        console.log("Search input keypress listener added.");
+
+
+        // Listener برای تغییر مقدار ورودی آستانه شباهت: به‌روزرسانی وضعیت دکمه (فعال/غیرفعال شدن)
+        // مقدار آستانه شباهت مستقیماً در تابع searchMemoirs از این input خوانده می شود.
+        similarityThresholdInput.addEventListener('input', () => {
+            console.log("Similarity threshold input value changed.");
+            checkAndEnableSearchButton(); // بررسی وضعیت دکمه پس از تغییر مقدار
+        });
+        console.log("Similarity threshold input listener added.");
+
+        // Listener برای تغییر انتخاب در نتایج در صفحه (resultsPerPageSelect)
+        // مقدار نتایج در صفحه مستقیماً در تابع searchMemoirs از این select خوانده می شود.
+        resultsPerPageSelect.addEventListener('change', () => {
+             console.log("Results per page setting changed.");
+             // نیازی به checkAndEnableSearchButton نیست چون تغییر این مقدار به تنهایی دکمه را فعال/غیرفعال نمی کند.
+        });
+        console.log("Results per page select listener added.");
+
+
+        // Listener ها برای چک باکس 'انتخاب همه' و چک باکس های تکی کتاب ها
+        // تغییر در این چک باکس ها باید منجر به بارگذاری مجدد داده ها شود.
+
+        if (selectAllCheckbox) {
+             selectAllCheckbox.addEventListener('change', () => {
+                const isChecked = selectAllCheckbox.checked; // استفاده مستقیم از selectAllCheckbox
+                // getElementsByClassName برمی گرداند HTMLCollection زنده، باید آن را به آرایه تبدیل کرد
+                Array.from(bookCheckboxes).forEach(cb => { // استفاده از bookCheckboxes
+                    cb.checked = isChecked;
+                });
+                console.log(`'Select All' checkbox changed to ${isChecked}. All book checkboxes updated.`); // لاگ
+                // پس از تغییر انتخاب کتاب، باید داده ها را بارگذاری مجدد کنیم.
+                updateSelectedBooksData(); // <--- فراخوانی بارگذاری مجدد داده ها
+            });
+            console.log("'Select All' checkbox change listener added.");
+        } else {
+             console.error("'Select All' checkbox element with ID 'select_all_books' not found.");
+             // اگر این المان پیدا نشد، قابلیت "انتخاب همه" کار نخواهد کرد.
+        }
+
+        if (bookCheckboxes && bookCheckboxes.length > 0) {
+             Array.from(bookCheckboxes).forEach(cb => { // استفاده از bookCheckboxes
+                 cb.addEventListener('change', () => {
+                     // بررسی کنید که آیا همه چک باکس های تکی انتخاب شده اند
+                     const allOthersChecked = Array.from(bookCheckboxes).every(cb => cb.checked); // استفاده از bookCheckboxes
+                     if (selectAllCheckbox) { // اگر چک باکس "انتخاب همه" وجود دارد، وضعیت آن را بر اساس وضعیت چک باکس های تکی به‌روزرسانی کن
+                          selectAllCheckbox.checked = allOthersChecked;
+                     }
+                      console.log("Individual book checkbox changed. Checking 'Select All' status."); // لاگ
+                      // پس از تغییر انتخاب کتاب، باید داده ها را بارگذاری مجدد کنیم.
+                      updateSelectedBooksData(); // <--- فراخوانی بارگذاری مجدد داده ها
+                 });
+             });
+             console.log("Individual book checkboxes change listeners added.");
+        } else {
+             console.warn("No book checkboxes found with class 'book-checkbox'. Book selection filtering will not work as expected.");
+             // اگر المان های چک باکس تکی پیدا نشدند، فیلترینگ بر اساس کتاب انتخاب شده کار نخواهد کرد.
+             // در این حالت، updateSelectedBooksData با لیست خالی selectedBookFiles اجرا خواهد شد.
+        }
+
+
+        // Listener برای دکمه های کپی (به صورت Delegation در searchResultsContainer)
+        // این Listener روی کانتینر نتایج گوش می دهد و برای دکمه های کپی که به صورت پویا اضافه می شوند، فعال می شود.
+        searchResultsContainer.addEventListener('click', (event) => {
+            // چک می کنیم که آیا کلیک روی المانی با کلاس 'copy-button' رخ داده است؟
+            if (event.target && event.target.classList && event.target.classList.contains('copy-button')) {
+                 // جلوگیری از رفتار پیش فرض دکمه (مثلا ارسال فرم اگر داخل فرم باشد)
+                 event.preventDefault(); // اضافه شده
+
+                 // المان والد نتیجه را پیدا می کنیم (.result-item)
+                 const resultItemElement = event.target.closest('.result-item');
+                 if (resultItemElement) {
+                      // متن کپی شامل متن خاطره، مرجع، نام کتاب و شباهت است.
+                      // این اطلاعات از متن نمایش داده شده در المان های نتیجه استخراج می شود.
+                      const passageText = resultItemElement.querySelector('.result-passage')?.textContent || '';
+                      // استفاده از ? در selector برای جلوگیری از خطا اگر المان پیدا نشد.
+                      // جایگزینی 'مرجع:' و trim برای تمیز کردن متن استخراج شده.
+                      const referenceText = resultItemElement.querySelector('.result-reference')?.textContent.replace('مرجع:', '').trim() || 'نامشخص';
+                      const bookTitleText = resultItemElement.querySelector('.result-book-title')?.textContent.replace('از کتاب:', '').trim() || 'نامشخص';
+                       const similarityText = resultItemElement.querySelector('.result-similarity')?.textContent.replace('شباهت:', '').trim() || 'N/A';
+
+                       // ساخت متنی که باید کپی شود با فرمت دلخواه
+                       const textToCopy = `خاطره:\n${passageText}\n\nمرجع: ${referenceText}\nاز کتاب: ${bookTitleText}\nشباهت: ${similarityText}`;
+
+                       // کپی کردن متن به کلیپ بورد
+                       navigator.clipboard.writeText(textToCopy)
+                           .then(() => {
+                               // نمایش پیام موفقیت روی همان دکمه
+                               event.target.textContent = 'کپی شد!';
+                               setTimeout(() => {
+                                   event.target.textContent = 'کپی متن';
+                               }, 2000); // بازگرداندن متن دکمه بعد از 2 ثانیه
+                               console.log("Passage, reference, book title, and similarity copied to clipboard."); // لاگ موفقیت
+                           })
+                           .catch(err => {
+                               console.error('Failed to copy text: ', err); // لاگ خطا در کنسول
+                               event.target.textContent = 'خطا در کپی'; // پیام بازخورد خطا
+                                setTimeout(() => {
+                                   event.target.textContent = 'کپی متن';
+                               }, 2000);
+                           });
+                 } else {
+                      console.warn("Result item parent not found for copy button."); // لاگ
+                 }
+            }
+        });
+        console.log("Copy button delegation click listener added.");
+
+
+        // ****** راه اندازی اولیه: بارگذاری داده ها هنگام بارگذاری صفحه ******
+        // این تابع فرآیند بارگذاری داده از فایل های JSON بر اساس چک باکس های پیش فرض انتخاب شده در HTML را شروع می کند.
+        updateSelectedBooksData(); // این فراخوانی در نهایت checkAndEnableSearchButton را صدا می زند.
+        console.log("Initial data loading process started.");
+
+
+    } else {
+        // اگر تمام عناصر مورد نیاز پیدا نشدند، پیام خطا در کنسول و روی صفحه نمایش داده میشود
+        const errorMessage = "خطا در بارگذاری صفحه: برخی یا تمام عناصر لازم (HTML) پیدا نشدند. شناسه‌های HTML و نام کلاس‌ها را در index.html بررسی کنید و مطمئن شوید همه عناصر ضروری وجود دارند."; // پیام خطا برای کاربر
+        console.error(errorMessage, {
+            searchButton: !!searchButton, // از !! برای تبدیل به boolean استفاده می کنیم
+            userQuestionInput: !!userQuestionInput,
+            searchResultsContainer: !!searchResultsContainer,
+            loadingStatusElement: !!loadingStatusElement,
+            selectionErrorElement: !!selectionErrorElement,
+            selectAllCheckbox: !!selectAllCheckbox,
+            bookCheckboxesCount: bookCheckboxes ? bookCheckboxes.length : 0, // تعداد المان ها را نشان می دهد
+            resultsPerPageSelect: !!resultsPerPageSelect,
+            similarityThresholdInput: !!similarityThresholdInput
+        });
+         if (searchResultsContainer) { // اگر کانتینر نتایج پیدا شد، خطا را در آن نمایش بده
+             searchResultsContainer.innerHTML = `<p style=\"color: red;\">${errorMessage}</p>`;
+        }
+        // نمایش خطا در المان های وضعیت و خطای جداگانه
+        updateStatus("راه‌اندازی اولیه با خطا مواجه شد.", true);
+        updateSelectionError(errorMessage);
+
+        // غیرفعال نگه داشتن دکمه جستجو اگر پیدا شد
+        if (searchButton) {
+            setButtonEnabled(false);
+        }
+         // نیازی به return نیست چون کد بعد از این بلوک اجرا نمی شود (به دلیل عدم وجود المان های ضروری)
+    }
+});