fix: AI搜索不触发/无搜索结果时无交互提示 (#146)

* fix: trigger AI search and preserve empty results

* fix: include sortBy/sortOrder in active filter check; prevent showAISummary reset during search

- Extract hasActiveSearchFilters as utility function with sortBy/sortOrder checks
  (defaults: stars/desc). Fixes sorting being ignored when no other filters active.
- Only reset showAISummary on category change, not during search/filter updates.
  Prevents AI analysis display from being incorrectly turned off during AI search.

* docs: add JSDoc comments to RepositoriesView and searchRepositoriesWithReranking

Addresses CodeRabbit docstring coverage warning (50% -> meets threshold).

---------

Co-authored-by: Hermes Agent <hermes@agent.local>

Author: hych0317

src/App.tsx

@@ -15,34 +15,66 @@ import { useAutoUpdateCheck } from './components/UpdateChecker';
 import { UpdateNotificationBanner } from './components/UpdateNotificationBanner';
 import { backend } from './services/backendAdapter';
 import { syncFromBackend, startAutoSync, stopAutoSync } from './services/autoSync';
-import type { AppState } from './types';
-
-const RepositoriesView = React.memo(({ 
-  repositories, 
-  searchResults, 
-  selectedCategory, 
-  onCategorySelect 
-}: { 
+import type { AppState, SearchFilters } from './types';
+
+/**
+ * Check if any search/filter/sort condition is active (non-default).
+ * Used to decide whether to display searchResults or the full repository list.
+ */
+function hasActiveSearchFilters(filters: SearchFilters): boolean {
+  return (
+    !!filters.query.trim() ||
+    filters.languages.length > 0 ||
+    filters.tags.length > 0 ||
+    filters.platforms.length > 0 ||
+    filters.minStars !== undefined ||
+    filters.maxStars !== undefined ||
+    filters.isAnalyzed !== undefined ||
+    filters.isSubscribed !== undefined ||
+    filters.isEdited !== undefined ||
+    filters.isCategoryLocked !== undefined ||
+    filters.analysisFailed !== undefined ||
+    filters.sortBy !== 'stars' ||
+    filters.sortOrder !== 'desc'
+  );
+}
+
+/**
+ * Main repository view combining category sidebar, search bar, and repository list.
+ * Switches between search results and full list based on active search filters.
+ */
+const RepositoriesView = React.memo(({
+  repositories,
+  searchResults,
+  searchFilters,
+  selectedCategory,
+  onCategorySelect
+}: {
   repositories: AppState['repositories'];
   searchResults: AppState['searchResults'];
+  searchFilters: AppState['searchFilters'];
   selectedCategory: string;
   onCategorySelect: (category: string) => void;
-}) => (
-  <div className="flex flex-col gap-4 lg:flex-row lg:gap-6">
-    <CategorySidebar 
-      repositories={repositories}
-      selectedCategory={selectedCategory}
-      onCategorySelect={onCategorySelect}
-    />
-    <div className="flex-1 space-y-6">
-      <SearchBar />
-      <RepositoryList 
-        repositories={searchResults.length > 0 ? searchResults : repositories}
+}) => {
+  const isActive = hasActiveSearchFilters(searchFilters);
+
+  return (
+    <div className="flex flex-col gap-4 lg:flex-row lg:gap-6">
+      <CategorySidebar
+        repositories={repositories}
         selectedCategory={selectedCategory}
+        onCategorySelect={onCategorySelect}
       />
+      <div className="flex-1 space-y-6">
+        <SearchBar />
+        <RepositoryList
+          repositories={isActive ? searchResults : repositories}
+          selectedCategory={selectedCategory}
+        />
+      </div>
     </div>
-  </div>
-));
+  );
+});
 RepositoriesView.displayName = 'RepositoriesView';
 
 const ReleasesView = React.memo(() => <ReleaseTimeline />);
@@ -62,6 +94,7 @@ function App() {
     theme,
     hasHydrated,
     searchResults,
+    searchFilters,
     repositories,
     setSelectedCategory,
   } = useAppStore();
@@ -115,6 +148,7 @@ function App() {
           <RepositoriesView
             repositories={repositories}
             searchResults={searchResults}
+            searchFilters={searchFilters}
             selectedCategory={selectedCategory}
             onCategorySelect={handleCategorySelect}
           />
@@ -134,7 +168,7 @@ function App() {
       default:
         return null;
     }
-  }, [currentView, repositories, searchResults, selectedCategory, handleCategorySelect]);
+  }, [currentView, repositories, searchResults, searchFilters, selectedCategory, handleCategorySelect]);
 
   // Show loading state while store is hydrating to ensure correct theme is applied
   if (!hasHydrated) {

src/components/RepositoryList.tsx

@@ -116,12 +116,19 @@ export const RepositoryList: React.FC<RepositoryListProps> = ({
     [filteredRepositories]
   );
 
-  // 当筛选的仓库变化时，如果没有AI分析的仓库，自动切换到原始描述
+  // 当切换分类时，如果目标分类没有AI分析的仓库，自动切换到原始描述
+  // 注意：不要在搜索/过滤过程中触发，否则会误关用户的显示偏好
+  const prevHasAnalyzedRef = useRef(hasAnalyzedRepos);
+  const prevCategoryRefForAI = useRef(selectedCategory);
   useEffect(() => {
-    if (!hasAnalyzedRepos && showAISummary) {
+    const categoryChanged = prevCategoryRefForAI.current !== selectedCategory;
+    prevCategoryRefForAI.current = selectedCategory;
+    prevHasAnalyzedRef.current = hasAnalyzedRepos;
+
+    if (categoryChanged && !hasAnalyzedRepos && showAISummary) {
       setShowAISummary(false);
     }
-  }, [hasAnalyzedRepos]);
+  }, [hasAnalyzedRepos, selectedCategory]);
 
   // Infinite scroll (瀑布流按需加载)
   const LOAD_BATCH = 50;

src/services/aiService.ts

@@ -629,16 +629,49 @@ Focus on practicality and accurate categorization to help users quickly understa
     return this.performBasicSearch(repositories, query);
   }
 
+  /**
+   * Search repositories using AI semantic search with fallback to enhanced basic search.
+   * Attempts to call the configured AI service to parse search intent and extract
+   * multilingual keywords, then delegates to performEnhancedSearch. Falls back to
+   * performEnhancedBasicSearch with intelligent ranking if AI is unavailable or fails.
+   *
+   * @param repositories - The full list of repositories to search
+   * @param query - The user's search query string
+   * @returns Filtered and ranked repositories matching the query
+   */
   async searchRepositoriesWithReranking(repositories: Repository[], query: string): Promise<Repository[]> {
     console.log('🤖 AI Service: Starting enhanced search for:', query);
     if (!query.trim()) return repositories;
 
-    // 直接使用增强的基础搜索，提供智能排序
+    try {
+      console.log('🚀 AI Service: Calling configured AI service for semantic search');
+      const searchPrompt = this.createSearchPrompt(query);
+      const system = this.language === 'zh'
+        ? '你是一个智能搜索助手。请分析用户的搜索意图，提取关键词并提供多语言翻译。'
+        : 'You are an intelligent search assistant. Please analyze user search intent, extract keywords and provide multilingual translations.';
+
+      const content = await this.requestText({
+        system,
+        user: searchPrompt,
+        temperature: 0.1,
+        maxTokens: 200,
+      });
+
+      if (content) {
+        const searchTerms = this.parseSearchResponse(content);
+        const results = this.performEnhancedSearch(repositories, query, searchTerms);
+        console.log('✨ AI Service: AI semantic search completed, results:', results.length);
+        return results;
+      }
+    } catch (error) {
+      console.warn('❌ AI Service: AI semantic search failed, falling back to enhanced basic search:', error);
+    }
+
     console.log('🔄 AI Service: Using enhanced basic search with intelligent ranking');
-    const results = this.performEnhancedBasicSearch(repositories, query);
-    console.log('✨ AI Service: Enhanced search completed, results:', results.length);
-    
-    return results;
+    const fallbackResults = this.performEnhancedBasicSearch(repositories, query);
+    console.log('✨ AI Service: Enhanced search completed, results:', fallbackResults.length);
+
+    return fallbackResults;
   }
 
   // Enhanced basic search with intelligent ranking (fallback when AI fails)